Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

ACL-ovi i načelo najmanjih povlastica

Lekcija 8 od 12 Ažurirano 28. srpnja 2026. Napredno
Na ovoj stranici
  1. Načelo najmanjih povlastica primijenjeno na API-je
  2. xAI-jev sustav ACL-ova
  3. Ograničenja stope: Dodatni sloj sigurnosti
  4. Strategija jednog ključa po okruženju
  5. Provjera i revizija dozvola
  6. Ključne točke

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