Gestion des informations d'identification des tâches

Dernière mise à jour : 14 mars 2025

L'identifiant de la tâche est une clé API générée par l'utilisateur, stockée en toute sécurité dans Vault, qui facilite l'authentification des demandes adressées aux IBM Cloud Services. Les identifiants de tâches sont utilisés pour exécuter certaines tâches dans un service ou pour permettre l'exécution de longues opérations, telles que des tâches programmées, sans interruption.

Dans IBM watsonx, les clés d'API IBM Cloud sont utilisées comme données d'identification de tâche. Vous pouvez soit fournir une clé d'API IBM Cloud existante, soit générer une nouvelle clé. Un seul justificatif de tâche peut être stocké par utilisateur, par compte IBM Cloud

Les informations d'identification des tâches mettent les clés API à la disposition des charges de travail asynchrones à long terme qui sont déclenchées par les actions que vous effectuez dans l'interface utilisateur du produit. Vous n'utilisez pas d'identifiants de tâches lorsque vous interagissez avec IBM watsonx par programme.

Si votre service nécessite un justificatif de tâche pour effectuer une opération, vous êtes invité à le fournir sous la forme d'une clé API (existante ou nouvellement générée).

Tout utilisateur disposant d'un compte IBM Cloud peut créer une clé d'API. Les administrateurs de services sont chargés de définir une stratégie pour révoquer les identifiants de tâches lorsqu'ils ne sont plus nécessaires.

Accès aux informations d'identification des tâches

Pour accéder à vos identifiants de tâches, procédez comme suit :

Connectez-vous à watsonx (https://dataplatform.cloud.ibm.com/wx/) et allez dans l'onglet "profil" :
Choisissez Profil et paramètres: '
Sélectionnez l'onglet User API key:

Création de justificatifs d'identité de tâche à partir de l'interface utilisateur

Pour créer de nouvelles références de tâches :

Dans l'onglet Clé API utilisateur, cliquez sur Créer une clé. Vous verrez votre nouvelle clé API apparaître dans la liste des clés : Informations d'identification générées pour les tâches

Création de justificatifs d'identité de tâche par programmation

Scénario 1 : Création d'identifiants de tâche pour un identifiant de service existant

Si vous utilisez serviceIDs,, vous ne pouvez pas utiliser UI Path pour créer des identifiants de tâche. Vous devez exécuter la requête d' cURL s suivante pour créer un identifiant de tâche pour l' serviceID spécifiée. Ce justificatif d'identité sera utilisé pour créer des déploiements, des tâches de déploiement et d'autres opérations connexes :

curl -X POST "https://<your cloud URL>/v1/task_credentials?owner.user_id=<your IBM user ID>&owner.account_id=<your IBM account ID>" \
  -H "accept: application/json" \
  -H "Authorization: Bearer <your service id api key token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "SERVICE_ID_TASK_CREDENTIALS",
    "description": "string",
    "type": "iam_api_key",
    "secret": {
      "api_key": "<your service id apikey>"
    }
  }'

Répétez cette opération pour tous les emplacements géographiques. Pour plus de détails, reportez-vous aux URL des sites géographiques disponibles.

Après avoir créé des identifiants de tâche, attendez 15 à 20 minutes avant de relancer les tâches ou les déploiements ayant échoué (mesure de précaution) afin que les données soient synchronisées pour vos identifiants de tâche nouvellement créés.

Scénario 2 : Création d'identifiants de tâche pour les utilisateurs réguliers (à l'aide de l'API)

Exécutez la requête d' cURL s suivante pour créer un identifiant de tâche :

curl -X POST "https://<your cloud URL>/v1/task_credentials?owner.user_id=<your IBM user ID>&owner.account_id=<your IBM account ID>" \
  -H "accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "USER_TASK_CREDENTIALS",
    "description": "string",
    "type": "iam_api_key",
    "secret": {
      "api_key": "<your api key>"
    }
  }'

Répétez cette opération pour tous les autres sites. Pour plus de détails, reportez-vous aux URL des sites géographiques disponibles.

URL des sites géographiques disponibles

Tokyo : https://api.jp-tok.dataplatform.cloud.ibm.com
Dallas : https://api.dataplatform.cloud.ibm.com
Francfort : https://api.eu-de.dataplatform.cloud.ibm.com
Londres : https://api.eu-gb.dataplatform.cloud.ibm.com