Pregled i izmjena vaših ključeva
Na ovoj stranici
Inventar tvojih API ključeva
Tijekom vremena, tvoj tim akumulira API ključeve za različita okruženja, projekte i članove tima. Management API omogućuje ti popis svih aktivnih ključeva, filtriranje po dopuštenjima i izmjenu njihovih postavki bez potrebe za ponovnim kreiranjem.
Popis ključeva
Ova krajnja točka polazište je za svaku reviziju pristupa i često mjesto gdje otkrivaš stvarni inventar: ključeve kreirane za testiranje prije osam mjeseci, ključeve na ime bivšeg člana tima ili dva produkcijska ključa za koje nitko ne zna koji se koristi. Napravi popis prije nego što kreiraš išta novo – ključ koji ti treba možda već postoji.
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Parametri zahtjeva
- pageSize: broj ključeva po stranici (zadano se vraćaju svi ključevi)
- paginationToken: token za dohvat sljedeće stranice ako broj ključeva premašuje veličinu stranice
- aclFilters: filtriranje ključeva prema specifičnim dopuštenjima
Filtriranje po ACL-u
Možeš dohvatiti samo ključeve s određenom razinom pristupa:
# Popiši samo ključeve s pristupom chatu
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?aclFilters=api-key:endpoint:chat" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Ovo filtriranje čini reviziju upravljivom čak i kada imaš više od desetak ključeva. U praksi se nameću dva pitanja na koja jedan zahtjev daje odgovor: tko može pozivati najskuplji model i koji ključevi još uvijek sadrže zamjenski znak (wildcard). Drugo je pitanje najkorisnije – zaboravljeni zamjenski znak u produkciji najčešća je konfiguracijska pogreška, ali i najtiša.
Paginacija
Za timove s mnogo ključeva koristi paginaciju:
# Prva stranica od 10 ključeva
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?pageSize=10" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
# Sljedeća stranica s primljenim tokenom
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?pageSize=10&paginationToken=TOKEN_RECU" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Izmjena postojećeg ključa
Izmjena umjesto ponovnog kreiranja nije samo pogodnost: tajni ključ ostaje isti, pa nije potrebno nikakvo implementiranje. To ti omogućuje prilagodbu ograničenja ili restrikciju dopuštenja bez prekida usluge – a u slučaju sumnje, možeš smanjiti prava ključa u nekoliko sekundi dok pripremaš njegovu rotaciju.
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
}'
Što možeš izmijeniti
- name: preimenuj ključ kako bi odražavao promjenu u korištenju
- acls: dodaj ili ukloni dopuštenja (krajnje točke, modeli)
- qps / qpm / tpm: prilagodi ograničenja stope (rate limits)
- expireTime: produži ili skrati razdoblje valjanosti
Što ne možeš izmijeniti
- Identifikator ključa (
api_key_id) ostaje fiksan - Tajni ključ se ne mijenja tijekom izmjene (za to koristi rotaciju)
- Vlasnički tim se ne može prenijeti
Provjera propagacije
Evo detalja koji objašnjava polovicu „bugova“ prijavljenih nakon izmjene ključa: promjena nije trenutna na svim poslužiteljima. Svježe kreirani ključ može vraćati status 401 nekoliko trenutaka, prošireni ACL možda još nije aktivan – i ti tražiš pogrešku u vlastitom kodu, a trebao si samo pričekati. Krajnja točka za propagaciju postoji upravo kako bi uklonila tu dilemu:
curl "https://management-api.x.ai/auth/api-keys/$API_KEY_ID/propagation" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Ova krajnja točka vraća status propagacije ključa. Prije korištenja ključa u produkciji, pričekaj da se propagacija završi, posebno nakon izmjene ACL-ova.
Uobičajeni scenariji
Nadogradnja razvojnom ključa na produkcijski
Prijelaz u produkciju najčešći je scenarij izmjene, a refleks da se tom prilikom kreira novi ključ skup je: moraš ga implementirati svugdje, ažurirati trezore (vaults), a stari ključ ostaje zauvijek. Povećanje ograničenja na postojećem ključu izbjegava sve to.
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
}'
Restrikcija ključa za koji se sumnja da je kompromitiran
U slučaju sumnje, redoslijed operacija je bitan. Prvo ograniči prava – prazni ACL-ovi, nulta ograničenja stope – time zaustavljaš curenje jednim zahtjevom, bez nepovratnog rušenja ičega. Rotacija dolazi kasnije, offline, jednom kada identificiraš gdje se ključ koristio. Obrnuti redoslijed ostavlja te s pala produkcijom i istragom koju moraš provoditi pod pritiskom.
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
}'
Ključne točke
GET /auth/teams/{teamId}/api-keysizlistava sve ključeve s paginacijom i filtriranjem po ACL-uPUT /auth/api-keys/{apiKeyId}mijenja parametre bez promjene tajnog ključaGET /auth/api-keys/{apiKeyId}/propagationprovjerava jesu li promjene stupile na snagu- Koristi filtriranje po ACL-u za redovitu reviziju pristupa svog tima
- Nakon svake izmjene, provjeri propagaciju prije korištenja ključa u produkciji