Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Validera hanteringsnyckeln

Lektion 13 av 14 Uppdaterad 29 juli 2026 Utvecklare
På denna sida
  1. Kontrollera integriteten hos dina nycklar
  2. Valideringsendpoint
  3. Integrera i dina skript
  4. Granskning av inferensnycklar
  5. Checklista för nyckelsäkerhet
  6. Principen om åtskillnad av uppgifter
  7. Viktiga punkter

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:

TypAnvändningVem har åtkomst
HanteringsnyckelAdministration, fakturering, analysInfrastrukturadministratörer
ProduktionsnyckelAPI-anrop i produktionProduktionsapplikation
TestnyckelTestning före produktionUtvecklingsteamet
UtvecklingsnyckelLokal utvecklingIndividuell 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/validation kontrollerar 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)