Create a secure ASP.NET MVC 5 web app with log in, email confirmation and password reset (C#) | Microsoft Docs
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...
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.
Create an ASP.NET MVC app
[!NOTE] Warning: You must install Visual Studio 2013 Update 3 or higher to complete this tutorial.
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.
Set the project to use SSL.
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.
In Server Explorer, navigate to Data Connections\DefaultConnection\Tables\AspNetUsers, right click and select Open table definition.
The following image shows the
Click on the row and select delete. You'll add this email again in the next step, and send a confirmation email.
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
"firstname.lastname@example.org" from registering as
"email@example.com". Without email confirmation,
"firstname.lastname@example.org" could get unwanted email from your app. Suppose Bob accidentally registered as
"email@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.
In the Package Manager Console, enter the following command:
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:
You'll need to add the following includes:
To keep this sample simple, we'll store the app settings in the web.config file:
[!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
Verify the Views\Account\ConfirmEmail.cshtml file has correct razor syntax. ( The @ character in the first line might be missing. )
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:
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.
Views\Shared\Info.cshtml file and add the following razor markup:
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.
You must also update the
HttpPost Login action method:
Update the Views\Shared\Error.cshtml view to display the error message:
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.
Remove the comment characters from the
HttpPost ForgotPassword action method in the account controller:
Remove the comment characters from the
ForgotPassword ActionLink in the Views\Account\Login.cshtml razor view file:
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:
Update the Register method to use the new helper:
Update the Login method to resend the password if the user account has not been confirmed:
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.
- Links to ASP.NET Identity Recommended Resources
- Account Confirmation and Password Recovery with ASP.NET Identity Goes into more detail on password recovery and account confirmation.
- MVC 5 App with Facebook, Twitter, LinkedIn and Google OAuth2 Sign-on This tutorial shows you how to write an ASP.NET MVC 5 app with Facebook and Google OAuth 2 authorization. It also shows how to add additional data to the Identity database.
- Deploy a Secure ASP.NET MVC app with Membership, OAuth, and SQL Database to Azure. This tutorial adds Azure deployment, how to secure your app with roles, how to use the membership API to add users and roles, and additional security features.
- Creating a Google app for OAuth 2 and connecting the app to the project
- Creating the app in Facebook and connecting the app to the project
- Setting up SSL in the Project