Clés API
Authentifie Bob pour les workflows d'automatisation sans connexion via navigateur. Disponible pour les utilisateurs en période d'essai et sur les plans payants. Gérez les clés individuellement ou en tant qu'administrateur sur l'ensemble de votre instance.
Propriété et administration
Les clés API sont liées à la fois à l'utilisateur et à l'instance d'abonnement. Les utilisateurs individuels peuvent créer, lister et révoquer leurs propres clés API. Les administrateurs d'instance d'abonnement peuvent lister et révoquer les clés API de tous les utilisateurs de leur instance.
Types de clés API
Vous pouvez créer deux types de clés API :
| Type | Portée et utilisation |
|---|---|
| Générale | Liée à votre instance d'abonnement et utilisable dans plusieurs services. Pour les requêtes d'inférence, vous devez également inclure l'en-tête d'identifiant d'équipe. |
| Inférence | Liée à une instance d'abonnement et une équipe spécifiques, et limitée aux requêtes d'inférence uniquement. Aucun en-tête d'instance ou d'équipe supplémentaire n'est requis. |
Quand utiliser les clés API
Utilisez des clés API lorsque vous avez besoin de :
- Authentifier Bob Shell dans des sessions non interactives
- Exécuter Bob dans des pipelines CI/CD ou des automatisations planifiées
- Éviter la connexion via navigateur pour les workflows scriptés
- Authentifier des requêtes d'inférence avec une clé API générale ou d'inférence
Créer une clé API
Accédez à bob.ibm.com et connectez-vous.
Ouvrez votre instance d'abonnement et accédez à la section de gestion des clés API.
Créez une nouvelle clé API et choisissez le type de clé que vous souhaitez créer.
Copiez la valeur de la clé API et stockez-la en lieu sûr.
Vous ne pourrez plus consulter la valeur de la clé API après sa création.
Gérer vos clés API
Vous pouvez utiliser la section de gestion des clés API pour :
- Lister vos clés API
- Rechercher et filtrer les clés
- Afficher les détails d'une clé API
- Révoquer les clés actives
- Afficher les clés révoquées avec les clés actives et expirées
Fonctionnalités administrateur
Les administrateurs d'instance d'abonnement peuvent gérer les clés API sur l'ensemble de leur instance. Les fonctionnalités administrateur comprennent :
- Lister les clés API de tous les utilisateurs de l'instance
- Révoquer les clés API de n'importe quel utilisateur de l'instance
- Consulter les clés actives, révoquées et expirées
Utiliser une clé API avec Bob Shell
Pour utiliser une clé API avec Bob Shell, consultez Installer et configurer Bob Shell et Démarrer une session non interactive.