Uw sleutels weergeven en wijzigen
Op deze pagina
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-keysgeeft een lijst van alle sleutels weer met paginering en ACL-filteringPUT /auth/api-keys/{apiKeyId}wijzigt parameters zonder de geheime sleutel te veranderenGET /auth/api-keys/{apiKeyId}/propagationverifieert 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