AiHummer
Аԥсшәа▾
Аиалаҵара
v1.0.x▾
v1.0.xstable
{ }Swagger
Анеира ва аинтеграциақәа/Иадҳәалареи (хархәаҩ-хаҭала OAuth2)

Иадҳәалареи (хархәаҩ-хаҭала OAuth2)

v1.0.x · ирҿыцуп 2026-07-07

Иадҳәалареи абарҭ ала хазы хархәаҩ AiHummer идоступ ииҭоит аҩбатәи апартиа амаҵзурахь иара ихаҭа ихьӡала. Еицырҟоу шәоу амаҵзуратә аккаунт ацынхәрас, зегьы ауаҩы аус ауеит стандарттә OAuth2 авторизациатә-код флоу ала, иаалырҟьаны иҟоу атокен ишифрованоу хранилище аҿы иасоуп, насгьы аҩаԥхьара (ход) аамҭазы арантайм иаарԥшуеит убри хархәаҩ итокен, амаҵзур уи иаҭахызар.

Уи AiHummer идоступ-модель «хаҭалатә» хәҭа ауп. Идуу асахьа разы — иарбоу ианба еиҳа ишьшәоу доступ ишабжьаргои насгьы ифоллбек ишԥанарбои — иашәырба Хаҭалатәи шәоуи доступқәа.

Иадҳәалара иарбоу

Иадҳәалара иаԥшьаргоит хԥа зхы иацызку: провайдер (OAuth2 апп шәара шәызавторизациа зуа), хархәаҩ (аконсент-экран зхырҟәоҵхаз ауаҩы), насгьы хранилище-аҩыхә (иарбоу атокен ахьыҵәахоу). Иргылоу ашьҭахь, убри хархәаҩ ихаҭала аус зуа маҵзур зегьы уи атокен иҟазшьаны ихархәоит, амодель аконтекст рҿы, ажурналқәа рҿы ма апромпт аҿы зныкгьы аамхәуа.

Иадҳәалареи рхылаԥшра мҩаԥысуеит аадминистраторатә UI аҟынтә. Ажәалист аарԥшуеит хархәаҩ зегьы иадгылоу провайдерцәа, рстатус насгьы иантба ианацынхәтәаз.

Авторизациатә-код флоу

Иадҳәалара иаԥшьаргоит канон, хԥа-шьапы змоу OAuth2 авторизациатә-код агрант ала:

  1. Хархәаҩ иалагоит иадҳәалара провайдер разы аадминистраторатә UI аҟынтә — POST/GET /v1/admin/connections/oauth/start аҭаӡра ала.
  2. AiHummer ибраузер ишьҭеиргоит провайдер авторизациа эндпоинт ахь, иҭахоу аскоупқәа рыла.
  3. Хархәаҩ иаԥшьоит аконсент-экран; провайдер шьҭыхны изеиҭеиргоит знытәтәи авторизациатә код /v1/admin/connections/oauth/callback ахь.
  4. Callback-аҟаҵаратә-хаҿ аҩныҵҟа, AiHummer сервер аганахьала убри акод иеиԥсахуеит доступ атокен ала (насгьы, провайдер иадгылозар, аиҭарҿыцра атокен ала) провайдер итокен-эндпоинт аҿы.
  5. Атокен иҩуп хранилище аҿы насгьы Иадҳәалара иактив-акәны иазгәаҭоуп.

Акод-атокен аиԥсахра мҩаԥысуеит сервер аганахьала, callback аҩныҵҟа, убри ала client secret насгьы иарбоу атокен зныкгьы гейтуэй иаҩыхымхуа.

[!NOTE] Ари флоу мап ацәышәамкааит POST /v1/oauth/token акала: уи AiHummer хаҭала OAuth2 client-credentials эндпоинтуп — /v1/admin/apikeys/register-client ала иаргистрироу амаҵзуратә аккаунтқәа убра рыла client_id/client_secret еиԥсоит амаҵзатәи ah- токен ахь. Уи аҩбатәи апартиатә Иадҳәалареи ирыдҳәаламкуа.

[!NOTE] Авторизациатә-код флоу зныкгьы иадоуп ииашоу браузер-консент ашьаҿа. Иадҳәалара API калит мацара аҟынтә «аӡбахьысыхуала» аргылара залшом — аус зуа хархәаҩ зныкгьы аскоупқәа иаԥшьалатәуп.

Атокен ахьынхо

Иарбоу атокен иҵәахуп AiHummer ишифрованоу доступтә хранилище аҿы, аартоу конфигурациа аҟны акәымкәа. Ахранилище ихархәоит конверт-ашифрованра (AES-256-GCM, тенант-хаҭала аелементдан акалит мастер-калит ацаҵаны), насгьы асекретқәа зныкгьы амодель аконтекст, апромптқәа ма ажурналқәа рҿы иахьшьуам. Иаԥхьаԥхьоу ма иасхьоу Иадҳәалара схарухәо секрет ааныжьуам.

oauth/start ─▶ консент ─▶ код ─▶ oauth/callback (провайдер аҟны аиԥсахра) ─▶ доступ/аиҭарҿыцра токен ─▶ хранилище (ишифрованоу)

Аус зуа хархәаҩ ала иаарԥшны

Иадҳәалара иҷыдоу аҟазшьа ауп уи аус зуа хархәаҩ ала иаарԥшны ахьыҟоу. Агент амаҵзур, провайдер зҭаху, ааус ауа аамҭазы, арантайм иаԥшаауеит аҩаԥхьара (ход) зхылҵуа хархәаҩ изку Иадҳәалара, насгьы ихархәоит уи итокен. Ааигәа ҩ-ҩык аусзуҩцәа акала агент дацәажәагьы, зегьы ирыжь-ужьтәи авторизациа ала аус руеит насгьы ирбоит рыжь-ужьтәи агрант зхараауа мацара.

Уи ауп Иадҳәалареи хаҭалатәи, хархәаҩ-хаҭалатәи интеграциақәа разы изыхадоу: зегьы ауаҩы идоступ хазы иашьҭоу, иаудиттәу насгьы хазы иаԥхьаԥхьартәу.

Иадоступ интеграциақәа

OAuth2 флоу ала хархәаҩ иадгылоит иара ихаҭа иаккаунт избоу амаҵзурақәа зегьы рахь. Абарҭ хаҭалатә интеграциақәа аартоу иадоступуп:

Агәыԥ Амаҵзурақәа
Google Gmail, Google Calendar, Google Contacts, Google Tasks, Google Drive, YouTube
Microsoft Outlook Mail, Outlook Calendar, OneDrive, Microsoft To Do
Аусуратә продуктивра Todoist, Asana, Jira Cloud, ClickUp, GitLab, Linear, monday.com
Агәабзиареи аԥсҭазаареи Fitbit, Oura Ring, Strava, Spotify, Samsung SmartThings

Зегьы иадгылоит убри авторизациатә-код флоу акала: хархәаҩ иаԥшьоит провайдер аконсент-экран, атокен хранилище аҿы иасоуп, насгьы иаарԥшуеит убри хархәаҩ разы, амаҵзур ианахьынагылалак.

Иадҳәалареи рхылаԥшра аадминистраторатә UI аҿы

Аадминистраторатә UI аҟынтә аоператор илшоит:

  • Ирбарц провайдерцәа хархәаҩ зегьы иадгылаз насгьы токен зегьы иаԥсабара.
  • Иалагарц ҿыцу иадҳәалара (иалхыз провайдер разы аконсент-флоу ашьҭагалара).
  • Иаԥхьаԥхьарц иадҳәалара — уи аныхуеит хранилище-аҩыхә насгьы аарԥшра иаԥыркуеит.

Иадҳәалареи руп хаҭалатә (иарбоу хархәаҩ изку, иара ихаҭа излаиҵаша) ма воркспеис-шәоу (тег «Workspace shared» рыманы; хаҭалатә ила рыҵаҵаша ыҟам). Ак провайдер аҟны ишәылшоит аккаунт рацәак реилазаара: батон «+ аккаунт» аҳәоит атег насгьы даҽа ак акредент (убри провайдер зну) хранилище аҿы иасуеит — ҿырԥш ала, Google акалендар ма апочта-аӡбахә рацәак.

Иҵабыргу адоступқәа хаҭалатә ишакыу азы, Иадҳәалара насгьы дара роуп ииашоу хархәага, аусура арбаны хаҭаны хархәаҩ иавторизациа ала ишьоу насгьы уи ала иазҟьоу иаҭахуа, воркспеис-шәоу аккаунт акәымкәа.

Иахьынтә ашьҭахь