De beheersleutel valideren
Op deze pagina
De integriteit van uw sleutels verifiëren
Validatie van de beheersleutel is de eerste verdedigingslinie van uw API-infrastructuur. Verifieer voordat u kritieke bewerkingen uitvoert—zoals implementatie, rotatie of wijzigingen in de facturatie—of uw sleutel geldig is en of de machtigingen correct zijn ingesteld.
Validatie-eindpunt
GET /auth/management-keys/validation
curl "https://management-api.x.ai/auth/management-keys/validation" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Het antwoord bevestigt dat de sleutel actief is en geeft het team, de machtigingen en de bijbehorende datums terug. Negeer de vervaldatum niet: dit is de enige informatie waarmee u een onderbreking kunt anticiperen in plaats van erdoor overvallen te worden. Een verlopen sleutel waarschuwt u namelijk niet; deze retourneert eenvoudigweg een 401-fout bij de eerste daaropvolgende oproep.
Foutgevallen
- 401 Unauthorized: De sleutel is ongeldig, verlopen of verwijderd.
- 403 Forbidden: De sleutel is geldig, maar beschikt niet over de benodigde machtigingen voor de gevraagde bewerking.
Integratie in uw scripts
Verificatie bij opstarten
Validatie bij het opstarten verplaatst fouten naar het moment waarop ze het minst kosten. Zonder deze controle manifesteert een ongeldige sleutel zich pas bij de eerste nuttige oproep—dat wil zeggen midden in de verwerking, soms nadat er al meerdere stappen zijn uitgevoerd. Met deze controle stopt het script binnen drie seconden met een bericht dat de oorzaak benoemt.
import requests
import sys
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
def validate_management_key():
"""Controleert of de beheersleutel geldig is."""
try:
response = requests.get(
f"{MANAGEMENT_API}/auth/management-keys/validation",
headers={"Authorization": f"Bearer {MGMT_KEY}"},
timeout=10
)
if response.status_code == 200:
print("Beheersleutel geldig")
return True
elif response.status_code == 401:
print("FOUT: Beheersleutel ongeldig of verlopen")
return False
else:
print(f"FOUT: Onverwachte status {response.status_code}")
return False
except requests.exceptions.RequestException as e:
print(f"VERBINDINGSFOUT: {e}")
return False
if not validate_management_key():
sys.exit(1)
Periodieke healthcheck
De periodieke healthcheck dekt wat validatie bij het opstarten mist: langlopende services die weken geleden zijn gestart en waarvan de sleutel onderweg kan verlopen of worden ingetrokken. Een uurlijkse controle is voldoende; het eindpunt is lichtgewicht en verbruikt geen inferentietokens.
#!/bin/bash
# healthcheck-xai.sh — elk uur uitvoeren via cron
STATUS=$(curl -s -o /dev/null -w "%{http_code}" \
"https://management-api.x.ai/auth/management-keys/validation" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY")
if [ "$STATUS" != "200" ]; then
echo "ALERT: xAI-beheersleutel ongeldig (HTTP $STATUS)"
# Stuur een melding (PagerDuty, Slack, e-mail)
fi
Inferentiesleutels auditen
Periodiek auditen beantwoordt drie vragen waar geen enkel alarm u voor waarschuwt: welke sleutels nog steeds een jokerteken bevatten, welke geen snelheidslimiet hebben en welke al maanden niet zijn gebruikt. De eerste twee zijn risico’s, de derde een kans om op te ruimen—en alle drie worden in één keer afgehandeld.
import requests
from datetime import datetime
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
def audit_api_keys():
"""Auditeert alle API-sleutels voor het team."""
response = requests.get(
f"{MANAGEMENT_API}/auth/teams/{TEAM_ID}/api-keys",
headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
keys = response.json().get("apiKeys", [])
print(f"=== API-sleutelaudit — {datetime.now().strftime('%d/%m/%Y %H:%M')} ===")
print(f"Totaal aantal sleutels: {len(keys)}")
for key in keys:
name = key.get("name", "Naamloos")
acls = key.get("acls", [])
expire = key.get("expireTime", "Nooit")
created = key.get("createdAt", "N/B")
# Waarschuwingen
warnings = []
# Sleutel met toegang via jokerteken
if "api-key:endpoint:*" in acls and "api-key:model:*" in acls:
warnings.append("VOLLEDIGE TOEGANG (jokertekens)")
# Sleutel zonder vervaldatum
if expire == "Nooit" or not expire:
warnings.append("GEEN VERVALDATUM")
# Sleutel zonder snelheidslimieten
if not key.get("qps") and not key.get("qpm"):
warnings.append("GEEN SNELHEIDSLIMIETEN")
status = " | ".join(warnings) if warnings else "OK"
print(f" [{name}] ACL's: {len(acls)} | Verloopt: {expire} | {status}")
audit_api_keys()
Checklist voor sleutelbeveiliging
Beheersleutels
Beheersleutels besturen alles; als ze worden gecompromitteerd, krijgt een aanvaller toegang om alle inferentiesleutels aan te maken, te wijzigen en te verwijderen. Ze vereisen daarom de strengste behandeling: uitsluitend opslaan in een kluis, nooit als platte tekst in code of versiebeheerde configuratie; toegang beperken tot alleen infrastructuurbeheerders, niet tot applicatieontwikkelaars; en regelmatige validatie via GET /auth/management-keys/validation, bij voorkeur geautomatiseerd als healthcheck. Een verlopen beheersleutel die u ontdekt op het moment dat u deze dringend nodig heeft, is het slechtste operationele scenario.
Inferentiesleutels (API-sleutels)
Voor inferentiesleutels is isolatie het leidende principe: elke applicatie ontvangt zijn eigen sleutel, nooit een sleutel die tussen services wordt gedeeld. Anders breekt het roteren van een gecompromitteerde sleutel namelijk alle services tegelijk, en maken analytics het onmogelijk om verbruik toe te wijzen. Elke sleutel heeft restrictieve ACL’s die zijn afgestemd op het daadwerkelijke gebruik (geen jokertekens in productie), snelheidslimieten die zijn berekend op basis van het verwachte verkeer, en een vervaldatum als het gebruik tijdelijk is—een POC die twee weken moet duren, heeft geen eeuwige sleutel nodig. Regelmatige audit via het bovenstaande script sluit de cirkel: het onthult vergeten, te ruim bevoegde of verloopende sleutels voordat ze tot problemen leiden.
Principe van scheiding van taken
Handhaaf een duidelijke scheiding tussen sleutels:
| Type | Gebruik | Wie heeft toegang |
|---|---|---|
| Beheersleutel | Administratie, facturatie, analytics | Infrastructuurbeheerders |
| Productiesleutel | API-oproepen in productie | Productieapplicatie |
| Staging-sleutel | Testen voor productie | Ontwikkelteam |
| Ontwikkelsleutel | Lokale ontwikkeling | Individuele ontwikkelaar |
Elke sleutel heeft een gedefinieerd bereik. Als een ontwikkelaar het team verlaat, wordt alleen zijn ontwikkelsleutel verwijderd; de anderen blijven intact.
Belangrijkste punten
GET /auth/management-keys/validationcontroleert de geldigheid van uw beheersleutel- Integreer validatie in het opstarten van uw script en in uw monitoring
- Auditeer regelmatig alle sleutels om te brede toegang op te sporen
- Scheid sleutels per omgeving en verantwoordelijkheid
- Waarschuw onmiddellijk bij een ongeldige sleutel (verlopen of verwijderd)