Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

ACL:er och principen om minsta privilegium

Lektion 8 av 12 Uppdaterad 28 juli 2026 Avancerad
På denna sida
  1. Principen om minsta privilegium tillämpad på API:er
  2. xAI:s ACL-system
  3. Hastighetsbegränsningar: Ett ytterligare säkerhetslager
  4. En nyckelstrategi per miljö
  5. Verifiera och granska behörigheter
  6. Viktiga punkter

Principen om minsta privilegium tillämpad på API:er

Principen om minsta privilegium är ett av de äldsta koncepten inom cybersäkerhet: varje komponent i ett system ska endast ha åtkomst till de resurser som är strikt nödvändiga för dess funktion. Idén är intuitiv när du överför den till den fysiska världen – du ger inte huvudnyckeln till hela byggnaden till personen som vattnar växterna i lobbyn. Tillämpat på xAI API-nycklar betyder detta att varje nyckel måste begränsas till endast de slutpunkter och modeller som applikationen som bär den faktiskt behöver. Om denna nyckel någonsin läcker, ärver angriparen dess behörigheter: en nyckel som är begränsad till chatt med en enda modell orsakar oändligt mycket mindre skada än en nyckel som öppnar hela katalogen.

xAI implementerar denna princip genom ett granulerat ACL-system (Access Control List), som vi går igenom nedan.

xAI:s ACL-system

ACL:er följer formatet api-key:{type}:{value}. Två typer berör dig i det dagliga arbetet: api-key:endpoint:{endpoint} begränsar tillgängliga slutpunkter, och api-key:model:{model_id} begränsar användbara modeller. Det finns också ett jokertecken, api-key:endpoint:*, som ger åtkomst till alla slutpunkter – bekvämt för utveckling, förbjudet i produktion, just för att det upphäver fördelen med minsta privilegium.

De slutpunkter du kan auktorisera individuellt är: chat (chattkomplettering, långt den vanligaste), embed (generering av inbäddningar), image (bildgenerering och redigering), models (konsultering av modellista), tokenize (texttokenisering), documents (dokhantering) och sample (sampling).

Låt oss se hur detta ser ut i ett verkligt exempel. Tänk dig en chattbot för kundsupport som endast använder modellen grok-4.3 i chattläge. Dess idealiska nyckel ser ut så här:

{
  "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 denna konfiguration som ett kontrakt: nyckeln kan bara komma åt chattslutpunkten – inga bilder, inga inbäddningar, så ingen möjlig missbruk för dessa ändamål. Den kan bara använda grok-4.3, vilket förhindrar oavsiktliga (eller illvilliga) anrop till dyrare modeller. Den är begränsad till 5 förfrågningar per sekund och 100 per minut, och den löper ut på ett känt datum. Om en utvecklare på projektet någonsin försöker lägga till bildgenerering utan att tala om det, kommer API:t att vägra: den tekniska begränsningen upprätthåller det arkitektoniska beslutet.

Hastighetsbegränsningar: Ett ytterligare säkerhetslager

ACL:er svarar på frågan “vad”, hastighetsbegränsningar svarar på “hur mycket”. QPS (Queries Per Second) sätter ett tak för förfrågningar per sekund: detta är ditt skydd mot oavsiktliga toppar – den oändliga slingan som introducerades av en refaktorering en fredagskväll, eller en DDoS-attack som studsar mot din applikation. QPM (Queries Per Minute) jämnar ut trafiken över en längre period och fångar missbruk som skulle hålla sig under QPS-radarn. TPM (Tokens Per Minute) sätter slutligen ett tak för volymen konsumerade token: det skyddar mot mycket långa enskilda förfrågningar – en användare som klistrar in ett dokument på 200 sidor i din chattbot – som skulle tömma din budget på minuter utan att någonsin överskrida det tillåtna antalet förfrågningar.

En nyckelstrategi per miljö

I praktiken konfigurerar du inte en enda nyckel utan en familj av nycklar, och varje miljö har sin egen logik. I utveckling vänder du på produktionslogiken: bred åtkomst, strikta 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"
}

Utvecklare kan utforska allt, men låga gränser undviker överraskningar på fakturan om ett test går fel. I staging, å andra sidan, replikerar du produktions-ACL:erna exakt (api-key:endpoint:chat, api-key:model:grok-4.3, QPS 5, QPM 100, TPM 500000): detta är det enda sättet att upptäcka ett behörighetsproblem i förväg – om staging-koden försöker göra ett anrop som produktionen kommer att vägra, är det bättre att upptäcka det nu än under den första timmen efter lansering. Produktionsnyckeln kombinerar dock stagings strikta behörigheter med gränser anpassade för verklig trafik (till exempel QPS 20, QPM 600, TPM 2000000) och ett schemalagt utgångsdatum – "expireTime": "2027-03-31T23:59:59Z" på en nyckel som heter prod-chatbot-v2.

Verifiera och granska behörigheter

För att se vad en aktiv nyckel faktiskt får göra, fråga API:t med nyckeln själv:

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

Svaret listar effektiva ACL:er, statusarna api_key_blocked och api_key_disabled, en maskerad version av nyckeln (redacted_api_key) och team_id. Gör det till en vana att regelbundet jämföra dessa ACL:er med applikationens faktiska behov: behörigheter tenderar att ackumuleras över tid, de krymper aldrig spontant. På modellsidan returnerar slutpunkten GET /auth/teams/{teamId}/models listan över modeller som är tillgängliga för ditt team med deras prissättning – värdefull information för att definiera relevanta modell-ACL:er och utesluta dyra modeller du inte använder.

För att cementera allt detta, genomför en fullständig granskning av dina nycklar. Lista aktiva nycklar för varje team, fråga sedan var och en: är dess ACL:er minimala, utan jokertecken i produktion? Är dess hastighetsbegränsningar rimliga? Är dess utgångsdatum inställt? Identifierar dess namnet applikationen och miljön – “prod-chatbot-v2” berättar en historia, “key-test-2” berättar ingen? Ta bort övergivna nycklar och dokumentera resultatet: detta dokument kommer att tjäna som utgångspunkt för nästa granskning, och du kommer vid en första anblick att se vad som har drivit iväg under tiden.

Viktiga punkter

  • Varje nyckel måste ha restriktiva ACL:er: endast nödvändiga slutpunkter och modeller
  • Använd aldrig ett jokertecken * i produktion
  • Kombinera ACL:er med hastighetsbegränsningar (QPS, QPM, TPM) anpassade till verklig användning
  • Skapa distinkta nycklar per miljö (dev, staging, prod) och per applikation – staging med samma ACL:er som prod
  • Granska regelbundet behörigheter på dina aktiva nycklar via GET /v1/api-key