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

# Externe Authentifizierung testen

> Testen Sie die Konfiguration Ihres externen Identitätsanbieters, indem Sie vor der Verwendung des Anbieters für einen Vantage-Mandanten eine Test-Challenge-URL in Ihrem Browser aufrufen.

Bevor Sie einen externen Identitätsanbieter für Ihren Mandanten verwenden, testen Sie Ihre Parameter, um zu überprüfen, ob sich Vantage darüber authentifizieren kann.

<div id="test-an-external-identity-provider">
  ## Einen externen Identitätsanbieter testen
</div>

<Steps>
  <Step title="Öffnen Sie die test-challenge-URL in Ihrem Browser">
    Verwenden Sie das zu Ihrem Protokoll passende URL-Format und füllen Sie die Parameter aus der unten stehenden [Parameter](#parameters)-Referenz ein. Vollständige Beispiele finden Sie unter [Beispiellinks](#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="Authentifizieren Sie sich beim externen Identitätsanbieter">
    Geben Sie Ihre Anmeldedaten auf der Anmeldeseite des Identitätsanbieters ein.
  </Step>

  <Step title="Überprüfen Sie das Ergebnis">
    Es gibt drei mögliche Ergebnisse:

    * **Erfolg mit `returnUrl`** — Vantage leitet Sie an die in `returnUrl` angegebene URL weiter. In der Adressleiste werden der Benutzername und die E-Mail-Adresse des authentifizierten Benutzers angezeigt.
    * **Erfolg ohne `returnUrl`** — Vantage leitet Sie zurück zu der Seite, von der aus Sie den Testlink geöffnet haben.
    * **Fehler** — Auf der Anmeldeseite des Identitätsanbieters wird ein Authentifizierungsfehler angezeigt. Überprüfen Sie Ihre Parameter und führen Sie den Test erneut aus.
  </Step>
</Steps>

<div id="parameters">
  ## Parameter
</div>

| Parameter   | Erforderlich für    | Beschreibung                                                                                                                                                                          |
| :---------- | :------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `settings`  | OAuth 2.0, SAML 2.0 | JSON zur Beschreibung des externen Identitätsanbieters. Die Struktur variiert je nach Protokoll — siehe unten.                                                                        |
| `returnUrl` | OAuth 2.0, SAML 2.0 | Die URL, zu der Vantage nach einem erfolgreichen Test weiterleitet. Verwenden Sie zum Testen einen beliebigen Vantage-Endpunkt wie `/skills`. Die Stamm-URL wird automatisch ergänzt. |
| `tenantId`  | nur SAML 2.0        | Die Vantage-Mandanten-ID, die für die Authentifizierung verwendet wird.                                                                                                               |

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

| Feld                 | Beschreibung                                                   |
| :------------------- | :------------------------------------------------------------- |
| `Kind`               | `AzureActiveDirectoryOidc` oder `OnPremiseActiveDirectoryOidc` |
| `Settings.Authority` | URL des externen Identitätsanbieters                           |
| `Settings.ClientId`  | Client-ID des Identitätsanbieters                              |

Beispiel:

```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` für SAML 2.0
</div>

| Feld                   | Beschreibung                                  |
| :--------------------- | :-------------------------------------------- |
| `Kind`                 | `Saml2`                                       |
| `Settings.MetadataUri` | URL des Föderationsmetadaten-Dokuments        |
| `Settings.OwnEntityId` | Anwendungs-ID-URI in der Form `api://<appId>` |

Beispiel:

```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">
  ## Beispiel-Links
</div>

<Accordion title="Beispiel-Link (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="Beispiel-Link (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">
  ## Verwandte Themen
</div>

* [Einen externen Identitätsanbieter einrichten](/de/vantage/documentation/tenant-admin/tenant-management/external-identity-provider)
* [Einen externen Identitätsanbieter für einen Mandanten einrichten](/de/vantage/documentation/tenant-admin/tenant-management/configuring-tenant)
* [Einen externen Identitätsanbieter mit OAuth 2.0 konfigurieren](/de/vantage/documentation/tenant-admin/tenant-management/oauth-2-0)
* [Einen externen Identitätsanbieter mit SAML 2.0 konfigurieren](/de/vantage/documentation/tenant-admin/tenant-management/saml-2-0)