Validering af administrationsnøglen
På denne side
Verificér integriteten af dine nøgler
Validering af administrationsnøglen er din API-infrastrukturs første forsvarslinje. Før enhver kritisk operation – deployment, rotation eller ændringer i fakturering – skal du verificere, at din nøgle er gyldig, og at dens tilladelser er korrekte.
Valideringsendpoint
GET /auth/management-keys/validation
curl "https://management-api.x.ai/auth/management-keys/validation" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Svaret bekræfter, at nøglen er aktiv, og returnerer teamet, tilladelserne samt de tilknyttede datoer. Overset ikke udløbsdatoen: Dette er den eneste information, der lader dig forudsige en nedetid i stedet for at lide under den, da en udløbet nøgle ikke advarer dig – den returnerer blot 401 ved det første kald, der følger efter.
Fejltilfælde
- 401 Unauthorized: Nøglen er ugyldig, udløbet eller blevet slettet
- 403 Forbidden: Nøglen er gyldig, men mangler de nødvendige tilladelser til den anmodede operation
Integrering i dine scripts
Verificering ved opstart
Validering ved opstart flytter fejlen til det tidspunkt, hvor det koster mindst. Uden denne tjek manifesterer en ugyldig nøgle sig ved det første nyttige kald – det vil sige midt i behandlingen, nogle gange efter flere trin allerede er blevet udført. Med tjekket stopper scriptet på tre sekunder med en besked, der navngiver årsagen.
import requests
import sys
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
def validate_management_key():
"""Checks that the management key is valid."""
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("Management key valid")
return True
elif response.status_code == 401:
print("ERROR: Management key invalid or expired")
return False
else:
print(f"ERROR: Unexpected status {response.status_code}")
return False
except requests.exceptions.RequestException as e:
print(f"CONNECTION ERROR: {e}")
return False
if not validate_management_key():
sys.exit(1)
Periodisk helbredstjek
Det periodiske helbredstjek dækker det, som validering ved opstart overser: langtkørende tjenester, der er startet for uger siden, og hvis nøgle kan udløbe eller blive tilbagekaldt undervejs. Et timevist tjek er nok – endpointet er letvægts og bruger ingen inference-tokens.
#!/bin/bash
# healthcheck-xai.sh — run every hour 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 management key invalid (HTTP $STATUS)"
# Send an alert (PagerDuty, Slack, email)
fi
Revision af inference-nøgler
Periodisk revision besvarer tre spørgsmål, som ingen alarm vil stille for dig: Hvilke nøgler har stadig et jokertegn (wildcard)? Hvilke har ingen hastighedsbegrænsninger? Og hvilke er ikke blevet brugt i måneder? De to første er risici, den tredje en mulighed for oprydning – og alle tre håndteres i ét gennemløb.
import requests
from datetime import datetime
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
def audit_api_keys():
"""Audits all API keys for the 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 Key Audit — {datetime.now().strftime('%d/%m/%Y %H:%M')} ===")
print(f"Total number of keys: {len(keys)}")
for key in keys:
name = key.get("name", "Unnamed")
acls = key.get("acls", [])
expire = key.get("expireTime", "Never")
created = key.get("createdAt", "N/A")
# Alerts
warnings = []
# Key with wildcard access
if "api-key:endpoint:*" in acls and "api-key:model:*" in acls:
warnings.append("TOTAL ACCESS (wildcards)")
# Key without expiration
if expire == "Never" or not expire:
warnings.append("NO EXPIRATION")
# Key without rate limits
if not key.get("qps") and not key.get("qpm"):
warnings.append("NO RATE LIMITS")
status = " | ".join(warnings) if warnings else "OK"
print(f" [{name}] ACLs: {len(acls)} | Expire: {expire} | {status}")
audit_api_keys()
Tjekliste for nøglesikkerhed
Administrationsnøgler
Administrationsnøgler styrer alt andet – deres kompromittering giver adgang til at oprette, modificere og slette alle inference-nøgler. De kræver derfor den strengeste håndtering: eksklusiv opbevaring i et hvælv (vault), aldrig som klartekst i kode eller versioneret konfiguration; adgang begrænset udelukkende til infrastrukturadministratorer, ikke applikationsudviklere; og regelmæssig validering via GET /auth/management-keys/validation, ideelt automatiseret som et helbredstjek – en udløbet administrationsnøgle opdaget, når du har akut brug for den, er det værste operationelle scenarie.
Inference-nøgler (API-nøgler)
For inference-nøgler er det ledende princip isolering: Hver applikation modtager sin egen nøgle, aldrig en nøgle delt mellem tjenester – ellers vil rotation af en kompromitteret nøgle bryde alle tjenester på én gang, og analyser vil ikke længere tillade tilskrivning af forbrug. Hver nøgle har restriktive ACL’er kalibreret til dens faktiske brug (ingen jokertegn i produktion), hastighedsbegrænsninger dimensioneret til forventet trafik og en udløbsdato, når brugen er midlertidig – en POC beregnet til at vare to uger behøver ikke en evig nøgle. Regelmæssig revision via scriptet ovenfor lukker sløjfen: Det afslører glemte, overprivilegerede eller udløbende nøgler, før de bliver til problemer.
Princippet om adskillelse af opgaver
Oprethold en klar adskillelse mellem nøgler:
| Type | Brug | Hvem har adgang |
|---|---|---|
| Administrationsnøgle | Administration, fakturering, analyser | Infrastrukturadministratorer |
| Prod-nøgle | API-kald i produktion | Produktionsapplikation |
| Staging-nøgle | Test før produktion | Udviklingsteam |
| Dev-nøgle | Lokal udvikling | Individuel udvikler |
Hver nøgle har et defineret omfang. Hvis en udvikler forlader teamet, slettes kun deres dev-nøgle – de andre forbliver intakte.
Vigtige pointer
GET /auth/management-keys/validationtjekker gyldigheden af din administrationsnøgle- Integrér validering i dine scripts ved opstart og i overvågningen
- Revidér regelmæssigt alle nøgler for at opdage alt for bred adgang
- Adskil nøgler efter miljø og ansvar
- Giv straks alarm ved en ugyldig nøgle (udløbet eller slettet)