Şahsy garşy umumy belgiler — AiHummer Resminamalar

AiHummer-iň saklaýan her belgisiniň — API açary, belgi, webhook syry — gural çagyryşynyň kimiň syry bilen işleýändigini kesgitleýän gerimi bardyr. Iki gerim bar: umumy we şahsy. Tapawudy we olaryň arasyndaky çözmek tertibini düşünmek, her agente we her ulanyja takyk degişli bolan girişi we artyk zat bermezligi açarydyr.

Iki gerim

Gerim	Degişli	Haçan ulanylýar
Umumy	Iş giňişligi	Hereket kimiň işe girizenligine garamazdan bir umumy hasap astynda işlemeli bolanda
Şahsy	Aýratyn ulanyjy	Hereket belli bir adamyň öz ygtyýarlygyna degişli we şol bilen çäklendirilmeli bolanda

Iki görnüş hem bir şifrlenen seýfde ýaşaýar (konwert şifrlemesi, AES-256-GCM, master açar astynda her kärendar açary); tapawudy diňe syryň kime çözülýändigi, onuň nähili saklanýandygy ýa-da goralýandygy däl.

Iş giňişligi ätiýaçlygy bilen hereket edýän ulanyjy boýunça çözmek

Nobat wagtynda gural belgi talap edende, AiHummer ony hereket edýän ulanyjy boýunça çözýär — nobatyň adyndan işleýän adam — we ulanyjynyň şahsysy ýok bolanda iş giňişligi (umumy) belgisine gaýdyp gelýär:

need credential ─▶ personal credential for the acting user?
                     ├─ yes ─▶ use the personal credential
                     └─ no  ─▶ fall back to the shared (workspace) credential

Bu ýeke düzgün size çeýe özüni alyp barşy berýär: diňe umumy belgi beriň we herkes ony ulanýar; aýratyn adamlara öz belgisini goşmaga rugsat beriň, olar şol adam üçin awtomatiki ileri tutulýar, galanlary bolsa umumysyny ulanmagyny dowam edýär.

[!NOTE] Şol bir ulanyjy üçin şahsy hemişe umumydan üstün çykýar. Iş giňişligi belgisi ätiýaçlykdyr, basyp geçme däldir — öz hasabyny birikdiren ulanyjy öz ygtyýarlygy bilen hereket edýär.

Umumyny haçan ulanmaly

Şu ýagdaýlarda umumy belgini saýlaň:

Hereket aýratyn adamy däl-de, guramany görkezýär (kompaniýa poçta gutusy, ýeke-täk CRM hyzmat hasaby, hasaplaşyk açary).
Agenti kim işe giriziwgine garamazdan yzygiderli özüni alyp barşy isleýärsiňiz.
Bir syry merkezleşdirilen görnüşde çykarmak we aýlamak her ulanyjy gurnamasyndan has aňsat.

Şahsyny haçan ulanmaly

Şu ýagdaýlarda şahsy belgini saýlaň:

Hereket belli bir adama degişli we şol adamyň etmäge rugsat berleni bilen çäklendirilmeli.
Dürli ulanyjylar şol bir agent we gural arkaly dürli maglumatlary görmeli.
Beýlekilerden garaşsyz, her ulanyjy yzyna gaýtaryşy we audity zerur.

Şahsy belgiler adatça işgäriň Birikmeler arkaly özüni birikdirýän aýratyn hasaplarydyr. Gutudan çykan badyna bularyň mysallary: Gmail, Google Calendar, Google Drive, Google Tasks, YouTube, Outlook Mail, Outlook Calendar, OneDrive, Microsoft To Do, Todoist, Asana, Jira Cloud, ClickUp, GitLab, Fitbit, Oura Ring, Spotify we Samsung SmartThings — her ulanyjy öz ygtyýarlygy astynda hereket edýär. Umumy belgi, tersine, herkesiň ulanýan bir iş giňişligi giňişlikdäki hasabydyr (mysal üçin kompaniýa poçta gutusy ýa-da CRM hyzmat hasaby).

Birikmeler we seýf bilen nähili täsirleşýär

Birikmeler — bu şahsy belginiň döremeginiň iň ýaýran usulydyr: ulanyjy OAuth2 awtorizasiýa-kod akymyny dolduýar, berlen belgi seýfde möhürlenýär, şondan soň ol şol ulanyjy üçin çözüjiniň saýlaýan takyk şahsy belgisidir. Umumy belgi, tersine, adatça operatoryň iş giňişligi derejesinde bir gezek saklaýan syrydyr.

Ähli ýagdaýlarda syr şifrlenen seýfde galýar we hiç haçan model kontekstine, prompta ýa-da loglara girmeýär — gerim diňe hereket edýän ulanyjynyň haýsy seýf girişine çözülýändigini dolandyrýar.

Indiki nirä

Birikmeler (her ulanyjy OAuth2) — şahsy belgiler nähili ygtyýarlandyrylýar.
BYOK we LLM üpjün edijiler — her kärendar üçin model açarlary.
Marketplace syny we derejeleri — 2-nji derejeli ukyplar şahsy belgileri ulanyp bilýär.