Lea y revise la documentación de Automation Anywhere

Automation Anywhere Automation 360

Cerrar contenidos

Contenidos

Abrir contenidos

Configurar una credencial con valores de atributo mediante API

  • Actualizado: 2021/01/31
    • Automation 360 v.x
    • Explorar
    • Espacio de trabajo de RPA

Configurar una credencial con valores de atributo mediante API

Cree una credencial con un atributo estándar y agregue dos atributos adicionales con valores de entrada de usuario.

Antes de empezar

Nota: Puede ver el Control Room APIs en Community Edition, pero la funcionalidad de la API es limitada. Necesita una Automation 360 edición con licencia para acceder a la funcionalidad completa de las API.
  • Utilice la API de autenticación para generar un token web JSON. Consulte API de autenticación.
  • Todos los roles tienen el permiso Administrar mis credenciales y bloqueos que es necesario para configurar credenciales y atributos. No se necesitan permisos adicionales para usar este criterio de valoración.
En este ejemplo, usted configura una credencial con tres atributos para mantener el nombre de host, nombre de usuario y contraseña de correo electrónico.

Procedimiento

  1. Agregue el token de autenticación al encabezado de la solicitud.
  2. Cree una credencial. Utilice el método POST y la URL de punto final: <your_control_room_url>/v2/credentialvault/credentials.
    Cuerpo de la solicitud: Esta solicitud de ejemplo incluye los siguientes parámetros requeridos:
    • userProvided: un valor booleano que configura si el atributo requiere la entrada de un usuario (verdadero) o es estándar para todos los usuarios (falso).
    • enmascarado: un valor booleano que configura si el valor del atributo está enmascarado con asteriscos (verdadero) o es visible para los usuarios (falso).
    {
      "name": "Email",
      "attributes": [
      	{
          "name": "hostname",
          "userProvided": false,
          "masked": false
        } 	
      ]
    }
  3. Enviar la
    Cuerpo de la respuesta: En una solicitud exitosa, este terminal devuelve los siguientes datos:
    • id: un identificador numérico único para la credencial.
    • atributos:id: un identificador numérico único para el atributo.
    {
        "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"
    }
    La API REST responde a cada solicitud con un código de respuesta HTTP. Para ver los códigos de respuesta, consulte Códigos de respuesta de API.
  4. Asigne un valor estándar al atributo de nombre de host a la credencial. Utilice el método POST y la URL de punto final:<your_control_room_url>/{credentialId}v2/credentialvault/credentials//attributevalues.
    {
      "list": [
        {
          "credentialAttributeId": "3335",
          "value": "mail.example.com"
        }
      ]
    }
  5. Enviar la
    Cuerpo de la respuesta:
    {
      "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"
        }
      ]
    }
  6. Agregue los atributos de nombre de usuario y contraseña a la credencial de correo electrónico. Utilice el método PUT y la URL de punto final:<your_control_room_url>/v2/credentialvault/credentials/{credentialId}.
    Cuerpo de la solicitud: Dado que especificó el ID de credencial en la URL de la solicitud, no es necesario incluir el ID de credencial o el nombre en el cuerpo de la solicitud. En este cuerpo de solicitud de ejemplo, los atributos de nombre de usuario y contraseña se configuran con valores que aceptan una entrada diferente de cada usuario. Además, el atributo de contraseña se configura para enmascarar el valor ingresado con asteriscos.
    {
        "attributes": [
      	{
          "name": "username",
          "userProvided": true,
          "masked": false
        },
         {
          "name": "password",
          "userProvided": true,
          "masked": true
        }	
      ]
    }
  7. Enviar la
    Cuerpo de la respuesta: El cuerpo de la respuesta devuelve la credencial con detalles de los tres atributos.
    {
        "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"
    }

Qué hacer a continuación

Si está siguiendo los pasos para configurar su Credential Vault, haga lo siguiente: Asignar credencial a locker API.
Enviar comentarios