Seznami nadzora dostopa (ACL) in načelo najmanjših privilegijev
Na tej strani
Načelo najmanjših privilegijev pri API-jih
Načelo najmanjših privilegijev je eden najstarejših konceptov v kibernetski varnosti: vsaka komponenta sistema sme imeti dostop le do virov, ki so strogo nujni za njeno delovanje. Ideja je intuitivna, če jo preslikaš v fizični svet – osebi, ki zaliva rastline v avli, ne daš glavnega ključa celotne stavbe. Pri ključih API xAI to pomeni, da mora biti vsak ključ omejen le na tiste končne točke in modele, ki jih aplikacija, ki ga nosi, dejansko potrebuje. Če ta ključ kdaj uhaja, napadalec podeduje njegova dovoljenja: ključ, omejen na klepet z enim samim modelom, povzroči neskončno manj škode kot ključ, ki odpira celoten katalog.
xAI uresničuje to načelo z granularnim sistemom seznamov nadzora dostopa (ACL), ki ga bomo podrobneje opisali spodaj.
Sistem ACL pri xAI
Seznami ACL sledijo formatu api-key:{type}:{value}. Dva tipa sta zate vsakodnevno pomembna: api-key:endpoint:{endpoint} omejuje dostopne končne točke, api-key:model:{model_id} pa omejuje uporabne modele. Na voljo je tudi nadomestni znak api-key:endpoint:*, ki omogoča dostop do vseh končnih točk – priročno za razvoj, v proizvodnji prepovedano, prav zato, ker izniči korist načela najmanjših privilegijev.
Končne točke, ki jih lahko posebej avtoriziraš, so: chat (zaključek klepeta, daleč najpogostejši), embed (ustvarjanje vgradenj), image (ustvarjanje in urejanje slik), models (pregled seznama modelov), tokenize (tokenizacija besedila), documents (upravljanje dokumentov) in sample (vzorčenje).
Poglejmo, kako to izgleda v praksi. Predstavljaj si klepetalnega robota za podporo strankam, ki uporablja izključno model grok-4.3 v načinu klepeta. Njegov idealni ključ izgleda takole:
{
"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"
}
To konfiguracijo beri kot pogodbo: ključ lahko dostopa le do končne točke chat – brez slik, brez vgradenj, torej nobene možnosti zlorabe za te namene. Uporablja lahko le grok-4.3, kar preprečuje naključne (ali zlonamerne) klice dražjih modelov. Omejen je na 5 zahtev na sekundo in 100 na minuto, poteče pa na znan datum. Če bi razvijalec na projektu kdaj poskusil dodati ustvarjanje slik, ne da bi kogar obvestil, bi API to zavrnil: tehnična omejitev uveljavlja arhitekturno odločitev.
Omejitve hitrosti: dodatna varnostna plast
Seznami ACL odgovarjajo na vprašanje „kaj”, omejitve hitrosti pa na „koliko”. QPS (poizvedbe na sekundo) omejuje število zahtev na sekundo: to je tvoja zaščita pred naključnimi skoki – neskončno zanko, ki jo vneseš med refaktoriranjem petek zvečer, ali napad DDoS, ki se odbije od tvoje aplikacije. QPM (poizvedbe na minuto) gladi promet daljše obdobje in zazna zlorabe, ki bi ostale pod radarjem QPS. TPM (tokeni na minuto) nazadnje omejuje količino porabljenih tokenov: ščiti pred zelo dolgimi posameznimi zahtevami – uporabnik, ki v tvojega klepetalnega robota prilepi 200-stranski dokument – ki bi izčrpale tvoj proračun v nekaj minutah, ne da bi kdaj presegle dovoljeno število zahtev.
Strategija ključev za vsako okolje
V praksi ne konfiguriraš enega samega ključa, temveč družino ključev, pri čemer ima vsako okolje svojo logiko. V razvojnem okolju obrneš logiko proizvodnje: širok dostop, stroge omejitve.
{
"name": "dev-team-alpha",
"acls": ["api-key:endpoint:*", "api-key:model:*"],
"qps": 2,
"qpm": 30,
"tpm": 100000,
"expireTime": "2026-06-30T23:59:59Z"
}
Razvijalci lahko raziskujejo vse, vendar nizke omejitve preprečujejo presenečenja pri obračunu, če test krene po zlu. V okolju staging nasprotno natančno repliciraš proizvodne sezname ACL (api-key:endpoint:chat, api-key:model:grok-4.3, QPS 5, QPM 100, TPM 500000): le tako lahko zaznaš težave z dovoljenji vnaprej – če koda v staging poskusi klic, ki ga bo proizvodnja zavrnila, je bolje, da to odkriješ zdaj kot v prvi uri po zagonu v živo. Proizvodni ključ združuje stroga dovoljenja iz staging z omejitvami, prilagojenimi realnemu prometu (na primer QPS 20, QPM 600, TPM 2000000), in načrtovanim potekom – "expireTime": "2027-03-31T23:59:59Z" pri ključu z imenom prod-chatbot-v2.
Preveri in revidiraj dovoljenja
Če želiš videti, kaj aktivni ključ dejansko sme početi, poizvedi API s samim ključem:
curl https://api.x.ai/v1/api-key \
-H "Authorization: Bearer $XAI_API_KEY"
Odgovor našteje veljavne sezname ACL, stanji api_key_blocked in api_key_disabled, maskirano različico ključa (redacted_api_key) in team_id. Navadi se redno primerjati te sezname ACL z dejanskimi potrebami aplikacije: dovoljenja se sčasoma kopičijo, nikoli se spontano ne zmanjšajo. Na strani modelov končna točka GET /auth/teams/{teamId}/models vrne seznam modelov, ki so na voljo tvoji ekipi, z njihovimi cenami – dragocene informacije za opredelitev ustreznih seznamov ACL za modele in izključitev dragih modelov, ki jih ne uporabljaš.
Da vse to utrdiš, izvedi popoln revizijski pregled svojih ključev. Naštej aktivne ključe za vsako ekipo, nato poizvedi vsakega posebej: ali so njegovi seznami ACL minimalni, brez nadomestnih znakov v proizvodnji? Ali so njegove omejitve hitrosti smiselne? Ali je datum poteka nastavljen? Ali njegovo ime identificira aplikacijo in okolje – „prod-chatbot-v2” pripoveduje zgodbo, „key-test-2” pa nobene? Izbriši osirotele ključe in dokumentiraj rezultat: ta dokument bo služil kot izhodišče za naslednjo revizijo in na prvi pogled boš videl, kaj se je v vmesnem času spremenilo.
Ključne ugotovitve
- Vsak ključ mora imeti omejevalne sezname ACL: le nujne končne točke in modele
- V proizvodnji nikoli ne uporabi nadomestnega znaka
* - Združi sezname ACL z omejitvami hitrosti (QPS, QPM, TPM), prilagojenimi realni uporabi
- Ustvari ločene ključe za vsako okolje (dev, staging, prod) in za vsako aplikacijo – staging z enakimi seznami ACL kot prod
- Redno revidiraj dovoljenja na svojih aktivnih ključih prek
GET /v1/api-key