Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

ACL un mazākās privilēģijas princips

Nodarbība 8 no 12 Atjaunota 2026. gada 28. jūlijs Augstākais
Šajā lapā
  1. Mazākās privilēģijas princips, ko piemēro API
  2. xAI ACL sistēma
  3. Ātruma ierobežojumi: papildu drošības slānis
  4. Atslēgu stratēģija katrai videi
  5. Pārbaudi un auditē atļaujas
  6. Galvenās atziņas

Mazākās privilēģijas princips, ko piemēro API

Mazākās privilēģijas princips ir viens no senākajiem kiberdrošības konceptiem: katram sistēmas komponentam ir jābūt piekļuvei tikai tiem resursiem, kas ir stingri nepieciešami tā darbībai. Ideja ir intuitīva, ja to pārnes uz fizisko pasauli — tu nedod ēkas galveno atslēgu personai, kas laista augus vestibilā. Attiecinot to uz xAI API atslēgām, tas nozīmē, ka katrai atslēgai ir jābūt ierobežotai tikai ar tiem galapunktiem un modeļiem, kas faktiski ir nepieciešami to izmantojošajai lietotnei. Ja šī atslēga jebkad tiek nopludināta, uzbrucējs manto tās tiesības: atslēga, kas ir ierobežota tikai ar sarunu ar vienu modeli, rada bezgalīgi mazāku kaitējumu nekā atslēga, kas atver visu katalogu.

xAI ievieš šo principu, izmantojot granulu ACL (piekļuves kontroles saraksta) sistēmu, ko mēs sīkāk aplūkosim tālāk.

xAI ACL sistēma

ACL formāts ir api-key:{type}:{value}. Divi veidi, kas tevi ikdienā skar, ir: api-key:endpoint:{endpoint}, kas ierobežo pieejamos galapunktus, un api-key:model:{model_id}, kas ierobežo izmantojamos modeļus. Pastāv arī aizstājējzīme api-key:endpoint:*, kas piešķir piekļuvi visiem galapunktiem — ērta izstrādei, bet ražošanā aizliegta, tieši tāpēc, ka tā anulē mazākās privilēģijas priekšrocības.

Galapunkti, kurus vari autorizēt individuāli, ir: chat (sarunas pabeigšana, visbiežāk izmantotais), embed (iegulšanas ģenerēšana), image (attēlu ģenerēšana un rediģēšana), models (modeļu saraksta apskate), tokenize (teksta tokenizēšana), documents (dokumentu pārvaldība) un sample (paraugu ņemšana).

Aplūkosim, kā tas izskatās reālā piemērā. Iedomājies klientu atbalsta čatbotu, kas izmanto tikai grok-4.3 modeli sarunu režīmā. Tā ideālā atslēga izskatās šādi:

{
  "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"
}

Uztver šo konfigurāciju kā līgumu: atslēga var piekļūt tikai sarunu galapunktam — nekādu attēlu, nekādu iegulšanu, tāpēc nav iespējama ļaunprātīga izmantošana šiem nolūkiem. Tā var izmantot tikai grok-4.3, kas novērš nejaušus (vai ļaunprātīgus) izsaukumus uz dārgākiem modeļiem. Tā ir ierobežota līdz 5 pieprasījumiem sekundē un 100 minūtē, un tās derīgums beigsies zināmā datumā. Ja kāds projekta izstrādātājs mēģinās pievienot attēlu ģenerēšanu, nevienam par to nepaziņojot, API atteiks: tehniskais ierobežums nodrošina arhitektūras lēmuma izpildi.

Ātruma ierobežojumi: papildu drošības slānis

ACL atbild uz jautājumu “ko”, bet ātruma ierobežojumi atbild uz “cik daudz”. QPS (pieprasījumi sekundē) ierobežo pieprasījumu skaitu sekundē: tā ir tava aizsardzība pret nejaušiem pārspriegumiem — bezgalīgu cilpu, ko ieviesusi refaktorizācija piektdienas vakarā, vai DDoS uzbrukumu, kas atsitas pret tavu lietotni. QPM (pieprasījumi minūtē) izlīdzina satiksmi ilgākā laika posmā un atklāj ļaunprātīgu izmantošanu, kas paliktu zem QPS radara. TPM (tokeni minūtē), savukārt, ierobežo patērēto tokenu apjomu: tas pasargā pret ļoti gariem individuāliem pieprasījumiem — piemēram, lietotājs, kas ielīmē 200 lappušu dokumentu tavā čatbotā —, kas iztukšotu tavu budžetu minūšu laikā, nekad nepārsniedzot atļauto pieprasījumu skaitu.

Atslēgu stratēģija katrai videi

Praksē tu konfigurē nevis vienu atslēgu, bet gan atslēgu saimi, un katrai videi ir sava loģika. Izstrādes vidē tu apgriez ražošanas loģiku otrādi: plaša piekļuve, stingri ierobežojumi.

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

Izstrādātāji var izpētīt visu, taču zemie ierobežojumi novērš rēķinu pārsteigumus, ja tests neizdodas. Staging vidē, gluži pretēji, tu precīzi replicē ražošanas ACL (api-key:endpoint:chat, api-key:model:grok-4.3, QPS 5, QPM 100, TPM 500000): tas ir vienīgais veids, kā augšupplūsmā atklāt atļauju problēmu — ja staging kods mēģina veikt izsaukumu, ko ražošana noraidīs, labāk to uzzināt tagad, nevis pirmajā stundā pēc palaišanas ekspluatācijā. Ražošanas atslēga, savukārt, apvieno staging stingrās atļaujas ar ierobežojumiem, kas pielāgoti reālai satiksmei (piemēram, QPS 20, QPM 600, TPM 2000000), un ieplānotu derīguma termiņu — "expireTime": "2027-03-31T23:59:59Z" atslēgai ar nosaukumu prod-chatbot-v2.

Pārbaudi un auditē atļaujas

Lai redzētu, ko aktīva atslēga faktiski drīkst darīt, veic vaicājumu API, izmantojot pašu atslēgu:

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

Atbilde uzskaita efektīvos ACL, statusus api_key_blocked un api_key_disabled, atslēgas maskēto versiju (redacted_api_key) un team_id. Pieradi regulāri salīdzināt šos ACL ar lietotnes faktiskajām vajadzībām: atļaujas mēdz laika gaitā uzkrāties, nekad spontāni nesamazinoties. Modeļu pusē galapunkts GET /auth/teams/{teamId}/models atgriež tavai komandai pieejamo modeļu sarakstu ar to cenām — vērtīga informācija, lai definētu atbilstošus modeļu ACL un izslēgtu neizmantotus dārgus modeļus.

Lai visu to nostiprinātu, veic pilnu savu atslēgu auditu. Uzskaiti aktīvās atslēgas katrai komandai, pēc tam veic vaicājumu katrai no tām: vai to ACL ir minimāli, bez aizstājējzīmēm ražošanā? Vai to ātruma ierobežojumi ir saprātīgi? Vai ir iestatīts derīguma termiņš? Vai to nosaukums identificē lietotni un vidi — “prod-chatbot-v2” stāsta stāstu, bet “key-test-2” nestāsta neko? Dzēš osirotušās atslēgas un dokumentē rezultātu: šis dokuments kalpos kā sākumpunkts nākamajam auditam, un tu uzreiz redzēsi, kas šajā laikā ir novirzījies.

Galvenās atziņas

  • Katrai atslēgai ir jābūt ierobežojošiem ACL: tikai nepieciešamie galapunkti un modeļi
  • Nekad neizmanto aizstājējzīmi * ražošanā
  • Apvieno ACL ar ātruma ierobežojumiem (QPS, QPM, TPM), kas pielāgoti reālai lietošanai
  • Izveido atsevišķas atslēgas katrai videi (dev, staging, prod) un katrai lietotnei — staging ar tādiem pašiem ACL kā prod
  • Regulāri auditē savu aktīvo atslēgu atļaujas, izmantojot GET /v1/api-key