API-Schlüssel
Authentifiziere Bob für Automatisierungs-Workflows ohne browserbasierte Anmeldung. Verfügbar für Test- und bezahlte Plan-Nutzer. Verwalte Schlüssel einzeln oder als Admin für deine gesamte Instanz.
Eigentümerschaft und Administration
API-Schlüssel sind sowohl dem Nutzer als auch der Abonnement-Instanz zugeordnet. Einzelne Nutzer können ihre eigenen API-Schlüssel erstellen, auflisten und widerrufen. Admins der Abonnement-Instanz können API-Schlüssel für alle Nutzer ihrer Instanz auflisten und widerrufen.
API-Schlüssel-Typen
Du kannst zwei Arten von API-Schlüsseln erstellen:
| Typ | Umfang und Verwendung |
|---|---|
| Allgemein | Auf deine Abonnement-Instanz beschränkt und über mehrere Dienste hinweg verwendbar. Für Inferenzanfragen musst du außerdem den Team-ID-Header angeben. |
| Inferenz | Auf eine bestimmte Abonnement-Instanz und ein Team beschränkt, nur für Inferenzanfragen geeignet. Es sind keine zusätzlichen Instanz- oder Team-Header erforderlich. |
Wann API-Schlüssel verwenden
Verwende API-Schlüssel, wenn du Folgendes benötigst:
- Bob Shell in nicht-interaktiven Sitzungen authentifizieren
- Bob in CI/CD-Pipelines oder geplanter Automatisierung ausführen
- Browser-basierte Anmeldung für skriptgesteuerte Workflows vermeiden
- Inferenzanfragen mit einem allgemeinen oder Inferenz-API-Schlüssel authentifizieren
Einen API-Schlüssel erstellen
Gehe zu bob.ibm.com und melde dich an.
Öffne deine Abonnement-Instanz und navigiere zum Bereich für die API-Schlüssel-Verwaltung.
Erstelle einen neuen API-Schlüssel und wähle den gewünschten Schlüsseltyp.
Kopiere den API-Schlüsselwert und speichere ihn sicher.
Du kannst den API-Schlüsselwert nach der Erstellung nicht mehr einsehen.
Deine API-Schlüssel verwalten
Du kannst den API-Schlüssel-Verwaltungsbereich für Folgendes nutzen:
- Deine API-Schlüssel auflisten
- Schlüssel suchen und filtern
- API-Schlüssel-Details anzeigen
- Aktive Schlüssel widerrufen
- Widerrufene Schlüssel neben aktiven und abgelaufenen Schlüsseln anzeigen
Administrator-Funktionen
Admins der Abonnement-Instanz können API-Schlüssel in ihrer gesamten Instanz verwalten. Zu den Admin-Funktionen gehören:
- API-Schlüssel für alle Nutzer der Instanz auflisten
- API-Schlüssel für beliebige Nutzer der Instanz widerrufen
- Aktive, widerrufene und abgelaufene Schlüssel anzeigen
Einen API-Schlüssel mit Bob Shell verwenden
Informationen zur Verwendung eines API-Schlüssels mit Bob Shell findest du unter Bob Shell installieren und einrichten und Nicht-interaktive Sitzung starten.