ACL-ovi i načelo najmanjih povlastica
Na ovoj stranici
Načelo najmanjih povlastica primijenjeno na API-je
Načelo najmanjih povlastica jedan je od najstarijih koncepata u kibernetičkoj sigurnosti: svaka komponenta sustava trebala bi imati pristup samo onim resursima koji su strogo nužni za njezin rad. Ideja je intuitivna kada je preneseš u fizički svijet—ne daješ glavni ključ zgrade osobi koja zalijeva biljke u predvorju. Primijenjeno na ključeve xAI API-ja, to znači da svaki ključ mora biti ograničen samo na one krajnje točke (endpoints) i modele koje aplikacija koja ga nosi stvarno treba. Ako taj ključ ikada curi, napadač nasljeđuje njegove dozvole: ključ ograničen na chat s jednim modelom uzrokuje beskonačno manju štetu od ključa koji otvara cijeli katalog.
xAI provodi ovo načelo kroz granulirani sustav ACL-a (Access Control List – Popis kontrole pristupa), koji ćemo detaljno opisati u nastavku.
xAI-jev sustav ACL-ova
ACL-ovi slijede format api-key:{type}:{value}. Dvije vrste tebe zanimaju svakodnevno: api-key:endpoint:{endpoint} ograničava dostupne krajnje točke, a api-key:model:{model_id} ograničava upotrebljive modele. Postoji i zamjenski znak (wildcard), api-key:endpoint:*, koji odobrava pristup svim krajnjim točkama—pogodan za razvoj, zabranjen u proizvodnji, upravo zato što poništava prednost najmanjih povlastica.
Krajnje točke koje možeš pojedinačno autorizirati su: chat (dovršetak chata, daleko najčešći), embed (generiranje ugradnji/embeddinga), image (generiranje i uređivanje slika), models (pregled popisa modela), tokenize (tokenizacija teksta), documents (upravljanje dokumentima) i sample (uzorkovanje).
Pogledajmo kako to izgleda u stvarnom primjeru. Zamisli chatbota za korisničku podršku koji koristi samo model grok-4.3 u načinu chata. Njegov idealan ključ izgleda ovako:
{
"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"
}
Ovu konfiguraciju čitaj kao ugovor: ključ može pristupiti samo krajnjoj točki chat—nema slika, nema ugradnji, dakle nema moguće zlouporabe u te svrhe. Može koristiti samo grok-4.3, što sprječava slučajne (ili zlonamjerne) pozive skupljim modelima. Ograničen je na 5 zahtjeva u sekundi i 100 u minuti, a istječe na poznati datum. Ako programer na projektu ikada pokuša dodati generiranje slika bez da ikome kaže, API će to odbiti: tehničko ograničenje provodi arhitektonsku odluku.
Ograničenja stope: Dodatni sloj sigurnosti
ACL-ovi odgovaraju na pitanje „što“, dok ograničenja stope odgovaraju na pitanje „koliko“. QPS (Queries Per Second – upiti u sekundi) ograničava zahtjeve po sekundi: to je tvoja zaštita od slučajnih skokova—beskonačne petlje uvedene refaktoriranjem petkom navečer ili DDoS napada koji se odbija o tvoju aplikaciju. QPM (Queries Per Minute – upiti u minuti) izglađuje promet tijekom dužeg razdoblja i hvata zlouporabe koje bi prošle ispod QPS radara. TPM (Tokens Per Minute – tokeni u minuti), konačno, ograničava volumen potrošenih tokena: štiti od vrlo dugih pojedinačnih zahtjeva—korisnik koji zalijepi dokument od 200 stranica u tvoj chatbot—koji bi iscrpili tvoj proračun u minutama, a da pritom nikada ne prijeđu autorizirani broj zahtjeva.
Strategija jednog ključa po okruženju
U praksi ne konfiguriraš jedan ključ, već obitelj ključeva, a svako okruženje ima svoju logiku. U razvoju okrećeš proizvodnu logiku: širok pristup, stroga ograničenja.
{
"name": "dev-team-alpha",
"acls": ["api-key:endpoint:*", "api-key:model:*"],
"qps": 2,
"qpm": 30,
"tpm": 100000,
"expireTime": "2026-06-30T23:59:59Z"
}
Programeri mogu istraživati sve, ali niska ograničenja izbjegavaju iznenađenja na računu ako test krene po zlu. U staging okruženju, naprotiv, točno repliciraš proizvodne ACL-ove (api-key:endpoint:chat, api-key:model:grok-4.3, QPS 5, QPM 100, TPM 500000): to je jedini način da otkriješ problem s dozvolama unaprijed—ako staging kod pokuša poziv koji će proizvodnja odbiti, bolje je to otkriti sada nego u prvom satu puštanja u rad. Proizvodni ključ, međutim, kombinira stroge dozvole staginga s ograničenjima prilagođenima stvarnom prometu (na primjer QPS 20, QPM 600, TPM 2000000) i zakazanim istekom—"expireTime": "2027-03-31T23:59:59Z" na ključu nazvanom prod-chatbot-v2.
Provjera i revizija dozvola
Da bi vidio što aktivni ključ stvarno smije raditi, upitaj API s tim istim ključem:
curl https://api.x.ai/v1/api-key \
-H "Authorization: Bearer $XAI_API_KEY"
Odgovor navodi efektivne ACL-ove, statusa api_key_blocked i api_key_disabled, maskiranu verziju ključa (redacted_api_key) i team_id. Učini navikom da redovito uspoređuješ ove ACL-ove sa stvarnim potrebama aplikacije: dozvole teže akumulaciji tijekom vremena, nikada se ne smanjuju spontano. S strane modela, krajnja točka GET /auth/teams/{teamId}/models vraća popis modela dostupnih tvom timu s njihovim cijenama—vrijedna informacija za definiranje relevantnih ACL-ova modela i isključivanje skupih modela koje ne koristiš.
Da bi sve ovo učvrstio, provedi potpunu reviziju svojih ključeva. Izlistaj aktivne ključeve za svaki tim, zatim upitaj svaki od njih: jesu li njegovi ACL-ovi minimalni, bez zamjenskih znakova u proizvodnji? Jesu li njegova ograničenja stope razumna? Je li datum isteka postavljen? Identificira li njegovo ime aplikaciju i okruženje—„prod-chatbot-v2“ priča priču, „key-test-2“ ne priča nikakvu? Izbriši osirotele ključeve i dokumentiraj rezultat: taj će dokument poslužiti kao polazište za sljedeću reviziju i odmah ćeš vidjeti što je odstupilo u međuvremenu.
Ključne točke
- Svaki ključ mora imati restriktivne ACL-ove: samo potrebne krajnje točke i modele
- Nikada ne koristi zamjenski znak
*u proizvodnji - Kombiniraj ACL-ove s ograničenjima stope (QPS, QPM, TPM) prilagođenima stvarnoj upotrebi
- Kreiraj različite ključeve po okruženju (dev, staging, prod) i po aplikaciji—staging s istim ACL-ovima kao prod
- Redovito revidiraj dozvole na svojim aktivnim ključevima putem
GET /v1/api-key