API-Schlüssel

Generieren, kopieren, identifizieren und widerrufen Sie einen persönlichen Runner-API-Schlüssel sicher.

API-Schlüssel sind persönliche Geheimnisse für programmatischen Runner-Zugriff. Erstellen Sie einen nur für eine Anwendung, der Sie vertrauen, speichern Sie ihn sicher und widerrufen Sie ihn, wenn er nicht mehr benötigt wird.

Was dieser Leitfaden abdeckt

Sie werden wissen, wie Sie das einmalige Geheimnis erstellen und speichern, vorhandene Schlüssel identifizieren, ohne sie offenzulegen, und einen Schlüssel mit Bestätigung widerrufen.

Verfügbarkeit und Voraussetzungen

API-Schlüssel ist bedingt und wird nur angezeigt, wenn es für Ihr Konto aktiviert ist.
Die Seite weist darauf hin, dass jeder Schlüssel in Ihrem Namen handelt. Die Schlüssel gehören zu Ihrem persönlichen Konto, nicht zu einem einzelnen Store.
Verwechseln Sie diese Schlüssel nicht mit den schreibgeschützten Analytics-API-Schlüsseln unter Arbeitsbereich – Allgemein.
Geben Sie niemals einen vollständigen Schlüssel in Chat, Agent Memory, eine Skill, einen Screenshot, die Quellcodeverwaltung oder die Produktdokumentation ein.

Eingabepfad

Wählen Sie Einstellungen → Ihr Kontoname → API-Schlüssel. Fehlt der Eintrag, ist die Funktion für das aktuelle Konto nicht verfügbar.

Steuerelemente

Eintrag oder Schaltfläche	Warum es nützlich ist	Was passiert als Nächstes
Neuen Schlüssel generieren	Erstellen Sie eine neue Anmeldeinformation.	Ein Dialog wird mit einem optionalen Namensfeld geöffnet.
Name	Identifizieren Sie die Anwendung später, ohne das Geheimnis offenzulegen.	Der Name wird in der Schlüsseltabelle angezeigt; leer erstellt einen unbenannten Schlüssel.
Schlüssel erstellen	Generieren Sie die Anmeldeinformation.	Runner öffnet API-Schlüssel generiert und zeigt das vollständige Geheimnis einmal an.
Augensymbol	Überprüfen Sie den vollständigen neu generierten Wert, bevor Sie ihn speichern.	Der einmalige Wert wird im Erfolgsdialog angezeigt oder verborgen.
Kopiersymbol	Kopieren Sie den neuen Schlüssel genau.	Runner kopiert ihn in die Zwischenablage und zeigt eine Bestätigung an.
Ich habe es gespeichert	Schließen Sie die einmalige Geheimnisansicht.	Der vollständige Wert wird aus dem Dialog gelöscht und kann dort nicht erneut angezeigt werden.
Vorhandene Schlüsseltabelle	Identifizieren Sie Schlüssel sicher.	Runner zeigt Name, Präfix, Erstellt und Zuletzt verwendet an, nicht das vollständige Geheimnis.
Löschsymbol	Widerrufen Sie einen vorhandenen Schlüssel.	Eine Bestätigung erklärt, dass der Widerruf nicht rückgängig gemacht werden kann.
Widerrufen	Deaktivieren Sie den ausgewählten Schlüssel.	Nach dem Erfolg wird der Schlüssel aus der Liste entfernt und kann sich nicht mehr authentifizieren.

Englische Markierungen: Persönliche API-Schlüssel: leere Liste und Neuen Schlüssel erstellen

Die englischen Markierungen zeigen die Bedienelemente. Wähle das Bild aus, um es zu vergrößern.

Die leere Liste zeigt den Ausgangszustand. In diesem Beispiel wurde kein geheimer Schlüssel erstellt oder angezeigt.

Überprüfen Sie den Dialog, bevor Sie einen Berechtigungsnachweis erstellen

Wählen Sie Neuen Schlüssel erstellen.
Suchen Sie das optionale Feld Name. Eine Bezeichnung wie Reporting integration hilft Ihnen später, die Anwendung zu erkennen.
Wählen Sie Abbrechen, wenn Sie die Funktion nur kennenlernen möchten. Erst mit Schlüssel erstellen wird ein Schlüssel angelegt.

Der folgende Ablauf gilt, wenn API-Schlüssel verfügbar sind und Sie einen neuen geheimen Schlüssel sicher speichern können.

Generieren und speichern Sie einen Schlüssel

Öffnen Sie Ihr Kontoname → API-Schlüssel.
Wählen Sie Neuen Schlüssel generieren.
Geben Sie einen beschreibenden Namen ein, z. B. die Anwendung oder Umgebung. Geben Sie kein Geheimnis in den Namen ein.
Wählen Sie Schlüssel erstellen.
Geben Sie in API-Schlüssel generiert den Schlüssel nur bei Bedarf frei und wählen Sie Kopieren.
Speichern Sie ihn in einem vertrauenswürdigen Secret Manager.
Bestätigen Sie den gespeicherten Wert, bevor Sie Ich habe es gespeichert wählen.
Verwenden Sie das Tabellenpräfix, um den Schlüssel später zu identifizieren, ohne den vollständigen Wert offenzulegen.

Runner warnt, dass der vollständige Schlüssel nicht erneut angezeigt wird. Wenn Sie den Dialog schließen, ohne ihn zu speichern, widerrufen Sie diesen Schlüssel und erstellen Sie einen Ersatz, anstatt zu versuchen, das Geheimnis wiederherzustellen.

Widerrufen Sie einen Schlüssel

Stimmen Sie den beabsichtigten Schlüssel nach Name und Präfix ab.
Wählen Sie sein Löschsymbol.
Überprüfen Sie die Widerrufen-Bestätigung.
Wählen Sie Widerrufen nur, wenn die abhängige Anwendung bereit ist, ihn nicht mehr zu verwenden.
Bestätigen Sie API-Schlüssel widerrufen und entfernen Sie das alte Geheimnis aus der Anwendung.

Der Widerruf ist destruktiv und kann nicht rückgängig gemacht werden. Erstellen Sie einen neuen Schlüssel, wenn der Zugriff später erforderlich ist.

Zustände und Limits

Noch keine API-Schlüssel ist der normale leere Zustand.
Der vollständige Wert eines neuen Schlüssels wird nur in seinem Erfolgsdialog angezeigt.
Vorhandene Zeilen zeigen ein Präfix und Nutzungsdaten an, keinen wiederherstellbaren Schlüssel.
Nie unter Zuletzt verwendet bedeutet, dass Runner keine Anfrage für diesen Schlüssel aufgezeichnet hat.
Die Schaltflächen Erstellen und Widerrufen zeigen den Fortschritt an und sollten nicht wiederholt eingereicht werden.

Fehlerbehebung

Wenn API-Schlüssel fehlen, verwenden Sie keinen kopierten direkten Link; die Funktion ist für dieses Konto deaktiviert.
Wenn das Kopieren in die Zwischenablage fehlschlägt, geben Sie den neuen Wert frei und kopieren Sie ihn manuell in einen sicheren Secret Manager, dann verbergen Sie ihn erneut.
Wenn Sie einen vollständigen Schlüssel verloren haben, widerrufen Sie seine Zeile und generieren Sie einen Ersatz.
Wenn eine Anwendung nach dem Widerruf nicht mehr funktioniert, aktualisieren Sie sie mit einem neu erstellten Schlüssel; der alte Schlüssel kann nicht wiederhergestellt werden.
Wenn der falsche Schlüssel ausgewählt wurde, brechen Sie die Bestätigung ab und vergleichen Sie Name und Präfix erneut.