Sikkerhedsbestemmelser
På denne side
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:
| Risikoniveau | Rotationsfrekvens | Eksempler |
|---|---|---|
| Høj | Hver 30. dag | Nøgler med fuld adgang (wildcard) |
| Mellem | Hver 90. dag | Produktionsnøgler med begrænsede ACL’er |
| Lav | Hver 180. dag | Lokale 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.