Pular para o conteúdo principal
Antes de configurar um Provedor de Identidade Externo para uso por um locatário, verifique se os parâmetros especificados do Provedor de Identidade Externo estão corretos. Para testar a autenticação externa via Vantage API, siga as instruções abaixo conforme o protocolo utilizado:
  1. Conforme o protocolo utilizado, abra o seguinte link com os parâmetros descritos na tabela abaixo:
    • 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>

Parâmetros

ParameterProtocolDescription
settingsOAuth 2.0Configurações de autenticação do Provedor de Identidade Externo em formato JSON. Inclui o tipo do Provedor de Identidade Externo (o parâmetro Kind, que pode ter os valores AzureActiveDirectoryOidc ou OnPremiseActiveDirectoryOidc), a URL do Provedor de Identidade Externo (o parâmetro Authority) e o ID do cliente (o parâmetro ClientId).

Por exemplo:
{"Kind":"AzureActiveDirectoryOidc","Settings":{"Authority":"https://login.microsoftonline.com/fb46032a-31c4-42ff-890d-6e08d6f57da3","ClientId":"4e674698-09b8-4ac5-8df7-35d6f0c1e36c"}}
settingsSAML 2.0Configurações de autenticação do Provedor de Identidade Externo em formato JSON. Inclui o tipo do Provedor de Identidade Externo e a URL do Provedor de Identidade Externo.

Por exemplo:
{"Kind":"Saml2","Settings":{"MetadataUri":"https://login.microsoftonline.com/fb46032a-31c4-42ff-890d-6e08d6f57da3/federationmetadata/2007-06/federationmetadata.xml"}}
returnUrlOAuth 2.0 or SAML 2.0A URL para a qual você será redirecionado após a conclusão da autenticação. Para testes, especifique qualquer endpoint do Vantage, como /skills. A raiz da URL é incorporada automaticamente no link usado para autorização.
tenantIdSAML 2.0O identificador do tenant a ser usado para autenticação por meio de um Provedor de Identidade Externo SAML 2.0.
  1. Insira suas credenciais do provedor de identidade externo.
  2. Após concluir a autenticação com êxito, você será redirecionado para a página de onde enviou a solicitação ou para a página especificada no parâmetro returnUrl. Neste último caso, a barra de endereços conterá informações sobre o usuário autenticado: nome de usuário e e‑mail. Se os parâmetros informados estiverem incorretos, será exibido um erro de autenticação na página do provedor de identidade externo. Nessa situação, verifique as configurações e repita o teste após fazer as alterações necessárias.