Výpis a úprava vašich klíčů
Na této stránce
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-keysvypíše všechny klíče se stránkováním a filtrováním podle ACLPUT /auth/api-keys/{apiKeyId}upravuje parametry beze změny tajného klíčeGET /auth/api-keys/{apiKeyId}/propagationověří, ž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