Lire et examiner la documentation Automation Anywhere

Automation 360

Fermer les contenus

Contenus

Ouvrir les contenus

Configurer un justificatif d'identité avec des valeurs d'attributs en utilisant l'API

  • Mis à jour le : 2021/12/16
    • Automation 360 v.x
    • Explorer
    • Espace de travail RPA

Configurer un justificatif d'identité avec des valeurs d'attributs en utilisant l'API

Créez un justificatif d'identité avec un attribut standard et ajoutez deux attributs supplémentaires avec des valeurs saisies par l'utilisateur.

Prérequis

Remarque : Vous pouvez consulter le Control Room APIs dans le Community Editionmais la fonctionnalité de l'API est limitée. Vous devez posséder une licence Automation 360 Edition pour accéder à l'ensemble des fonctionnalités des API.
  • Tous les appels d'API doivent contenir un jeton d'authentification dans l'en-tête de la demande. Utilisez l'option Authentification pour générer un jeton Web JSON. Reportez-vous à API d'authentification.
  • Tous les rôles ont le Gérer mes informations d'identification et mes casiers qui est nécessaire pour configurer les informations d'identification et les attributs. Aucune autorisation supplémentaire n'est nécessaire pour utiliser ce point de terminaison.
Dans cet exemple, vous configurez un justificatif d'identité avec trois attributs pour contenir le nom d'hôte, le nom d'utilisateur et le mot de passe du courrier électronique.

Procédure

  1. Ajoutez le jeton d'authentification à l'en-tête de la requête.

Créez une accréditation :

  1. Utilisez la méthode POST et l'URL du point de terminaison :<votre_salle_de_contrôle_url>/v2/credentialvault/credentials.
    Corps de la demande : Cet exemple de demande comprend les paramètres obligatoires suivants :
    • userProvidedune valeur booléenne qui indique si l'attribut nécessite l'intervention d'un utilisateur (true) ou s'il est standard pour tous les utilisateurs (false).
    • masquéune valeur booléenne qui permet de configurer si la valeur de l'attribut est masquée par des astérisques (true) ou si elle est visible pour les utilisateurs (false).
    {
      "name": "Email",
      "attributes": [
      	{
          "name": "hostname",
          "userProvided": false,
          "masked": false
        } 	
      ]
    }
  2. Envoyez la demande.
    Corps de la réponse : Dans une requête réussie, ce point de contact renvoie les données suivantes :
    • idun identifiant numérique unique pour le justificatif d'identité.
    • attributs:idun identifiant numérique unique pour l'attribut.
    {
        "id": "1630",
        "name": "Email",
        "description": "",
        "ownerId": "1508",
        "attributes": [
            {
                "id": "3335",
                "name": "hostname",
                "description": "",
                "userProvided": false,
                "masked": false,
                "createdBy": "1508",
                "createdOn": "2020-12-28T22:04:41.366448Z",
                "updatedBy": "1508",
                "updatedOn": "2020-12-28T22:04:41.366450Z",
                "version": "0",
                "passwordFlag": false
            }
        ],
        "createdBy": "1508",
        "createdOn": "2020-12-28T22:04:41.366460Z",
        "updatedBy": "1508",
        "updatedOn": "2020-12-28T22:04:41.366464Z",
        "version": "0"
    }
    L'API REST répond à chaque demande par un code de réponse HTTP.Pour les codes de réponse, voir Codes de réponse de l'API.

Attribuez une valeur standard à l'attribut hostname de l'accréditation :

  1. Utilisez la méthode POST et l'URL du point de terminaison :<your_control_room_url>/v2/credentialvault/credentials/{credentialId}/attributevalues.
    {
      "list": [
        {
          "credentialAttributeId": "3335",
          "value": "mail.example.com"
        }
      ]
    }
  2. Envoyez la demande.
    Corps de la réponse :
    {
      "list": [
        {
          "id": "1630",
          "credentialAttributeId": "3335",
          "value": "mail.example.com",
          "userId": "1508",
          "createdBy": "1508",
          "createdOn": "2020-12-28T22:04:41.366460Z",
          "updatedBy": "1508",
          "updatedOn": "2020-12-28T22:04:41.366464Z",
          "version": "0"
        }
      ]
    }
  3. Ajoutez le nom d'utilisateur et mot de passe aux attributs Courriel credential. Utilisez la méthode PUT et l'URL du point de terminaison :<votre_salle_de_contrôle_url>/v2/credentialvault/credentials/{credentialId}.
    Remarque : Vous devez inclure les attributs existants avec les nouveaux attributs dans la demande, sinon les attributs actuels seront écrasés.
    Corps de la demande : Puisque vous avez spécifié l'ID d'accréditation dans l'URL de la demande, il n'est pas nécessaire d'inclure l'ID ou le nom d'accréditation dans le corps de la demande. Dans le corps de la requête de cet exemple, le nom d'utilisateur et mot de passe sont configurés avec des valeurs qui acceptent une entrée différente pour chaque utilisateur. En outre, l'attribut du mot de passe est configuré pour masquer la valeur saisie par des astérisques.
    {
        "attributes": [
      	{
          "name": "username",
          "userProvided": true,
          "masked": false
        },
         {
          "name": "password",
          "userProvided": true,
          "masked": true
        },
         {
          "name": "hostname",
          "userProvided": false,
          "masked": false
        } 		
      ]
    }
  4. Envoyez la demande.
    Corps de la réponse : Le corps de réponse renvoie la créance avec les détails des trois attributs.
    {
        "id": "1630",
        "name": "Email",
        "description": "",
        "ownerId": "1508",
        "attributes": [
            {
                "id": "3335",
                "name": "hostname",
                "description": "",
                "userProvided": false,
                "masked": false,
                "createdBy": "1508",
                "createdOn": "2020-12-28T22:04:41.366448Z",
                "updatedBy": "1508",
                "updatedOn": "2020-12-28T22:04:41.366450Z",
                "version": "0",
                "passwordFlag": false
            },
            {
                "id": "3336",
                "name": "username",
                "description": "",
                "userProvided": true,
                "masked": false,
                "createdBy": "1508",
                "createdOn": "2020-12-28T22:04:41.366450Z",
                "updatedBy": "1508",
                "updatedOn": "2020-12-28T22:04:41.366450Z",
                "version": "0",
                "passwordFlag": false
            },
            {
                "id": "3337",
                "name": "password",
                "description": "",
                "userProvided": true,
                "masked": true,
                "createdBy": "1508",
                "createdOn": "2020-12-28T22:04:41.366450Z",
                "updatedBy": "1508",
                "updatedOn": "2020-12-28T22:04:41.366450Z",
                "version": "0",
                "passwordFlag": false
            }
        ],
        "createdBy": "1508",
        "createdOn": "2020-12-28T22:04:41.366460Z",
        "updatedBy": "1508",
        "updatedOn": "2020-12-28T22:06:35.366464Z",
        "version": "2"
    }

Étapes suivantes

Si vous suivez les étapes de la configuration de votre site Web, procédez comme suit Credential Vault, procédez comme suit : Attribuer une accréditation à locker API.
Envoyer le commentaire