Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Zugriffssteuerlisten (ACLs) und das Prinzip der geringsten Rechte

Lektion 8 von 12 Aktualisiert am 28. Juli 2026 Fortgeschritten
Auf dieser Seite
  1. Das Prinzip der geringsten Rechte angewendet auf APIs
  2. Das ACL-System von xAI
  3. Rate Limits: Eine zusätzliche Sicherheitsebene
  4. Eine Schlüsselstrategie pro Umgebung
  5. Berechtigungen überprüfen und auditieren
  6. Kernaussagen

Das Prinzip der geringsten Rechte angewendet auf APIs

Das Prinzip der geringsten Rechte ist eines der ältesten Konzepte in der Cybersicherheit: Jeder Bestandteil eines Systems sollte nur Zugriff auf Ressourcen haben, die für seinen Betrieb zwingend erforderlich sind. Die Idee ist intuitiv, wenn man sie auf die physische Welt bezieht – Sie geben den Hauptschlüssel zum Gebäude nicht der Person, die die Lobbypflanzen gießt. Übertragen auf xAI API-Schlüssel bedeutet dies, dass jeder Schlüssel auf die Endpunkte und Modelle beschränkt sein muss, die die ihn tragende Anwendung tatsächlich benötigt. Wenn dieser Schlüssel jemals kompromittiert wird, übernimmt der Angreifer seine Berechtigungen: Ein Schlüssel, der nur auf den Chat mit einem einzelnen Modell beschränkt ist, verursacht im Falle eines Lecks unendlich weniger Schaden als ein Schlüssel, der den gesamten Katalog öffnet.

xAI setzt dieses Prinzip durch ein granulares ACL-System (Access Control List) um, das wir im Folgenden detailliert beschreiben.

Das ACL-System von xAI

ACLs folgen dem Format api-key:{type}:{value}. Zwei Typen sind im täglichen Betrieb relevant: api-key:endpoint:{endpoint} beschränkt die zugänglichen Endpunkte, und api-key:model:{model_id} beschränkt die nutzbaren Modelle. Es gibt zudem einen Platzhalter, api-key:endpoint:*, der Zugriff auf alle Endpunkte gewährt – praktisch für die Entwicklung, aber in der Produktion untersagt, da er den Nutzen des Prinzips der geringsten Rechte zunichtemacht.

Die Endpunkte, die Sie einzeln autorisieren können, sind: chat (Chat-Vervollständigung, bei weitem der häufigste), embed (Erstellung von Embeddings), image (Bildgenerierung und -bearbeitung), models (Abfrage der Modellliste), tokenize (Text-Tokenisierung), documents (Dokumentenverwaltung) und sample (Sampling).

Schauen wir uns dies in einem realen Beispiel an. Stellen Sie sich einen Kundensupport-Chatbot vor, der ausschließlich das Modell grok-4.3 im Chat-Modus verwendet. Der ideale Schlüssel sieht wie folgt aus:

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

Lesen Sie diese Konfiguration als Vertrag: Der Schlüssel kann nur auf den Chat-Endpunkt zugreifen – keine Bilder, keine Embeddings, also kein Missbrauch für diese Zwecke möglich. Er kann nur grok-4.3 verwenden, was versehentliche (oder böswillige) Aufrufe an teurere Modelle verhindert. Er ist auf 5 Anfragen pro Sekunde und 100 pro Minute begrenzt und läuft an einem bekannten Datum ab. Wenn ein Entwickler im Projekt jemals versucht, die Bildgenerierung hinzuzufügen, ohne dies zu melden, wird die API dies ablehnen: Die technische Einschränkung erzwingt die architektonische Entscheidung.

Rate Limits: Eine zusätzliche Sicherheitsebene

ACLs beantworten die Frage „was”, Rate Limits die Frage „wie viel”. QPS (Queries Per Second) begrenzt die Anfragen pro Sekunde: Dies ist Ihr Schutz vor versehentlichen Spitzen – dem Endlosschleifen-Problem, das durch eine Refaktorierung am Freitagabend eingeführt wird, oder einem DDoS-Angriff, der von Ihrer Anwendung abprallt. QPM (Queries Per Minute) glättet den Datenverkehr über einen längeren Zeitraum und erfasst Missbrauch, der unter dem Radar von QPS bleiben würde. TPM (Tokens Per Minute) begrenzt schließlich das Volumen der verbrauchten Tokens: Es schützt vor sehr langen einzelnen Anfragen – einem Nutzer, der ein 200-seitiges Dokument in Ihren Chatbot einfügt – die Ihr Budget in Minuten erschöpfen würden, ohne die autorisierte Anzahl der Anfragen zu überschreiten.

Eine Schlüsselstrategie pro Umgebung

In der Praxis konfigurieren Sie nicht einen einzelnen Schlüssel, sondern eine Familie von Schlüsseln, und jede Umgebung hat ihre eigene Logik. In der Entwicklung kehren Sie die Produktionslogik um: breiter Zugriff, strenge Limits.

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

Entwickler können alles erkunden, aber niedrige Limits vermeiden Abrechnungsüberraschungen, falls ein Test schiefgeht. In der Staging-Umgebung replizieren Sie im Gegensatz dazu die Produktions-ACLs exakt (api-key:endpoint:chat, api-key:model:grok-4.3, QPS 5, QPM 100, TPM 500000): Dies ist der einzige Weg, um ein Berechtigungsproblem upstream zu erkennen – wenn Staging-Code einen Aufruf versucht, den die Produktion ablehnen würde, ist es besser, dies jetzt zu entdecken als in der ersten Stunde nach dem Go-Live. Der Produktionsschlüssel kombiniert jedoch die strengen Berechtigungen der Staging-Umgebung mit Limits, die für den echten Datenverkehr ausgelegt sind (z. B. QPS 20, QPM 600, TPM 2000000), und ein geplantes Ablaufdatum – "expireTime": "2027-03-31T23:59:59Z" bei einem Schlüssel namens prod-chatbot-v2.

Berechtigungen überprüfen und auditieren

Um zu sehen, wozu ein aktiver Schlüssel tatsächlich befugt ist, queryen Sie die API mit dem Schlüssel selbst:

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

Die Antwort listet die effektiven ACLs, die Status api_key_blocked und api_key_disabled, eine maskierte Version des Schlüssels (redacted_api_key) sowie die team_id auf. Machen Sie es zur Gewohnheit, diese ACLs regelmäßig mit den tatsächlichen Anforderungen der Anwendung zu vergleichen: Berechtigungen neigen dazu, sich im Laufe der Zeit zu akkumulieren, schrumpfen aber nie von selbst. Auf der Modellseite gibt der Endpunkt GET /auth/teams/{teamId}/models die Liste der für Ihr Team verfügbaren Modelle mit deren Preisen zurück – wertvolle Informationen zur Definition relevanter Modell-ACLs und zum Ausschluss teurer Modelle, die Sie nicht nutzen.

Um dies alles zu festigen, führen Sie ein vollständiges Audit Ihrer Schlüssel durch. Listen Sie die aktiven Schlüssel für jedes Team auf, und queryen Sie jeden einzelnen: Sind seine ACLs minimal, ohne Platzhalter in der Produktion? Sind seine Rate Limits angemessen? Ist ein Ablaufdatum festgelegt? Identifiziert der Name die Anwendung und die Umgebung – „prod-chatbot-v2” erzählt eine Geschichte, „key-test-2” erzählt keine? Löschen Sie verwaiste Schlüssel und dokumentieren Sie das Ergebnis: Dieses Dokument dient als Ausgangspunkt für das nächste Audit, und Sie werden auf einen Blick erkennen, was sich in der Zwischenzeit verschoben hat.

Kernaussagen

  • Jeder Schlüssel muss restriktive ACLs haben: Nur notwendige Endpunkte und Modelle
  • Verwenden Sie in der Produktion niemals einen *-Platzhalter
  • Kombinieren Sie ACLs mit Rate Limits (QPS, QPM, TPM), die an den tatsächlichen Nutzungsmuster angepasst sind
  • Erstellen Sie unterschiedliche Schlüssel pro Umgebung (Entwicklung, Staging, Produktion) und pro Anwendung – Staging mit denselben ACLs wie die Produktion
  • Auditieren Sie regelmäßig die Berechtigungen Ihrer aktiven Schlüssel über GET /v1/api-key