AiHummer
Тоҷикӣ▾
ВоридшавӣКабинети шахсӣ
v1.6.x▾
{ }Swagger

Пайвастҳо (OAuth2 барои ҳар як корбар)

v1.6.x · навсозӣ шуд 2026-11-17

Пайвастҳо ин аст, ки чӣ тавр як корбари алоҳида ба AiHummer дастрасӣ ба хидмати шахси сеюмро ба номи худ медиҳад. Ба ҷои як ҳисоботи хидмати муштарак, ҳар як шахс ҳисоботи стандартиро иҷро мекунад Ҷараёни иҷозатдиҳии рамзи OAuth2, рамзи натиҷавӣ дар анбори рамзгузорӣшуда маҳкам карда мешавад ва дар вақти иҷро, вақти иҷро рамзи он корбарро ҳангоми зарурат барои асбоб ҳал мекунад.

Ин нимаи «шаҳсӣ» модели эътимодномаи AiHummer мебошад. Барои тасвироти васеътар — кай бояд эътимодномаи муштаракро афзал донист ва чӣ гуна механизми ивазкунӣ кор мекунад — нигаред Шаҳсӣ бар муқобили шарикии иҷозатномаҳо.

Ҷараёни шахсии поён асосӣ мемонад. Баъди насби Core 1.4.15-и имзошуда канал ва абзорҳои маҳаллии танзимшуда метавонанд як пайвасти ошкоро басташударо бо калиди ҷудогонаи connection-token интихоб кунанд; токенҳоро танҳо махзан нав мекунад. Ин ҳамаи иҷозатҳои ҳамаи корбаронро муштарак намекунад ва пайвастшавии ҳар кормандро талаб намекунад. Абзорҳо ҳуқуқи ҷории корбари амалкунандаро месанҷанд. Нигаред: Bitrix24.

Чӣ гуна пайванд аст

Як пайванд се чизро бо ҳам мепайвандад: як таъминкунанда (барномаи OAuth2, ки шумо иҷозат медиҳед), як истифодабаранда (шахсе, ки экранро барои розигӣ пур кард), ва як входи анбор (ки дар он ҷо нишонаи додашуда нигоҳ дошта мешавад). Пас аз таъсис, ҳар воситае, ки ба номи он корбар амал мекунад, метавонад нишонаро бефосила истифода барад, бе он ки он ҳеҷ гоҳ дар контексти модел, қайдҳо ё дар фармон пайдо шавад.

Пайвастҳо аз интерфейси маъмур идора карда мешаванд. Феҳрист провайдерҳои пайвастшудаи ҳар корбар, ҳолати онҳо ва вақти охирини навсозии онҳоро нишон медиҳад.

Ҷараёни рамзи иҷозат

Пайвастагӣ бо коди иҷозатномаи OAuth2 бо се пойи муқаррарӣ эҷод карда мешавад:

  1. Истифодабаранда пайвастшавӣ барои провайдерро аз интерфейси идоракунӣ оғоз мекунад — а POST/GET /v1/admin/connections/oauth/start дархост
  2. AiHummer браузерро ба таъминкунанда равона мекунад сомонат нирӯи ниҳоӣ бо доираҳои дархостшуда.
  3. Истифодабаранда саҳифаи розигӣ пешниҳодшударо тасдиқ мекунад; провайдер баргардонида мешавад бо як яквақта рамзи иҷозат ба /v1/admin/connections/oauth/callback.
  4. Дар дохили идорагари баргардонидани занг, AiHummer он кодро дар паҳлӯи сервер бо як токени дастрасӣ (ва, вақте таъминкунанда онро дастгирӣ мекунад, як навсозии токен) дар нуқтаи охирини токени провайдер.
  5. Шиноснома ба анбор навишта шуда, Пайвастшавӣ ҳамчун фаъол қайд мешавад.

Табодули рамз ба рамзи дастрасӣ дар сервер дар дохили_CALLBACK сурат мегирад, бинобар ин, махфияти муштарӣ ва рамзи додашуда ҳеҷ гоҳ дари гузаргоҳро тарк намекунад.

[!NOTE] Ин равонро бо POST /v1/oauth/tokenин АиҲаммер аст шахсӣ Нуқтаи охири OAuth2 барои мизоҷ-эътиборҳо — ҳисоби хизматрасоние, ки тавассути сабт шудааст /v1/admin/apikeys/register-client иваз кардани онҳо client_id/client_secret онҷо барои муддате кӯтоҳ ah- токен. Он ҳеҷ иртиботе бо тарафи сеюм надорад Пайвандҳо

[!NOTE] Ҷараёни рамзи иҷозат ҳамеша марҳилаи розигии браузери воқеиро дар бар мегирад. Пайвастшавӣ наметавонад танҳо бо калиди API бе сарсозиш сохта шавад — истифодабарандаи амалкунанда иқдомҳоро як маротиба бояд тасдиқ кунанд

Куҷо ин нишон зиндагӣ мекунад

Токени додашуда дар AiHummer нигоҳ дошта мешавад анбори эъломияҳои рамзшуда, на дар конфигуратсияи оддӣ. Сароя аз рамзгузории конвертӣ (AES-256-GCM бо калиди маълумоти ҳар иҷорагирӣ таҳти калиди асосӣ) истифода мебарад, ва сирфҳо ҳеҷ гоҳ ба матни модели контекст, супоришҳо ё журналиҳо нусхабардорӣ намешаванд. Пайванди бозхудшуда ё мӯҳлаташ гузашта танҳо сирфи истифодашаванда намеменонад.

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

Аз ҷониби корбари муваққатӣ ҳал карда шуд

Хусусияти муайяни Пайванд он аст, ки он ҳалшуда аз ҷониби корбари муваққат. Вақте ки агент асбобе кор мекунад, ки ба провайдер ниёз дорад, вақти иҷро пайвасти марбут ба корбареро, ки ба ҷои ӯ навбат кор мекунад, меҷӯяд ва токени худро истифода мебарад. Даҳшкар ду корманд, ки бо ҳамон агент сӯҳбат мекунанд, бинобар ин бо иҷозатномаҳои худ амал мекунанд ва фақат он чизеро мебинанд, ки иҷозатномаи худ ба онҳо медиҳад.

Ин чизе аст, ки Connections-ро барои ҳамгироӣҳои шахсӣ ва барои ҳар як корбар мувофиқ мекунад: дастрасии ҳар шахс ҷудогона, ҳисобшудар ва алоҳида бекоршаванда мебошад.

Интегратсияҳои дастрас

Хизматрасониҳои зер пайвастҳои шахсиро дастгирӣ мекунанд. Барои оғози OAuth провайдер бояд дар ин сервер танзим шуда бошад.

Гурӯҳ Хизматрасониҳо
Гугл Gmail, Google Calendar, Google Contacts, Google Tasks, Google Drive, YouTube
Майкрософт Почтаи Outlook, Ҷадвали Outlook, OneDrive, Microsoft To Do
Самаранокӣ Todoist, Asana, Jira Cloud, ClickUp, GitLab, Linear, monday.com
Саломатӣ ва тарзи ҳаёт Фитбит, Оура Ринг, Страва, Спотифай, Самсунг СмартТингс

Агар пайвасти OAuth дастрас бошад, экрани ризоияти провайдерро гузаред. Токени додашуда дар анбори асрори шумо нигоҳ дошта мешавад ва ҳангоми истифодаи хизматрасонӣ аз ҷониби абзор интихоб мегардад.

Gmail-и шахсӣ ҳангоми дастнорас будани OAuth

Агар Gmail OAuth дастнорас бошад, аз агент пайванди танзими Gmail-и шахсиро пурсед. Онро бо ворид шудан ба ҳамон ҳисоби AiHummer, ки пайванд барои он сохта шудааст, кушоед. Ҳангоми номувофиқии ҳисоб ба ҳисоби дуруст ворид шуда, пайвандро боз кушоед. Шакл дар баробари қуттии почтаи агент пайвасти ҷудогонаи хусусии шахсиро нигоҳ медорад.

Агар ҳисоби Google-и шумо ин имкониятро иҷозат диҳад ва санҷиши дуқадамӣ фаъол бошад, дар танзимоти он гузарвожаи барнома созед. Суроғаи Gmail ва гузарвожаи махсуси барномаро мустақиман дар шакл ворид кунед. Танзимоти IMAP/SMTP худкор таъин мешаванд. Танзимоти гузарвожаҳои барнома · Кӯмаки Google.

Пас аз нигоҳдорӣ аз агент хондани Gmail-и шахсиро хоҳиш кунед. Абзори mail бо account=personal_gmail Gmail-и шахсӣ ва бо account=agent қуттии агентро интихоб мекунад. Ҳар амалиёт дастрасии ҷорӣ ва маълумоти интихобшудаи пайвастро месанҷад. Нигоҳдорӣ сабти маълумотро тасдиқ мекунад. Хониши муваффақ дастрасиро тасдиқ мекунад. Ирсол супориши шуморо талаб мекунад. Агар ирсол тасдиқ нашуда бошад, пеш аз кӯшиши нав расиди аслиро санҷед.

Идоракунии пайвастагиҳо дар интерфейси идоракунанда

Аз интерфейси идоракунӣ оператор метавонад:

  • Бинед ки ҳар корбар кадом провайдерҳоро пайваст кардааст ва саломатии ҳар як токен чӣ ҳост.
  • Пайвасти навро оғоз кунед (равандии ризоиятро барои провайдери интихобшуда оғоз кунед).
  • Шабакаи пайвастшударо лағв кунед, ки вурудро ба анбор нест мекунад ва ҳалли онро ғайрифаъол мекунад.

Пайвандҳо ё шаҳсӣ (ба як корбари муайян тааллуқдошта, ки метавонад онро ҷудо кунад) ё бо майдони корӣ мубодила шуд (тамғагузорӣ шудааст “Иштироки фазои корӣ”; онҳоро шахсан ҷудо кардан мумкин нест). Як хизматрасон метавонад нигоҳ дорад ҳисобҳои сершуморТугмаи «+ ҳисоб» барои нишонномаи ҳисоб талаб мекунад ва маълумоти дигареро аз ҳамон таъминкунанда нигоҳ медорад — масалан, чандин тақвими Google ё қуттиҳои почта.

Азбаски шаҳодатномаҳои асосӣ шахсӣ мебошанд, пайвастшавӣ аксаран воситаи дуруст аст вақте ки як амал бояд ба иҷозати шахсии муайян дода шуда ва маҳдуд карда шавад, на ба ҳисоби умумии ҷои кор.

Баъд ба куҷо