Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

ACL ir mažiausių privilegijų principas

Paskaita 8 iš 12 Atnaujinta 2026 m. liepos 28 d. Pažengusiems
Šiame puslapyje
  1. Mažiausių privilegijų principas, taikomas API
  2. xAI ACL sistema
  3. Užklausų ribos: papildomas saugumo sluoksnis
  4. Rakto strategija kiekvienai aplinkai
  5. Patikrink ir audituok leidimus
  6. Svarbiausi punktai

Mažiausių privilegijų principas, taikomas API

Mažiausių privilegijų principas yra viena seniausių kibernetinio saugumo koncepcijų: kiekvienas sistemos komponentas turėtų turėti prieigą tik prie tų išteklių, kurie yra griežtai būtini jo veikimui. Ši idėja intuityvi, jei ją perkeli į fizinį pasaulį – juk neduodi pastato universalaus rakto žmogui, kuris laisto gėlius vestibiulyje. Taikant tai xAI API raktams, tai reiškia, kad kiekvienas raktas turi būti apribotas tik tomis galinėmis punktais (endpoint) ir modeliais, kurių programai, naudojančiai šį raktą, iš tikrųjų reikia. Jei šis raktas kada nors nutekėtų, puolėjas paveldėtų jo teises: raktas, apribotas pokalbiu su vienu modeliu, padarys be galo mažiau žalos nei raktas, atveriantis visą katalogą.

xAI įgyvendina šį principą naudodama granuliarią ACL (prieigos valdymo sąrašo) sistemą, kurią detaliai aptarsime toliau.

xAI ACL sistema

ACL laikosi formato api-key:{type}:{value}. Du tipai tau rūpi kasdienėje veikloje: api-key:endpoint:{endpoint} apriboja pasiekiamus galinius punktus, o api-key:model:{model_id} apriboja naudojamus modelius. Taip pat yra pakartojimo simbolis (wildcard) api-key:endpoint:*, kuris suteikia prieigą visiems galiniams punktams – tai patogu kūrimo metu, bet draudžiama gamybinėje aplinkoje, būtent todėl, kad tai panaikina mažiausių privilegijų naudą.

Galimi individualiai autorizuoti galiniai punktai yra šie: chat (pokalbio užbaigimas, pats dažniausias), embed (įterpinių generavimas), image (vaizdų generavimas ir redagavimas), models (modelių sąrašo peržiūra), tokenize (teksto tokenizavimas), documents (dokumentų valdymas) ir sample (atranka).

Pažiūrėkime, kaip tai atrodo realiame pavyzdyje. Įsivaizduok klientų aptarnavimo pokalbių robotą, kuris naudoja tik grok-4.3 modelį pokalbio režimu. Jo idealus raktas atrodytų taip:

{
  "name": "support-chatbot-prod",
  "acls": [
    "api-key:endpoint:chat",
    "api-key:model:grok-4.3"
  ],
  "qps": 5,
  "qpm": 100,
  "tpm": 500000,
  "expireTime": "2026-12-31T23:59:59Z"
}

Šią konfigūraciją skaityk kaip sutartį: raktas gali pasiekti tik pokalbio galinį punktą – jokių vaizdų, jokių įterpinių, todėl nėra galimybės jais piktnaudžiauti. Jis gali naudoti tik grok-4.3, kas neleidžia atsitiktinai (arba tyčia) kviesti brangesnių modelių. Jis apribotas 5 užklausomis per sekundę ir 100 per minutę, o jo galiojimas baigsis žinomą datą. Jei kuris nors projekte dirbantis kūrėjas bandytų pridėti vaizdų generavimą niekam nepranešęs, API tai atmestų: techninis apribojimas užtikrina architektūrinio sprendimo laikymąsi.

Užklausų ribos: papildomas saugumo sluoksnis

ACL atsako į klausimą „ką“, o užklausų ribos – į „kiek“. QPS (užklausos per sekundę) riboja užklausų skaičių per sekundę: tai tavo apsauga nuo atsitiktinių šuolių – begalinės kilpos, atsiradusios dėl pertvarkos penktadienio vakarą, arba DDoS atakos, atsispindinčios nuo tavo programos. QPM (užklausos per minutę) išlygina srautą ilgesniu laikotarpiu ir pagauna piktnaudžiavimą, kuris liktų nepastebėtas QPS lygmenyje. TPM (tokenai per minutę) savo ruožtu riboja suvartojamų tokenų apimtį: tai apsaugo nuo labai ilgų individualių užklausų – pavyzdžiui, kai vartotojas įklijuoja 200 puslapių dokumentą į tavo pokalbių robotą – kurios išsektų tavo biudžetą per kelias minutes, niekada neviršijusios leidžiamo užklausų skaičiaus.

Rakto strategija kiekvienai aplinkai

Praktiškai tu konfigūruoji ne vieną raktą, o raktų šeimą, ir kiekviena aplinka turi savo logiką. Kūrimo metu apversi gamybinę logiką: plati prieiga, griežtos ribos.

{
  "name": "dev-team-alpha",
  "acls": ["api-key:endpoint:*", "api-key:model:*"],
  "qps": 2,
  "qpm": 30,
  "tpm": 100000,
  "expireTime": "2026-06-30T23:59:59Z"
}

Kūrėjai gali tyrinėti viską, tačiau mažos ribos išvengia netikėtumų sąskaitose, jei testas nepavyktų. Tuo tarpu tarpinėje (staging) aplinkoje, priešingai, tiksliai atkartoji gamybines ACL taisykles (api-key:endpoint:chat, api-key:model:grok-4.3, QPS 5, QPM 100, TPM 500000): tai vienintelis būdas anksti aptikti leidimų problemas – jei tarpinės aplinkos kodas bando atlikti kvietimą, kurį gamyba atmestų, geriau tai sužinoti dabar, nei pirmąją veiklos valandą. Gamybinis raktas, tačiau, derina griežtus tarpinės aplinkos leidimus su ribomis, pritaikytam realiam srautui (pavyzdžiui, QPS 20, QPM 600, TPM 2000000) ir suplanuotu galiojimo laiku – "expireTime": "2027-03-31T23:59:59Z" rakto, pavadinto prod-chatbot-v2, atveju.

Patikrink ir audituok leidimus

Norėdamas pamatyti, ką iš tikrųjų leidžiama daryti aktyviam raktui, užklausk API naudodamas patį tą raktą:

curl https://api.x.ai/v1/api-key \
  -H "Authorization: Bearer $XAI_API_KEY"

Atsakyme išvardijami galiojantys ACL, būsenos api_key_blocked ir api_key_disabled, užmaskuota rakto versija (redacted_api_key) ir team_id. Įprask reguliariai lyginti šiuos ACL su realiais programos poreikiais: leidimai linkę kauptis laikui bėgant ir niekada nesumažėja savaime. Modelių方面, galinis punktas GET /auth/teams/{teamId}/models grąžina tavo komandai доступных modelių sąrašą su jų kainomis – tai vertinga informacija apibrėžiant tinkamus modelio ACL ir atmetant brangius modelius, kurių nenaudoji.

Norėdamas visa tai įtvirtinti, atlik pilną savo raktų auditą. Išvardink aktyvius raktus kiekvienai komandai, tada užklausk kiekvieną iš jų: ar jų ACL yra minimalūs, be pakartojimo simbolių gamyboje? Ar jų užklausų ribos protingos? Ar nustatyta jų galiojimo pabaigos data? Ar jų pavadinimas identifikuoja programą ir aplinką – „prod-chatbot-v2“ pasakoja istoriją, o „key-test-2“ nepasakoja jokios? Ištrink našlaičius raktus ir uždokumentuok rezultatą: šis dokumentas taps atspirties tašku kitam auditui, ir iškart matysi, kas pasikeitė tarpiniu laikotarpiu.

Svarbiausi punktai

  • Kiekvienas raktas turi turėti ribotus ACL: tik būtinus galinius punktus ir modelius
  • Niekada nenaudok * pakartojimo simbolio gamybinėje aplinkoje
  • Derink ACL su užklausų ribomis (QPS, QPM, TPM), pritaikytomis realiam naudojimui
  • Sukurk atskirus raktus kiekvienai aplinkai (dev, staging, prod) ir kiekvienai programai – tarpinė aplinka turi turėti tokias pačias ACL kaip ir gamyba
  • Reguliariai audituok savo aktyvių raktų leidimus naudodamas GET /v1/api-key