Zum Hauptinhalt springen
Gesamte Dokumentation

API-Schlüssel erstellen und schützen

Erstellen Sie Live- oder Sandbox-Zugangsdaten mit minimalen Berechtigungen, beschränken Sie bei Bedarf IP-Adressen und rotieren oder widerrufen Sie Schlüssel sicher.

Ablauf
  1. Kontext wählenWählen Sie den persönlichen Arbeitsbereich oder den der Organisation.
  2. Berechtigungen festlegenBenennen Sie den Schlüssel und wählen Sie nur nötige Berechtigungsbereiche.
  3. Quellen beschränkenGeben Sie bei Bedarf gültige aufrufende IP-Adressen oder Netze ein.
  4. Einmalig speichernLegen Sie das angezeigte Geheimnis in einem geschützten Secret-Manager ab.
  5. Zugriff verwaltenRotieren Sie Ersatzschlüssel und widerrufen Sie nicht mehr benötigte Zugangsdaten.

Berechtigungsbereiche und Rollen

API-Schlüssel führt Beschreibungen unterstützter Berechtigungsbereiche auf, darunter Kontozugriff, KI-Inferenz und -Training, KI-Hosting-Aufträge, Modellumwandlungsaufträge, Blockchain-Dienste und Support-Tickets. In einer Organisation verwalten Eigentümer und Administratoren die Schlüssel; Mitglieder können sie ansehen, aber nicht verwalten. Wählen Sie den passenden Kontext: Sichtbarkeit und Befugnisse gelten jeweils nur dort.

  1. Wählen Sie vor dem Öffnen der API-Schlüssel die richtige Organisation.
  2. Lesen Sie die Beschreibungen und wählen Sie nur notwendige Vorgänge.
  3. Bitten Sie Eigentümer oder Administratoren um Hilfe, falls die Verwaltung fehlt.

Live-Schlüssel erstellen

Ein regulärer Schlüssel benötigt einen Namen mit 2 bis 120 Zeichen, mindestens einen aufgeführten Berechtigungsbereich und kann auf Wunsch eine IP-Zulassungsliste erhalten. Geben Sie gültige IP-Adressen oder CIDR-Netze ein, jeweils eine Zeile und innerhalb der angezeigten Grenze. Eine leere Liste lässt Aufrufe von jeder Quell-IP zu. Der Klartext wird nach dem Erstellen nur einmal angezeigt; gespeichert wird lediglich ein Hash und der Schlüssel kann später nicht erneut abgerufen werden.

  1. Verwenden Sie einen Namen für Anwendung oder Umgebung.
  2. Wählen Sie minimale Berechtigungen und notwendige, stabile Quelladressen.
  3. Speichern Sie den angezeigten Wert direkt im zugelassenen Secret-Manager.

Sandbox-Schlüssel für Inferenz

Das Dashboard kann einen Sandbox-Schlüssel erstellen, der auf KI-Inferenz und das dort angezeigte monatliche Anfragekontingent begrenzt ist. Pro Konto- oder Organisationskontext ist nur ein aktiver Sandbox-Schlüssel zulässig. Verwenden Sie einen vorhandenen Schlüssel oder widerrufen Sie ihn, bevor Sie Ersatz erstellen. Halten Sie Sandbox- und Live-Zugangsdaten getrennt. Das Sandbox-Kontingent ist keine Zusage für den Produktivbetrieb.

  1. Prüfen Sie, ob in diesem Kontext ein Sandbox-Schlüssel aktiv ist.
  2. Erstellen Sie einen Schlüssel für Inferenztests und speichern Sie ihn getrennt.
  3. Behalten Sie das Kontingent im Blick und widerrufen Sie den Schlüssel nach Gebrauch.

Geheimnis schützen

Kopieren Sie den vollständigen Schlüssel nur bei der einmaligen Anzeige nach Erstellung oder Rotation. Speichern Sie ihn in einem verschlüsselten Secret-Manager mit Zugriff nur für den nutzenden Dienst. Hinterlegen Sie ihn niemals in Quellcode, Browsercode, Protokollen, Screenshots, Tickets oder Chats. Haben Sie die Anzeige verpasst oder den Wert verloren, rotieren Sie den Schlüssel; der Support kann den Klartext nicht abrufen.

  1. Übertragen Sie den angezeigten Wert direkt in den geschützten Speicher.
  2. Konfigurieren Sie den Verbraucher anhand der dokumentierten Einstellungen.
  3. Rotieren Sie den Schlüssel sofort bei vermuteter Offenlegung oder Verlust.

Rotieren oder widerrufen

Bei der Rotation wird der alte Schlüssel widerrufen und ein Ersatz mit gleichem Namen, Tarif, Berechtigungsbereichen und gleicher Zulassungsliste erstellt. Der neue Wert wird einmal angezeigt. Aktualisieren Sie abhängige Dienste umgehend, denn der alte Schlüssel funktioniert danach nicht mehr. Ein Widerruf deaktiviert den ausgewählten Schlüssel, ohne ihn zu ersetzen. Prüfen Sie vor beiden Aktionen Schlüssel und Kontext.

  1. Ermitteln Sie vor einer geplanten Rotation alle Verbraucher.
  2. Speichern Sie den neuen Wert und aktualisieren Sie abhängige Dienste.
  3. Widerrufen Sie alte Schlüssel und prüfen Sie ihren Status im Dashboard.

Abgewiesene Anfragen untersuchen

Eine Anfrage kann wegen eines fehlerhaften oder widerrufenen Schlüssels, eines inaktiven Nutzers, einer nicht zugelassenen Quell-IP oder eines fehlenden Berechtigungsbereichs abgewiesen werden. Sandbox-Anfragen können außerdem das Monatskontingent überschreiten. Prüfen Sie Kontext, ausgerollte Secret-Version, ausgehende IP-Adresse und benötigte Berechtigung. Teilen Sie bei Supportanfragen niemals den Schlüssel.

  1. Prüfen Sie, ob der Schlüssel aktiv ist und den erforderlichen Bereich enthält.
  2. Vergleichen Sie Quell-IP und Sandbox-Kontingent.
  3. Rotieren Sie falsche oder offengelegte Schlüssel; teilen Sie nur bereinigte Referenzen.

Häufig gestellte Fragen

Kann ich einen Schlüssel später erneut abrufen?

Nein. Erstellen Sie durch Rotation einen Ersatzwert.

Welche Berechtigungen soll ich vergeben?

Nur die aufgeführten Bereiche, die die Integration benötigt.

Können Mitglieder Organisationsschlüssel erstellen?

Nein. Das können nur Eigentümer und Administratoren.

Bleibt der alte Schlüssel bei Rotation aktiv?

Nein. Er wird widerrufen und durch einen neuen ersetzt.

Was ist bei einer geänderten Quell-IP zu tun?

Lassen Sie die Zulassungsliste durch einen berechtigten Schlüsselverwalter aktualisieren.

Kann ich zwei Sandbox-Schlüssel haben?

Je Kontext ist nur ein aktiver Sandbox-Schlüssel zulässig.

Verwandte Seiten