Шаҳсӣ бар муқобили шарикии иҷозатномаҳо

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] > Шахсӣ ҳамеша аз умумӣ барои ҳамон корбар пеш мегирад. Шаҳодатномаи фазои корӣ мебошад > ҳамагӣ як *пойгоҳ*, на як ивазкунӣ — корбарие, ки ҳисобномаи худро пайваст кардааст, амал мекунад > бо иҷозати худ. ## Кай бояд shared истифода шавад Якеро интихоб кунед **муштарак** шаҳодатнома вақте: - Ин амал ташкилотро намояндагӣ мекунад, на як шахс (қуттии почтаи ширкат, як ҳисоби хидматрасонии CRM, калиди пардохт). - Шумо мехоҳед рафтори доимӣ дошта бошед новобаста аз он ки кӣ агентиро оғоз кардааст. - Шарти додан ва гардондани як рамз ба таври марказӣ соддатар аст аз насб кардан барои ҳар як корбар. ## Кай бояд шахсӣ истифода шавад Якеро интихоб кунед **шаҳсӣ** шаҳодатнома вақте: - Ин амал бояд ба инсон муайян мансуб бошад ва бо он чизе, ки ӯ ба инсон иҷозат дода мешавад, ки кунад - Истифодабарандагони гуногун бояд тавассути ҳамон агент ва абзор маълумоти гуногунро бубинанд. - Шумо ба бекорсозӣ ва аудит барои ҳар як корбар, мустақил аз дигарон, ниёз доред. Шиносномаҳои шахсӣ одатан ҳисобҳои инфиродӣ мебошанд, ки корманд тавассути онҳо худро пайваст мекунад. [Пайвастҳо](/tg/v1.0/access/connections-oauth2)Дар бастаи стандартӣ инҳо, ба монанди Gmail, Google Calendar, Google Contacts, Google Drive, Google Tasks, YouTube, Outlook Mail, Outlook Calendar, OneDrive, Microsoft To Do, Todoist, Asana, Jira Cloud, ClickUp, GitLab, Linear, monday.com, Fitbit, Oura Ring, Strava, Spotify ва Samsung SmartThings дохил мешаванд — ҳар як корбар таҳти иҷозатномаи худ амал мекунад. Ҳисобномаи муштарак, баръакс, як ҳисоби умумиҷоиза дар як муҳити корӣ мебошад (масалан, почтаи кории ширкат ё ҳисоби хидмати CRM), ки ҳама истифода мебаранд. ## Дар амал татбиқ кардани он Бо забони сода: - **Як шаҳодатнома барои ҳама (шарикшудагӣ).** Як оператор сирро як бор дар сатҳи ҷойи кор — дар [Сирҳо](/tg/v1.0/webui/marketplace#secrets-vault) экран ё ҳамчун пайвандии муштарак. Сипас ҳамаи агентҳо ва корбарон зери як ҳисоб амал мекунанд (масалан, як қуттии почтаи ширкат) - **Як шаҳодатнома барои ҳар як шахс (шахсӣ)** Истиқболкунанда ҳисоби худро тавассути пайваст мекунад [Пайвастҳо](/tg/v1.0/access/connections-oauth2) (қатъ мекунад ба вуруд бо OAuth) — ва аз он дам ба баъд зангҳои худи онҳо тибқи иҷозати онҳо сурат мегиранд, дар ҳоле ки ҳама иқтидори муштаракро дигар кас нигоҳ медорад. - **Кӣ метавонад ба агент нависад** дар ин ҷо нест, балки дар [Каналҳо](/tg/v1.0/webui/channels#access-control-reply-only-to-known-users) экрани: гузариш ба "Танҳо ба корбарони шинос ҷавоб диҳед". - **Шахсияти инфиродӣ/рафтор барои шахси муайян** омехтани пайвандҳои шахсӣ (ин саҳифа) бо танзимоти агент; қоидаҳои умумиширавӣро дохил кунед [блокҳои муштарак](/tg/v1.0/webui/skills-prompts). Ҳеҷ чизе иловагӣ барои 'фаъол кардан': қоидаи қарордиҳӣ (шахсӣ → дигарон мубодилашуда) ба таври худкор кор мекунад. ## Чӣ тавр бо Connections ва анбор ҳамкорӣ мекунад [Пайвастҳо](/tg/v1.0/access/connections-oauth2) ин маъмултарин роҳ барои як **шаҳсӣ** Шиноснома ба вуҷуд меояд: корбар равияи иҷозатдиҳии рамзи OAuth2-ро анҷом медиҳад, токени додашуда дар анбор нигоҳ дошта мешавад ва аз он лаҳза ба баъд он дақиқ шиносномаи шахсии аст, ки ҳалкунандаи масъала барои он корбар интихоб мекунад. Шиносномаи муштарак, баръакс, одатан як сирр аст, ки оператор як бор дар сатҳи кори ҷои кор нигоҳ медорад. Дар ҳама ҳолатҳо сир дар анбори рамзгузорӣ нигоҳ дошта мешавад ва ҳеҷ гоҳ ба контексти модел, фармон ё қайдҳо ворид намегардад — масоҳат танҳо назорат мекунад, ки истифодабари амалкунанда кадом воридшавии анборро ҳал мекунад. ## Баъд ба куҷо - [Пайвастҳо (OAuth2 барои ҳар як корбар)](/tg/v1.0/access/connections-oauth2) — чӣ тавр Шахсиятҳо иҷозат дода шудаанд. - [Провайдерҳои BYOK ва LLM](/tg/v1.0/access/byok-providers) — калидҳои модел барои ҳар иҷоранишин. - [Назари умумӣ ба бозор ва сатҳҳо](/tg/v1.0/marketplace/overview-tiers) — Синф-2 малакаҳо метавонанд аз шаҳодатномаҳои шахсӣ истифода кунанд.