Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Lista och modifiera dina nycklar

Lektion 3 av 14 Uppdaterad 29 juli 2026 Utvecklare
På denna sida
  1. Inventering av dina API-nycklar
  2. Lista nycklar
  3. Modifiera en befintlig nyckel
  4. Kontrollera spridning
  5. Vanliga scenarier
  6. Viktiga punkter

Inventering av dina API-nycklar

Med tiden ackumulerar ditt team API-nycklar för olika miljöer, projekt och teammedlemmar. Management API låter dig lista alla aktiva nycklar, filtrera efter behörigheter och ändra deras inställningar utan att behöva skapa nya.

Lista nycklar

Denna endpoint är startpunkten för varje granskning av åtkomst, och det är ofta här du upptäcker den verkliga inventeringen: nycklar skapade för ett test för åtta månader sedan, en nyckel i en före detta teammedlems namn, två produktionsnycklar där ingen vet vilken som används. Lista allt innan du skapar något nytt – nyckeln du behöver kanske redan finns.

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

Begäransparametrar

  • pageSize: antal nycklar per sida (som standard returneras alla nycklar)
  • paginationToken: token för att hämta nästa sida om antalet nycklar överskrider sidstorleken
  • aclFilters: filtrera nycklar efter specifika behörigheter

Filtrera efter ACL

Du kan hämta endast nycklar med en viss åtkomstnivå:

# Lista endast nycklar med chattåtkomst
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?aclFilters=api-key:endpoint:chat" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Denna filtrering är vad som gör en granskning hanterbar även när du har fler än ett dussin nycklar. Två frågor dyker ofta upp i praktiken och besvaras med en enda begäran: vem kan anropa den dyraste modellen, och vilka nycklar har fortfarande ett jokertecken? Den senare är mest användbar – ett glömt jokertecken i produktion är det vanligaste konfigurationsfelet, och det tystaste.

Paginering

För team med många nycklar, använd paginering:

# Första sidan med 10 nycklar
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?pageSize=10" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

# Nästa sida med den mottagna token
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?pageSize=10&paginationToken=TOKEN_RECU" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Modifiera en befintlig nyckel

Att modifiera istället för att återskapa är inte bara en bekvämlighet: den hemliga nyckeln förblir densamma, så ingen distribution krävs. Detta låter dig justera gränser eller begränsa behörigheter utan avbrott i tjänsten – och vid misstanke kan du reducera en nyckels rättigheter på sekunder medan du förbereder dess rotation.

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
  }'

Vad du kan modifiera

  • name: byt namn på nyckeln för att spegla en ändrad användning
  • acls: lägg till eller ta bort behörigheter (endpoints, modeller)
  • qps / qpm / tpm: justera hastighetsbegränsningar
  • expireTime: förläng eller förkorta giltighetstiden

Vad du inte kan modifiera

  • Nyckelidentifieraren (api_key_id) förblir oförändrad
  • Den hemliga nyckeln ändras inte vid modifiering (använd rotation för detta)
  • Det ägande teamet kan inte överföras

Kontrollera spridning

Här är detaljen som förklarar hälften av de “buggar” som rapporteras efter en nyckelmodifiering: ändringen är inte omedelbar på alla servrar. En nyskapad nyckel kan returnera 401 under några ögonblick, en utökad ACL kanske inte är aktiv än – och du letar efter felet i din egen kod när du egentligen bara behövde vänta. Endpointen för spridning finns just för att eliminera detta tvivel:

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

Denna endpoint returnerar nyckelns spridningsstatus. Vänta tills spridningen är klar innan du använder nyckeln i produktion, särskilt efter att ha modifierat ACL:er.

Vanliga scenarier

Uppgradera en utvecklingsnyckel till produktion

Att gå över till produktion är det vanligaste modifieringsscenariot, och reflexen att skapa en ny nyckel i detta läge är kostsam: du måste distribuera den överallt, uppdatera valv, och den gamla ligger kvar på obestämd tid. Att höja gränserna på den befintliga nyckeln undviker allt detta.

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
  }'

Begränsa en nyckel vid misstanke om kompromettering

Vid misstanke är ordningen på operationerna avgörande. Att först begränsa – tomma ACL:er, noll hastighetsgränser – stoppar blödningen med en enda begäran, utan att bryta något oåterkalleligt. Rotation kommer senare, offline, när du har identifierat var nyckeln användes. Motsatt ordning lämnar dig med en nereproduktion och en utredning som måste ske under press.

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
  }'

Viktiga punkter

  • GET /auth/teams/{teamId}/api-keys listar alla nycklar med paginering och ACL-filtrering
  • PUT /auth/api-keys/{apiKeyId} modifierar parametrar utan att ändra den hemliga nyckeln
  • GET /auth/api-keys/{apiKeyId}/propagation verifierar att ändringar har trätt i kraft
  • Använd ACL-filtrering för att regelbundet granska ditt teams åtkomst
  • Efter varje modifiering, kontrollera spridningen innan du använder nyckeln i produktion