Sicherheit von KI-API-Schlüsseln & Kosten

Schützen Sie KI-Workloads mit getrennten Schlüsseln, Kontingenten, Ablaufdaten, Modellgrenzen, IP-Zulassungslisten, Routing-Richtlinien, Rotation und Kostenzuordnung.

Sicherheit von KI-API-Schlüsseln & Kosten

Ein KI-API-Schlüssel sollte die Grenze einer einzelnen Arbeitslast kennzeichnen, nicht dauerhaft eine ganze Organisation. Separate Schlüssel erleichtern die Kontrolle von Zugriff, Kontingent, Routing, Rotation und Nutzungsdaten, ohne dieselben Zugangsdaten in voneinander unabhängigen Anwendungen offenzulegen.

API-Schlüssel von Modelflare können Ablaufdatum, endliches oder unbegrenztes Kontingent, Modellgrenzen, eine IP-Zulassungsliste und eine Routing-Richtlinie kombinieren. Diese Kontrollen wirken am besten, wenn sie gemeinsam geplant und nicht erst nach einem Vorfall ergänzt werden.

Mit einem Schlüssel pro Arbeitslast beginnen

Erstellen Sie separate Schlüssel für Bereiche, die eigenen Zugriff oder eine eigene Abrechnung benötigen, zum Beispiel:

  • Produktions-API und Hintergrund-Worker;
  • Entwicklung und CI;
  • ein Coding-Agent oder ein lokales Tool;
  • eine Anwendung für Kunden;
  • eine befristete Mitarbeit externer Dienstleister oder eine Migration;
  • eine kostenintensive Batch-Verarbeitung.

Verwenden Sie Namen, die Umgebung und Zweck beschreiben, etwa prod-support-agent oder dev-evaluation. Ein klarer Name macht Anfragedatensätze und Rotationsentscheidungen verständlich, ohne das Secret preiszugeben.

Das Secret aus clientseitig sichtbarem Code heraushalten

Speichern Sie den vollständigen Schlüssel in einem serverseitigen Secret-Manager oder einer geschützten Umgebungsvariable. Legen Sie ihn nicht ab in:

  • Browser-JavaScript oder mobilen Paketen, die Benutzer untersuchen können;
  • Versionsverwaltung, Container-Images, Screenshots oder Tickets;
  • Analytics-Events, Fehler-Trackern, Shell-Verlauf oder Anwendungsprotokollen;
  • URLs, Query-Strings oder kopierten Befehlsbeispielen mit echten Werten.

Leiten Sie bei einer Browseranwendung Anfragen über ein Backend, das den Benutzer authentifiziert und den Modelflare-Schlüssel verwahrt. Wenn ein Schlüssel offengelegt worden sein könnte, erstellen Sie einen Ersatz, stellen die Arbeitslast um, prüfen den Traffic über den neuen Schlüssel und widerrufen den alten.

Kontingent und Ablaufdatum als unabhängige Grenzen nutzen

Ein endliches Schlüsselkontingent setzt eine harte Nutzungsgrenze für diesen Schlüssel. Ein Ablaufdatum begrenzt, wie lange die Zugangsdaten gültig bleiben. Beide decken unterschiedliche Risiken ab:

Kontrolle Hauptzweck
Endliches Kontingent Begrenzt die Nutzung, die dem Schlüssel zugerechnet werden kann
Unbegrenztes Kontingent Vermeidet eine Obergrenze auf Schlüsselebene; Kontoguthaben und andere Richtlinien gelten weiterhin
Ablaufdatum Beendet den Zugriff nach einer festgelegten Zeit
Deaktivieren oder widerrufen Stoppt neuen Zugriff sofort

Schlüssel für Entwicklung, externe Dienstleister und Evaluierung sollten in der Regel sowohl ein endliches Kontingent als auch ein Ablaufdatum haben. Produktionsschlüssel benötigen möglicherweise ein größeres oder unbegrenztes Schlüsselkontingent, profitieren aber trotzdem von einer getrennten Zuordnung pro Arbeitslast und einem Rotationsplan.

Ein Kontingent ersetzt weder Grenzen für die Parallelität noch die Kontrolle von Wiederholungen im Client. Eine Lastspitze kann den Restbetrag schnell aufbrauchen, und wiederholte Fehler können zusätzliche Anfragen erzeugen.

Modelle bei eng umrissenen Arbeitslasten einschränken

Modellgrenzen verhindern, dass ein Schlüssel Modelle außerhalb des vorgesehenen Umfangs anfragt. Das verringert die versehentliche Nutzung eines inkompatiblen oder unerwartet teuren Modells und liefert eine klarere 403-Grenze, wenn der Client etwas anfordert, auf das er keinen Zugriff haben soll.

Halten Sie die erlaubten Modelle auf den Endpunkt abgestimmt. Ein Schlüssel, der ein Modell auflisten kann, benötigt weiterhin einen Client und ein Protokoll, die das Anfrageformat dieses Modells unterstützen. Prüfen Sie den aktuellen Vertrag unter Modelle & Preise, statt Modell-IDs in ein langlebiges Richtliniendokument zu kopieren.

IP-Regeln nur bei stabilem Netzwerkpfad hinzufügen

Eine IP-Zulassungsliste vergleicht die von Modelflare beobachtete Client-IP mit einzelnen Adressen oder CIDR-Bereichen, die für den Schlüssel konfiguriert sind. Das ist nützlich für Server mit bekannter ausgehender Adresse, kann aber Traffic blockieren, wenn:

  • eine Cloud-Arbeitslast ihre ausgehenden NAT-Adressen ändert;
  • Anfragen über einen neuen Proxy oder ein neues Gateway laufen;
  • sich IPv4- und IPv6-Pfade unterscheiden;
  • ein Entwickler das Netzwerk wechselt;
  • der konfigurierte CIDR-Bereich weiter oder enger ist als beabsichtigt.

Prüfen Sie den tatsächlichen ausgehenden Netzwerkpfad, bevor Sie die Einschränkung aktivieren, halten Sie einen Weg für eine Notfallrotation bereit und betrachten Sie die IP-Zulassungsliste nicht als Ersatz für den Schutz des Secrets.

Reguläres oder intelligentes Routing bewusst wählen

Schlüsseltyp Routing-Verhalten Am besten geeignet für
Regulärer API-Schlüssel Eine explizite primäre Gruppe plus optionale geordnete Fallback-Gruppen Arbeitslasten, die eine bekannte Routenreihenfolge und Gruppenrichtlinie erfordern
Smart-API-Schlüssel (Smart API Key) Bewertet die für das Konto zulässigen Gruppen mit ausgewogener, stabilitätsorientierter oder preisorientierter Strategie Arbeitslasten, die eine breitere automatische Routenauswahl wünschen

Beide Schlüsseltypen senden weiterhin das angeforderte Modell und Protokoll. Die Routing-Richtlinie wählt eine geeignete Gruppe; sie garantiert nicht, dass jede Gruppe jedes Modell und jede Funktion unterstützt. Eine reguläre Fallback-Liste sollte in ihrer Reihenfolge getestet werden. Ein Smart-API-Schlüssel sollte vor dem Produktivbetrieb anhand der tatsächlichen Anforderungen an Latenz, Preis und Kompatibilität bewertet werden.

Details zum Verhalten finden Sie unter Zuverlässiges KI-API-Routing.

Ohne vermeidbaren Ausfall rotieren

Verwenden Sie eine überlappende Rotation:

  1. Erstellen Sie einen neuen Schlüssel mit denselben vorgesehenen Einschränkungen.
  2. Speichern Sie ihn im Secret-System der Anwendung.
  3. Stellen Sie die neuen Zugangsdaten bereit, ohne den alten Schlüssel zu löschen.
  4. Prüfen Sie den Modellzugriff und eine echte Anfrage.
  5. Bestätigen Sie, dass neue Nutzungsdatensätze unter dem neuen Schlüssel erscheinen.
  6. Entfernen Sie den alten Schlüssel aus allen Deployments und Automatisierungsjobs.
  7. Deaktivieren oder löschen Sie den alten Schlüssel.
  8. Überwachen Sie unerwartete Anfragen mit den ausgemusterten Zugangsdaten.

Ist eine Kompromittierung im Gange, widerrufen Sie zuerst und nehmen die kontrollierte Unterbrechung in Kauf. Das überlappende Verfahren ist für geplante Rotationen gedacht, nicht für eine fortbestehende Offenlegung.

Schlüsselrichtlinie mit der Kostenprüfung verbinden

Die Trennung auf Schlüsselebene macht Kostenprüfungen umsetzbar. Filtern Sie die Nutzungsprotokolle nach Schlüssel und vergleichen Sie dann Modell, Gruppe, Eingabe- und Ausgabenutzung, Status, Wiederholungen und Kosten. Ein endliches Kontingent kann die weitere Nutzung stoppen, aber erst die Anfragedatensätze erklären, was es verbraucht hat.

Einen wiederholbaren Prüfablauf finden Sie unter KI-API-Kostenverfolgung.

Checkliste für API-Schlüssel

  • Ein Schlüssel pro Anwendung, Umgebung oder verantwortlicher Arbeitslast.
  • Keine Secrets in Browsercode, Repositorys, Protokollen, URLs oder Screenshots.
  • Endliches Kontingent und Ablaufdatum für befristete oder experimentelle Nutzung.
  • Modellbeschränkungen für eng umrissene Arbeitslasten.
  • IP-Regeln nur für einen geprüften, stabilen ausgehenden Netzwerkpfad.
  • Explizite reguläre Fallback-Reihenfolge oder eine bewusst gewählte Strategie für den Smart-API-Schlüssel.
  • Rotation testen, bevor der alte Schlüssel entfernt wird.
  • Nutzung und Kosten nach jeder Richtlinienänderung pro Schlüssel prüfen.

Häufige Fragen

Hebt ein unbegrenzter Schlüssel alle Ausgabenlimits auf?

Nein. Er hebt nur die Kontingentgrenze auf Schlüsselebene auf. Kontoguthaben, Modellpreise, Gruppenrichtlinie, Anfragelimits und andere Dienstkontrollen gelten weiterhin.

Lässt sich ein Ratenlimit mit mehreren Schlüsseln umgehen?

Nicht unbedingt. Ein Limit kann auf Konto-, Modellgruppen- oder Routenebene gelten. Erstellen Sie Schlüssel für Zugriff und Zuordnung, nicht als ungeprüfte Umgehung von Ratenlimits.

Reicht eine IP-Zulassungsliste, wenn ein Schlüssel offengelegt wurde?

Nein. Netzwerkregeln schränken ein, wo ein Schlüssel verwendet werden kann, aber Netzwerkpfade ändern sich und Konfigurationen können fehlerhaft sein. Rotieren Sie offengelegte Zugangsdaten und schützen Sie das Secret bei der Speicherung und im Deployment.