AiHummer
Türkmençe▾
Gir
v1.0.x▾
v1.0.xstable
{ }Swagger
Howpsuzlyk/RBAC & çäklendirilen API açarlary

RBAC & çäklendirilen API açarlary

v1.0.x · täzelendi 2026-07-07

AiHummer öz admin meýdanyny rol esasly elýeterlilik gözegçiligi we çäklendirilen API açarlary bilen goraýar. Roller adamyň kim bolmagyna rugsat berilýändigini çözýär; çäklendirilen açarlar bolsa ähli zady edip bilýän açaryň ýerine, awtomatizasiýanyň bir bölegine diňe hakykatdan-da gerek artykmaçlyklary bermäge mümkinçilik berýär.

Roller

Admin API-ä we admin UI-ä elýeterlilik roller bilen dolandyrylýar. Rol prinsipalyň haýsy çeşme toparlaryny görüp biljekdigini we haýsylaryny üýtgedip biljekdigini kesgitleýär.

Roller admin UI-niň «Roller» sahypasynda dolandyrylýar. Gutudan çykan badyna içki roller bar — owner (ähli zat), admin, operator we member — olar diňe okamak üçin (build-in belligi bilen bellikli; olary redaktirläp ýa-da pozup bolmaýar). Olardan başga siz hususy roller döredip bilersiňiz: rol formasy ady, beýany we rugsat gözenegini alýar — ~19 çeşme domeniniň (agentler, gepleşikler, gurallar, syrlar, pluginler, sazlamalar, tassyklamalar, API açarlary we ş.m.) her biri üçin okamak/ýazmak bellikleri; “ýazmak” awtomatiki “okamak”y aňladýar. Her rol näçe subýektiň ony ulanýandygyny görkezýär; kimdir birine bellenen rol, bellenmeler aýrylýança pozulyp bilinmez.

Rolleri bu saýtdaky beýleki gözegçilikler — IP rugsat sanawy, kärhana SSO we audit žurnaly — bilen birleşdiriň, şeýdip her admin hereketi hem ygtyýar berlen hem-de ýazga alnan bolar.

Çäklendirilen API açarlary

API açarlary açaryň näme edip biljekdigini çäklendirýän çäkleri göterýär. Kesgitlenen çäkler şular:

Çäk Berýär
chat Ahyrky ulanyjynyň OpenAI-gabat gelýän endpointi (bar bolan açarlar üçin köne deslapky çäk).
admin:read Admin çeşmelerine diňe okamak elýeterliligi (GET /v1/admin/*: sazlamalar, gepleşikler, analitika we ş.m.).
admin:write Admin API-ni üýtgedýän çagyryşlar (POST/PUT/DELETE /v1/admin/*).
mcp Çap edilen MCP endpointi (POST /v1/mcp).
a2a Çap edilen Agent-to-Agent endpointi (POST /a2a/message).
* Ähli zada doly elýeterlilik (hakyky doly-elýeterlilik çägi).

Muňa goşmaça, umumy <meýdan>:* wildcard-y hem işleýär: mysal üçin, admin:* ähli admin hereketlerini berýär, ýöne chat, mcp ýa-da a2a-ny bermeýär — ol aýratyn kesgitlenen çäk däl-de, diňe wildcard-yň bir ýagdaýy. Diňe * ähli meýdanlara doly elýeterlilik berýär.

Çäkler 0073 migrasiýasy bilen girizildi. Bar bolan açarlar işlemegini dowam edýär; täze açarlar dar çäk bilen döredilip bilner, şeýdip, mysal üçin, diňe metrikalary okaýan dolandyryş paneli hiç haçan sazlamalary üýtgedip biljek açary saklamaýar.

[!TIP] Iň az artykmaçlygy ulanyň: monitoring ýa-da hasabat integrasiýasy admin:write-den, *-den hem beter, admin:read açaryny almaly. *-i hakykatdan-da her meýdana elýeterlilik gerek bolan açarlar üçin saklaň.

Dogry çägi saýlamak

  • Chat müşderileri (OpenAI-gabat gelýän endpointi çagyrýan) → chat.
  • Diňe okaýan integrasiýalar (dolandyryş panelleri, eksportçylar, status barlaglary) → admin:read.
  • Çeşmeleri döredýän ýa-da redaktirleýän awtomatizasiýa (üpjün etme agentleri, bilim import etmek, tertipleri dolandyrmak) → admin:write.
  • MCP we A2A müşderileri → degişlilikde mcp we a2a.
  • Aýna döwmek / doly elýeterlilik → *, mümkin boldugyça az açar bilen saklanýan we yzygiderli çalşylýan.

[!WARNING] Çäklendirilen açar hem admin API üçin kepilnamadyr. Ony syrlar gaznasynda ýa-da öz syr menejeriňizde saklaň, hiç haçan çeşme dolandyryşda däl, we ol äşgär bolan bolup biler diýseňiz ony çalşyň.

Açarlar nähili dolandyrylýar

Admin API açarlary admin API (/v1/admin/apikeys) we admin UI arkaly dolandyrylýar, ol ýerde açar döredýärsiňiz, onuň çägini belleýärsiňiz we ol indi gerek bolmasa ony ýatyrýarsyňyz. Admin API-niň özi OIDC we IP rugsat sanawy bilen goralýandygy sebäpli, açar döretmek autentifikasiýa edilen, auditlanan amaldyr.

Indiki nirä