FAQ sobre a utilização do OpenID Connect no Power Pages

Este artigo fornece informações sobre cenários do Power Pages comuns e respostas a perguntas frequentes sobre a utilização de um fornecedor de autenticação em conformidade com a especificação do OpenID Connect.

Pode configurar o provedor Entra ID integrado como um provedor OpenID em separado?

Não, não pode configurar o fornecedor do Entra ID predefinido como um fornecedor OpenID separado.

Preciso que um documento de deteção automática do OpenID Connect se integre com o Power Pages?

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

Se o seu fornecedor de identidade não fornecer um documento de deteção automática, pode criar um e hospedá-lo em qualquer local público, incluindo o seu site.

Nota

À semelhança do documento de deteção, o Power Pages também exige que o fornecedor de identidade forneça um ponto final URI JWKS público, onde as chaves públicas estão disponíveis para verificar a assinatura do token de ID. Este ponto final tem de ser especificado no documento de deteção como chave jwks_uri.

O Power Pages suporta parâmetros de âmbito personalizado em pedidos de autenticação?

Os parâmetros de âmbito personalizado podem ser especificados utilizando a definição de Âmbito na configuração do seu fornecedor.

Porque é que o nome de utilizador num contacto ou registo de identidade externo no Dataverse é diferente do que o utilizador introduziu na página de início de sessão?

O campo de nome de utilizador num registo de contacto e num registo de identidade externo mostra o valor enviado na reivindicação de sub ou na reivindicação de ID de objeto (OID) para fornecedores baseados na Microsoft Entra. Isto deve-se ao facto de a claim “sub” representar o identificador do utilizador e de o fornecedor de identidade garantir que este é único.

Porque é que um utilizador não está ligado como o contacto existente esperado?

A forma como o site corresponde a um contacto existente depende da definição de mapeamento de contactos com email (AllowContactMappingWithEmail):

  • Se a opção AllowContactMappingWithEmail estiver ativada, o site faz a correspondência do contacto através do Endereço de e-mail principal utilizando a afirmação email, emails ou upn.
  • Se AllowContactMappingWithEmail estiver desativado, o site faz corresponder o contacto por Username com base na declaração de identificador do utilizador (sub ou oid).

O Power Pages suporta o término de sessão de fornecedores baseados em OpenID Connect?

A autenticação do Power Pages suporta a técnica de término de sessão do canal frontal para terminar sessão tanto da aplicação como do fornecedor baseado em OpenID Connect.

O Power Pages suporta o encerramento único de sessão?

O Power Pages não suporta a técnica de término de sessão único para fornecedores baseados em OpenID Connect.

O Power Pages requer uma afirmação específica num token de ID?

O Power Pages requer uma declaração que represente o endereço de e-mail do utilizador no token de ID. Esta afirmação deve ser denominada email, emails ou upn. Estas reivindicações são processadas pela seguinte ordem para serem definidas como o Endereço de e-mail principal do registo de contacto no Dataverse:

  1. e-mail
  2. emails
  3. upn

Quando está a ser utilizado, "emailclaimsmapping" também é usado para procurar um contacto existente (campo Endereço de E-mail Principal no Dataverse).

Posso ter acesso a tokens (ID ou acesso) usando JavaScript?

O token de ID fornecido pelo fornecedor de identidade não é disponibilizado utilizando JavaScript ou qualquer técnica padrão no lado do cliente. É utilizado apenas para autenticação. No entanto, se estiver a utilizar o fluxo de concessão implícita, pode utilizar os métodos fornecidos pelo seu provedor de identidade para obter tokens de identificação ou de acesso. Por exemplo, o Microsoft Entra ID fornece a Biblioteca de Autenticação da Microsoft para este cenário.

Posso utilizar um fornecedor personalizado OpenID Connect em vez do Microsoft Entra ID?

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

Consulte também

Configurar um fornecedor OpenID Connect