RBAC ва калидҳои API-и доирабандишуда

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

Нақшҳо

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

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

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

Калидҳои API-и доирабандишудаи админ

Калидҳои API-и админ доираҳоеро доранд, ки маҳдуд мекунанд, ки калид чӣ карда метавонад. Се доира мавҷуд аст:

Доира	Медиҳад
`admin:read`	Дастрасии танҳохонданӣ ба захираҳои админ (намоиши танзимот, сӯҳбатҳо, аналитика ва ғ.).
`admin:write`	Дастрасии хондан ва навиштан ба захираҳои админ.
`admin:*`	Дастрасии пурраи админ (баробар ба ҳама доираҳои админ).

Доираҳо тавассути миграцияи 0073 ҷорӣ карда шуданд. Калидҳои мавҷуда кор карданро идома медиҳанд; калидҳои нав метавонанд бо як доираи танг сикка зада шаванд, то масалан, як дашборде, ки танҳо метрикаҳоро мехонад, ҳаргиз калидеро надошта бошад, ки танзимотро тағйир диҳад.

[!TIP] Камтарин имтиёзро татбиқ кунед: як интегратсияи назоратӣ ё ҳисоботӣ бояд як калиди admin:read гирад, на admin:write ё admin:*. admin:*-ро барои калидҳое нигоҳ доред, ки воқеан бояд ҳар гурӯҳи захираро тағйир диҳанд.

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

Интегратсияҳои танҳохонданӣ (дашбордҳо, содиркунандагон, санҷишҳои вазъият) → admin:read.
Автоматизатсияе, ки захираҳоро эҷод ё таҳрир мекунад (агентҳои таъмин, воридкунии дониш, идораи ҷадвалҳо) → admin:write.
Идораи пурра / шиша-шикан → admin:*, ки бо имкони камтарин калид нигоҳ дошта ва мунтазам ивазкарда мешавад.

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

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

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

Минбаъд ба куҷо

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