Set authentication identity for a portal

Portal capabilities for Microsoft Dynamics 365 provides authentication functionality built on the ASP.NET Identity API. ASP.NET Identity is in turn built on the OWIN framework, which is also an important component of the authentication system. The services provided include:

  • Local (username/password) user sign-in
  • External (social provider) user sign-in through third-party identity providers
  • Two-factor authentication with email
  • Email address confirmation
  • Password recovery
  • Invitation code sign-up for registering pregenerated contact records


Portal capabilities for Microsoft Dynamics 365 requires:

  • Microsoft Dynamics 365 Portal Base
  • Microsoft Identity
  • Microsoft Identity Workflows solution packages

Authentication overview

Returning portal visitors have the option to authenticate by using local user credentials and/or external identity provider accounts. A new visitor can register for a new user account either by providing a username/password or by signing in through an external provider. Visitors who are sent an invitation code (by the portal administrator) have the option to redeem the code in the process of signing up for a new user account.

Related site settings:

  • Authentication/Registration/Enabled
  • Authentication/Registration/LocalLoginEnabled
  • Authentication/Registration/ExternalLoginEnabled
  • Authentication/Registration/OpenRegistrationEnabled
  • Authentication/Registration/InvitationEnabled
  • Authentication/Registration/RememberMeEnabled
  • Authentication/Registration/ResetPasswordEnabled

Sign in by using a local identity or external identity

Sign in by using a local account

Sign up by using a local identity or external identity

Register for a new local account

Redeem an invitation code manually

Sign up by using a invitation code

Forgot password or password reset

Returning visitors who require a password reset (and have previously specified an email address on their user profile) have the option of requesting a password reset token to be sent to their email account. A reset token allows its owner to choose a new password. Alternatively, the token can be abandoned, leaving the user’s original password unmodified.

Related site settings:

  • Authentication/Registration/ResetPasswordEnabled
  • Authentication/Registration/ResetPasswordRequiresConfirmedEmail

Related process: Send password reset to contact

  • Customize the email in the workflow as necessary
  • Submit email to invoke process
  • Visitor prompted to check email
  • Password reset email with instructions
  • Visitor returns to the reset form
  • Password reset complete

Redeem an invitation

Redeeming an invitation code allows a registering visitor to be associated to an existing contact record that was prepared in advance specifically for that visitor. Typically, the invitation codes are sent out by email but a general code submission form is available for codes sent though other channels. After a valid invitation code is submitted, the normal user registration (sign-up) process takes place to set up the new user account.

Related site settings:


Related process: Send invitation

The email sent by this workflow must be customized by using the URL to the redeem invitation page on the portal:{Invitation Code(Invitation)}

  1. Create invitation for a new contact

    Create an invitation for a new contact

  2. Customize and save the new invitation

    Customize a new invitation

  3. Process: Send invitation

  4. Customize the invitation email.
  5. The invitation email opens the redemption page.
  6. The user signs up by using the submitted invitation code.

    Sign-up with a invitation code

Manage user accounts through profile pages

Authenticated users manage their user accounts through the Security navigation bar of the profile page. Users are not limited to the single local account or single external account they chose at user registration time. Users who have an external account can choose to create a local account by applying a username and password. Otherwise, users who started with a local account can choose to associate multiple external identities to their account. The profile page is also where the user is reminded to confirm their email address by requesting a confirmation email to be sent to their email account.

Related site settings:

  • Authentication/Registration/LocalLoginEnabled

  • Authentication/Registration/ExternalLoginEnabled

  • Authentication/Registration/TwoFactorEnabled

Set or change a password

A user who has an existing local account can apply a new password by providing the original password. A user who does not have a local account can choose a username and password to set up a new local account. The username cannot be changed after it is set.

Related site settings:


  • Create a username and password.
  • Change an existing password.

Change or confirm an email address

Changing an email address (or setting it for the first time) puts it into an unconfirmed state. The user can request a confirmation email to be sent to the new email address, including instructions for completing the email confirmation process.

Related process: Send email confirmation to contact

  1. Customize the email in the workflow as necessary.
  2. Submit a new email (unconfirmed).
  3. Check email for confirmation.
  4. Process: Send email confirmation to contact
  5. Customize the confirmation email.
  6. Click the confirmation link to complete.

Enable two-factor authentication

The two-factor authentication feature increases user account security by requiring proof of ownership of a confirmed email in addition to the standard local/external account sign-in. A user trying to sign in to an account that has two-factor authentication enabled is sent a security code to the confirmed email associated with their account. The security code must be submitted to complete the sign-in process. A user can choose to remember the browser that successfully passed the verification, so that the security code will not be required for subsequent sign-ins from the same browser. Each user account enables this feature individually and requires a confirmed email.

Related Site Settings:

  • Authentication/Registration/TwoFactorEnabled
  • Authentication/Registration/RememberBrowserEnabled

Related Process: Send Email Two Factor Code To Contact

  1. Enable two-factor authentication.
  2. Choose to receive security code by email.
  3. Wait for email with security code.
  4. Process: Send Email Two Factor Code To Contact.
  5. Two-factor authentication can be disabled.

Manage external accounts

An authenticated user may connect (register) multiple external identities to their user account one from each of the configured identity providers. After the identities are connected, the user may choose to sign in with any of the connected identities. Existing identities can also be disconnected, as long as a single external or local identity remains.

Related Site Settings:


  • External Identity Provider Site Settings
  1. Select a provider to connect

    Manage external accounts

  2. Sign-in with provider to connect

  3. Provider is connected
  4. Provider can be disconnected

Enable ASP.NET identity authentication

The following describes the settings for enabling/disabling various authentication features and behaviors:

Site Setting Name Description
Authentication/Registration/LocalLoginEnabled Enables or disables local account sign-in based on a username (or email) and password. Default: false
Authentication/Registration/LocalLoginByEmail Enables or disables local account sign-in using an email address field instead of a username field. Default: false
Authentication/Registration/ExternalLoginEnabled Enables or disables external account sign-in and registration. Default: true
Authentication/Registration/RememberMeEnabled Enables or disables a "Remember Me?" checkbox on local sign-in to allow authenticated sessions to persist even when the web browser is closed. Default: true
Authentication/Registration/TwoFactorEnabled Enables or disables the option for users to enable two-factor authentication. Users with a confirmed email address can opt into the added security of two-factor authentication. Default: false
Authentication/Registration/RememberBrowserEnabled Enables or disables a "Remember Browser?" checkbox on second-factor validation (email code) to persist the second-factor validation for the current browser. The user will not be required to pass the second-factor validation for subsequent sign-ins as long as the same browser is being used. Default: true
Authentication/Registration/ResetPasswordEnabled Enables or disables the password reset feature. Default: true
Authentication/Registration/ResetPasswordRequiresConfirmedEmail Enables or disables password reset for confirmed email addresses only. If enabled, unconfirmed email addresses cannot be used to send password reset instructions. Default: false
Authentication/Registration/TriggerLockoutOnFailedPassword Enables or disables recording of failed password attempts. If disabled, user accounts will not be locked out. Default: true
Authentication/Registration/IsDemoMode Enables or disables a demo mode flag to be used in development or demonstration environments only. Do not enable this setting on production environments. Demo mode also requires the web browser to be running locally to the web application server. When demo mode is enabled, the password reset code and 2nd-factor code are displayed to the user for quick access. Default: false
Authentication/Registration/LoginButtonAuthenticationType If a portal only requires a single external identity provider (to handle all authentication), this allows the Sign-In button of the header nav bar to link directly to the login page of that external identity provider (instead linking to the intermediate local login form and identity provider selection page). Only a single identity provider can be selected for this action. Specify the AuthenticationType value of the provider.
For a single sign-on configuration using OpenIdConnect, such as using Azure AD-B2C, the user needs to provide the Authority.
For a single sign-on configuration using OpenIdConnect, such as using Azure AD-B2C, the user needs to provide the Authority.
For OAuth2 based providers the accepted values are: Facebook, Google, Yahoo, [!INCLUDE[cc-microsoft](../includes/], LinkedIn, Yammer, or Twitter
For WS-Federation based providers use the value specified for the Authentication/WsFederation/ADFS/AuthenticationType and Authentication/WsFederation/[!INCLUDE[pn-azure-shortest](../includes/]/\[provider\]/AuthenticationType site settings. Examples:, Facebook-0123456789, Google, Yahoo!, uri:WindowsLiveID.

Enable/disable user registration

The following describes the settings for enabling/disabling user registration (sign-up) options:

Site Setting Name Description
Authentication/Registration/Enabled Enables or disables all forms of user registration. Registration must be enabled for the other settings in this section to take effect. Default: true
Authentication/Registration/OpenRegistrationEnabled Enables or disables the sign-up registration form for creating new local users. The sign-up form allows any anonymous visitor to the portal to create a new user account. Default: true
Authentication/Registration/InvitationEnabled Enables or disables the invitation code redemption form for registering users who possess invitation codes. Default: true

User credential validation

The following describes the settings for adjusting username and password validation parameters. Validation occurs when signing up for a new local account or changing a password.

Site Setting Name Description
Authentication/UserManager/PasswordValidator/EnforcePasswordPolicy Whether the password contains characters from three of the following categories:
  • Uppercase letters of European languages (A through Z, with diacritic marks, Greek and Cyrillic characters)
  • Lowercase letters of European languages (a through z, sharp-s, with diacritic marks, Greek and Cyrillic characters)
  • Base 10 digits (0 through 9)
  • Non-alphanumeric characters (special characters) (for example, !, $, #, %)
Default: true. MSDN.
Authentication/UserManager/UserValidator/AllowOnlyAlphanumericUserNames Whether to allow only alphanumeric characters for the user name. Default: false. MSDN.
Authentication/UserManager/UserValidator/RequireUniqueEmail Whether unique e-mail is needed for validating the user. Default: true. MSDN.
Authentication/UserManager/PasswordValidator/RequiredLength The minimum required password length. Default: 8. MSDN.
Authentication/UserManager/PasswordValidator/RequireNonLetterOrDigit Whether the password requires a non-letter or digit character. Default: false. MSDN.
Authentication/UserManager/PasswordValidator/RequireDigit Whether the password requires a numeric digit ('0' - '9'). Default: false. MSDN.
Authentication/UserManager/PasswordValidator/RequireLowercase Whether the password requires a lower case letter ('a' - 'z'). Default: false. MSDN.
Authentication/UserManager/PasswordValidator/RequireUppercase Whether the password requires an upper case letter ('A' - 'Z'). Default: false. MSDN.

User account lockout settings

The following describes the settings that define how and when an account becomes locked from authentication. When a certain number of failed password attempts are detected under a short period of time, the user account is locked for a period of time. The use can try again after the lockout period elapses.

Site Setting Name Description
Authentication/UserManager/UserLockoutEnabledByDefault Indicates whether the user lockout is enabled when users are created. Default: true. MSDN.
Authentication/UserManager/DefaultAccountLockoutTimeSpan The default amount of time that a user is locked out for after Authentication/UserManager/MaxFailedAccessAttemptsBeforeLockout is reached. Default: 24:00:00 (1 Day). MSDN.
Authentication/UserManager/MaxFailedAccessAttemptsBeforeLockout The maximum number of access attempts allowed before a user is locked out (if lockout is enabled). Default: 5. MSDN.
Authentication/ApplicationCookie/ExpireTimeSpan The default amount of time cookie authentication sessions are valid for. Default: 24:00:00 (1 Day). MSDN.

See also

Configure Dynamics 365 portal authentication
OAuth2 provider settings for portals
Open ID Connect provider settings for portals
WS-Federation provider settings for portals
SAML 2.0 provider settings for portals
Facebook App (Page Tab) authentication for portals