Externe Authentifizierung testen - ABBYY Documentation

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.

Einen externen Identitätsanbieter testen

Ö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-Referenz ein. Vollständige Beispiele finden Sie unter Beispiellinks.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>

Authentifizieren Sie sich beim externen Identitätsanbieter

Geben Sie Ihre Anmeldedaten auf der Anmeldeseite des Identitätsanbieters ein.

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

Parameter

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.

`settings` für OAuth 2.0

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

Beispiel:

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

`settings` für SAML 2.0

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

Beispiel:

{
  "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"
  }
}

Beispiel-Links

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

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

​Einen externen Identitätsanbieter testen

​Parameter

​settings für OAuth 2.0

​settings für SAML 2.0

​Beispiel-Links

​Verwandte Themen

Einen externen Identitätsanbieter testen

Parameter

`settings` für OAuth 2.0

`settings` für SAML 2.0

Beispiel-Links

Verwandte Themen