Test dell'autenticazione esterna

Verifica la configurazione del provider di identità esterno eseguendo nel browser un URL test-challenge prima di applicare il provider a un tenant Vantage.

Prima di applicare un provider di identità esterno al tuo tenant, verifica i parametri per assicurarti che Vantage possa autenticarsi tramite tale provider.

​

Testare un provider di identità esterno

1. Apri l'URL test-challenge nel browser

   Usa il formato URL corrispondente al protocollo in uso, compilando i parametri in base al riferimento Parametri riportato di seguito. Per esempi completi, vedi Link di esempio.

   OAuth 2.0:

   https://<your-vantage-url>/api/v2/external/test-challenge?settings=<settings>&returnUrl=<returnUrl>
   

   SAML 2.0:

   https://<your-vantage-url>/api/v2/external/test-challenge?settings=<settings>&returnUrl=<returnUrl>&tenantId=<tenantId>
   
2. Autenticati con il provider di identità esterno

   Inserisci le tue credenziali nella pagina di accesso del provider di identità.

3. Verifica il risultato

   Si verifica una delle tre seguenti situazioni:

   • Esito positivo con returnUrl — Vantage ti reindirizza all’URL specificato in returnUrl. Nella barra degli indirizzi vengono visualizzati il nome utente e l’indirizzo email dell’utente autenticato.
   • Esito positivo senza returnUrl — Vantage ti reindirizza alla pagina da cui hai aperto il link di test.
   • Errore — Nella pagina di accesso del provider di identità viene visualizzato un errore di autenticazione. Controlla i parametri ed esegui di nuovo il test.

​

Parametri

Parametro	Richiesto per	Descrizione
settings	OAuth 2.0, SAML 2.0	JSON che descrive il provider di identità esterno. La struttura varia in base al protocollo — vedi sotto.
returnUrl	OAuth 2.0, SAML 2.0	L’URL a cui Vantage reindirizza dopo un test riuscito. Per il test, usa qualsiasi endpoint di Vantage, ad esempio /skills. La radice dell’URL viene aggiunta automaticamente.
tenantId	Solo SAML 2.0	L’identificatore del tenant in Vantage usato per l’autenticazione.

​

settings per OAuth 2.0

Field	Descrizione
Kind	AzureActiveDirectoryOidc o OnPremiseActiveDirectoryOidc
Settings.Authority	URL del provider di identità esterno
Settings.ClientId	ID client del provider di identità

Esempio:

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

​

settings per SAML 2.0

field	Descrizione
Kind	Saml2
Settings.MetadataUri	URL del documento di metadati della federazione
Settings.OwnEntityId	URI ID applicazione nel formato api://<appId>

Esempio:

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

​

Link di esempio

Link di sample (OAuth 2.0)

https://vantage-eu.abbyy.com/auth2/api/v2/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

Link di sample (SAML 2.0)

https://vantage-eu.abbyy.com/auth2/api/v2/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