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

Výpis a úprava vašich klíčů

Lekce 3 z 14 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. Inventář vašich API klíčů
  2. Výpis klíčů
  3. Úprava existujícího klíče
  4. Kontrola propagace
  5. Běžné scénáře
  6. Klíčové poznatky

Inventář vašich API klíčů

Časem váš tým nashromáždí API klíče pro různá prostředí, projekty a členy týmu. Management API vám umožňuje vypsat všechny aktivní klíče, filtrovat je podle oprávnění a upravovat jejich nastavení bez nutnosti jejich znovu vytvářet.

Výpis klíčů

Tento koncový bod je výchozím místem pro jakýkoli audit přístupu a často právě zde objevíte skutečný inventář: klíče vytvořené před osmi měsíci pro testování, klíč na jméno bývalého člena týmu nebo dva produkční klíče, u kterých nikdo neví, který se právě používá. Než vytvoříte něco nového, nejprve si udělejte výpis – klíč, který potřebujete, možná již existuje.

curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Parametry požadavku

  • pageSize: počet klíčů na stránku (ve výchozím nastavení se vrátí všechny klíče)
  • paginationToken: token pro získání další stránky, pokud počet klíčů překročí velikost stránky
  • aclFilters: filtruje klíče podle konkrétních oprávnění

Filtrace podle ACL

Můžete získat pouze klíče s určitou úrovní přístupu:

# Vypíše pouze klíče s přístupem k chatu
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?aclFilters=api-key:endpoint:chat" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Právě toto filtrování činí audit zvládnutelným i u více než tuctu klíčů. V praxi vyvstanou dvě otázky, na které odpoví jediný požadavek: kdo může volat nejdražší model a které klíče stále obsahují zástupné znaky (wildcard). To druhé je nejužitečnější – zapomenutý zástupný znak v produkci je nejčastější chybou v konfiguraci a zároveň tou nejtišší.

Stránkování

Pro týmy s velkým množstvím klíčů použijte stránkování:

# První stránka s 10 klíči
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?pageSize=10" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

# Další stránka s přijatým tokenem
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?pageSize=10&paginationToken=TOKEN_RECU" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Úprava existujícího klíče

Úprava místo znovuvytvoření není jen otázkou pohodlí: tajný klíč zůstává stejný, takže není nutné žádné nasazení. To vám umožňuje upravit limity nebo omezit oprávnění bez přerušení služby – a v případě podezření snížit práva klíče během vteřin, zatímco připravujete jeho rotaci.

curl -X PUT "https://management-api.x.ai/auth/api-keys/$API_KEY_ID" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "prod-backend-v3",
    "acls": [
      "api-key:endpoint:chat",
      "api-key:endpoint:embed",
      "api-key:model:grok-4.20-0309-reasoning"
    ],
    "qps": 30,
    "qpm": 1000,
    "tpm": 3000000
  }'

Co můžete upravit

  • name: přejmenujte klíč tak, aby odpovídal změně ve využití
  • acls: přidejte nebo odeberte oprávnění (koncové body, modely)
  • qps / qpm / tpm: upravte limity rychlosti
  • expireTime: prodlužte nebo zkraťte dobu platnosti

Co nemůžete upravit

  • Identifikátor klíče (api_key_id) zůstává fixní
  • Tajný klíč se při úpravě nemění (k tomu použijte rotaci)
  • Vlastnící tým nelze převést

Kontrola propagace

Zde je detail, který vysvětluje polovinu „chyb“ hlášených po úpravě klíče: změna není okamžitá na všech serverech. Čerstvě vytvořený klíč může několik okamžiků vracet chybu 401, rozšířené ACL nemusí být ještě aktivní – a vy hledáte chybu ve svém kódu, když jste jen měli počkat. Koncový bod pro propagaci existuje přesně proto, aby odstranil tuto nejistotu:

curl "https://management-api.x.ai/auth/api-keys/$API_KEY_ID/propagation" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Tento koncový bod vrací stav propagace klíče. Před použitím klíče v produkci, zejména po úpravě ACL, vyčkejte na dokončení propagace.

Běžné scénáře

Povýšení vývojářského klíče na produkční

Přechod do produkce je nejčastějším scénářem úpravy a reflex vytvořit při této příležitosti nový klíč je nákladný: musíte jej nasadit všude, aktualizovat trezory a ten starý zůstává neurčitě ležet ladem. Zvýšení limitů na existujícím klíči tomu všemu zabrání.

curl -X PUT "https://management-api.x.ai/auth/api-keys/$API_KEY_ID" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "prod-chatbot",
    "qps": 50,
    "qpm": 2000,
    "tpm": 5000000
  }'

Omezení klíče s podezřením na kompromitaci

V případě podezření záleží na pořadí operací. Nejprve omezte – prázdná ACL, nulové limity rychlosti – tím zastavíte únik jediným požadavkem, aniž by došlo k nevratnému poškození. Rotace přijde až později, offline, jakmile identifikujete, kde byl klíč používán. Obrácený postup vás nechá s nefunkční produkcí a vyšetřováním pod tlakem.

curl -X PUT "https://management-api.x.ai/auth/api-keys/$API_KEY_ID" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "acls": [],
    "qps": 0,
    "qpm": 0
  }'

Klíčové poznatky

  • GET /auth/teams/{teamId}/api-keys vypíše všechny klíče se stránkováním a filtrováním podle ACL
  • PUT /auth/api-keys/{apiKeyId} upravuje parametry beze změny tajného klíče
  • GET /auth/api-keys/{apiKeyId}/propagation ověří, že jsou změny účinné
  • Pravidelně auditujte přístup svého týmu pomocí filtrování podle ACL
  • Po jakékoli úpravě před použitím klíče v produkci zkontrolujte propagaci