Validera hanteringsnyckeln
På denna sida
Kontrollera integriteten hos dina nycklar
Validering av hanteringsnyckeln är din API-infrastrukturs första försvarslinje. Innan du utför någon kritisk åtgärd – som distribution, rotation eller ändringar i fakturering – måste du verifiera att din nyckel är giltig och att behörigheterna är korrekta.
Valideringsendpoint
GET /auth/management-keys/validation
curl "https://management-api.x.ai/auth/management-keys/validation" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Svaret bekräftar att nyckeln är aktiv och returnerar teamet, behörigheterna samt associerade datum. Förbise inte utgångsdatumet: detta är den enda informationen som låter dig förutse ett avbrott istället för att drabbas av det, eftersom en utgången nyckel inte varnar dig – den returnerar helt enkelt 401 vid det första anropet som följer.
Felhantering
- 401 Unauthorized: Nyckeln är ogiltig, har löpt ut eller har raderats
- 403 Forbidden: Nyckeln är giltig men saknar nödvändiga behörigheter för den begärda åtgärden
Integrera i dina skript
Verifiering vid start
Att validera vid start flyttar misslyckanden till där de kostar minst. Utan denna kontroll manifesteras en ogiltig nyckel vid det första användbara anropet – det vill säga mitt under bearbetning, ibland efter att flera steg redan har exekverats. Med kontrollen stoppas skriptet på tre sekunder med ett meddelande som anger orsaken.
import requests
import sys
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
def validate_management_key():
"""Kontrollerar att hanteringsnyckeln är giltig."""
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("Hanteringsnyckeln är giltig")
return True
elif response.status_code == 401:
print("FEL: Hanteringsnyckeln är ogiltig eller har löpt ut")
return False
else:
print(f"FEL: Oväntad status {response.status_code}")
return False
except requests.exceptions.RequestException as e:
print(f"ANSVLUTNINGSFEL: {e}")
return False
if not validate_management_key():
sys.exit(1)
Periodisk hälsokontroll
Den periodiska hälsokontrollen täcker det som startvalideringen missar: långlivade tjänster som startades för veckor sedan, vars nyckel kan löpa ut eller återkallas under tiden. En timvis kontroll räcker – endpointen är lättviktig och förbrukar inga inferenstokens.
#!/bin/bash
# healthcheck-xai.sh — kör varje timme 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 "ALARM: xAI-hanteringsnyckel ogiltig (HTTP $STATUS)"
# Skicka en avisering (PagerDuty, Slack, e-post)
fi
Granskning av inferensnycklar
Periodisk granskning besvarar tre frågor som inget larm ställer åt dig: vilka nycklar som fortfarande har wildcard-åtkomst, vilka som saknar hastighetsbegränsningar och vilka som inte använts på månader. De två första utgör risker, den tredje en möjlighet att städa upp – och alla tre hanteras i ett enda svep.
import requests
from datetime import datetime
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
def audit_api_keys():
"""Granskar alla API-nycklar för teamet."""
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"=== Granskning av API-nycklar — {datetime.now().strftime('%d/%m/%Y %H:%M')} ===")
print(f"Totalt antal nycklar: {len(keys)}")
for key in keys:
name = key.get("name", "Namnlös")
acls = key.get("acls", [])
expire = key.get("expireTime", "Aldrig")
created = key.get("createdAt", "Ej tillgängligt")
# Varningar
warnings = []
# Nyckel med wildcard-åtkomst
if "api-key:endpoint:*" in acls and "api-key:model:*" in acls:
warnings.append("FULL ÅTKOMST (wildcards)")
# Nyckel utan utgångsdatum
if expire == "Never" or not expire:
warnings.append("INGET UTGÅNGSDATUM")
# Nyckel utan hastighetsbegränsningar
if not key.get("qps") and not key.get("qpm"):
warnings.append("INGA HASTIGHETSBGRÄNSNINGAR")
status = " | ".join(warnings) if warnings else "OK"
print(f" [{name}] ACL: {len(acls)} | Upphör: {expire} | {status}")
audit_api_keys()
Checklista för nyckelsäkerhet
Hanteringsnycklar
Hanteringsnycklar styr allt annat – om de äventyras ger de åtkomst att skapa, modifiera och radera alla inferensnycklar. De kräver därför den striktaste hanteringen: exklusiv lagring i ett valv, aldrig som klartext i kod eller versionshanterad konfiguration; åtkomst begränsad enbart till infrastrukturadministratörer, inte applikationsutvecklare; och regelbunden validering via GET /auth/management-keys/validation, helst automatiserad som en hälsokontroll – en utgången hanteringsnyckel som upptäcks när du akut behöver den är det värsta operativa scenariot.
Inferensnycklar (API-nycklar)
För inferensnycklar är den ledande principen isolering: varje applikation får sin egen nyckel, aldrig en nyckel som delas mellan tjänster – annars bryter rotation av en äventyrad nyckel alla tjänster på en gång, och analysen tillåter inte längre attribuering av konsumtion. Varje nyckel har restriktiva ACL:er kalibrerade efter faktisk användning (inga wildcards i produktion), hastighetsbegränsningar anpassade för förväntad trafik och ett utgångsdatum när användningen är tillfällig – ett POC som ska pågå i två veckor behöver ingen evig nyckel. Regelbunden granskning via skriptet ovan sluter cirkeln: det avslöjar bortglömda, överprivilegierade eller snart utgående nycklar innan de blir problem.
Principen om åtskillnad av uppgifter
Upprätthåll en tydlig åtskillnad mellan nycklar:
| Typ | Användning | Vem har åtkomst |
|---|---|---|
| Hanteringsnyckel | Administration, fakturering, analys | Infrastrukturadministratörer |
| Produktionsnyckel | API-anrop i produktion | Produktionsapplikation |
| Testnyckel | Testning före produktion | Utvecklingsteamet |
| Utvecklingsnyckel | Lokal utveckling | Individuell utvecklare |
Varje nyckel har ett definierat omfång. Om en utvecklare lämnar teamet raderas endast dennes utvecklingsnyckel – de andra förblir intakta.
Viktiga punkter
GET /auth/management-keys/validationkontrollerar giltigheten hos din hanteringsnyckel- Integrera validering i dina skript vid start och i övervakningen
- Granska regelbundet alla nycklar för att upptäcka alltför bred åtkomst
- Separera nycklar efter miljö och ansvarsområde
- Avisera omedelbart vid en ogiltig nyckel (utgången eller raderad)