ACL a princip nejmenších oprávnění
Na této stránce
Princip nejmenších oprávnění aplikovaný na API
Princip nejmenších oprávnění je jedním z nejstarších konceptů v kybernetické bezpečnosti: každá komponenta systému by měla mít přístup pouze ke zdrojům, které jsou pro její provoz nezbytně nutné. Myšlenka je intuitivní, když ji převedete do fyzického světa – nedáte hlavní klíč od budovy člověku, který jen zalévá rostliny v hale. Aplikováno na klíče API xAI to znamená, že každý klíč musí být omezen pouze na koncové body a modely, které aplikace, jež jej nese, skutečně potřebuje. Pokud tento klíč kdy unikne, útočník zdědí jeho oprávnění: klíč omezený na chat s jediným modelem napáchá nekonečně menší škody než klíč, který otevírá celý katalog.
xAI implementuje tento princip prostřednictvím granulárního systému ACL (Access Control List – seznam řízení přístupu), který si podrobně rozebereme níže.
Systém ACL v xAI
ACL mají formát api-key:{type}:{value}. Dva typy se vás týkají denně: api-key:endpoint:{endpoint} omezuje přístupné koncové body a api-key:model:{model_id} omezuje použitelné modely. Existuje také zástupný znak api-key:endpoint:*, který uděluje přístup ke všem koncovým bodům – vhodné pro vývoj, zakázané v produkci, právě proto, že popírá výhodu principu nejmenších oprávnění.
Koncové body, které můžete autorizovat jednotlivě, jsou: chat (dokončení chatu, zdaleka nejčastější), embed (generování vnoření), image (generování a úprava obrázků), models (konzultace seznamu modelů), tokenize (tokenizace textu), documents (správa dokumentů) a sample (vzorkování).
Podívejme se, jak to vypadá v reálném příkladu. Představte si chatbota pro zákaznickou podporu, který používá pouze model grok-4.3 v režimu chatu. Jeho ideální klíč vypadá takto:
{
"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"
}
Tuto konfiguraci čtěte jako smlouvu: klíč může přistupovat pouze ke koncovému bodu chatu – žádné obrázky, žádná vnoření, takže žádné možné zneužití pro tyto účely. Může používat pouze grok-4.3, což zabraňuje náhodným (nebo škodlivým) voláním dražších modelů. Je omezen na 5 požadavků za sekundu a 100 za minutu a vyprší v známé datum. Pokud se někdy vývojář na projektu pokusí přidat generování obrázků bez vědomí ostatních, API to odmítne: technické omezení vynucuje architektonické rozhodnutí.
Limity rychlosti: Další vrstva zabezpečení
ACL odpovídají na otázku „co“, limity rychlosti odpovídají na otázku „kolik“. QPS (Queries Per Second – dotazy za sekundu) omezuje požadavky za sekundu: je to vaše pojistka proti náhodným špičkám – nekonečné smyčce zavedené refaktoringem v pátek večer nebo útoku DDoS odraženému od vaší aplikace. QPM (Queries Per Minute – dotazy za minutu) vyrovnává provoz během delšího období a zachycuje zneužívání, které by zůstalo pod radarem QPS. TPM (Tokens Per Minute – tokeny za minutu) nakonec omezuje objem spotřebovaných tokenů: chrání před velmi dlouhými jednotlivými požadavky – uživatel vloží do vašeho chatbota 200stránkový dokument – které by vyčerpaly váš rozpočet během minut, aniž by kdy překročily autorizovaný počet požadavků.
Strategie klíčů pro každé prostředí
V praxi nekonfigurujete jediný klíč, ale rodinu klíčů a každé prostředí má svou vlastní logiku. Ve vývoji obrátíte produkční logiku: široký přístup, přísné limity.
{
"name": "dev-team-alpha",
"acls": ["api-key:endpoint:*", "api-key:model:*"],
"qps": 2,
"qpm": 30,
"tpm": 100000,
"expireTime": "2026-06-30T23:59:59Z"
}
Vývojáři mohou prozkoumávat vše, ale nízké limity zabraňují překvapením na faktuře, pokud se test pokazí. Ve stagingu naopak přesně replikujete produkční ACL (api-key:endpoint:chat, api-key:model:grok-4.3, QPS 5, QPM 100, TPM 500000): je to jediný způsob, jak odhalit problém s oprávněními předem – pokud se kód ve stagingu pokusí o volání, které produkce odmítne, je lepší to zjistit nyní než v první hodině ostrovního provozu. Produkční klíč však kombinuje přísná oprávnění ze stagingu s limity přizpůsobenými reálnému provozu (například QPS 20, QPM 600, TPM 2000000) a naplánovaným vypršením – "expireTime": "2027-03-31T23:59:59Z" u klíče pojmenovaného prod-chatbot-v2.
Ověření a audit oprávnění
Chcete-li zjistit, co aktivní klíč skutečně smí dělat, dotazujte se API pomocí samotného klíče:
curl https://api.x.ai/v1/api-key \
-H "Authorization: Bearer $XAI_API_KEY"
Odpověď uvádí efektivní ACL, stavy api_key_blocked a api_key_disabled, maskovanou verzi klíče (redacted_api_key) a team_id. Zvykněte si pravidelně porovnávat tato ACL se skutečnými potřebami aplikace: oprávnění mají tendenci se časem hromadit, nikdy se spontánně nezmenšují. Na straně modelů vrací koncový bod GET /auth/teams/{teamId}/models seznam modelů dostupných pro váš tým s jejich cenami – cenné informace pro definování relevantních ACL modelů a vyloučení drahých modelů, které nepoužíváte.
Abyste to vše upevnili, proveďte úplný audit svých klíčů. Vypište aktivní klíče pro každý tým a poté dotazujte každý z nich: jsou jeho ACL minimální, bez zástupných znaků v produkci? Jsou jeho limity rychlosti přiměřené? Má nastavené datum vypršení? Identifikuje jeho název aplikaci a prostředí – „prod-chatbot-v2“ vypráví příběh, „key-test-2“ nevypráví žádný? Smažte osiřelé klíče a zdokumentujte výsledek: tento dokument bude sloužit jako výchozí bod pro další audit a na první pohled uvidíte, co se mezitím změnilo.
Klíčové poznatky
- Každý klíč musí mít restriktivní ACL: pouze nezbytné koncové body a modely
- Nikdy nepoužívejte zástupný znak
*v produkci - Kombinujte ACL s limity rychlosti (QPS, QPM, TPM) přizpůsobenými reálnému využití
- Vytvářejte odlišné klíče pro každé prostředí (dev, staging, prod) a pro každou aplikaci – staging se stejnými ACL jako prod
- Pravidelně auditujte oprávnění na svých aktivních klíčích pomocí
GET /v1/api-key