Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

ACL's en het principe van de minste bevoegdheid

Les 8 van 12 Bijgewerkt op 28 juli 2026 Gevorderd
Op deze pagina
  1. Het principe van de minste bevoegdheid toegepast op API’s
  2. Het ACL-systeem van xAI
  3. Snelheidslimieten: Een extra beveiligingslaag
  4. Een sleutelstrategie per omgeving
  5. Rechten verifiëren en auditeren
  6. Belangrijkste punten

Het principe van de minste bevoegdheid toegepast op API’s

Het principe van de minste bevoegdheid is een van de oudste concepten in cybersecurity: elk onderdeel van een systeem mag alleen toegang hebben tot de bronnen die strikt noodzakelijk zijn voor de werking ervan. Het idee is intuïtief als u het vertaalt naar de fysieke wereld: u geeft de hoofdsleutel van het gebouw niet aan de persoon die de planten in de lobby water geeft. Toegepast op xAI API-sleutels betekent dit dat elke sleutel beperkt moet blijven tot alleen die eindpunten en modellen die de applicatie die de sleutel draagt daadwerkelijk nodig heeft. Als deze sleutel ooit lekt, erft de aanvaller de bijbehorende rechten: een sleutel die beperkt is tot chatten met één model veroorzaakt oneindig veel minder schade dan een sleutel die de volledige catalogus opent.

xAI implementeert dit principe via een granulair ACL-systeem (Access Control List), dat we hieronder in detail bespreken.

Het ACL-systeem van xAI

ACL’s volgen het formaat api-key:{type}:{value}. Twee typen zijn voor u dagelijks relevant: api-key:endpoint:{endpoint} beperkt de toegankelijke eindpunten, en api-key:model:{model_id} beperkt de bruikbare modellen. Er is ook een jokerteken, api-key:endpoint:*, dat toegang verleent tot alle eindpunten—handig voor ontwikkeling, verboden in productie, juist omdat het het voordeel van de minste bevoegdheid tenietdoet.

De eindpunten die u individueel kunt autoriseren zijn: chat (chat-voltooiing, veruit het meest gebruikelijk), embed (genereren van embeddings), image (genereren en bewerken van afbeeldingen), models (raadplegen van modellenlijsten), tokenize (tekst-tokenisatie), documents (documentbeheer) en sample (sampling).

Laten we bekijken hoe dit eruitziet in een praktijkvoorbeeld. Stel u een chatbot voor klantenservice voor die alleen het grok-4.3-model gebruikt in chatmodus. De ideale sleutel ziet er als volgt uit:

{
  "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"
}

Lees deze configuratie als een contract: de sleutel kan alleen het chat-eindpunt bereiken—geen afbeeldingen, geen embeddings, dus geen mogelijk misbruik voor die doeleinden. Het kan alleen grok-4.3 gebruiken, wat per ongeluk (of kwaadwillig) oproepen naar duurdere modellen voorkomt. Het is beperkt tot 5 verzoeken per seconde en 100 per minuut, en het verloopt op een bekende datum. Als een ontwikkelaar in het project ooit probeert afbeeldingsgeneratie toe te voegen zonder iemand te informeren, weigert de API: de technische beperking forceert de architecturale beslissing.

Snelheidslimieten: Een extra beveiligingslaag

ACL’s beantwoorden de vraag “wat”, snelheidslimieten beantwoorden “hoeveel”. QPS (Queries Per Second) limiteert verzoeken per seconde: dit is uw veiligheidsnet tegen per ongeluk pieken—de oneindige lus geïntroduceerd door een refactor op een vrijdagavond, of een DDoS-aanval die op uw applicatie afstuit. QPM (Queries Per Minute) spreidt het verkeer over een langere periode en vangt misbruik op dat onder de QPS-radar zou blijven. TPM (Tokens Per Minute) limiteert tot slot het volume aan verbruikte tokens: het beschermt tegen zeer lange individuele verzoeken—een gebruiker die een document van 200 pagina’s in uw chatbot plakt—die uw budget binnen enkele minuten zouden uitputten zonder ooit het toegestane aantal verzoeken te overschrijden.

Een sleutelstrategie per omgeving

In de praktijk configureert u niet één enkele sleutel, maar een familie van sleutels, waarbij elke omgeving zijn eigen logica heeft. In ontwikkeling draait u de productielogica om: brede toegang, strikte limieten.

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

Ontwikkelaars kunnen alles verkennen, maar lage limieten voorkomen verrassingen op de factuur als een test misgaat. In staging daarentegen repliceert u de productie-ACL’s exact (api-key:endpoint:chat, api-key:model:grok-4.3, QPS 5, QPM 100, TPM 500000): dit is de enige manier om een rechtenprobleem stroomopwaarts op te sporen—als staging-code een oproep probeert te doen die productie zal weigeren, ontdekt u dat beter nu dan in het eerste uur na livegang. De productiesleutel combineert echter de strikte rechten van staging met limieten die afgestemd zijn op echt verkeer (bijvoorbeeld QPS 20, QPM 600, TPM 2000000) en een geplande vervaldatum—"expireTime": "2027-03-31T23:59:59Z" op een sleutel genaamd prod-chatbot-v2.

Rechten verifiëren en auditeren

Om te zien wat een actieve sleutel daadwerkelijk mag doen, vraagt u de API aan met de sleutel zelf:

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

Het antwoord somt de effectieve ACL’s op, de statussen api_key_blocked en api_key_disabled, een gemaskeerde versie van de sleutel (redacted_api_key) en de team_id. Maak er een gewoonte van om deze ACL’s regelmatig te vergelijken met de daadwerkelijke behoeften van de applicatie: rechten hebben de neiging om in de loop der tijd toe te nemen, ze krimpen nooit spontaan. Aan de kant van de modellen geeft het eindpunt GET /auth/teams/{teamId}/models de lijst terug van modellen die voor uw team beschikbaar zijn met hun prijzen—waardevolle informatie voor het definiëren van relevante model-ACL’s en het uitsluiten van dure modellen die u niet gebruikt.

Om dit alles te verankeren, voert u een volledige audit uit van uw sleutels. Maak een lijst van actieve sleutels voor elk team en query vervolgens elk exemplaar: zijn de ACL’s minimaal, zonder jokertekens in productie? Zijn de snelheidslimieten redelijk? Is de vervaldatum ingesteld? Identificeert de naam de applicatie en omgeving—“prod-chatbot-v2” vertelt een verhaal, “key-test-2” vertelt niets? Verwijder verweesde sleutels en documenteer het resultaat: dit document dient als startpunt voor de volgende audit, en u ziet in één oogopslag wat er in de tussentijd is afgedreven.

Belangrijkste punten

  • Elke sleutel moet restrictieve ACL’s hebben: alleen noodzakelijke eindpunten en modellen
  • Gebruik nooit een * jokerteken in productie
  • Combineer ACL’s met snelheidslimieten (QPS, QPM, TPM) die zijn afgestemd op echt gebruik
  • Maak afzonderlijke sleutels per omgeving (dev, staging, prod) en per applicatie—staging met dezelfde ACL’s als prod
  • Auditeer regelmatig de rechten op uw actieve sleutels via GET /v1/api-key