Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

ACL a princip nejmenších oprávnění

Lekce 8 z 12 Aktualizováno 28. července 2026 Pokročilý
Na této stránce
  1. Princip nejmenších oprávnění aplikovaný na API
  2. Systém ACL v xAI
  3. Limity rychlosti: Další vrstva zabezpečení
  4. Strategie klíčů pro každé prostředí
  5. Ověření a audit oprávnění
  6. Klíčové poznatky

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