Perguntas frequentes sobre o uso do OpenID Connect no Power Pages

Este artigo fornece informações sobre cenários comuns do Power Pages e responde às perguntas frequentes sobre o uso de um provedor de autenticação em conformidade com a especificação do OpenID Connect.

Você pode configurar o provedor interno do Entra ID como um provedor OpenID separado?

Não, você não pode configurar o provedor padrão do Entra ID como um provedor OpenID separado.

Preciso de um Documento de descoberta automática do OpenId Connect para integração com o Power Pages?

Um documento de descoberta automática ou documento de metadados do OpenID Connect (também conhecido como /.well-known/openid-configuration) é necessário para integrar com o Power Pages. O Power Pages usa as informações deste documento para criar solicitações de autorização e validar os tokens de autenticação.

Se o seu provedor de identidade não fornecer um documento de descoberta automática, você poderá criar o seu e hospedá-lo em qualquer local público, incluindo seu site.

Observação

Semelhante ao documento de descoberta, o Power Pages também exige que o provedor de identidade forneça um endpoint público de JWKS URI, no qual as chaves públicas ficam disponíveis para verificar a assinatura do token de identificação. Este ponto de extremidade precisa ser especificado no documento de descoberta como a chave jwks_uri.

O Power Pages dá suporte a parâmetros de escopo personalizados em solicitações de autenticação?

Os parâmetros de escopo personalizados podem ser especificados usando a configuração Escopo em sua configuração do provedor.

Por que o nome de usuário em contato ou registro de identidade externa no Dataverse é diferente do que o usuário inseriu na página de login?

O campo nome de usuário em um registro de contato e em um registro de identidade externa mostra o valor enviado na declaração sub ou na declaração de ID de objeto (OID) para provedores baseados no Microsoft Entra. Isso ocorre porque a claim sub representa o identificador do usuário e tem sua unicidade garantida pelo provedor de identidade.

Por que um usuário não está conectado como o contato existente esperado?

A forma como o site faz a correspondência com um contato existente depende da configuração Mapeamento de contato com e-mail (AllowContactMappingWithEmail):

  • Se AllowContactMappingWithEmail estiver ativado, o site fará a correspondência do contato pelo Endereço de Email Principal usando a declaração email, emails ou upn.
  • Se AllowContactMappingWithEmail estiver desativado, o site associará o contato por Nome de usuário usando a declaração de identificador do usuário (sub ou oid).

O Power Pages oferece suporte ao encerramento de sessão com provedores baseados em OpenID Connect?

A autenticação do Power Pages suporta a técnica de logout pelo canal frontal para encerrar a sessão tanto no aplicativo quanto no provedor baseado em OpenID Connect.

O Power Pages dá suporte para logoff único?

O Power Pages não oferece suporte à técnica de saída única para provedores baseados em OpenID Connect.

O Power Pages exige alguma declaração específica em um token de ID?

O Power Pages requer uma declaração que representa o endereço de email do usuário no token de ID. Esta reivindicação deve ser chamada de email, emails ou upn. Essas declarações são processadas na seguinte ordem para definir o Endereço de Email Principal do registro do contato no Dataverse:

  1. email
  2. emails
  3. upn

Quando utilizado, "emailclaimsmapping" também é usado para localizar um contato existente (campo de Endereço de Email Principal no Dataverse).

Posso obter acesso a tokens (ID ou acesso) usando o JavaScript?

O token de ID fornecido pelo provedor de identidade não está disponível por meio de JavaScript nem de qualquer técnica padrão no lado do cliente. Ele é usado apenas para autenticação. No entanto, se estiver usando o fluxo de concessão implícita, você poderá usar os métodos fornecidos pelo seu provedor de identidade para obter tokens de ID ou de acesso. Por exemplo, o Microsoft Entra ID fornece a Biblioteca de Autenticação da Microsoft para este cenário.

Posso usar um provedor OpenID Connect personalizado em vez de usar o Microsoft Entra ID?

O Power Pages suporta qualquer provedor de identidade que esteja em conformidade com a especificação do OpenID Connect padrão.

Confira também

Configurar um provedor do OpenID Connect