Authentification auprès de l'API

Avant de pouvoir effectuer des appels API vers le service Red Hat AI Inference, vous devez authentifier vos requêtes. Vous pouvez vous authentifier à l'aide d'un jeton bearer ou d'une clé API IBM Cloud.

Avant de commencer

  • Créez un compte IBM Cloud avec facturation à l'utilisation ou par abonnement. Les comptes d'essai ne sont pas pris en charge. Pour plus d'informations ou pour mettre à niveau votre compte, consultez la section Types de comptes.

  • Créer un projet Red Hat AI Inference.

  • Assurez-vous de disposer du rôle Writer ou d'un rôle supérieur sur le service Red Hat AI Inference. Pour plus d'informations, consultez la section Gestion des accès IAM.

Authentification à l'aide d'un jeton bearer

Les jetons bearer garantissent un accès sécurisé aux capacités d'inférence de votre projet et sont générés à partir de votre clé API IBM Cloud. Les jetons bearer expirent après une période définie; ils doivent donc être actualisés périodiquement.

L'exemple suivant montre comment récupérer un jeton bearer.

curl -X POST "https://iam.cloud.ibm.com/identity/token" --header "Content-Type: application/x-www-form-urlencoded" --header "Accept: application/json" --data-urlencode "grant_type=urn:ibm:params:oauth:grant-type:apikey" --data-urlencode "apikey=$<IBM_CLOUD_API_KEY>"

Le jeton porteur est le présent dans access_token la réponse. Ces jetons ont une date d'expiration et doivent être renouvelés périodiquement.

{"access_token":"xxxxx","refresh_token":"not_supported","token_type":"Bearer","expires_in":3600,"expiration":1770058324,"scope":"ibm openid"}

Authentification à l’aide d’une clé API

Vous pouvez vous authentifier à l'aide d'une clé API, qu'il s'agisse d'une clé API d'identifiant de service ou d'une clé API d'utilisateur.

L'utilisation d'un identifiant de service est la méthode recommandée pour gérer et déléguer les autorisations d'accès. Après avoir créé un identifiant de service, créez une clé API d'identifiant de service pour authentifier vos requêtes. Pour plus d'informations sur la création d'un identifiant de service et d'une clé API au sein de votre projet, consultez la section Premiers pas avec Red Hat AI Inference.

Lorsque vous créez l'ID de service dans IAM, attribuez le rôle d'accès Writer au service afin de pouvoir créer des suggestions de chat. Attribuez le rôle d'accès Reader si vous avez uniquement besoin de consulter les informations relatives aux modèles ou de lire les compléments de conversation. Aucun rôle d'accès à la plateforme n'est requis pour accéder à l'API.

Vous pouvez également vous authentifier à l'aide d'une clé API utilisateur personnelle. Pour plus d'informations, voir Gestion des clés d'API utilisateur.