Эътимоднмаҳои шахсӣ дар муқобили муштарак

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

Ҳар эътимоднмае, ки AiHummer нигоҳ медорад — як калиди API, як токен, як сири webhook — як **доира** дорад, ки тасмим мегирад, сири *кӣ* як даъвати асбоб бо он иҷро мешавад. Ду доира мавҷуданд: **муштарак** ва **шахсӣ**. Фаҳмидани фарқият ва тартиби ҳалкунӣ байни онҳо калиди додани дастрасии маҳз ба ҳар агент ва ҳар корбар аст, ки бояд дошта бошанд ва на бештар. ## Ду доира | Доира | Ба кӣ тааллуқ дорад | Кай истифода мешавад | |---|---|---| | **Муштарак** | Фазои корӣ | Вақте ки амал бояд дар зери як ҳисоби умумӣ новобаста аз он ки киро ба кор андохт, иҷро шавад | | **Шахсӣ** | Корбари алоҳида | Вақте ки амал бояд ба иҷозати шахсии худи як шахс нисбат дода ва бо он маҳдуд карда шавад | Ҳар ду навъ дар ҳамон анбори рамзгузошта зиндагӣ мекунанд (рамзгузории лифофа, AES-256-GCM, калиди ҳар иҷоранишин дар зери калиди мастер); фарқият танҳо дар он аст, ки сир ба *кӣ* ҳал мешавад, на дар он ки чӣ гуна нигоҳ дошта ё муҳофизат карда мешавад. ## Ҳалкунӣ аз рӯи корбари амалкунанда, бо бозгашт ба фазои корӣ Ҳангоми навбат, вақте ки асбоб ба эътимоднма ниёз дорад, AiHummer онро **аз рӯи корбари амалкунанда** ҳал мекунад — шахсе, ки аз номи ӯ навбат иҷро мешавад — ва ба эътимоднмаи **фазои корӣ** (муштарак) бармегардад, вақте ки корбар эътимоднмаи шахсӣ надорад: ```text need credential ─▶ personal credential for the acting user? ├─ yes ─▶ use the personal credential └─ no ─▶ fall back to the shared (workspace) credential ``` Ин қоидаи ягона ба шумо рафтори чандиршаванда медиҳад: танҳо як эътимоднмаи муштарак таъмин кунед ва ҳама онро истифода мебаранд; ба ашхоси алоҳида иҷозат диҳед, ки эътимоднмаи худро илова кунанд ва онҳо ба таври худкор барои он шахс авлавият мегиранд, дар ҳоле ки ҳамаи дигарон муштаракро истифода бурда мемонанд. > [!NOTE] > Шахсӣ ҳамеша болои муштарак барои ҳамон корбар ғолиб меояд. Эътимоднмаи фазои корӣ як > *бозгашт* аст, на боло гузаронидан — корбаре, ки ҳисоби худро васл кардааст, бо > иҷозати худаш амал мекунад. ## Кай муштаракро истифода бояд кард Эътимоднмаи **муштарак**-ро вақте интихоб кунед, ки: - Амал ташкилотро ифода мекунад, на як шахсро (қуттии почтаи ширкат, як ҳисоби хидматии CRM-и ягона, як калиди ҳисоббаробаркунӣ). - Шумо рафтори мувофиқ мехоҳед, новобаста аз он ки киро агентро ба кор андохт. - Додан ва навсозии як сир ба таври марказӣ соддатар аз танзими барои ҳар корбар аст. ## Кай шахсиро истифода бояд кард Эътимоднмаи **шахсӣ**-ро вақте интихоб кунед, ки: - Амал бояд ба як инсони мушаххас нисбат дода шавад ва бо он чизе ки он инсон иҷозат дорад, маҳдуд гардад. - Корбарони гуногун бояд маълумоти гуногунро тавассути ҳамон агент ва асбоб бубинанд. - Шумо ба бекоркунӣ ва аудити барои ҳар корбар, мустақил аз ҳамаи дигарон ниёз доред. Эътимоднмаҳои шахсӣ одатан ҳисобҳои инфиродӣ ҳастанд, ки корманд худаш онҳоро тавассути [Пайвастагиҳо](/en/v1.0/access/connections-oauth2) васл мекунад. Бо танзимоти пешфарз инҳо, масалан, 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 ва Samsung SmartThings-ро дар бар мегиранд — ҳар корбар бо иҷозати худаш амал мекунад. Эътимоднмаи муштарак, баръакс, як ҳисоби дар тамоми фазои корӣ (масалан як қуттии почтаи ширкат ё як ҳисоби хидматии CRM) аст, ки ҳама онро истифода мебаранд. ## Чӣ гуна он бо Пайвастагиҳо ва анбор муошират мекунад [Пайвастагиҳо](/en/v1.0/access/connections-oauth2) усули маъмултарини ба вуҷуд омадани як эътимоднмаи **шахсӣ** ҳастанд: корбар ҷараёни OAuth2 authorization-code-ро анҷом медиҳад, токени додашуда дар анбор мӯҳршуда мешавад, ва аз он вақт он маҳз ҳамон эътимоднмаи шахсӣ аст, ки ҳалкунанда барои он корбар интихоб мекунад. Эътимоднмаи муштарак, баръакс, одатан сирест, ки оператор як бор дар сатҳи фазои корӣ нигоҳ медорад. Дар ҳама ҳолатҳо сир дар анбори рамзгузошта мемонад ва ҳаргиз ба контексти модел, промпт ё логҳо ворид намешавад — доира танҳо назорат мекунад, ки *кадом* сабти анборро корбари амалкунанда ҳал мекунад. ## Минбаъд ба куҷо - [Пайвастагиҳо (OAuth2 барои ҳар корбар)](/en/v1.0/access/connections-oauth2) — чӣ гуна эътимоднмаҳои шахсӣ иҷозат дода мешаванд. - [BYOK ва провайдерҳои LLM](/en/v1.0/access/byok-providers) — калидҳои модел барои ҳар иҷоранишин. - [Шарҳи бозор ва сатҳҳо](/en/v1.0/marketplace/overview-tiers) — маҳоратҳои Tier-2 метавонанд эътимоднмаҳои шахсиро истифода баранд.