Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

De beheersleutel valideren

Les 13 van 14 Bijgewerkt op 29 juli 2026 Ontwikkelaar
Op deze pagina
  1. De integriteit van uw sleutels verifiëren
  2. Validatie-eindpunt
  3. Integratie in uw scripts
  4. Inferentiesleutels auditen
  5. Checklist voor sleutelbeveiliging
  6. Principe van scheiding van taken
  7. Belangrijkste punten

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:

TypeGebruikWie heeft toegang
BeheersleutelAdministratie, facturatie, analyticsInfrastructuurbeheerders
ProductiesleutelAPI-oproepen in productieProductieapplicatie
Staging-sleutelTesten voor productieOntwikkelteam
OntwikkelsleutelLokale ontwikkelingIndividuele 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/validation controleert 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)