Lea y revise la documentación de Automation Anywhere

Cerrar contenidos

Contenidos

Abrir contenidos

API de autenticación

  • Actualizado: 5/06/2020
    • 11.3.x
    • Explorar
    • Enterprise
    • Documentos de API

API de autenticación

Utilice la API de autenticación para generar, actualizar y administrar los Web Token JSON (JSON Web Tokens, JWT) requeridos para la autorización en todas las API de Enterprise Control Room.

JWT es una cadena de texto con 703 caracteres.
{
  "token": "eyJhbGciOiJSUzUxMiJ9.eyJzdWIiOiIxIiwiY2xpZW50VHlwZSI6IldFQiIsImxpY2Vuc2VzIjpbXSwiYW5hbHl0aWNzTGljZW5zZXNQdXJjaGFzZWQiOnsiQW5hbHl0aWNzQ2xpZW50Ijp0cnVlLCJBbmFseXRpY3NBUEkiOnRydWV9LCJpYXQiOjE1NzMxMDc4NzMsImV4cCI6MTU3MzEwOTA3MywiaXNzIjoiQXV0b21hdGlvbkFueXdoZXJlIiwibmFub1RpbWUiOjM2NTc1NjI0OTQ2MzE2MDAsImNzcmZUb2tlbiI6ImNiZjgwZWNkZmU5YmUwYzViOGI2MDk3NmU0ZTI2MTNiIn0.rGYxbS5kKUTxtZhYtRSXpmIHwbf3IwLBIKDEA7odG5uGVAjD55Tv05bYdARx_3-tl1CBg_cDGbwj5FvaBt9u5xKu5W5j3Nur6x3PF62NeB3ZIdxiUPaFBU0Br84mPJMD4_EpwBfbeSVOMH6ngiLtJYhIOtJa0kp4pAAm3mvkuOUELtH8lf3pQf-2Ose2fUAaebDkqiH13SUF1TONAjUQv6Ef_uY0wgq9SjZwKHg9SKUhX3S8PXAJne_ih2QnN8nUE1SXGlkC04eoIvyWpFkM963XEjptc2uvwtVn42MdA4Nd1opD5yijEl9VM92Fe1sPb6_T5-oV-U1Iw0JHiX2-Ug",  . . . 
}

aute

PUBLICAR http://<your_control_room_url>/v1/authentication
Parámetros del cuerpo:
{
  "username": "string",
  "password": "string",
  "apiKey": "string",
  "mfaCode": 0
}
Haga una solicitud de publicar para generar un JWT.
  • El nombre del usuario de Automation Anywhere.
  • La contraseña del usuario de Automation Anywhere.
  • La clave de API es obligatoria para configurar el inicio de sesión único. También se puede utilizar en lugar de una contraseña para usuarios asignados al rol de generación de clave de API.
  • El código de autenticación multifactor es necesario para el usuario con un rol que ha sido habilitado para la 2FA. Consulte Habilitar la autenticación de dos factores.
    Nota: Recomendamos que desactive la 2FA en un rol o cree un rol independiente que no utilice la 2FA para usar en secuencias de comandos u otros entornos programáticos. Debe utilizar el nombre de usuario y una clave de API para autenticarse cuando se realicen solicitudes de API de manera programática. Evite usar contraseñas en formato de texto simple para mejorar la seguridad.
Nota: Los token de autenticación tienen un tiempo de espera predeterminado de 20 minutos.
Se requiere un JWT en el encabezado de otras API del Enterprise Control Room. No se requieren todos los parámetros para generar un token de autenticación. Consulte los ejemplos que aparecen aquí para obtener información detallada.
Nota:

Mecanismo GSSAPI de negociación simple y protegida (SPNEGO)

Puede usar SPNEGO, que se pronuncia "spinigou", cuando su Enterprise Control Room esté configurado correctamente con las siguientes características de autenticación:
  • Modo de autenticación de Active Directory (AD)
  • AD está habilitado para Kerberos

En un Enterprise Control Room con SPNEGO configurado correctamente, los usuarios no necesitan escribir nombre de usuario y contraseña para generar un JWT.

Ejemplo de dirección URL de API de autenticación de SPNEGO:https://<your_control_room_url/v1/authentication/SPNEGO

OBTENER http://<your_control_room_url>/v1/authentication/token/{token}
Parámetro de dirección URL:
El token que está validando.
Nota: El token se pasa como un parámetro en la URL. No hay parámetros para el cuerpo de solicitud.

Lea Validar un token de autenticación para obtener detalles de la tarea.

PUBLICAR http://<your_control_room_url>/v1/autenticación/token
Parámetro del cuerpo:
Un token de actualización le permite obtener una nueva clave sin la necesidad de recopilar y autenticar credenciales cada vez que un token caduque.
{
  "token": "string"
}

Haga clic en Actualización de un token de autenticación para obtener un ejemplo detallado de esta API.

PUBLICAR http://<your_control_room_url>/v1/authentication/logout
Parámetro del encabezado:
caduca inmediatamente el token que agrega al encabezado de la solicitud.
POST 'http://<your_control_room_url>/v1/authentication/logout'
-H 'X-Authorization: <access_token> 

Haga clic en Cerrar sesión de inmediato (caducar) un token de autenticación para obtener un ejemplo detallado de esta API.

PUBLICAR http://<your_control_room_url>/v1/authentication/app/login
La API .../autenticación/aplicación/inicio de sesión es una de autenticación de servicio a servicio utilizado por Automation Anywhere aplicaciones admitidas internamente. Esta API no es compatible para uso por parte de usuarios externos.
Enviar comentarios