API-Schlüssel
Erstellen, widerrufen und löschen Sie Organization-Anmeldedaten für den programmatischen Zugriff.
Ein API-Schlüssel gewährt einem Programm Zugriff auf eine Organisation. Ciele speichert nur den Hash des Secrets.
Einen Schlüssel erstellen
- Öffnen Sie Settings.
- Wählen Sie API Keys aus.
- Wählen Sie Create API key aus.
- Geben Sie einen Namen für den Schlüssel ein.
- Wählen Sie die minimal erforderliche Role aus.
- Kopieren Sie das Secret in einen sicheren Anmeldedatenspeicher.
Ciele zeigt das ciele_sk_...-Secret nur einmal an. Sie können dasselbe Secret
später nicht mehr abrufen.
Die ausgewählte Role darf nicht höher sein als Ihre eigene Role. Ciele überprüft die Role bei jedem API-Vorgang.
Einen Schlüssel widerrufen
- Öffnen Sie Settings > API Keys.
- Suchen Sie den Schlüssel.
- Wählen Sie Revoke aus.
- Bestätigen Sie die Aktion.
Durch den Widerruf werden neue Anfragen, die den Schlüssel verwenden, verhindert. Ciele speichert den Schlüsseleintrag für Audit-Informationen.
Einen Schlüssel löschen
Sie können nur einen Schlüssel löschen, der bereits gesperrt ist. Ein Admin oder ein Owner kann dies tun.
- Öffnen Sie Settings > API Keys.
- Suchen Sie den gesperrten Schlüssel.
- Wählen Sie das rote Papierkorb-Symbol aus.
- Bestätigen Sie die Aktion.
Ciele entfernt den Key-Datensatz aus der Liste. Sie können diese Aktion nicht rückgängig machen.
Protect the secret
Do not put an API key in source control, public logs, prompts, or screenshots. Use an environment variable or a secret store.