Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Validering af administrationsnøglen

Lektion 13 af 14 Opdateret 29. juli 2026 Udvikler
På denne side
  1. Verificér integriteten af dine nøgler
  2. Valideringsendpoint
  3. Integrering i dine scripts
  4. Revision af inference-nøgler
  5. Tjekliste for nøglesikkerhed
  6. Princippet om adskillelse af opgaver
  7. Vigtige pointer

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:

TypeBrugHvem har adgang
AdministrationsnøgleAdministration, fakturering, analyserInfrastrukturadministratorer
Prod-nøgleAPI-kald i produktionProduktionsapplikation
Staging-nøgleTest før produktionUdviklingsteam
Dev-nøgleLokal udviklingIndividuel 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/validation tjekker 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)