AiHummer
Türkmençe▾
GirmekŞahsy kabinet
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Howpsuzlyk/RBAC we çäklenen API açarlary

RBAC we çäklenen API açarlary

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

AiHummer administrasiýa ýüzüni bilen gorap durýar rol esasynda elýeterlilik gözegçiligi we çägelenen API açarlaryRolalar bir adamyň kime bolmagyna rugsat berilýändigini kesgitleýär; çäkli açarlar programma awtomatizasiýasynyň diňe hakykatdan hem gerek bolan hukuklaryny bermäge mümkinçilik berýär, hemme zady edip bilýän açar däl-de.

Rollar

Admin API we admin UI-a elýeterlilik rollar tarapyndan dolandyrylýar. Rol, bir şahsyň haýsy çeşme toparlaryna seredip biljekdigini we haýsylaryny üýtgedip biljekdigini kesgitleýär.

Rolary admin UI-larynda dolandyrýarlar “Wezipeler” sahypa. Gutudan çykanda bar gurlan wezipeler — owner (hemme zat), admin, operator we member — diňe okalmaly (“Gurlan” nyşany bilen bellendir; redaktirläp ýa-da pozup bolmaýar). Olaryň daşynda siz döredip bilersiňiz ýörite rollar: rol formasy at, düşündiriş we rugsat toruny alýar — okamak/ýazmak kataklary takmynan 19 serişdeler ulgamynyň hersi üçin (agentler, söhbetler, gurallar, syrlary, plaginler, sazlamalar, tassyklamalar, API açarlary we ş.m.; “ýazmak” awtomatiki ýagdaýda “okamak” manysyny berýär). Her rol haýsy mowzuklaryň ony ulanýandygyny görkezýär; birine bellenen rol, bellenmeler aýrylmazdan ýok edilip bilinmez.

Bu sahypadaky beýleki dolandyryşlar bilen rollary birleşdiriň — IP rugsat sanawy, korporatiw SSO we audit ýazgy — her bir administratiw hereketiň hem tassyklanan, hem-de ýazga alynan bolmagy üçin.

Çäklendirilen API açarlary

API açarlary bar gerimler bu iň möhüminiň näme edip biljekdigini çäklendirýär. Kesgitlenen gerimler şulardyr:

Gerim Grantlar
chat Ahyrky ulanyjy üçin OpenAI bilen gabat gelýän nokat (bar bolan açarlaryň köne standarty).
admin:read Administrator serişdelerine diňe okamak hukukly giriş (GET /v1/admin/*: sazlamalar, söhbetler, analizler we ş.m.).
admin:write Admin API çagyryşlaryny üýtgetmek (POST/PUT/DELETE /v1/admin/*).
mcp Çap edilen MCP ugry (POST /v1/mcp).
a2a Çap edilen Agent-den-Agent-e nokady (POST /a2a/message).
* Her zada doly girizmek (hakyky doly elýeterlilik gerimi).

Mundan başga-da, umumy <area>:* ýaprakly işleýär: admin:*, meselem, grantlar her bir administrasiýa herekəti emma edýär däk bermek chat, mcp ýa-da a2a — bu aýratyn kesgitlenen gerimi däl, diňe ýalňyşlyk belgisiniň bir ýagdaýy. Diňe * peredälere doly girmegi berýär.

Çäkler döreýändigi öňki açarlar çäklendirilmezden işlemäge dowam edýär; täze açarlar çäklendirilen çäk bilen döretmek bolýar, meselem, diňe ölçegleri okaýan dolandyryş paneli hiç haçan sazlamalary üýtgedip biljek açara eýe bolmaýar.

[!TIP] Iň az ygtyýarlylyk düzgünini ulanyň: gözegçilik ýa-da hasabat integrasiýasy almagy üçin admin:read açar, däl admin:write — aýtmasa-da boljak zat *. Ýazgy * açarlar üçin her ýüzüne hakykatdan-da el ýetirmek zerurlygy bolan.

Dogry meşin saýlamak

  • Söhbet müşderileri (OpenAI bilen gabat gelýän uç nokady çagyrmak) → chat.
  • Diňe okamak üçin integrasiýalar (dashboardlar, eksport edijiler, status barlamalar) → admin:read.
  • Resurslary döredýän ýa-da redaktirleýän awtomatlaşdyrma ( üpjünçilik agentleri, import etmek bilim, meýilnamalary dolandyrmak) → admin:write.
  • MCP we A2A müşderileri → mcp we a2a degişli tertipde.
  • Aýak üýtgetmek / doly giriş → *, mümkin boldugyça az düwmä bilen öňünde we yzygiderli öwrüldi.

[!WARNING] Çäklenen açar entek administrasiýa API-ä girmegiň şahadatnamasydyr. Ony şu ýerde saklaň syrlaryň howusy ýa-da öz gizlin dolandyryjynyň öňünde hiç haçan Çeşmä gözegçilik ediň we eger ol açyk bolup bilse, aýlaň.

Açarlar nähili dolandyrylýar

Admin API açarlary admin API arkaly dolandyrylýar (/v1/admin/apikeys) we administrasiýa ulanyjy interfeýsi, ýeri, siz açary çykarýan, onuň gerimini belleýärsiňiz we gerek bolmadyk wagtynda yzyna alýarsyňyz. Sebäbi administrasiýa API-niň özü hem gorag astynda bolýar OIDC we IP rugsat sanawy, açar döretmek tassyklanan we barlanan bir amaldyr.

Indi nire?