Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Oplist og modificér dine nøgler

Lektion 3 af 14 Opdateret 29. juli 2026 Udvikler
På denne side
  1. Oversigt over dine API-nøgler
  2. List nøgler
  3. Modificér en eksisterende nøgle
  4. Tjek udrulning
  5. Almindelige scenarier
  6. Vigtige pointer

Oversigt over dine API-nøgler

Med tiden ophober dit team API-nøgler til forskellige miljøer, projekter og teammedlemmer. Management API’en giver dig mulighed for at liste alle aktive nøgler, filtrere efter rettigheder og ændre deres indstillinger uden at skulle genoprette dem.

List nøgler

Dette endpoint er udgangspunktet for enhver adgangsaudit, og det er ofte her, du opdager den faktiske beholdning: nøgler oprettet til en test for otte måneder siden, en nøgle i navnet på et tidligere teammedlem, to produktionsnøgler hvor ingen ved, hvilken der er i brug. List før du opretter noget nyt – den nøgle, du har brug for, eksisterer måske allerede.

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

Anmodningsparametre

  • pageSize: antal nøgler per side (som standard returneres alle nøgler)
  • paginationToken: token til at hente næste side, hvis antallet af nøgler overstiger sidestørrelsen
  • aclFilters: filtrér nøgler efter specifikke rettigheder

Filtrér efter ACL

Du kan kun hente nøgler med et bestemt adgangsniveau:

# List kun nøgler med chat-adgang
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?aclFilters=api-key:endpoint:chat" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Denne filtrering er det, der gør en audit håndterbar ud over et dusin nøgler. To spørgsmål dukker ofte op i praksis og besvares med en enkelt anmodning: hvem kan kalde den dyreste model, og hvilke nøgler bærer stadig et jokertegn? Det sidste er mest nyttigt – et glemt jokertegn i produktion er den hyppigste konfigurationsfejl, og den mest stille.

Paginering

For teams med mange nøgler skal du bruge paginering:

# Første side med 10 nøgler
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?pageSize=10" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

# Næste side med det modtagne token
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?pageSize=10&paginationToken=TOKEN_RECU" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Modificér en eksisterende nøgle

At modificere frem for at genoprette er ikke blot en bekvemmelighed: den hemmelige nøgle forbliver den samme, så ingen udrulning er nødvendig. Dette lader dig justere grænser eller begrænse rettigheder uden afbrydelse af tjenesten – og i tilfælde af mistanke reducere en nøgles rettigheder på få sekunder, mens du forbereder dens 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
  }'

Hvad du kan modificere

  • name: omdøb nøglen for at afspejle en ændring i anvendelsen
  • acls: tilføj eller fjern rettigheder (endpoints, modeller)
  • qps / qpm / tpm: justér hastighedsgrænser
  • expireTime: forlæng eller forkort gyldighedsperioden

Hvad du ikke kan modificere

  • Nøgleidentifikatoren (api_key_id) forbliver fastlåst
  • Den hemmelige nøgle ændres ikke under modificering (brug rotation til dette)
  • Det ejende team kan ikke overføres

Tjek udrulning

Her er detaljen, der forklarer halvdelen af de „bugs”, der rapporteres efter en nøglemodificering: ændringen er ikke øjeblikkelig på tværs af alle servere. En nyoprettet nøgle kan returnere 401 i nogle øjeblikke, en udvidet ACL er måske endnu ikke aktiv – og du leder efter fejlen i din egen kode, når du blot skulle have ventet. Udrulnings-endpointet findes netop for at fjerne denne tvivl:

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

Dette endpoint returnerer nøglens udrulningsstatus. Vent på, at udrulningen er fuldført, før du bruger nøglen i produktion, især efter modificering af ACL’er.

Almindelige scenarier

Opgradér en udviklingsnøgle til produktion

Overgang til produktion er det mest almindelige modificeringsscenarie, og refleksen til at oprette en ny nøgle i denne anledning er bekostelig: du skal udrulle den overalt, opdatere hvælvinger, og den gamle bliver hængende på ubestemt tid. At hæve grænserne på den eksisterende nøgle undgår alt dette.

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æns en nøgle med mistanke om kompromittering

I tilfælde af mistanke betyder rækkefølgen af operationer noget. At begrænse først – tomme ACL’er, nul hastighedsgrænser – stopper blødningen med én anmodning uden at ødelægge noget irreversibelt. Rotation kommer senere, offline, når du har identificeret, hvor nøglen blev brugt. Den omvendte rækkefølge efterlader dig med nede produktion og en undersøgelse, der skal udføres under pres.

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

Vigtige pointer

  • GET /auth/teams/{teamId}/api-keys lister alle nøgler med paginering og ACL-filtrering
  • PUT /auth/api-keys/{apiKeyId} modificerer parametre uden at ændre den hemmelige nøgle
  • GET /auth/api-keys/{apiKeyId}/propagation verificerer, at ændringer er effektive
  • Brug ACL-filtrering til regelmæssigt at auditere dit teams adgang
  • Efter enhver modificering skal du tjekke udrulning, før du bruger nøglen i produktion