Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Sikkerhedsbestemmelser

Lektion 14 af 14 Opdateret 29. juli 2026 Udvikler
På denne side
  1. Sikr din brug af Grok API
  2. Håndtering af hemmeligheder
  3. Regelmæssig rotation
  4. Princippet om mindste privilegium
  5. Revision og overvågning
  6. Komplet sikkerhedstjekliste
  7. Vigtige pointer
  8. Test din viden

Sikr din brug af Grok API

En Management API-nøgle er ikke som andre nøgler: den bruger ikke tokens, den opretter og tilbagekalder dem, der gør. Den, der har den, kan åbne adgang, hæve grænser og belaste dit team med udgifterne. Derfor er praksisserne nedenfor ikke valgfri hygiejne: de er forskellen på en hændelse, der er indeholdt på en time, og en regning, du opdager ved månedens udgang.

Fire områder strukturerer denne lektion, og de understøtter hinanden: hvor hemmeligheder opbevares, hvor ofte de ændres, hvad præcist de autoriserer, og hvordan du bemærker, når noget er galt. Ingen af dem er tilstrækkelige alene – en perfekt opbevaret nøgle med wildcard-tilladelser er stadig en farlig nøgle.

Håndtering af hemmeligheder

Grundregel: Aldrig i klartekst

En nøgle må aldrig skrives i klartekst, hvor den kan kopieres, indekseres eller gemmes uden din eksplicitte beslutning. Kodelagre topper listen, selv private: et privat lager bliver offentligt ved et uheld, skifter ejere, eller forbliver i en tredjeparts værktøjscache – og Git-historik glemmer intet, så en hemmelighed, der er commit’et én gang, forbliver genfindelig, selv efter filen er slettet.

De tre andre klassiske lækager er mere snigende, fordi de ikke ligner lagring. Applikationslogs fanger villigt en fuld header under fejlfinding og sender den derefter til en aggregator, som hele teamet kan se. URL’er i query-parametre passerer proxyer og ender i access-loggene hos hver mellemmand. Og en nøgle, der indsættes i en Slack-besked eller ticket, bliver der uendeligt, synlig for personer, der ikke var på teamet den dag, den blev delt. I alle fire tilfælde blev nøglen ikke “stjålet”: den blev kopieret af systemer, der gjorde deres job.

Anbefalede hvælvinger

Bagsiden af denne regel er, at nøgler需要一个 legitimt sted at bo. En hemmelighedshåndterer (secrets manager) opfylder tre funktioner, som en fil aldrig vil: den krypterer i hvile, den sporer, hvem der læste hvad, og den lader dig erstatte en værdi uden at genudgive applikationen. Valget afhænger mest af din eksisterende infrastruktur – at bruge din cloud-udbyders værktøj sparer dig for endnu en integration.

  • HashiCorp Vault: Komplet løsning med automatisk rotation, adgangspolitikker, revisionsspor
  • AWS Secrets Manager: Nativer integration med AWS-økosystemet, automatisk rotation
  • Google Secret Manager: GCP-modstykke, integration med Cloud Run og GKE
  • Azure Key Vault: Microsoft Azure-løsning
  • Doppler: Cloud-uafhængig løsning, simpelt interface
  • 1Password / Bitwarden: Til små team, inkluderer CLI

Anbefalet konfiguration

# Dårligt: hardcodet nøgle i et script
MANAGEMENT_API_KEY="xai-mgmt-abc123..."  # GØR IKKE DETTE

# Godt: hent fra en hvælving
MANAGEMENT_API_KEY=$(vault kv get -field=key secret/xai/management)

# Godt: miljøvariabel injiceret af CI/CD
# Nøglen er konfigureret i pipeline-hemmeligheder (GitHub Actions, GitLab CI osv.)

Regelmæssig rotation

Rotationspolitik

Definér en rotationspolitik tilpasset din kontekst:

RisikoniveauRotationsfrekvensEksempler
HøjHver 30. dagNøgler med fuld adgang (wildcard)
MellemHver 90. dagProduktionsnøgler med begrænsede ACL’er
LavHver 180. dagLokale udviklingsnøgler

Automatisér rotation

import requests
from datetime import datetime, timedelta

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
ROTATION_DAYS = 90  # Roter hver 90. dag

def check_and_rotate():
    """Tjekker nøglealder og roterer om nødvendigt."""
    response = requests.get(
        f"{MANAGEMENT_API}/auth/teams/{TEAM_ID}/api-keys",
        headers={"Authorization": f"Bearer {MGMT_KEY}"}
    )
    keys = response.json().get("apiKeys", [])
    now = datetime.now()

    for key in keys:
        created = datetime.fromisoformat(key.get("createdAt", "").replace("Z", "+00:00"))
        age_days = (now - created.replace(tzinfo=None)).days

        if age_days >= ROTATION_DAYS:
            key_id = key.get("id")
            name = key.get("name", "Unnamed")
            print(f"Rotation krævet for [{name}] (alder: {age_days} dage)")

            # Udfør rotation
            rotate_resp = requests.post(
                f"{MANAGEMENT_API}/auth/api-keys/{key_id}/rotate",
                headers={"Authorization": f"Bearer {MGMT_KEY}"}
            )

            if rotate_resp.status_code == 200:
                new_secret = rotate_resp.json().get("secret")
                print(f"  Ny nøgle genereret. Opdater din hvælving.")
                # Gem new_secret i din hvælving
            else:
                print(f"  Rotationsfejl: {rotate_resp.status_code}")

check_and_rotate()

Princippet om mindste privilegium

Granulære ACL’er

Mindste privilegium handler om at besvare ét præcist spørgsmål: hvis denne nøgle lækker i morgen, hvad kan en tredjepart så gøre med den? En nøgle begrænset til chat-endpointet og en enkelt model giver et kort svar. En nøgle med et wildcard giver et svar, der starter med “alt”. Omkostningen ved begrænsning er nul, når du opretter nøglen, og det er netop derfor, du skal sætte den på det tidspunkt snarere end efter hændelsen.

{
  "acls": ["api-key:endpoint:chat", "api-key:model:grok-4.3"],
  "qps": 10,
  "qpm": 100
}

Undgå wildcards (*) i produktion. Hvis din applikation kun bruger chat med en enkelt model, så giv kun adgang til netop det.

Hastighedsgrænser som sikkerhedsnet

ACL’er siger hvad nøglen kan gøre; hastighedsgrænser siger hvor meget. Distinktionen er vigtig, fordi en legitimt begrænset chat-nøgle stadig kan generere en betydelig regning, hvis ingen sætter loft over dens gennemstrømning. Indstil qps, qpm og tpm på hver nøgle, kalibreret til faktisk brug snarere end tænkelige toppe: en applikation, der håndterer ti forespørgsler i sekundet ved spidsbelastning, har ingen grund til at være autoriseret til tusind. Dette loft beskytter dig ikke mod et læk, men det gør en katastrofal udgift til en indeholdt én, og det køber dig tid til at opdage anomalien, før den koster dyrt.

Revision og overvågning

Revisionslogs

Før en journal over alle management-operationer:

import logging
from datetime import datetime

# Konfigurér logging
logging.basicConfig(
    filename="/var/log/xai-management-audit.log",
    level=logging.INFO,
    format="%(asctime)s | %(levelname)s | %(message)s"
)

def log_operation(operation, key_name, details=""):
    """Logger en management-operation til revisionsjournalen."""
    logging.info(f"{operation} | Nøgle: {key_name} | {details}")

# Brugseksempler
log_operation("CREATE", "prod-backend-v2", "ACL'er: chat+embed, QPS: 50")
log_operation("ROTATE", "prod-backend-v2", "Planlagt rotation 90d")
log_operation("DELETE", "dev-former-intern", "Team-afgang")

Sikkerhedsadvarsler

En log er kun nyttig til undersøgelse; det, der beskytter dig i realtid, er advarslen. Princippet for at vælge, hvad der skal overvåges, er simpelt: giv advarsel ved begivenheder, der ingen grund har til at ske under normal drift, for det er de eneste, hvis falske positiv-rate vil forblive lav nok til, at teamet fortsætter med at læse dem. Fem signaler fortjener denne status.

  • Nøgle med wildcards oprettet i produktion
  • Login-forsøg med en ugyldig nøgle (spike i 401’er)
  • Unormalt forbrug opdaget (uventet spike)
  • Faktura i status FAILED (risiko for serviceafbrydelse)
  • Nøgle nær udløb (7 dage før)

Komplet sikkerhedstjekliste

Her er, kondenseret, hvad de fire områder giver i praksis. Denne liste er kun værdifuld, hvis den gennemgås på det rigtige tidspunkt: den første del ved udrulning, den anden med jævne mellemrum, den tredje den dag, du opdager, at en nøgle er lækket – den dag, hvor ingen vil have roen til at improvisere en procedure.

Indledende udrulning

  • Nøgler gemt i en hvælving, aldrig i klartekst
  • Begrænsende ACL’er (ingen wildcards i produktion)
  • Hastighedsgrænser konfigureret for hver nøgle
  • Automatisk healthcheck af management-nøgle
  • Script til nøglerevision på plads

Regelmæssig drift

  • Roter nøgler efter defineret politik (30/90/180 dage)
  • Månedlig revision af nøgler og deres tilladelser
  • Gennemgang af nøgler, når et teammedlem forlader virksomheden
  • Tjek fakturaer (opdag FAILED-statusser)
  • Overvåg unormale forbrugsspike

Håndtering af hændelser

  • Dokumenteret nødprocedure for rotation
  • Evne til straks at begrænse ACL’er (via PUT)
  • Evne til at slette en kompromitteret nøgle (via DELETE)
  • Identificerede nødkontakter (sikkerhedsteam, xAI-support)

Vigtige pointer

  • Gem alle nøgler i en hemmelighedshvælving – aldrig klartekst i kode
  • Anvend mindste privilegium: begrænsede ACL’er, ingen wildcards i produktion
  • Automatisér nøglerotation efter defineret politik (30 til 180 dage)
  • Opsæt regelmæssige revisioner og advarsler for kritiske begivenheder
  • Dokumentér din procedure for håndtering af hændelser ved kompromitterede nøgler
  • Kombinér begrænsede ACL’er, hastighedsgrænser og udgiftslofter for flerlagsbeskyttelse

Test din viden

Styring af nøgler, fakturering og brug via API’et: turen er komplet.

1. Hvad er Management API til?

Svar: Til administrativt at styre din xAI-konto programmatisk: API-nøgler (opret, modificér, rotér, slet), fakturering, grænser og analyser – administration bliver scriptbar.

2. Hvordan sikrer du nøglernes livscyklus?

Svar: Én nøgle pr. brugstilfælde, regelmæssig rotation (opret ny, skift, slet gammel) og øjeblikkelig sletning ved tvivl – alt sammen automatiserbart via API’et.

3. Hvilke finansielle sikkerhedsforanstaltninger kan du sætte ind?

Svar: Udgrænsninger, forudbetalte kreditter og overvågede automatiske genopfyldninger – budgetkontrol via konfiguration, ikke regningsoverraskelser.

4. Hvad giver brugsanalyser?

Svar: Forbrug pr. nøgle og pr. model, avancerede rapporter – nok til at fordele omkostninger, opdage anomalier og dimensionere niveauer.

5. Hvilken særlig forholdsregel for selve management-nøglen?

Svar: Det er nøglernes nøgle: maksimalt omfang, så maksimal beskyttelse – aldrig klient-side, begrænset adgang, regelmæssig validering og rotation som de andre.

Styrede nøgler, afgrænset budget, målt brug: xAI-administration er kodet – og sikret på niveau med det, den beskytter.