Partilhar via

Autenticação de portal (Dynamics CRM 2015)

  • Artigo

 

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

O Conta da Microsoft permite que os usuários sejam autenticados no seu site sem ter que criar os seus próprios provedores de segurança. Este tópico mostra como usar a autenticação Conta da Microsoft com o seu site usando extensões de desenvolvedor para Microsoft Dynamics CRM 2015 e o conjunto de ferramentas do portal.

Neste tópico

Registre o seu site com a conta da Microsoft

Adicionar o controle LiveIdLoginStatus

Adicionar o provedor de associação e o serviço de manipulador

Registro da equipe

Registre o seu site com a conta da Microsoft

Para começar, você precisa registrar o site com Conta da Microsoft:

https://account.live.com/developers/applications

Ao registrar seu site, você precisa fornecer o nome completo do domínio, por exemplo, “yoursite.yourdomain.com", não apenas “yourdomain.com".

Também será necessário fornecer uma URL que direciona as solicitações de Conta da Microsoft de volta para quando terminarem de se conectar Isso será ao serviço do manipulador, sobre o qual você poderá ler mais adiante neste documento, mas, por padrão, a URL a ser inserida é:

http://yoursite.yourdomain.com/liveid.axd.

Após registrar seu site, ele lhe fornece uma ID do aplicativo e um segredo que você usará para se conectar ao seu web.config para que o site possa ser conectado ao Conta da Microsoft.

Aqui seguem algumas coisas a se observar:

Os nomes do seu domínio não podem incluir cadeias de caracteres como localhost, 127.0.0.1 ou qualquer coisa com a palavra “live" neles.

Não é possível compartilhar o gerenciamento de site com outros usuários.

Não é possível alterar o nome do seu domínio após registrá-lo.

Adicionar o controle LiveIdLoginStatus

A última etapa é adicionar o controle LiveIdLoginStatus, o qual funciona como o controle LoginStatus. Exibe um link de entrada para usuários que não sejam autenticados e um link de saída para usuários que sejam autenticados.

Quando anônimo, o link direciona o usuário para o Windows Live ou opcionalmente (usando Loginhref) para uma página de aterrissagem que permite ao usuário saber que ele vai para o Windows Live.

Quando autenticado, o link de saída redefine a identidade atual do usuário para ser um usuário anônimo.

<crm:LiveIdLoginStatus runat="server" />

Esse procedimento pressupõe que o prefixo do guia "crm"foi registrado ao "Microsoft.Xrm.Portal.Web.UI.WebControls”.

Adicionar o provedor de associação e o serviço de manipulador

O provedor de associação controla as informações de login do usuário. Usar o Conta da Microsoft exige a utilização do provedor de associação Conta da Microsoft:

<membership defaultProvider="CrmMembershipProvider">
    <providers>
        <add name="CrmMembershipProvider" type="Microsoft.Xrm.Portal.Web.Security.LiveIdMembershipProvider, Microsoft.Xrm.Portal" liveIdConnectionStringName="Live"/>
    </providers>
</membership>

O serviço do manipulador verifica se o usuário autenticado foi registrado no seu site. Se você estiver executando um local Serviços de Informações da Internet (IIS) 7 no modo integrado, você precisará garantir que o que segue seja adicionado na sua seção <handlers>:

<add name="LiveId" verb="*" path="LiveID.axd" preCondition="integratedMode" type="Microsoft.Xrm.Portal.Web.Handlers.LiveIdWebAuthenticationHandler, Microsoft.Xrm.Portal" />

Se você estiver executando o modo clássico pipeline ou o IIS6, o serviço do manipulador é configurado na seção <httpHandlers> do seu arquivo Web.config.

<add verb="*" path="LiveID.axd" type="Microsoft.Xrm.Portal.Web.Handlers.LiveIdWebAuthenticationHandler, Microsoft.Xrm.Portal"/>

Registro da equipe

Ao usar o Conta da Microsoft para autenticação, somente o identificador exclusivo de passaporte (PUID) é conhecido. Se você quiser informações adicionais sobre o usuário (como um nome para exibição ou email) você precisará obter estas informações com o usuário. Duas maneiras de fazer isso são:

  • Configurar uma página para eles preencherem suas informações em sua própria conveniência quando são conectados.

  • Coletar informações antes que possam ser autenticados no seu local.

Para realizar a segunda maneira, a sua configuração Conta da Microsoft precisará de um tratamento especial.

  1. Como parte de um registro de usuário, o Microsoft Dynamics 365 precisa conhecer o PUID do usuário para que seja possível vincular este às informações de contato Microsoft Dynamics 365 do usuário. Ou seja, você precisa ter o login do usuário usando o Conta da Microsoft e então enviar o usuário à sua página de registro. Isso é feito adicionando o atributo RegistrationUrl no controle LiveIdLoginStatus.

    <crm:LiveIdLoginStatus runat="server" RegistrationUrl="/CreateUser" />

  2. No código atrás da sua página de registro, é necessário adicionar o código para manter o token Conta da Microsoft e criar o novo usuário depois de coletar as informações que deseja.

    protected void Page_Load(object sender, EventArgs e)
{
  if (InvitationCode == null || InvitedContact == null)
  {
    var page = SiteContext.Current.Website.GetPageBySiteMarkerName("Home");
    Response.Redirect(page.GetUrl());
  }

  // Add the Live ID variables that come from the authentication handler to hidden 
  // script variables.
  if (Request["live-id-action"] == "register")
  {
    Page.ClientScript.RegisterHiddenField("live-id-token", 
      Request["live-id- token"]);
    Page.ClientScript.RegisterHiddenField("live-id-action", 
      Request["live-id-action"]);
  }
}

Confira Também

Guia do desenvolvedor para o portal do Microsoft Dynamics CRM 2015
Preparar-se para desenvolvimento do portal (Dynamics CRM 2015)
Formulário da Web e associação de dados do ASP.NET
Gerenciar o conteúdo do portal (Dynamics CRM 2015)
Instruções passo a passo do portal do Dynamics CRM 2015

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais