Saltar al contenido principal
Antes de configurar un proveedor de identidad externo para que lo use un inquilino, verifique que los parámetros especificados del proveedor de identidad externo sean correctos. Para probar la autenticación externa mediante Vantage API, haga lo siguiente según el protocolo que utilice:
  1. Según el protocolo que utilice, abra el siguiente enlace con los parámetros descritos en la tabla a continuación:
    • OAuth 2.0: https://<your-vantage-url>/api/v1/external/test-challenge?settings=<settings>&returnUrl=<returnUrl>
    • SAML 2.0: https://<your-vantage-url>/api/v1/external/test-challenge?settings=<settings>&returnUrl=<returnUrl>&tenantId=<tenantId>

Parámetros

ParameterProtocolDescription
settingsOAuth 2.0Configuración de autenticación del proveedor de identidad externo en formato JSON. Incluye el tipo de proveedor de identidad externo (el parámetro Kind, puede tener los valores AzureActiveDirectoryOidc o OnPremiseActiveDirectoryOidc), la URL del proveedor de identidad externo (parámetro Authority) y el ID de cliente (parámetro ClientId).

Por ejemplo:
{"Kind":"AzureActiveDirectoryOidc","Settings":{"Authority":"https://login.microsoftonline.com/fb46032a-31c4-42ff-890d-6e08d6f57da3","ClientId":"4e674698-09b8-4ac5-8df7-35d6f0c1e36c"}}
settingsSAML 2.0Configuración de autenticación del proveedor de identidad externo en formato JSON. Incluye el tipo de proveedor de identidad externo y la URL del proveedor de identidad externo.

Por ejemplo:
{"Kind":"Saml2","Settings":{"MetadataUri":"https://login.microsoftonline.com/fb46032a-31c4-42ff-890d-6e08d6f57da3/federationmetadata/2007-06/federationmetadata.xml"}}
returnUrlOAuth 2.0 o SAML 2.0La URL a la que se redirigirá una vez completada la autenticación. Para fines de prueba, especifique cualquier endpoint de Vantage como /skills. La raíz de la URL se inserta automáticamente en el enlace utilizado para la autorización.
tenantIdSAML 2.0El identificador del arrendatario que se utilizará para la autenticación mediante un proveedor de identidad externo SAML 2.0.
https://vantage-eu.abbyy.com/auth2/api/v1/account/external/test-challenge?settings={"Kind":"AzureActiveDirectoryOidc","Settings":{"Authority":"https://login.microsoftonline.com/fb46032a-31c4-42ff-890d-6e08d6f57da3","ClientId":"4e674698-09b8-4ac5-8df7-35d6f0c1e36c"}}&returnUrl=/skills
https://vantage-eu.abbyy.com/auth2/api/v1/account/external/test-challenge?settings={"Kind":"Saml2","Settings":{"MetadataUri":"https://login.microsoftonline.com/fb46032a-31c4-42ff-890d-6e08d6f57da3/federationmetadata/2007-06/federationmetadata.xml"}}&returnUrl=/skills&tenantId=your_vantage_tenant_id
  1. Introduzca sus credenciales del Proveedor de identidad externo.
  2. Tras completar correctamente el procedimiento de autenticación, será redirigido a la página desde la que envió la solicitud o a la página especificada en el parámetro returnUrl. En este último caso, la barra de direcciones mostrará información del usuario autenticado: nombre de usuario y correo electrónico. Si los parámetros introducidos son incorrectos, se mostrará un error de autenticación en la página del Proveedor de identidad externo. En ese caso, verifique que la configuración sea correcta y repita la prueba después de aplicar los cambios correspondientes.