RBAC ва калидҳои API бо чуқурӣ — AiHummer Ҳуҷҷатнигорӣ

AiHummer рӯйпӯши маъмурии худро бо муҳофизат мекунад Назорати дастрасӣ асосёфта бар нақш ва калидҳои API бо доираи муайянНақшҳо муайян мекунанд, ки шахс ба чӣ имкон дорад; калидҳои доирадор ба шумо имкон медиҳанд, ки ба як қисми автоматизатсия танҳо ҳуқуқҳое диҳед, ки воқеан лозим аст, на калиде, ки ҳама чизро карда метавонад.

Нақшҳо

Дастрасӣ ба API-и идоракунӣ ва UI-и идоракунӣ тавассути нақшҳо идора карда мешавад. Нақш муайян мекунад, ки принсипал кадом гурӯҳҳои захираро мебинад ва кадомҳоро метавонад тағйир диҳад.

Рӯлҳо дар интерфейси идоракунии админ идора карда мешаванд Нақшҳо саҳифа. Аз қуттӣ берун ҳастанд вазифаҳои дохилшуда — owner (ҳама чиз), admin, operator ва member — ки танҳо барои хондананд (бо нишондиҳандаи «Дарунсохт» аломатгузорӣ шудаанд; онҳоро таҳрир ё нест кардан мумкин нест). Ғайр аз онҳо шумо метавонед эҷод кунед нақшҳои фармоишӣШакли нақш ном, тавсиф ва ҷадвали иҷозатҳоро мегирад — қуттиҳои санҷидан/навиштан барои ҳар яке аз ~19 соҳаи манбаъ (агентҳо, сӯҳбатҳо, асбобҳо, сиррҳо, плагинҳо, танзимот, тасдиқҳо, калидҳои API ва ғайра; “навиштан” ба таври худкор “хонаидан”-ро низ дар бар мегирад). Ҳар як нақш нишон медиҳад, ки чанд субъект онро истифода мебаранд; нақше, ки ба касе таъин шудааст, то вақте ки таъинҳо бардошта нашудаанд, нест карда намешавад.

Вазифаҳоро бо назорати дигар дар ин сайт муттаҳид кунед — Рӯйхати иҷозати IP, SSO-и корхона ва логҳои аудит — то ҳар як амали маъмурӣ ҳам иҷозатшуда ва ҳам сабтшуда бошад.

Мӯҳлатдоркунандаи калидҳои API

Рӯйхати калидҳои API доранд даъвоҳо ки маҳдуд мекунад, ки калид чӣ кор карда метавонад. Ҳудудҳои муайяншуда инҳоянд:

Ҳудуд	Грантҳо
`chat`	Пайванди охирин барои корбарони ниҳоӣ, ки бо OpenAI мутобиқ аст (танзими кӯҳна барои калидҳои мавҷуда).
`admin:read`	Дастрасии фақат барои хондан ба манбаъҳои админ (`GET /v1/admin/*`: танзимот, гуфтугӯҳо, таҳлилҳо ва ғайра)
`admin:write`	Зангҳои API-и маъмурӣ, ки тағйир меёбанд (`POST`/`PUT`/`DELETE /v1/admin/*`).
`mcp`	Нуқтаи ниҳоии нашршудаи MCP (`POST /v1/mcp`).
`a2a`	Нуқтаи анҷоми нашршудаи Агент-то-Агент (`POST /a2a/message`).
`*`	Дастрасӣ пурра ба ҳама чиз (ҳақиқатан доираи пурраи дастрасӣ)

Ғайр аз ин, як умумӣ <area>:* корҳои аломати васеъ: admin:*, масалан, грантҳо ҳар як амали маъмур аммо мекунад не грант chat, mcp ё a2a — ин доираи мустақилан таъинотшуда нест, танҳо ҳолати аст аз аломати умумӣ. Танҳо * Дастрасии пурра ба тамоми сатҳҳоро пешниҳод мекунад.

Калидҳое, ки пеш аз пайдо шудани доираҳо сохта шудаанд, бидуни маҳдудият кор мекунанд; калидҳои нав метавонанд бо доираи маҳдуд сохта шаванд, то, масалан, панели идоракунии танҳо барои хондани меъёру нишондиҳандаҳо калиде надошта бошад, ки метавонад танзимотро тағйир диҳад.

[!TIP] Арзиши камтарини иҷозатҳоро татбиқ кунед: як муттаҳидсозии мониторинг ё ҳисоботдиҳӣ бояд гирифтани admin:read калид, не admin:write — бигзор гӯем *. Захира * барои калидҳо ки воқеан ба дастрасӣ ба ҳар як сатҳ ниёз доранд.

Интихоби доираи дурусти кор

Мизоҷони чат (даъват кардани нуқтаи охири мувофиқи OpenAI) → chat.
Интегратсияҳои танҳо барои хондан (панелҳо, содиркунандагон, санҷишҳои ҳолат) → admin:read.
Автоматизатсия, ки захираҳоро эҷод мекунад ё таҳрир мекунад (агентҳои таъминкунанда, воридкунанда) иқтидори донишу идоракунии ҷадвалҳо) → admin:write.
Мизоҷони MCP ва A2A → mcp ва a2a мутапарра
Шикастани шиша / дастрасии комил → *, бо камтарин миқдори тугмаҳо нигоҳ дошта шудааст ва муддати мунтазам гардиш мекард.

[!WARNING] Калиди доираи муайяншуда ҳамоно як шаҳодатнома барои API-и админ аст. Онро дар дохили ҳуҷраи сиррӣ ё мудири махфии худатон, ҳеҷ гоҳ назорати манбаъ ва агар он фош шуда бошад, онро гардонед.

Чӣ тавр идора кардани калидҳо

Калидҳои API-и админ тавассути API-и админ идора карда мешаванд (/v1/admin/apikeys) ва интерфейси идоракунӣ, ҷое ки шумо калид месозед, доирашро таъин мекунед ва вақте ки дигар лозим нест, онро бекор мекунед. Зеро худи API-и идоракунӣ бо OIDC ва рӯйхати иҷозати IPҶойгиркунии калид як амали тасдиқшуда ва санҷидашуда мебошад.

Баъд ба куҷо

SSO-и корхона — одамонро тасдиқ кунед пас аз нақшҳо тавассути SAML, LDAP, SCIM ё OIDC.
Шабака, аудит ва ҷудошуда аз ҳаво — Ҷойеро маҳдуд кунед, ки API-и маъмур метавонад аз он ҷо дастрас бошад ва роҳи назоратиро нигоҳ доред.
Анбори сиррҳо — куҷо бояд калидҳое, ки месозӣ, нигоҳ дорӣ.