Lea y revise la documentación de Automation Anywhere

Cerrar contenidos

Contenidos

Abrir contenidos

API de Enterprise Control Room para administrar las credenciales de inicio de sesión de los bots

  • Actualizado: 9/05/2019

    API de Enterprise Control Room para administrar las credenciales de inicio de sesión de los bots

    Puede utilizar las API de inicio de sesión de los bots para automatizar el proceso de inicio de sesión que permite a un usuario con los privilegios adecuados crear, actualizar o eliminar las credenciales de inicio de sesión almacenadas en Bóveda de Credenciales.

    Credenciales de inicio de sesión

    Cuando el bot se implementa desde Enterprise Control Room hacia Bot Runner, el bot inicia sesión automáticamente en Bot Runner (si la máquina está bloqueada o con la sesión cerrada). El bot utilizará las credenciales almacenadas en Credential Vault para el inicio de sesión automático. El usuario puede configurar estas credenciales en Herramientas → Opciones → Configuración de inicio de sesión, en Enterprise Client.

    Sin embargo, podría haber casos en los que se modifique la contraseña de Windows del usuario, especialmente en las empresas donde hay una política de rotación de contraseñas. En estos casos, el usuario deberá recordar actualizar la nueva contraseña en Herramientas → Opciones → Configuración de inicio de sesión.

    Para automatizar el proceso anterior, Enterprise Control Room 11.1 cuenta con una API directa para crear, actualizar o eliminar las credenciales de inicio de sesión almacenadas en Bóveda de Credenciales.

    Existen 2 pasos para usar esta API:

    1. Invocar la API de autenticación
    2. Invocar la API de credenciales de inicio de sesión

    API de autenticación

    Puede consultar los detalles de la API de autenticación en el artículo API de autenticación de Enterprise Control Room.

    API de credenciales de inicio de sesión

    Nota: Únicamente los administradores de Enterprise Control Room (es decir, los usuarios que tienen el rol AAE_Admin) tienen acceso a usar la API de credenciales de inicio de sesión. Esto significa que, si el usuario que invoca la API de autenticación tiene un rol AAE_Admin, únicamente ese usuario puede usar la API de credenciales de inicio de sesión.
    Además, esta API usará el token de autenticación que se obtiene con la API de autenticación. El token de autenticación se debe pasar como una de las entradas de encabezado en la API de credenciales de inicio de sesión.

    API: v1/credentialvault/external/credentials/loginsetting

    Si la dirección URL de Enterprise Control Room es https://ultron.com:81, entonces la API será: https://ultron.com:81/v1/credentialvault/external/credentials/loginsetting

    La API necesita tres parámetros obligatorios como entrada en formato JSON:

    1. El nombre del usuario de .
    2. El nombre de usuario (de inicio de sesión en Windows) de la persona que se actualizará en Bóveda de Credenciales.
    3. La contraseña (de inicio de sesión en Windows) de la persona que se actualizará en Bóveda de Credenciales.
      Nota: Todos los parámetros son obligatorios.

    Por ejemplo:

    Si tomamos un escenario de "Autenticación de base de datos" (donde los usuarios se almacenan y autentican en Enterprise Control Room)

    1. El nombre del usuario de es mike_williams
    2. El nombre de usuario de inicio de sesión completo es ultron.com\mike.williams
    3. La contraseña de inicio de sesión es abc123, entonces el JSON será:

      { "Username": "mike_williams", "Windows_Username": "ultron.com\\mike.williams", "Windows_Password": "abc123" }

    Con la API de credenciales de inicio de sesión, los administradores de Enterprise Control Room pueden hacer lo siguiente:

    1. Crear las credenciales de inicio de sesión de un usuario en Enterprise Control Room con el método "POST"
    2. Actualizar las credenciales de inicio de sesión de un usuario en Enterprise Control Room con el método "PUT"
    3. Eliminar las credenciales de inicio de sesión de un usuario de Enterprise Control Room con el método "DELETE".

    Utilizar VB Script para crear las credenciales de inicio de sesión de un usuario

    "API DE AUTENTICACIÓN - INICIO

    Set objStream = CreateObject("ADODB.Stream")

    objStream.CharSet = "utf-8"

    objStream.Open

    objStream.LoadFromFile("D:\Deven.Deshpande\Office\Products\API for CV\auth-input.txt")

    restRequest = objStream.ReadText()

    objStream.Close

    Set objStream = Nothing

    contentType = "application/json"

    Set oWinHttp = CreateObject("WinHttp.WinHttpRequest.5.1")

    oWinHttp.Open "POST", "http://productslt12.aaspl-brd.com:81/v1/authentication", False

    oWinHttp.setRequestHeader "Content-Type", contentType

    oWinHttp.Send restRequest

    response = oWinHttp.StatusText

    MsgBox response

    Dim AuthToken

    'Set oJson = new aspJSON

    AuthToken = oWinHttp.ResponseText

    'oJson.loadJSON(AuthToken)

    'MsgBox oJson.data("token")

    MsgBox AuthToken

    "API DE AUTENTICACIÓN - FIN

    '---------------------------------------------------

    "ANÁLISIS DE ENCABEZADO DE RESPUESTA - INICIO

    Dim sToken

    Dim posUser

    sToken = Right(AuthToken, Len(AuthToken) - 10)

    MsgBox(sToken)

    'sToken = Left(sToken, Len(sToken) - 4)

    posUser = InStr(sToken, "user")

    MsgBox posUser

    sToken = Left(sToken, posUser - 4)

    MsgBox(sToken)

    "ANÁLISIS DE ENCABEZADO DE RESPUESTA - FIN

    "API DE IMPLEMENTACIÓN - INICIO

    Set objStream_dep = CreateObject("ADODB.Stream")

    objStream_dep.CharSet = "utf-8"

    objStream_dep.Open

    objStream_dep.LoadFromFile("D:\Deven.Deshpande\Office\Products\API for CV\cred-input.txt")

    restRequest = objStream_dep.ReadText()

    objStream_dep.Close

    Set objStream = Nothing

    contentType = "application/json"

    Set oWinHttp = CreateObject("WinHttp.WinHttpRequest.5.1")

    oWinHttp.Open "PUT", "http://productslt12.aaspl-brd.com:81/v1/credentialvault/external/credentials/loginsetting", False

    oWinHttp.setRequestHeader "Content-Type", contentType

    oWinHttp.setRequestHeader "X-Authorization", sToken

    oWinHttp.Send restRequest

    response = oWinHttp.StatusText

    MsgBox response

    Dim DeployResponse

    DeployResponse = oWinHttp.ResponseText

    'MsgBox DeployResponse

    "API DE IMPLEMENTACIÓN - FIN

    Contenido de los archivos de entrada

    Aplica para la secuencia anterior de VB Script

    El texto de auth-input.txt tendrá la cadena de entrada JSON para la autenticación {"UserName":"admin","Password":"12345678"}

    El texto para deploy-input.txt tendrá la cadena de entrada JSON para la implementación

    { "Username": "mike_williams", "Windows_Username": "ultron.com\\mike.williams", "Windows_Password": "abc123" }

    Enviar comentarios