> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pruebe la autenticación externa

> Pruebe la configuración de su proveedor de identidad externo ejecutando una URL de test-challenge en el navegador antes de aplicar el proveedor a un tenant de Vantage.

Antes de aplicar un proveedor de identidad externo a su tenant, pruebe los parámetros para confirmar que Vantage puede autenticarse a través de él.

<div id="test-an-external-identity-provider">
  ## Probar un proveedor de identidad externo
</div>

<Steps>
  <Step title="Abra la URL de test-challenge en su navegador">
    Use el formato de URL correspondiente a su protocolo y rellene los parámetros según la referencia de [Parámetros](#parameters) que aparece a continuación. Para ver ejemplos completos, consulte [Enlaces de ejemplo](#sample-links).

    **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>
    ```
  </Step>

  <Step title="Autentíquese con el proveedor de identidad externo">
    Introduzca sus credenciales en la página de inicio de sesión del proveedor de identidad.
  </Step>

  <Step title="Compruebe el resultado">
    Ocurrirá una de estas tres cosas:

    * **Éxito con un `returnUrl`** — Vantage le redirige a la URL especificada en `returnUrl`. La barra de direcciones muestra el nombre de usuario y el correo electrónico del usuario autenticado.
    * **Éxito sin un `returnUrl`** — Vantage le redirige a la página desde la que abrió el enlace de prueba.
    * **Error** — Aparece un error de autenticación en la página de inicio de sesión del proveedor de identidad. Compruebe sus parámetros y vuelva a realizar la prueba.
  </Step>
</Steps>

<div id="parameters">
  ## Parámetros
</div>

| Parámetro   | Requerido para      | Descripción                                                                                                                                                                       |
| :---------- | :------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `settings`  | OAuth 2.0, SAML 2.0 | JSON que describe el proveedor de identidad externo. La estructura varía según el protocolo; consulte a continuación.                                                             |
| `returnUrl` | OAuth 2.0, SAML 2.0 | La URL a la que Vantage redirige después de una prueba exitosa. Para las pruebas, use cualquier endpoint de Vantage, como `/skills`. La raíz de la URL se agrega automáticamente. |
| `tenantId`  | Solo SAML 2.0       | El identificador del tenant de Vantage utilizado para la autenticación.                                                                                                           |

<div id="settings-for-oauth-20">
  ### `settings` para OAuth 2.0
</div>

| Campo                | Descripción                                                 |
| :------------------- | :---------------------------------------------------------- |
| `Kind`               | `AzureActiveDirectoryOidc` o `OnPremiseActiveDirectoryOidc` |
| `Settings.Authority` | URL del proveedor de identidad externo                      |
| `Settings.ClientId`  | Identificador de cliente del proveedor de identidad         |

Ejemplo:

```json theme={null}
{
  "Kind": "AzureActiveDirectoryOidc",
  "Settings": {
    "Authority": "https://login.microsoftonline.com/11112222-3333-4444-5555-666677778888",
    "ClientId": "aaaabbbb-0000-cccc-1111-dddd2222eeee"
  }
}
```

<div id="settings-for-saml-20">
  ### `settings` para SAML 2.0
</div>

| Campo                  | Descripción                                                |
| :--------------------- | :--------------------------------------------------------- |
| `Kind`                 | `Saml2`                                                    |
| `Settings.MetadataUri` | URL del documento de metadatos de la federación            |
| `Settings.OwnEntityId` | URI del ID de la aplicación con el formato `api://<appId>` |

Ejemplo:

```json theme={null}
{
  "Kind": "Saml2",
  "Settings": {
    "MetadataUri": "https://login.microsoftonline.com/11112222-3333-4444-5555-666677778888/federationmetadata/2007-06/federationmetadata.xml",
    "OwnEntityId": "api://cccc3333-dddd-4444-eeee-5555ffff6666"
  }
}
```

<div id="sample-links">
  ## Enlaces de ejemplo
</div>

<Accordion title="Enlace de ejemplo (OAuth 2.0)">
  ```
  https://vantage-eu.abbyy.com/auth2/api/v1/account/external/test-challenge?settings={"Kind":"AzureActiveDirectoryOidc","Settings":{"Authority":"https://login.microsoftonline.com/11112222-3333-4444-5555-666677778888","ClientId":"aaaabbbb-0000-cccc-1111-dddd2222eeee"}}&returnUrl=/skills
  ```
</Accordion>

<Accordion title="Enlace de ejemplo (SAML 2.0)">
  ```
  https://vantage-eu.abbyy.com/auth2/api/v1/account/external/test-challenge?settings={"Kind":"Saml2","Settings":{"MetadataUri":"https://login.microsoftonline.com/11112222-3333-4444-5555-666677778888/federationmetadata/2007-06/federationmetadata.xml","OwnEntityId":"api://cccc3333-dddd-4444-eeee-5555ffff6666"}}&returnUrl=/skills&tenantId=your_vantage_tenant_id
  ```
</Accordion>

<div id="related-topics">
  ## Temas relacionados
</div>

* [Configurar un proveedor de identidad externo](/es/vantage/documentation/tenant-admin/tenant-management/external-identity-provider)
* [Configurar un proveedor de identidad externo para un tenant](/es/vantage/documentation/tenant-admin/tenant-management/configuring-tenant)
* [Configurar un proveedor de identidad externo OAuth 2.0](/es/vantage/documentation/tenant-admin/tenant-management/oauth-2-0)
* [Configurar un proveedor de identidad externo SAML 2.0](/es/vantage/documentation/tenant-admin/tenant-management/saml-2-0)