Configurar páginas personalizadas para inícios de sessão de utilizador
Este artigo descreve como criar páginas personalizadas no Microsoft Dynamics 365 Commerce que processam inícios de sessão personalizados para utilizadores de inquilinos B2C (business-to-consumer) do Microsoft Entra.
Para utilizar páginas personalizadas criadas no Dynamics 365 Commerce para lidar com fluxos de início de sessão de utilizador, tem de configurar as políticas do Microsoft Entra que serão referenciadas no ambiente do Commerce. Pode configurar as políticas "Inscrever-se e iniciar sessão", "Edição de perfil" e "Reposição de palavra-passe" do Microsoft Entra B2C utilizando a aplicação Microsoft Entra B2C. Os nomes de inquilinos e políticas do Microsoft Entra B2C podem então ser referenciados durante o processo de aprovisionamento que é feito para o ambiente do Commerce utilizando o Microsoft Dynamics Lifecycle Services (LCS).
As páginas personalizadas do Commerce podem ser criadas usando os módulos de início de sessão, de inscrição, de edição de perfil da conta, de reposição de palavra-se ou genéricos do Microsoft Entra. Os URLs de página que são publicados para estas páginas personalizadas devem então ser referenciados nas configurações de política do Microsoft Entra B2C no portal do Azure.
Aviso
O Microsoft Entra ID B2C irá preterir os fluxos de utilizador antigos (legados) até 1 de agosto de 2021. Portanto, deve planear a migração dos seus fluxos de utilizador para a nova versão recomendada. A nova versão oferece paridade de funcionalidades e novas caraterísticas. Para mais informações, consulte Fluxos de utilizador no Microsoft Entra ID B2C.
A biblioteca de módulos para versão 10.0.15 ou posterior do Commerce deve ser utilizada com os fluxos de utilizador B2C recomendados. As páginas de política de utilizador predefinidas oferecidas com o Microsoft Entra ID B2C também podem ser usadas e permitem alterações adicionais de imagem de fundo, logotipo e cor de fundo relacionadas com a marca da empresa. Embora mais limitadas em capacidades de design, as páginas de política de utilizador predefinida fornecem funcionalidade de política do Microsoft Entra B2C sem criar e configurar páginas personalizadas dedicadas.
Configurar políticas B2C
Depois de configurar o seu inquilino do Microsoft Entra B2C e associá-lo ao seu ambiente do Commerce, aceda à página Microsoft Entra B2C no portal do Azure e, em seguida, no menu, em Políticas, selecione Fluxos de utilizador (políticas).
Agora pode configurar os fluxos de início de sessão de utilizador "Inscrever-se e iniciar sessão", "Edição de perfil" e "Reposição de palavra-passe".
Configurar a política "Inscrever-se e iniciar sessão"
Para configurar a política "Inscrever-se e iniciar sessão", siga estes passos.
Selecione Novo fluxo de utilizador, selecione Inscrever-se e iniciar sessão, selecione o separador Recomendado e, em seguida, selecione Criar.
Introduza um nome para a política (por exemplo, B2C_1_SignInSignUp).
Na secção Fornecedores de Identidade, selecione os fornecedores de identidade a serem utilizados para a política. No mínimo, a Inscrição por e-mail tem de ser selecionada.
Na coluna Recolher atributo, selecione as caixas de verificação Endereço de E-mail, Nome Próprio e Apelido.
Na coluna Afirmação de devolução, selecione as caixas de verificação de Endereços de E-mail, Nome Próprio, Fornecedor de Identidade, Apelido e ID de Objeto do Utilizador.
Selecione OK para criar a política.
Clique duas vezes no nome da nova política e, em seguida, no painel de navegação, selecione Propriedades.
Defina a opção Ativar o esquema da página de imposição de JavaScript (pré-visualização) como Ativado.
Nota
O nome da política será totalmente referenciado no ambiente do Commerce. (O prefixo B2C_1_ será incluído na referência.) As políticas não podem mudar de nome depois de serem criadas. Se estiver a substituir uma política existente para o seu ambiente do Commerce, pode eliminar a política original e criar uma nova política com o mesmo nome. Em alternativa, se o ambiente já tiver sido aprovisionado, pode submeter o novo nome da política através de um pedido de serviço.
Regressará a esta política para concluir a configuração depois de ter criado as páginas personalizadas. Por enquanto, feche a política para regressar à página Fluxos de utilizador (políticas) no portal do Azure.
Configurar a política de "Edição de perfil"
Para configurar a política de "Edição de perfil", siga estes passos.
- Selecione Novo fluxo de utilizador, selecione Edição de perfil, selecione o separador Recomendado e, em seguida, selecione Criar.
- Introduza um nome para a política (por exemplo, B2C_1_EditProfile).
- Na secção Fornecedores de Identidade, selecione os fornecedores de identidade a serem utilizados para a política. No mínimo, Início de Sessão na Conta Local tem de ser selecionado.
- Na coluna Recolher atributo, selecione as caixas de verificação de Nome Próprio e Apelido.
- Na coluna Afirmação de devolução, selecione as caixas de verificação de Endereços de E-mail, Nome Próprio, Fornecedor de Identidade, Apelido e ID de Objeto do Utilizador.
- Selecione OK para criar a política.
- Clique duas vezes no nome da nova política e, em seguida, no painel de navegação, selecione Propriedades.
- Defina a opção Ativar o esquema da página de imposição de JavaScript (pré-visualização) como Ativado.
Regressará a esta política para concluir a configuração depois de ter criado as páginas personalizadas. Por enquanto, feche a política para regressar à página Fluxos de utilizador (políticas) no portal do Azure.
Configurar a política de "Reposição de palavra-passe"
Para configurar a política de "Reposição de palavra-passe", siga estes passos.
- Selecione Novo fluxo de utilizador e, em seguida, selecione a opção Reposição de palavra-passe, escolha o separador Recomendado e clique em Criar.
- Introduza um nome para a política (por exemplo, B2C_1_ForgetPassword).
- Na secção Fornecedores de Identidade, selecione Repor palavra-passe através de endereço de email.
- Na coluna Afirmação de devolução, selecione as caixas de verificação de Endereços de E-mail, Nome Próprio, Apelido e ID de Objeto do Utilizador.
- Selecione OK para criar a política.
- Clique duas vezes no nome da nova política e, em seguida, no painel de navegação, selecione Propriedades.
- Defina a opção Ativar o esquema da página de imposição de JavaScript (pré-visualização) como Ativado.
Regressará a esta política para concluir a configuração depois de ter criado as páginas personalizadas. Por enquanto, feche a política para regressar à página Fluxos de utilizador (políticas) no portal do Azure.
Criar as páginas personalizadas
Módulos do Microsoft Entra dedicados estão incluídos no Commerce para criar páginas personalizadas para políticas de utilizador do Microsoft Entra B2C. As páginas podem ser criadas especificamente para o esquema de cada página de política de utilizador usando os módulos principais do Microsoft Entra B2C detalhados abaixo. Como alternativa, o módulo Microsoft Entra Genérico pode ser utilizado para todos os esquemas de página e políticas no Microsoft Entra ID B2C (mesmo para opções de esquema de página dentro de políticas não listadas abaixo).
- Os módulos do Microsoft Entra específicos da página são vinculados a itens de entrada de dados compostos pelo Microsoft Entra ID B2C. Estes módulos dão-lhe mais controlo sobre o posicionamento dos elementos nas suas páginas. No entanto, talvez seja necessário criar mais páginas e extensões de módulo para levar em conta variações para além das predefinições descritas abaixo.
- O módulo Microsoft Entra Genérico cria o elemento "div" para o Microsoft Entra B2C compor todos os elementos no esquema de página da política de utilizador, dando mais flexibilidade às funções B2C da página, mas menos controle do posicionamento e estilo (embora o CSS possa ser utilizado para corresponder ao aspeto e funcionalidade do seu site).
Pode criar uma única página com o módulo Microsoft Entra Genérico e usá-la para todas as suas páginas de política de utilizador, ou pode criar páginas específicas usando os módulos individuais do Microsoft Entra para início de sessão, inscrição, edição de perfil, reposição de palavra-passe e verificação de reposição de palavra-passe. Também pode usar uma combinação de ambos, usando as páginas específicas do Microsoft Entra para os esquemas de página mencionados abaixo e a página de módulo genérica do Microsoft Entra para esquemas de página restantes dentro destas ou de outras páginas de políticas de utilizador.
Para mais informações sobre os Módulos do Microsoft Entra fornecidos com a biblioteca de módulos, leia mais em Páginas e módulos da gestão de identidades.
Para criar as páginas personalizadas com módulos de identidade específicos para processar inícios de sessão de utilizador, siga estes passos.
- No construtor de sites do Commerce, aceda ao seu site.
- Crie os seguintes cinco modelos e páginas (se ainda não estiverem presentes no seu site):
- Um modelo e uma página de Início de Sessão que utilizam o módulo de início de sessão.
- Um modelo e uma página de Inscrição que utilizam o módulo de inscrição.
- Um modelo e uma página de Reposição de Palavra-passe que usam o módulo de reposição de palavra-passe.
- Um modelo e uma página de Verificação de Reposição de Palavra-passe que usam o módulo de verificação de reposição de palavra-passe.
- Um modelo e uma página de Edição de Perfil que usam o módulo de edição de perfil de conta.
Ao criar as páginas, siga estas diretrizes:
- Para cada página ou módulo, use o esquema e o estilo que melhor se adequam às suas necessidades de negócio.
- Publique todas as páginas e URLs que devem ser utilizados na configuração do Microsoft Entra B2C.
- Depois de as páginas e URLs serem publicados, recolha os URLs que devem ser utilizados para as configurações de política do Microsoft Entra B2C. Um sufixo ?preloadscripts=true será adicionado a cada URL quando for utilizado.
Importante
As páginas criadas para serem referenciadas no Microsoft Entra B2C são servidas diretamente a partir do domínio do inquilino do Microsoft Entra B2C. Não reutilize cabeçalhos e rodapés universais que tenham ligações relativas. Porque estas páginas serão hospedadas no domínio do Microsoft Entra B2C quando forem usadas, apenas URLs absolutos devem ser utilizados para todas as ligações. Recomenda-se a criação de um cabeçalho e rodapé específicos com URLs absolutos para as suas páginas personalizadas relacionadas com o Microsoft Entra, com quaisquer módulos específicos do Commerce que exijam ligação ao Servidor do Retail removidos. Por exemplo, os favoritos, a barra de pesquisa, a ligação de início de sessão e os módulos de carrinho não devem ser incluídos em nenhuma página que será usada nos fluxos de utilizadores do Microsoft Entra B2C.
Configurar políticas do Microsoft Entra B2C com informações de página personalizadas
No portal do Azure, regresse à página Microsoft Entra B2C e, em seguida, no menu, em Políticas, selecione Fluxos de utilizador (políticas).
Atualize a política de "Inscrição e início de sessão" com informações de página personalizadas
Para atualizar a política de "Inscrição e início de sessão" com informações de página personalizadas, siga estes passos.
Na política de Início de sessão e inscrição que configurou anteriormente, no painel de navegação, selecione Esquemas de página.
Selecione o esquema de Página unificada de inscrição ou início de sessão.
Defina a opção Utilizar conteúdo de página personalizada como Sim.
No campo URI de página personalizada, introduza o URL de início de sessão completo. Inclua o sufixo ?preloadscripts=true. Por exemplo, introduza
www.<my domain>.com/sign-in?preloadscripts=true
.No campo Versão do Esquema de Página, selecione a versão 2.1.0 ou posterior (requer a biblioteca de módulos para a versão 10.0.15 ou posterior do Commerce).
Selecione Guardar.
Selecione o esquema de Página de inscrição na conta local.
Defina a opção Utilizar conteúdo de página personalizada como Sim.
No campo URI de página personalizada, introduza o URL de inscrição completo. Inclua o sufixo ?preloadscripts=true. Por exemplo, introduza
www.<my domain>.com/sign-up?preloadscripts=true
.No campo Versão do Esquema de Página, selecione a versão 2.1.0 ou posterior (requer a biblioteca de módulos para a versão 10.0.15 ou posterior do Commerce).
Na secção Atributos de utilizador, siga estes passos:
- Para os atributos Nome Próprio e Apelido, selecione Não na coluna Requer Verificação.
- Para o atributo Endereço de E-mail, é recomendável deixar o valor predefinido Sim selecionado na coluna Requer verificação. Esta opção garante que os utilizadores que se inscreverem com um determinado endereço de e-mail verificam se são os proprietários do endereço de e-mail.
- Para os atributos Endereço de E-mail, Nome Próprio e Apelido, selecione Não na coluna Opcional.
Selecione Guardar.
Atualize a política de "Edição de perfil" com informações de página personalizadas
Para atualizar a política de "Edição de perfil" com informações de página personalizadas, siga estes passos.
- Na política de Edição de Perfil que configurou anteriormente, no painel de navegação, selecione Esquemas de página.
- Selecione o esquema da página Edição de perfil (pode exigir deslocação para baixo passando por outras opções de esquema, dependendo do ecrã).
- Defina a opção Utilizar conteúdo de página personalizada como Sim.
- No campo URI de página personalizada, introduza o URL de edição de perfil. Inclua o sufixo ?preloadscripts=true. Por exemplo, introduza
www.<my domain>.com/profile-edit?preloadscripts=true
. - Para Versão do Esquema de Página, selecione a versão 2.1.0 ou posterior (requer a biblioteca de módulos para a versão 10.0.15 ou posterior do Commerce).
- Na secção Atributos de utilizador, siga estes passos:
- Para os atributos Nome Próprio e Apelido, selecione Não na coluna Opcional.
- Para os atributos Nome Próprio e Apelido, selecione Não na coluna Requer verificação.
- Selecione Guardar.
Atualize a política de "Reposição de palavra-passe" com informações de página personalizadas
Para atualizar a política de "Reposição de palavra-passe" com informações de página personalizadas, siga estes passos.
- Na política de Reposição de Palavra-passe que configurou anteriormente, no painel de navegação, selecione Esquemas de página.
- Selecione o esquema da página Esqueceu-se da palavra-passe.
- Defina a opção Utilizar conteúdo de página personalizada como Sim.
- No campo URI de página personalizada, introduza o URL de verificação de reposição de palavra-passe. Inclua o sufixo ?preloadscripts=true. Por exemplo, introduza
www.<my domain>.com/password-reset-verification?preloadscripts=true
. - No campo Versão do Esquema de Página, selecione a versão 2.1.0 ou posterior (requer a biblioteca de módulos para a versão 10.0.15 ou posterior do Commerce).
- Selecione Guardar.
- Selecione o esquema da página Alterar palavra-passe.
- Defina a opção Utilizar conteúdo de página personalizada como Sim.
- No campo URI de página personalizada, introduza o URL de reposição de palavra-passe. Inclua o sufixo ?preloadscripts=true. Por exemplo, introduza
www.<my domain>.com/password-reset?preloadscripts=true
. - No campo Versão do Esquema de Página, selecione a versão 2.1.0 ou posterior (requer a biblioteca de módulos para a versão 10.0.15 ou posterior do Commerce).
- Selecione Guardar.
Personalizar cadeias de texto predefinidas para etiquetas e descrições
Na biblioteca de módulos, os módulos de início de sessão são pré-preenchidos com cadeias de texto predefinidas para as etiquetas e as descrições. Pode personalizar as cadeias no painel de propriedades do módulo em que está a trabalhar. Cadeias adicionais na página (como o texto da ligação Palavra-passe esquecida? ou a chamada para ação Criar uma conta) exigirão a utilização do kit de programação de software (SDK) do Commerce e a atualização dos valores no ficheiro global.json para o módulo de início de sessão.
Por exemplo, o texto predefinido da ligação de palavra-passe esquecida é Palavra-passe esquecida?. Segue-se este texto predefinido na página de início de sessão.
No entanto, no ficheiro global.json para o módulo de início de sessão da biblioteca de módulos, pode editar o texto para Esqueceu-se da Palavra-passe?, como mostrado na ilustração seguinte.
Depois de atualizar o ficheiro global.json e publicar as alterações, o novo texto da ligação aparece no módulo de início de sessão no Commerce e na página de início de sessão em direto.
Recursos adicionais
Configurar o seu nome de domínio
Implementar um novo inquilino de comércio eletrónico
Criar um site de comércio eletrónico
Associar um site do Dynamics 365 Commerce a um canal online
Carregar redirecionamentos URL em massa
Configurar um inquilino B2C no Commerce
Configurar vários inquilinos B2C num ambiente do Commerce
Adicionar suporte para uma rede de entrega de conteúdos (CDN)