Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
9 contributors

Users who have contributed to this file

@Rick-Anderson @nschonni @guardrex @scottaddie @v-anpasi @tdykstra @neusamir @JSweetland95 @agriffard
190 lines (115 sloc) 14.4 KB
uid title author description ms.author ms.date ms.assetid msc.legacyurl msc.type
mvc/overview/security/create-an-aspnet-mvc-5-web-app-with-email-confirmation-and-password-reset
Create a secure ASP.NET MVC 5 web app with log in, email confirmation and password reset (C#) | Microsoft Docs
Rick-Anderson
This tutorial shows you how to build an ASP.NET MVC 5 web app with email confirmation and password reset using the ASP.NET Identity membership system. You ca...
riande
03/26/2015
d4911cb3-1afb-4805-b860-10818c4b1280
/mvc/overview/security/create-an-aspnet-mvc-5-web-app-with-email-confirmation-and-password-reset
authoredcontent

Create a secure ASP.NET MVC 5 web app with log in, email confirmation and password reset (C#)

by Rick Anderson

This tutorial shows you how to build an ASP.NET MVC 5 web app with email confirmation and password reset using the ASP.NET Identity membership system. You can download the completed application here. The download contains debugging helpers that let you test email confirmation and SMS without setting up an email or SMS provider.

This tutorial was written by Rick Anderson ( Twitter: @RickAndMSFT ).

Create an ASP.NET MVC app

Start by installing and running Visual Studio Express 2013 for Web or Visual Studio 2013. Install Visual Studio 2013 Update 3 or higher.

[!NOTE] Warning: You must install Visual Studio 2013 Update 3 or higher to complete this tutorial.

  1. Create a new ASP.NET Web project and select the MVC template. Web Forms also supports ASP.NET Identity, so you could follow similar steps in a web forms app.

  2. Leave the default authentication as Individual User Accounts. If you'd like to host the app in Azure, leave the check box checked. Later in the tutorial we will deploy to Azure. You can open an Azure account for free.

  3. Set the project to use SSL.

  4. Run the app, click the Register link and register a user. At this point, the only validation on the email is with the [EmailAddress] attribute.

  5. In Server Explorer, navigate to Data Connections\DefaultConnection\Tables\AspNetUsers, right click and select Open table definition.

    The following image shows the AspNetUsers schema:

  6. Right click on the AspNetUsers table and select Show Table Data.

    At this point the email has not been confirmed.

  7. Click on the row and select delete. You'll add this email again in the next step, and send a confirmation email.

Email confirmation

It's a best practice to confirm the email of a new user registration to verify they are not impersonating someone else (that is, they haven't registered with someone else's email). Suppose you had a discussion forum, you would want to prevent "bob@example.com" from registering as "joe@contoso.com". Without email confirmation, "joe@contoso.com" could get unwanted email from your app. Suppose Bob accidentally registered as "bib@example.com" and hadn't noticed it, he wouldn't be able to use password recover because the app doesn't have his correct email. Email confirmation provides only limited protection from bots and doesn't provide protection from determined spammers, they have many working email aliases they can use to register.

You generally want to prevent new users from posting any data to your web site before they have been confirmed by email, a SMS text message or another mechanism. In the sections below, we will enable email confirmation and modify the code to prevent newly registered users from logging in until their email has been confirmed.

Hook up SendGrid

The instructions in this section are not current. See Configure SendGrid email provider for updated instructions.

Although this tutorial only shows how to add email notification through SendGrid, you can send email using SMTP and other mechanisms (see additional resources).

  1. In the Package Manager Console, enter the following command:

    [!code-consoleMain]

  2. Go to the Azure SendGrid sign up page and register for a free SendGrid account. Configure SendGrid by adding code similar to the following in App_Start/IdentityConfig.cs:

    [!code-csharpMain]

You'll need to add the following includes:

[!code-csharpMain]

To keep this sample simple, we'll store the app settings in the web.config file:

[!code-xmlMain]

[!WARNING] Security - Never store sensitive data in your source code. The account and credentials are stored in the appSetting. On Azure, you can securely store these values on the Configure tab in the Azure portal. See Best practices for deploying passwords and other sensitive data to ASP.NET and Azure.

Enable email confirmation in the Account controller

[!code-csharpMain]

Verify the Views\Account\ConfirmEmail.cshtml file has correct razor syntax. ( The @ character in the first line might be missing. )

[!code-cshtmlMain]

Run the app and click the Register link. Once you submit the registration form, you are logged in.

Check your email account and click on the link to confirm your email.

Require email confirmation before log in

Currently once a user completes the registration form, they are logged in. You generally want to confirm their email before logging them in. In the section below, we will modify the code to require new users to have a confirmed email before they are logged in (authenticated). Update the HttpPost Register method with the following highlighted changes:

[!code-csharpMain]

By commenting out the SignInAsync method, the user will not be signed in by the registration. The TempData["ViewBagLink"] = callbackUrl; line can be used to debug the app and test registration without sending email. ViewBag.Message is used to display the confirm instructions. The download sample contains code to test email confirmation without setting up email, and can also be used to debug the application.

Create a Views\Shared\Info.cshtml file and add the following razor markup:

[!code-cshtmlMain]

Add the Authorize attribute to the Contact action method of the Home controller. You can click on the Contact link to verify anonymous users don't have access and authenticated users do have access.

[!code-csharpMain]

You must also update the HttpPost Login action method:

[!code-csharpMain]

Update the Views\Shared\Error.cshtml view to display the error message:

[!code-cshtmlMain]

Delete any accounts in the AspNetUsers table that contain the email alias you wish to test with. Run the app and verify you can't log in until you have confirmed your email address. Once you confirm your email address, click the Contact link.

Password recovery/reset

Remove the comment characters from the HttpPost ForgotPassword action method in the account controller:

[!code-csharpMain]

Remove the comment characters from the ForgotPassword ActionLink in the Views\Account\Login.cshtml razor view file:

[!code-cshtmlMain]

The Log in page will now show a link to reset the password.

Resend email confirmation link

Once a user creates a new local account, they are emailed a confirmation link they are required to use before they can log on. If the user accidentally deletes the confirmation email, or the email never arrives, they will need the confirmation link sent again. The following code changes show how to enable this.

Add the following helper method to the bottom of the Controllers\AccountController.cs file:

[!code-csharpMain]

Update the Register method to use the new helper:

[!code-csharpMain]

Update the Login method to resend the password if the user account has not been confirmed:

[!code-csharpMain]

Combine social and local login accounts

You can combine local and social accounts by clicking on your email link. In the following sequence RickAndMSFT@gmail.com is first created as a local login, but you can create the account as a social log in first, then add a local login.

Click on the Manage link. Note the External Logins: 0 associated with this account.

Click the link to another log in service and accept the app requests. The two accounts have been combined, you will be able to log on with either account. You might want your users to add local accounts in case their social log in authentication service is down, or more likely they have lost access to their social account.

In the following image, Tom is a social log in (which you can see from the External Logins: 1 shown on the page).

Clicking on Pick a password allows you to add a local log on associated with the same account.

Email confirmation in more depth

My tutorial Account Confirmation and Password Recovery with ASP.NET Identity goes into this topic with more details.

Debugging the app

If you don't get an email containing the link:

  • Check your junk or spam folder.
  • Log into your SendGrid account and click on the Email Activity link.

To test the verification link without email, download the completed sample. The confirmation link and confirmation codes will be displayed on the page.

Additional Resources

You can’t perform that action at this time.