Delen via

Portalverificatie configureren (Dynamics CRM 2015)

  • Artikel

 

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

Met Microsoft-account kunnen gebruikers op de website worden geverifieerd zonder dat u uw eigen beveiligingsproviders hoeft te maken. In dit onderwerp ziet u hoe u de Microsoft-account-verificatie gebruikt met uw website met behulp van Developer-uitbreidingen voor Microsoft Dynamics CRM 2015 en de portalwerkset.

In dit onderwerp

Uw website registreren met Microsoft Account

Het besturingselement LiveIdLoginStatus toevoegen

De lidmaatschapsprovider en handlerservice toevoegen

Registratie afdwingen

Uw website registreren met Microsoft Account

Om te beginnen, moet u uw website registeren met Microsoft-account:

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

Bij het registreren van uw site moet u uw volledige domeinnaam opgeven, bijvoorbeeld "yoursite.yourdomain.com", niet alleen "yourdomain.com".

U moet ook een URL opgeven waarnaar Microsoft-account-aanvragen worden teruggestuurd wanneer het aanmelden is voltooid. Dit is uw uw Handler Service, waarover u verderop in dit document kunt lezen, maar standaard is dit de URL:

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

Nadat u uw website hebt geregistreerd, krijgt u een toepassings-ID en een geheim dat u aan uw web.config koppelen zodat de site kan worden verbonden met Microsoft-account.

Houd hier rekening mee:

Uw domeinnamen kunnen geen tekenreeksen bevatten zoals localhost, 127.0.0.1 of iets dat het woord "live" bevat.

U kunt het beheer van de website niet met andere gebruikers delen.

U kunt uw domeinnaam niet wijzigen nadat u deze hebt geregistreerd.

Het besturingselement LiveIdLoginStatus toevoegen

De laatste stap is het toevoegen van het besturingselement LiveIdLoginStatus, dat net zoals het besturingselement LoginStatus werkt. Het geeft een aanmeldingskoppeling weer voor gebruikers die niet zijn geverifieerd en een afmeldingskoppeling voor gebruikers die wel zijn geverifieerd.

Bij anonieme gebruikers wordt de gebruiker naar Windows Live gestuurd of eventueel (met Loginhref) naar een opgegeven landingspagina waarop staat hoe de gebruiker naar Windows Live gaat.

Bij geverifieerde gebruikers wordt met de afmeldingskoppeling de identiteit van de huidige gebruiker op die van een anonieme gebruiker ingesteld.

<crm:LiveIdLoginStatus runat="server" />

Hierbij wordt ervan uitgegaan dat het labelvoorvoegsel "crm" is geregistreerd op "Microsoft.Xrm.Portal.Web.UI.WebControls".

De lidmaatschapsprovider en handlerservice toevoegen

De lidmaatschapsprovider regelt de aanmeldgegevens van gebruikers. Het gebruik van Microsoft-account vereist het gebruik van de lidmaatschapsprovider Microsoft-account:

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

De handlerservice valideert of de geverifieerde gebruiker is geregistreerd op uw website. Als u Internet Information Services (IIS) 7-locatie in geïntegreerde modus uitvoert, moet u ervoor zorgen dat het volgende in uw <handlers>-sectie is toegevoegd:

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

Als u in de klassieke pipeline-modus of IIS6 uitvoert, wordt de handlerservice geconfigureerd onder de <httpHandlers>-sectie van uw Web.config-bestand.

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

Registratie afdwingen

Als u Microsoft-account gebruikt voor verificatie, is alleen de passport-unieke ID (PUID) bekend. Als u extra gegevens over de gebruiker (zoals een weergavenaam of e-mail) wilt, moet u dit van de gebruiker verzamelen. Dit kunt u op twee manieren doen:

  • Stel een pagina in voor gebruikers waarop die hun gegevens kunnen invullen op een voor hun geschikt moment wanneer ze zijn aangemeld.

  • Verzamel informatie voordat ze op uw site kunnen worden geverifieerd.

Om de tweede manier uit te voeren, heeft uw Microsoft-account-installatie een speciale behandeling nodig.

  1. Als onderdeel van een gebruikerregistratie moet Microsoft Dynamics 365 de PUID van de gebruiker weten, zodat die aan de contactpersoongegevens van Microsoft Dynamics 365 de gebruiker kan worden gekoppeld. Met andere woorden, gebruikers moeten zich aanmelden met Microsoft-account en vervolgens moeten ze naar uw registratiepagina worden gestuurd. Dit wordt gedaan door het kenmerk LiveIdLoginStatus toe te voegen aan het besturingselement RegistrationUrl.

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

  2. In de code van uw registratiepagina moet u code toevoegen om het token Microsoft-account te behouden en de nieuwe gebruiker te maken zodra u de gegevens hebt verzameld die u wilt.

    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"]);
  }
}

Zie ook

Portalontwikkelingshandleiding voor Microsoft Dynamics CRM 2015
Voorbereiding voor poortontwikkeling (Dynamics CRM 2015)
ASP.NET-webformulieren en gegevensbinding
Portalinhoud beheren (Dynamics CRM 2015)
Portaloverzichten voor Dynamics CRM 2015

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht