Birikmeler (her ulanyjy OAuth2) — AiHummer Resminamalar

Birikmeler — bu aýratyn ulanyjynyň öz adyndan AiHummer-e üçünji tarap hyzmatyna giriş bermeginiň usulydyr. Ýeke-täk umumy hyzmat hasaby ýerine, her adam standart OAuth2 awtorizasiýa-kod akymyny işledýär, netijede alnan belgi şifrlenen seýfde möhürlenýär we nobat wagtynda gural zerur bolanda işleýiş wagty şol ulanyjynyň belgisini çözýär.

Bu AiHummer-iň kepilnama modeliniň “şahsy” ýarymydyr. Has giň surat üçin — umumy kepilnamany haçan saýlamaly we ätiýaçlyk nähili işleýär — Şahsy garşy umumy kepilnamalar bölümine serediň.

Birikme näme

Birikme üç zady birleşdirýär: üpjün ediji (siziň ygtyýarlandyrýan OAuth2 programmaňyz), ulanyjy (razylyk ekranyny dolduran adam) we seýf girişi (berlen belginiň saklanýan ýeri). Bir gezek döredilenden soň, şol ulanyjynyň adyndan hereket edýän islendik gural belgini model kontekstinde, loglarda ýa-da promptda hiç haçan görkezmän aç-açan ulanyp bilýär.

Birikmeler admin UI-den dolandyrylýar. Sanaw her ulanyjynyň birikdirilen üpjün edijilerini, olaryň ýagdaýyny we iň soňky haçan täzelenendigini görkezýär.

Awtorizasiýa-kod akymy

Birikme kanoniki üç-aýakly OAuth2 awtorizasiýa-kod granty bilen döredilýär:

Ulanyjy admin UI-den üpjün ediji üçin birikme başladýar — POST/GET /v1/admin/connections/oauth/start haýyşy.
AiHummer brauzeri üpjün edijiniň awtorizasiýa nokadyna talap edilen gerimler bilen gönükdirýär.
Ulanyjy razylyk ekranyny tassyklaýar; üpjün ediji bir gezeklik awtorizasiýa kody bilen /v1/admin/connections/oauth/callback-a yzyna gönükdirýär.
Callback işleýjisiniň içinde AiHummer şol kody üpjün edijiniň öz belgi nokadynda serwer tarapynda giriş belgisine (we üpjün ediji goldaýan bolsa, täzeleýiş belgisine) çalyşýar.
Belgi seýfe ýazylýar we Birikme işjeň diýlip bellenýär.

Kod-belgi çalşygy callback-yň içinde serwer tarapynda bolup geçýär, şonuň üçin müşderi syry we berlen belgi gateway-den hiç haçan çykmaýar.

[!NOTE] Muny POST /v1/oauth/token bilen bulaşdyrmaň: bu AiHummer-iň öz OAuth2 müşderi-kepilnama (client-credentials) endpointidir — /v1/admin/apikeys/register-client arkaly hasaba alnan hyzmat hasaplary öz client_id/client_secret-ini şol ýerde gysga ömürli ah- belgisine çalyşýarlar. Onuň üçünji tarap Birikmelerine hiç hili degişliligi ýok.

[!NOTE] Awtorizasiýa-kod akymy hemişe hakyky brauzer razylyk ädimini öz içine alýar. Birikmäni diňe API açaryndan kellesiz döredip bolmaýar — hereket edýän ulanyjy gerimleri bir gezek tassyklamalydyr.

Belgi nirede ýaşaýar

Berlen belgi açyk sazlamada däl-de, AiHummer-iň şifrlenen kepilnama seýfinde saklanýar. Seýf konwert şifrlemesini ulanýar (master açar astynda her kärendar maglumat açary bilen AES-256-GCM), syrlar hiç haçan model kontekstine, promptlara ýa-da loglara göçürilmeýär. Yzyna gaýtarylan ýa-da möhleti geçen Birikme yzynda hiç hili ulanyp boljak syr galdyrmaýar.

oauth/start ─▶ consent ─▶ code ─▶ oauth/callback (üpjün edijide çalşyk) ─▶ access/refresh token ─▶ vault (şifrlenen)

Hereket edýän ulanyjy boýunça çözülýär

Birikmäniň kesgitleýji häsiýeti, onuň hereket edýän ulanyjy boýunça çözülmegidir. Agent üpjün edijini talap edýän gurally işledende, işleýiş wagty nobatyň adyndan işleýän ulanyja degişli Birikmäni gözleýär we olaryň belgisini ulanýar. Şonuň üçin bir agent bilen gürleşýän iki işgär öz ygtyýarlyklary bilen hereket edýärler we diňe öz grantynyň rugsat berýänini görýärler.

Birikmeleri şahsy, her ulanyjy integrasiýalary üçin amatly edýän zat budur: her adamyň girişi izolirlenen, audit edip bolýan we aýratyn yzyna gaýtarylyp bilinýär.

Elýeterli integrasiýalar

OAuth2 akymy arkaly ulanyjy öz hasabyny iberilýän hyzmatlaryň islendigine birikdirip bilýär. Bu şahsy integrasiýalar gutudan çykan badyna elýeterli:

Topar	Hyzmatlar
Google	Gmail, Google Calendar, Google Contacts, Google Tasks, Google Drive, YouTube
Microsoft	Outlook Mail, Outlook Calendar, OneDrive, Microsoft To Do
Önümçilik	Todoist, Asana, Jira Cloud, ClickUp, GitLab, Linear, monday.com
Saglyk we durmuş ýörelgesi	Fitbit, Oura Ring, Strava, Spotify, Samsung SmartThings

Olaryň her biri şol bir awtorizasiýa-kod akymy bilen birikýär: ulanyjy üpjün edijiniň razylyk ekranyny dolduýar, belgi seýfde möhürlenýär we gural hyzmata ýeten her gezeginde şol ulanyjy üçin çözülýär.

Admin UI-de birikmeleri dolandyrmak

Admin UI-den operator şulary edip bilýär:

Her ulanyjynyň haýsy üpjün edijileri birikdirenligini we her belginiň saglygyny görmek.
Täze birikme başlatmak (saýlanan üpjün ediji üçin razylyk akymyny işe girizmek).
Birikmäni yzyna gaýtarmak, bu seýf girişini aýyrýar we çözmegi öçürýär.

Birikmeler ýa şahsy (belli bir ulanyja degişli, ol olary aýryp bilýär), ýa-da iş giňişligi bilen paýlaşylan (“Workspace shared” bellikli; olary şahsy aýryp bolmaýar). Bir üpjün ediji birnäçe hasaby saklap biler: “+ hasap” düwmesi bellik soraýar we şol bir üpjün edijiniň başga bir kepilnamasyny seýfleýär — mysal üçin, birnäçe Google kalendary ýa-da poçta gutusy.

Esasy kepilnamalar şahsy bolany üçin, hereket bütin iş giňişligi hasaby ýerine belli bir adamyň ygtyýarlygyna degişli we şolar bilen çäklendirilmeli bolanda Birikme köplenç dogry gural bolýar.

Indiki nirä

Şahsy garşy umumy kepilnamalar — doly gerim modeli we her birini haçan saýlamaly.
BYOK LLM üpjün edijiler — her kärendar üçin öz model açarlaryňyzy getiriň.
Marketplace syny we derejeleri — OAuth bilen goldanýan integrasiýalar nirä gelýär.