> ## 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.

# Tester l’authentification externe

> Vérifiez la configuration de votre fournisseur d’identité externe en ouvrant une URL de test-challenge dans votre navigateur avant d’appliquer ce fournisseur à un tenant Vantage.

Avant d’appliquer un fournisseur d’identité externe à votre tenant, testez vos paramètres pour vérifier que Vantage peut s’authentifier par son intermédiaire.

<div id="test-an-external-identity-provider">
  ## Tester un fournisseur d’identité externe
</div>

<Steps>
  <Step title="Ouvrez l’URL de test-challenge dans votre navigateur">
    Utilisez le modèle d’URL correspondant à votre protocole en renseignant les paramètres à partir de la référence [Paramètres](#parameters) ci-dessous. Pour des exemples complets, voir [Exemples de liens](#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="Authentifiez-vous auprès du fournisseur d’identité externe">
    Saisissez vos identifiants sur la page de connexion du fournisseur d’identité.
  </Step>

  <Step title="Vérifiez le résultat">
    L’un des trois résultats suivants se produit :

    * **Succès avec un `returnUrl`** — Vantage vous redirige vers l’URL indiquée dans `returnUrl`. La barre d’adresse affiche le nom d’utilisateur et l’adresse e-mail de l’utilisateur authentifié.
    * **Succès sans `returnUrl`** — Vantage vous redirige vers la page à partir de laquelle vous avez ouvert le lien de test.
    * **Échec** — Une erreur d’authentification s’affiche sur la page de connexion du fournisseur d’identité. Vérifiez vos paramètres et exécutez de nouveau le test.
  </Step>
</Steps>

<div id="parameters">
  ## Paramètres
</div>

| Paramètre   | Requis pour         | Description                                                                                                                                                                         |
| :---------- | :------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `settings`  | OAuth 2.0, SAML 2.0 | JSON décrivant le fournisseur d’identité externe. La structure varie selon le protocole — voir ci-dessous.                                                                          |
| `returnUrl` | OAuth 2.0, SAML 2.0 | URL vers laquelle Vantage redirige après un test réussi. Pour les tests, utilisez n’importe quel endpoint Vantage, comme `/skills`. La racine de l’URL est ajoutée automatiquement. |
| `tenantId`  | SAML 2.0 uniquement | Identifiant du tenant Vantage utilisé pour l’authentification.                                                                                                                      |

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

| Champ                | Description                                                  |
| :------------------- | :----------------------------------------------------------- |
| `Kind`               | `AzureActiveDirectoryOidc` ou `OnPremiseActiveDirectoryOidc` |
| `Settings.Authority` | URL du fournisseur d’identité externe                        |
| `Settings.ClientId`  | Identifiant client du fournisseur d’identité                 |

Exemple :

```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` pour SAML 2.0
</div>

| Champ                  | Description                                             |
| :--------------------- | :------------------------------------------------------ |
| `Kind`                 | `Saml2`                                                 |
| `Settings.MetadataUri` | URL du document de métadonnées de fédération            |
| `Settings.OwnEntityId` | URI d’ID de l’application sous la forme `api://<appId>` |

Exemple :

```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">
  ## Liens d’exemple
</div>

<Accordion title="Lien d’exemple (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="Lien d’exemple (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">
  ## Sujets connexes
</div>

* [Configurer un fournisseur d’identité externe](/fr/vantage/documentation/tenant-admin/tenant-management/external-identity-provider)
* [Configuration d’un fournisseur d’identité externe pour un tenant](/fr/vantage/documentation/tenant-admin/tenant-management/configuring-tenant)
* [Configurer un fournisseur d’identité externe OAuth 2.0](/fr/vantage/documentation/tenant-admin/tenant-management/oauth-2-0)
* [Configurer un fournisseur d’identité externe SAML 2.0](/fr/vantage/documentation/tenant-admin/tenant-management/saml-2-0)