Spring til hovedindhold
Dansk— Vælg et sprog
Menu

ACL'er og princippet om mindst privilegium

Lektion 8 af 12 Opdateret 28. juli 2026 Avanceret
På denne side
  1. Princippet om mindst privilegium anvendt på API’er
  2. xAI’s ACL-system
  3. Rate Limits: Et yderligere sikkerhedslag
  4. En nøglestrategi per miljø
  5. Verificér og revidér rettigheder
  6. Vigtige pointer

Princippet om mindst privilegium anvendt på API’er

Princippet om mindst privilegium er et af de ældste koncepter inden for cybersikkerhed: hver komponent i et system bør kun have adgang til de ressourcer, der er strengt nødvendige for dets drift. Ideen er intuitiv, når du overfører den til den fysiske verden – du giver ikke hovednøglen til bygningen til personen, der vander planterne i lobbyen. Anvendt på xAI API-nøgler betyder det, at hver nøgle skal begrænses til kun de endpoints og modeller, som applikationen, der bærer den, faktisk har brug for. Hvis denne nøgle nogensinde lækker, arver angriberen dens rettigheder: en nøgle, der er begrænset til chat med en enkelt model, forårsager uendeligt meget mindre skade end en nøgle, der åbner hele kataloget.

xAI implementerer dette princip gennem et granulart ACL-system (Access Control List), som vi vil gennemgå i detaljer nedenfor.

xAI’s ACL-system

ACL’er følger formatet api-key:{type}:{value}. To typer vedrører dig i det daglige: api-key:endpoint:{endpoint} begrænser de tilgængelige endpoints, og api-key:model:{model_id} begrænser de modeller, der kan bruges. Der findes også et jokertegn, api-key:endpoint:*, som giver adgang til alle endpoints – praktisk til udvikling, forbudt i produktion, netop fordi det ophæver fordelen ved mindst privilegium.

De endpoints, du kan autorisere individuelt, er: chat (chat-fuldførelse, langt den mest almindelige), embed (generering af embeddings), image (billedgenerering og redigering), models (konsultation af modelliste), tokenize (tekst-tokenisering), documents (dokumenthåndtering) og sample (sampling).

Lad os se på, hvordan dette ser ud i et realistisk eksempel. Forestil dig en chatbot til kundesupport, der kun bruger grok-4.3-modellen i chat-tilstand. Dens ideelle nøgle ser sådan ud:

{
  "name": "support-chatbot-prod",
  "acls": [
    "api-key:endpoint:chat",
    "api-key:model:grok-4.3"
  ],
  "qps": 5,
  "qpm": 100,
  "tpm": 500000,
  "expireTime": "2026-12-31T23:59:59Z"
}

Læs denne konfiguration som en kontrakt: nøglen kan kun få adgang til chat-endpointet – ingen billeder, ingen embeddings, så ingen mulig misbrug til disse formål. Den kan kun bruge grok-4.3, hvilket forhindrer utilsigtede (eller ondsindede) kald til dyrere modeller. Den er begrænset til 5 forespørgsler pr. sekund og 100 pr. minut, og den udløber på en kendt dato. Hvis en udvikler på projektet nogensinde forsøger at tilføje billedgenerering uden at fortælle det til nogen, vil API’et nægte: den tekniske begrænsning håndhæver den arkitektoniske beslutning.

Rate Limits: Et yderligere sikkerhedslag

ACL’er besvarer spørgsmålet “hvad”, rate limits besvarer “hvor meget”. QPS (Queries Per Second) sætter loft over forespørgsler pr. sekund: dette er din sikkerhedsforanstaltning mod utilsigtede toppe – den uendelige løkke introduceret af en refaktorering en fredag aften, eller et DDoS-angreb, der preller af på din applikation. QPM (Queries Per Minute) udjævner trafikken over en længere periode og fanger misbrug, der ville holde sig under QPS-radaren. TPM (Tokens Per Minute) sætter endelig loft over volumenet af forbrugte tokens: det beskytter mod meget lange individuelle forespørgsler – en bruger, der indsætter et dokument på 200 sider i din chatbot – som ville tømme dit budget på få minutter uden nogensinde at overskride det autoriserede antal forespørgsler.

En nøglestrategi per miljø

I praksis konfigurerer du ikke en enkelt nøgle, men en familie af nøgler, og hvert miljø har sin egen logik. I udvikling vender du produktionslogikken på hovedet: bred adgang, stramme grænser.

{
  "name": "dev-team-alpha",
  "acls": ["api-key:endpoint:*", "api-key:model:*"],
  "qps": 2,
  "qpm": 30,
  "tpm": 100000,
  "expireTime": "2026-06-30T23:59:59Z"
}

Udviklere kan udforske alt, men lave grænser undgår overraskelser på fakturaen, hvis en test går galt. I staging derimod replikerer du produktions-ACL’erne nøjagtigt (api-key:endpoint:chat, api-key:model:grok-4.3, QPS 5, QPM 100, TPM 500000): dette er den eneste måde at opdage et rettighedsproblem upstream på – hvis staging-koden forsøger et kald, som produktionen vil nægte, er det bedre at opdage det nu end i den første time efter go-live. Produktionsnøglen kombinerer dog stagings strikse rettigheder med grænser, der er dimensioneret til rigtig trafik (f.eks. QPS 20, QPM 600, TPM 2000000) og en planlagt udløbsdato – "expireTime": "2027-03-31T23:59:59Z" på en nøgle ved navn prod-chatbot-v2.

Verificér og revidér rettigheder

For at se, hvad en aktiv nøgle faktisk har lov til at gøre, skal du spørge API’et med selve nøglen:

curl https://api.x.ai/v1/api-key \
  -H "Authorization: Bearer $XAI_API_KEY"

Svaret lister de effektive ACL’er, statusserne api_key_blocked og api_key_disabled, en maskeret version af nøglen (redacted_api_key) og team_id. Gør det til en vane regelmæssigt at sammenligne disse ACL’er med applikationens faktiske behov: rettigheder har tendens til at ophobe sig over tid, de krymper aldrig spontant. På modelsiden returnerer endpointet GET /auth/teams/{teamId}/models listen over modeller, der er tilgængelige for dit team, med deres priser – værdifuld information til at definere relevante model-ACL’er og udelukke dyre modeller, du ikke bruger.

For at cementere alt dette skal du udføre en fuld revision af dine nøgler. List aktive nøgler op for hvert team, og spørg derefter hver enkelt: Er dens ACL’er minimale, uden jokertegn i produktion? Er dens rate limits rimelige? Er dens udløbsdato sat? Identificerer dens navn applikationen og miljøet – „prod-chatbot-v2” fortæller en historie, „key-test-2” fortæller ingen? Slet forældreløse nøgler og dokumentér resultatet: dette dokument vil tjene som udgangspunkt for næste revision, og du vil ved et øjekast kunne se, hvad der er afveget i mellemtiden.

Vigtige pointer

  • Hver nøgle skal have restriktive ACL’er: kun nødvendige endpoints og modeller
  • Brug aldrig et * jokertegn i produktion
  • Kombinér ACL’er med rate limits (QPS, QPM, TPM) tilpasset den faktiske brug
  • Opret særskilte nøgler per miljø (dev, staging, prod) og per applikation – staging med samme ACL’er som prod
  • Revidér regelmæssigt rettighederne på dine aktive nøgler via GET /v1/api-key