AiHummer
Հայերեն▾
ՄուտքԱնձնական գրասենյակ
v1.6.x▾
{ }Swagger

Հնարավորություններ (OAuth2 յուրաքանչյուր օգտագործողի համար)

v1.6.x · թարմացվել է 2026-11-17

Կապեր այս այն է, թե ինչպես առանձին օգտատերը տրամադրում է AiHummer-ին արտաքին ծառայության մուտք իր անունից: Մի ընդհանուր ծառայության հաշիվ օգտագործելու փոխարեն յուրաքանչյուր մարդ օգտագործում է ստանդարտ Օտհորիզացիայի հոսքը OAuth2 կոդով, ստացված տոքենը պահվում է համեմատաբար ապահով պահարանի մեջ, և գործարկման ժամանակ համակարգը թույլ տալիս է այս օգտատիրոջ տոքենը, երբ գործիքը այն խնդրում է:

Սա AiHummer հաշվի տվյալների մոդելի «անձնական» հատվածն է: Ընդհանուր պատկեր ունենալու համար՝ երբ նախապատվությունը տալ համատեղ հաշիվին և ինչպես գործում է պահուստային սխեման՝ նայեք Անձնական և հանրային հավատարմագրման տեղեկություններ.

Ստորև ներկայացված անձնական հոսքը մնում է հիմնականը։ Ստորագրված Core 1.4.15-ը տեղադրելուց հետո կարգավորված ալիքն ու տեղային գործիքները կարող են ընտրել մեկ հստակ կապակցված հաշիվ՝ առանձին connection-token բանալիով․ թարմացումն անում է միայն պահոցը։ Սա չի կիսում բոլոր օգտատերերի թույլտվությունները և չի պահանջում յուրաքանչյուր աշխատակցի միացում։ Գործիքները շարունակում են ստուգել գործող օգտատիրոջ ընթացիկ իրավունքները։ Տե՛ս Bitrix24։

Ինչ է միակցումը

Հաղորդակցությունը միացնում է երեքը միասին՝ a մատակարար (OAuth2 հավելվածը, որին դուք տրամադրում եք թույլտվություն), և օգտատեր (մարդը, ով լրացրել է համաձայնության էկրանը), և գրանցում պահոցում (որտեղ պահվում է տրված տոկենը): Ինստալյացիայից հետո ցանկացած գործիք, որը գործում է այս օգտվողի անունից, կարող է թափանցիկ կերպով օգտագործել տոկենը, առանց հայտնվելու մոդելի համատեքստում, մատյաններում կամ պնդման տեքստում։

Կապերն կառավարվում են ադմինիստրատիվ ինտերֆեյսի միջոցով: Ցուցակն ցույց է տալիս յուրաքանչյուր օգտվողի համար միացված պրովայդերներին, նրանց կարգավիճակը և վերջին թարմացման ժամանակը:

Հոսք՝ զեկուցման կոդով

Ստեղծվում է կապ՝ օգտագործելով կանոնակարգված երեքաստիճան OAuth2 փաստաթղթավորման կոդը:

  1. Օգտատերը սկսում է միանալ պրովայդերին վարչական ինտերֆեյսի միջոցով — իսկ POST/GET /v1/admin/connections/oauth/start հարցում.
  2. AiHummer վերակենդանացնում է զննարկիչը մատակարարի մոտ ավտորիզացիա վերջնական կետ հարցված ոլորտներով։
  3. Օգտատերը հաստատում է համաձայնության էկրանը; մատակարարը վերադարձնում է հետ մեկանգամյա ավտորիզացման կոդ կ /v1/admin/connections/oauth/callback.
  4. AiHummer-ի վերակապվող ֆունկցիայի ներսում այս կոդը փոխանակվում է սերվերի կողմից մուտքի տոկեն (և երբ դա աջակցվում է մատակարարի կողմից, a թարմացնել տոկենը) տոկենի կայացածի վերջնական կետում։
  5. Տոկենը գրանցվում է պահոցում, իսկ միացումը նշվում է որպես ակտիվ։

Կոդի փոխանակումը տոկենի վրա տեղի է ունենում սերվերի կողմում հետադարձ կանչի մեջ, այն պատճառով հաճախորդի գաղտնիքը և տրամադրված տոկենը երբեք չեն լքում գեյթվեյը:

[!NOTE] Մի շփոթեք այս հոսքը POST /v1/oauth/token: սա պատկանում է AiHummer-ին տնային OAuth2 client-credentials վերջնակետը՝ ծառայության հաշիվներ, գրանցված միջոցով /v1/admin/apikeys/register-client փոխանակել դրանք client_id/client_secret տամ չէ երկար ah- տոկեն։ Դա չի առնչվում երրորդ կողմի հետ Ընդհանուր դասավորություններ.

[!NOTE] Հավաստավորման կոդի հոսքը միշտ ընդգրկում է իրական բրաուզերի համաձայնության փուլ։ A կապը հնարավոր չէ ստեղծել առանց գլխի միայն API բանալիով — գործող օգտագործող Պիտանի է մեկանգամյա կերպով հաստատել գործողության ոլորտները։

Որտեղ է գտնվում տոկենը

Միտված տոկենը պահպանում է AiHummer-ում ակնային ծածկագրված տվյալների պահոց, սովորական կազմաձևով չէ: Ապրանքանիշը օգտագործում է ծալված կոդավորում (AES-256-GCM՝ յուրաքանչյուր վարձորդի տվյալների բանալիով՝ գլխավոր բանալիի տակ), և գաղտնիքներն երբեք չեն պատճենվում մոդելի կոնտեքստ, կանխորոշումներ կամ գրանցումներ: Չեղարկված կամ ժամկետանց Միասնությունը պարզապես չի թողնում հետևին որևէ օգտակար գաղտնիք։

oauth/start ─▶ consent ─▶ code ─▶ oauth/callback (exchange at the provider) ─▶ access/refresh token ─▶ vault (encrypted)

Այլ գործող օգտագործողի կողմից լուծված

Միացման որոշիչ հատկությունը այն է, որ այն որոշվել է գործող օգտագործողի կողմից. Երբ գործակալը սկսում է գործիք, որը պահանջում է պրովայդեր, գործարկման միջավայրը փնտրում է այն կցված միությունն, որը պատկանում է այն օգտատիրոջը, որի անունից կատարվում է այս քայլը, և օգտագործում է նրանց տոկենը: Երկու աշխատակից, որոնք խոսում են նույն գործակցի հետ հետեւաբար գործում են իրենց սեփական թույլտվություններով և տեսնում են միայն այն, ինչ թույլ է տալիս իրենց սեփական դրամաշնորհը:

Դրա շնորհիվ Connections-ը հարմար է անձնական, յուրաքանչյուր օգտագործողի ինտեգրացիաների համար․ յուրաքանչյուր անձի մուտքը միմյանցից անկախ է, ստուգելի և անհատապես ֆիքսելի է վերացվող։

Առկա ինտեգրացիաներ

Ստորև նշված ծառայություններն աջակցում են անձնական կապերին։ OAuth-ը սկսելու համար այս սերվերում պետք է կարգավորված լինի մատակարարը։

Խմբ Ծառայություններ
Գուգլ Gmail, Google Վերջացուցիչ, Google Կապերի, Google Առաջադրանքներ, Google Դիսկ, YouTube
Մայքրոսոֆթ Outlook Էլ.փոստ, Outlook Օրացույց, OneDrive, Microsoft To Do
Արտադրողականություն Todoist, Asana, Jira Cloud, ClickUp, GitLab, Linear, monday.com
Առողջություն և ապրելակերպ Ֆիթբիթ, Օուրա Ռինգ, Ստրավա, Սպոթիֆայ, Սամսունգ ՍմարթԹինգս

Եթե OAuth կապը հասանելի է, անցեք մատակարարի համաձայնության էկրանը։ Տրված թոքենը պահվում է ձեր գաղտնիքների պահոցում և ընտրվում է, երբ գործիքն օգտագործում է այդ ծառայությունը։

Անձնական Gmail, երբ OAuth-ը հասանելի չէ

Եթե Gmail OAuth-ը հասանելի չէ, գործակալից խնդրեք անձնական Gmail-ի կարգավորման հղումը։ Բացեք այն՝ մուտք գործելով այն AiHummer հաշիվը, որի համար հղումը ստեղծվել է։ Հաշվի անհամապատասխանության դեպքում մուտք գործեք համապատասխան հաշիվը և կրկին բացեք հղումը։ Ձևը գործակալի փոստարկղի կողքին պահպանում է առանձին մասնավոր անձնական կապ։

Եթե ձեր Google հաշիվը թույլ է տալիս և երկքայլ հաստատումը միացված է, Google հաշվի կարգավորումներում ստեղծեք հավելվածի գաղտնաբառ։ Gmail հասցեն և ստեղծված հավելվածային գաղտնաբառը մուտքագրեք անմիջապես ձևում։ IMAP/SMTP պարամետրերը սահմանվում են ինքնաշխատ։ Հավելվածների գաղտնաբառերի կարգավորումներ · Google հաշվի օգնություն։

Պահպանելուց հետո խնդրեք գործակալին կարդալ ձեր անձնական Gmail-ը։ mail գործիքում account=personal_gmail-ն ընտրում է անձնական Gmail-ը, իսկ account=agent-ը՝ գործակալի փոստարկղը։ Յուրաքանչյուր գործողության համար ստուգվում են ընթացիկ հասանելիությունն ու ընտրված մուտքային տվյալները։ Պահպանումը հաստատում է գրանցումը։ Հաջող ընթերցումը հաստատում է մուտքը։ Ուղարկելու համար անհրաժեշտ է ձեր հանձնարարությունը։ Չհաստատված ուղարկման դեպքում նոր փորձից առաջ ստուգեք սկզբնական գործողության անդորրագիրը։

Կապերի կառավարում վարչարարական ինտերֆեյսում

Մակարդակային ինտերֆեյսից՝ ադմինիստրատորը օպերատորը կարող է՝

  • Դիտեք՝ ինչ պրովայդերներ են միացված յուրաքանչյուր օգտագործողի մոտ և յուրաքանչյուր տոկենի վիճակը։
  • Սկսել նոր միացում (ներգործվող գործընթացի սկսում ընտրված մատակարարի համաձայնությունը ստանալու համար)։
  • Հրաժարվել միացումից, որը ջնջում է պահեստի գրառումը և անջատում թույլտվությունը։

Կապերը լինում են կամ անձնական (հատկացված կոնկրետ օգտվողին, ով կարող է դրանք անջատել) կամ ընդհանուր հասանելիություն աշխատանքային տարածքի հետ (նշված է որպես «Ընդհանուր աշխատանքային տարածք»; դրանք անհատապես անջատել հնարավոր չէ): Մեկ մատակարար կարող է պահել քանևէ հաշիվ«+ հաշիվ» կոճակը խնդրում է նշում և պահպանում մեկ այլ հաշիվ նույն մատակարարից՝ օրինակ, մի քանի Google օրացույցներ կամ էլփոստի փոստարկղեր:

Քանի որ սկզբնական հավատարմագրերը անձնական են, Հավելումը հաճախ ճիշտ գործիքն է, երբ գործողությունը պետք է վերագրվի կոնկրետ անձին և սահմանափակվի նրա թույլտվությամբ, ոչ թե ամբողջ աշխատանքային տարածքի հաշվի միջոցով:

Որտեղից հետո