Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Uw sleutels weergeven en wijzigen

Les 3 van 14 Bijgewerkt op 29 juli 2026 Ontwikkelaar
Op deze pagina
  1. Overzicht van uw API-sleutels
  2. Sleutels weergeven
  3. Een bestaande sleutel wijzigen
  4. Propagatie controleren
  5. Veelvoorkomende scenario’s
  6. Belangrijkste punten

Overzicht van uw API-sleutels

Na verloop van tijd verzamelt uw team API-sleutels voor verschillende omgevingen, projecten en teamleden. Met de Management API kunt u alle actieve sleutels weergeven, filteren op machtigingen en de instellingen aanpassen zonder ze opnieuw te hoeven maken.

Sleutels weergeven

Dit eindpunt is het startpunt voor elke toegangscontrole. Het is vaak de plek waar u de werkelijke inventaris ontdekt: sleutels die acht maanden geleden voor een test zijn gemaakt, een sleutel op naam van een voormalig teamlid, of twee productiesleutels waarvan niemand weet welke er daadwerkelijk wordt gebruikt. Controleer eerst voordat u iets nieuws maakt; de sleutel die u nodig heeft, bestaat misschien al.

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

Aanvraagparameters

  • pageSize: aantal sleutels per pagina (standaard worden alle sleutels geretourneerd)
  • paginationToken: token om de volgende pagina op te halen als het aantal sleutels de paginagrootte overschrijdt
  • aclFilters: filter sleutels op specifieke machtigingen

Filteren op ACL

U kunt alleen sleutels ophalen met een bepaald toegangsniveau:

# Alleen sleutels met chat-toegang weergeven
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?aclFilters=api-key:endpoint:chat" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Deze filterfunctie maakt een audit beheersbaar, zelfs bij meer dan een dozijn sleutels. In de praktijk rijzen twee vragen die met één aanvraag worden beantwoord: wie kan het duurste model aanroepen, en welke sleutels hebben nog steeds een jokerteken? Het tweede punt is het nuttigst; een vergeten jokerteken in productie is de meest voorkomende configuratiefout, en tegelijkertijd de stilste.

Paginering

Voor teams met veel sleutels gebruikt u paginering:

# Eerste pagina van 10 sleutels
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?pageSize=10" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

# Volgende pagina met het ontvangen token
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?pageSize=10&paginationToken=TOKEN_RECU" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Een bestaande sleutel wijzigen

Een sleutel wijzigen in plaats van opnieuw maken is niet slechts een gemak: de geheime sleutel blijft hetzelfde, waardoor geen nieuwe implementatie nodig is. Hiermee past u limieten aan of beperkt u machtigingen zonder onderbreking van de service. Bij een vermoeden van misbruik kunt u binnen enkele seconden de rechten van een sleutel beperken terwijl u de rotatie voorbereidt.

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

Wat u kunt wijzigen

  • name: hernoem de sleutel om een gewijzigd gebruik weer te geven
  • acls: machtigingen toevoegen of verwijderen (eindpunten, modellen)
  • qps / qpm / tpm: snelheidslimieten aanpassen
  • expireTime: de geldigheidsduur verlengen of verkorten

Wat u niet kunt wijzigen

  • De sleutelidentifier (api_key_id) blijft vast
  • De geheime sleutel verandert niet tijdens het wijzigen (gebruik daarvoor rotatie)
  • Het eigendom van het team kan niet worden overgedragen

Propagatie controleren

Hier is het detail dat de helft van de “bugs” verklaart die na een sleutelwijziging worden gemeld: de wijziging is niet direct op alle servers actief. Een pas gemaakte sleutel kan enkele momenten een 401-fout retourneren, een uitgebreide ACL is mogelijk nog niet actief, en u zoekt de fout in uw eigen code terwijl u alleen had hoeven wachten. Het propagatie-eindpunt bestaat precies om deze twijfel weg te nemen:

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

Dit eindpunt retourneert de propagatiestatus van de sleutel. Wacht tot de propagatie is voltooid voordat u de sleutel in productie gebruikt, vooral na het wijzigen van ACL’s.

Veelvoorkomende scenario’s

Een ontwikkelsleutel opwaarderen voor productie

De overstap naar productie is het meest voorkomende wijzigingsscenario. De reflex om bij deze gelegenheid een nieuwe sleutel te maken, is kostbaar: u moet deze overal implementeren, kluisjes bijwerken, en de oude sleutel blijft eindeloos bestaan. Het verhogen van de limieten op de bestaande sleutel voorkomt dit allemaal.

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

Een vermoedelijk gecompromitteerde sleutel beperken

Bij een vermoeden van misbruik is de volgorde van handelingen belangrijk. Eerst beperken—lege ACL’s, nul snelheidslimieten—stopt het lek in één aanvraag, zonder iets onomkeerbaar te breken. Rotatie komt later, offline, zodra u heeft geïdentificeerd waar de sleutel werd gebruikt. De omgekeerde volgorde laat u achter met een platliggende productieomgeving en een onderzoek dat onder druk moet worden uitgevoerd.

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

Belangrijkste punten

  • GET /auth/teams/{teamId}/api-keys geeft een lijst van alle sleutels weer met paginering en ACL-filtering
  • PUT /auth/api-keys/{apiKeyId} wijzigt parameters zonder de geheime sleutel te veranderen
  • GET /auth/api-keys/{apiKeyId}/propagation verifieert dat wijzigingen effectief zijn
  • Gebruik ACL-filtering om regelmatig de toegang van uw team te controleren
  • Controleer na elke wijziging de propagatie voordat u de sleutel in productie gebruikt