Zoznam a úprava vašich kľúčov
Na tejto strane
Inventár vašich API kľúčov
Časom si váš tím nahromadí API kľúče pre rôzne prostredia, projekty a členov tímu. Management API vám umožňuje vypísať všetky aktívne kľúče, filtrovať ich podľa oprávnení a upravovať ich nastavenia bez potreby ich znovu vytvárať.
Zoznam kľúčov
Tento koncový bod je východiskom pre akýkoľvek audit prístupu a často práve tu objavíte skutočný inventár: kľúče vytvorené pred ôsmimi mesiacmi na testovanie, kľúč na meno bývalého člena tímu alebo dva produkčné kľúče, pri ktorých nikto nevie, ktorý sa používa. Pred vytvorením čohokoľvek nového si najprv urobte zoznam – kľúč, ktorý potrebujete, možno už existuje.
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Parametre požiadavky
- pageSize: počet kľúčov na stránku (predvolene sa vrátia všetky kľúče)
- paginationToken: token na získanie ďalšej stránky, ak počet kľúčov presahuje veľkosť stránky
- aclFilters: filtrovanie kľúčov podľa konkrétnych oprávnení
Filtrovanie podľa ACL
Môžete získať iba kľúče s určitou úrovňou prístupu:
# Zoznam iba kľúčov s prístupom na chat
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?aclFilters=api-key:endpoint:chat" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Práve toto filtrovanie robí audit zvládnuteľným aj pri viac ako tucte kľúčov. V praxi sa často objavujú dve otázky, na ktoré odpovie jediná požiadavka: kto môže volať najdrahší model a ktoré kľúče stále obsahujú wildcards. Druhá otázka je najdôležitejšia – zabudnutý wildcard v produkcii je najčastejšou chybou v konfigurácii a zároveň tou najtichšou.
Stránkovanie
Pre tímy s veľkým počtom kľúčov použite stránkovanie:
# Prvá stránka s 10 kľúčmi
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?pageSize=10" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
# Ďalšia stránka s prijatým tokenom
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úceho kľúča
Úprava namiesto znovu vytvorenia nie je len otázkou pohodlia: tajný kľúč zostáva rovnaký, takže nie je potrebné nasadzovanie. Umožňuje vám to upraviť limity alebo obmedziť oprávnenia bez prerušenia služby – a v prípade podozrenia znížiť práva kľúča v priebehu sekúnd, zatiaľ čo pripravujete jeho rotáciu.
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
}'
Čo môžete upraviť
- name: premenovanie kľúča tak, aby odrážal zmenu vo využití
- acls: pridanie alebo odstránenie oprávnení (koncové body, modely)
- qps / qpm / tpm: úprava limitov rýchlosti
- expireTime: predĺženie alebo skrátenie doby platnosti
Čo nemôžete upraviť
- Identifikátor kľúča (
api_key_id) zostáva nezmenený - Tajný kľúč sa počas úpravy nemení (na to slúži rotácia)
- Vlastniaci tím nie je možné preniesť
Kontrola propagácie
Tu je detail, ktorý vysvetľuje polovicu „chýb“ nahlásených po úprave kľúča: zmena nie je okamžite platná na všetkých serveroch. Čerstvo vytvorený kľúč môže niekoľko okamihov vracať chybu 401, rozšírené ACL nemusí byť ešte aktívne – a vy hľadáte chybu vo vlastnom kóde, hoci stačilo počkať. Koncový bod pre propagáciu existuje práve na to, aby odstránil túto neistotu:
curl "https://management-api.x.ai/auth/api-keys/$API_KEY_ID/propagation" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Tento koncový bod vráti stav propagácie kľúča. Pred použitím kľúča v produkcii, najmä po úprave ACL, počkajte na dokončenie propagácie.
Bežné scenáre
Prechod vývojového kľúča do produkcie
Prechod do produkcie je najbežnejším scenárom úpravy a reflexné vytváranie nového kľúča pri tejto príležitosti je nákladné: musíte ho nasadiť všade, aktualizovať trezory a starý kľúč zostane navždy ležať. Zvýšením limitov na existujúcom kľúči sa tomu všetkému vyhnete.
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
}'
Obmedzenie podozrivého kompromitovaného kľúča
V prípade podozrenia záleží na poradí operácií. Najprv obmedzte – prázdne ACL, nulové limity rýchlosti – čím zastavíte únik jednou požiadavkou bez toho, aby ste niečo nenávratne pokazili. Rotácia príde až neskôr, offline, keď identifikujete, kde sa kľúč používal. Opačný postup vás pripraví o produkciu a vyšetrovanie budete musieť viesť pod tlakom.
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
}'
Kľúčové poznatky
GET /auth/teams/{teamId}/api-keysvypíše všetky kľúče so stránkovaním a filtrovaním podľa ACLPUT /auth/api-keys/{apiKeyId}upraví parametre bez zmeny tajného kľúčaGET /auth/api-keys/{apiKeyId}/propagationoverí, či sú zmeny účinné- Pravidelne auditujte prístup svojho tímu pomocou filtrovania podľa ACL
- Po akejkoľvek úprave skontrolujte propagáciu pred použitím kľúča v produkcii