Пайвастҳо (OAuth2 барои ҳар як корбар)
Пайвастҳо ин аст, ки чӣ тавр як корбари алоҳида ба AiHummer дастрасӣ ба хидмати шахси сеюмро ба номи худ медиҳад. Ба ҷои як ҳисоботи хидмати муштарак, ҳар як шахс ҳисоботи стандартиро иҷро мекунад Ҷараёни иҷозатдиҳии рамзи OAuth2, рамзи натиҷавӣ дар анбори рамзгузорӣшуда маҳкам карда мешавад ва дар вақти иҷро, вақти иҷро рамзи он корбарро ҳангоми зарурат барои асбоб ҳал мекунад.
Ин нимаи «шаҳсӣ» модели эътимодномаи AiHummer мебошад. Барои тасвироти васеътар — кай бояд эътимодномаи муштаракро афзал донист ва чӣ гуна механизми ивазкунӣ кор мекунад — нигаред Шаҳсӣ бар муқобили шарикии иҷозатномаҳо.
Чӣ гуна пайванд аст
Як пайванд се чизро бо ҳам мепайвандад: як таъминкунанда (барномаи OAuth2, ки шумо иҷозат медиҳед), як истифодабаранда (шахсе, ки экранро барои розигӣ пур кард), ва як входи анбор (ки дар он ҷо нишонаи додашуда нигоҳ дошта мешавад). Пас аз таъсис, ҳар воситае, ки ба номи он корбар амал мекунад, метавонад нишонаро бефосила истифода барад, бе он ки он ҳеҷ гоҳ дар контексти модел, қайдҳо ё дар фармон пайдо шавад.
Пайвастҳо аз интерфейси маъмур идора карда мешаванд. Феҳрист провайдерҳои пайвастшудаи ҳар корбар, ҳолати онҳо ва вақти охирини навсозии онҳоро нишон медиҳад.
Ҷараёни рамзи иҷозат
Пайвастагӣ бо коди иҷозатномаи OAuth2 бо се пойи муқаррарӣ эҷод карда мешавад:
- Истифодабаранда пайвастшавӣ барои провайдерро аз интерфейси идоракунӣ оғоз мекунад — а
POST/GET /v1/admin/connections/oauth/startдархост - AiHummer браузерро ба таъминкунанда равона мекунад сомонат нирӯи ниҳоӣ бо доираҳои дархостшуда.
- Истифодабаранда саҳифаи розигӣ пешниҳодшударо тасдиқ мекунад; провайдер баргардонида мешавад бо як
яквақта рамзи иҷозат ба
/v1/admin/connections/oauth/callback. - Дар дохили идорагари баргардонидани занг, AiHummer он кодро дар паҳлӯи сервер бо як токени дастрасӣ (ва, вақте таъминкунанда онро дастгирӣ мекунад, як навсозии токен) дар нуқтаи охирини токени провайдер.
- Шиноснома ба анбор навишта шуда, Пайвастшавӣ ҳамчун фаъол қайд мешавад.
Табодули рамз ба рамзи дастрасӣ дар сервер дар дохили_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-ро барои ҳамгироӣҳои шахсӣ ва барои ҳар як корбар мувофиқ мекунад: дастрасии ҳар шахс ҷудогона, ҳисобшудар ва алоҳида бекоршаванда мебошад.
Интегратсияҳои дастрас
Аз тариқи раванди OAuth2 корбар метавонад ҳисоби худро ба ҳар як хадамоти интиқол пайваст кунад. Ин ҳамгироиҳои шахсӣ фаврӣ дастрасанд:
| Гурӯҳ | Хизматрасониҳо |
|---|---|
| Гугл | 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 |
| Саломатӣ ва тарзи ҳаёт | Фитбит, Оура Ринг, Страва, Спотифай, Самсунг СмартТингс |
Ҳар яке бо ҳамон равияи рамзи иҷозат пайваст мешавад: корбар экрани ризоияти таъминкунандагро пур мекунад, рамз дар анбор маҳфуз мешавад ва ҳангоми дастрасии абзор ба хизматрасонӣ барои он корбар ҳалли худро мегирад.
Идоракунии пайвастагиҳо дар интерфейси идоракунанда
Аз интерфейси идоракунӣ оператор метавонад:
- Бинед ки ҳар корбар кадом провайдерҳоро пайваст кардааст ва саломатии ҳар як токен чӣ ҳост.
- Пайвасти навро оғоз кунед (равандии ризоиятро барои провайдери интихобшуда оғоз кунед).
- Шабакаи пайвастшударо лағв кунед, ки вурудро ба анбор нест мекунад ва ҳалли онро ғайрифаъол мекунад.
Пайвандҳо ё шаҳсӣ (ба як корбари муайян тааллуқдошта, ки метавонад онро ҷудо кунад) ё бо майдони корӣ мубодила шуд (тамғагузорӣ шудааст “Иштироки фазои корӣ”; онҳоро шахсан ҷудо кардан мумкин нест). Як хизматрасон метавонад нигоҳ дорад ҳисобҳои сершуморТугмаи «+ ҳисоб» барои нишонномаи ҳисоб талаб мекунад ва маълумоти дигареро аз ҳамон таъминкунанда нигоҳ медорад — масалан, чандин тақвими Google ё қуттиҳои почта.
Азбаски шаҳодатномаҳои асосӣ шахсӣ мебошанд, пайвастшавӣ аксаран воситаи дуруст аст вақте ки як амал бояд ба иҷозати шахсии муайян дода шуда ва маҳдуд карда шавад, на ба ҳисоби умумии ҷои кор.
Баъд ба куҷо
- Шаҳсӣ бар муқобили шарикии иҷозатномаҳо — пурра намудори доира ва кай бояд ҳар кадомро интихоб кард.
- Таъминкунандагони LLM BYOK — калидҳои модели худро биёред барои ҳар иҷоранишин.
- Назари умумӣ ба бозор ва сатҳҳо — куҷо Интегратсияҳо бо пуштибонии OAuth мувофиқанд.