Authentification à IBM Cloud

IBM Cloud

L'authentification IBM Cloud® Identity and Access Management (IAM) permet de faire des demandes authentifiées auprès des services IBM Watson® publics. Vous pouvez envoyer un jeton bearer dans un en-tête d'autorisation ou une clé d'API.

• Authentification avec un jeton IAM

  Les jetons IAM sont des données d'identification de sécurité temporaires valides pour une durée maximale de 60 minutes. Lorsqu'un jeton arrive à expiration, vous devez en générer un nouveau. Les jetons peuvent être utiles pour accéder temporairement à des ressources. Pour plus d'informations, voir Génération d'un jeton IAM IBM Cloud à l'aide d'une clé d'API.

  La commande curl suivante génère un jeton d'accès IAM. Remplacez {apikey} par la valeur de votre clé API.

  curl -X POST \
  -header "Content-Type: application/x-www-form-urlencoded" \
  -data "grant_type=urn:ibm:params:oauth:grant-type:apikey&apikey={apikey}" \
  "https://iam.cloud.ibm.com/identity/token"
  

  La réponse inclut une propriété access_token. Pour authentifier une demande au service, remplacez {access_token} par le jeton de la réponse. Remplacez {url} par la valeur de l'URL de votre instance de service, que vous pouvez trouver en cliquant sur Afficher les données d'identification dans la zone Données d'identification de la page Gérer de votre instance de service.

  curl -header "Authorization: Bearer {access_token}" \
  "{url}/v1/{method}"
  

• Authentification avec une clé d'API IBM Cloud, une clé d'API d'ID de service ou une clé d'API spécifique au service Remplacez {url} par la valeur de l'URL de votre instance de service, que vous pouvez trouver en cliquant sur Afficher les données d'identification dans la zone Données d'identification de la page Gérer de votre instance de service.

  Les clés d'API sont simples à utiliser et n'expirent pas automatiquement. Quiconque possède une clé valide peut accéder à la ressource. Vous pouvez créer des clés d'API séparées pour des applications ou des utilisateurs différents ou pour prendre en charge des scénarios de renouvellement des clés. Vous pouvez révoquer des clés d'API depuis la console sans entraver le fonctionnement des autres clés d'API ou de l'utilisateur.

  L'exemple de commande curl suivant s'authentifie avec la clé d'API f5sAznhrKQyvBFFaZbtF60m5tzLbqWhyALQawBg5TjRI.

  curl -u "apikey:f5sAznhrKQyvBFFaZbtF60m5tzLbqWhyALQawBg5TjRI" \
  "{url}/v1/{method}"
  

Dans les environnements de test et de développement, vous pouvez transmettre directement une clé d'API. Toutefois, pour les utilisations en production, privilégiez le jeton IAM, sauf si vous utilisez les logiciels SDK Watson. La transmission d'une clé d'API peut avoir des conséquences négatives sur les performances, car le service recherche les détails associés à cette clé. Pour plus d'informations, voir Appel des API de service IBM Cloud.

Les logiciels SDK Watson sont compatibles avec les deux méthodes. Pour plus d'informations, voir la section Authentification de la référence d'API de votre service et SDK.

Certains plans de service permettent IBM® Key Protect for IBM Cloud®de contrôler l'accès aux données. Pour plus d'informations, voir Protection des informations sensibles dans votre service Watson.

Authentification à IBM Cloud Pak for Data

IBM Cloud Pak for Data

Vous vous authentifiez auprès du service en transmettant un jeton d'accès à chaque demande. Vous transmettez un jeton au porteur dans un en-tête Authorization pour l'authentification. Il existe plusieurs méthodes pour générer le jeton, notamment à l'aide d'une clé d'API ou d'un nom d'utilisateur. Pour plus d'informations, voir Génération d'un jeton d'autorisation ou d'une clé d'API.

Pour plus d'informations sur les méthodes d'authentification prises en charge par les logiciels SDK Watson pour les services installés sur IBM Cloud Pak for Data, voir la section Authentification de la référence d'API pour votre service et votre logiciel SDK.