ASP.NET Identity教程二：（用户管理3）用户登录和邮箱验证功能

三.用户登录

当用户在你的网站上完成注册之后，下次再光顾你的网站时，只需要登录一下即可，登录时需要提供帐号和密码。还有在用户注册时，如果注册成功，也需要执行一下登录操作，在 7.1 节的注册用户逻辑中，没有实现登录操作，在本节中会完成登录操作。登录成功后，会在顶部导航栏上显示用户的帐号和注销按钮，表示当前用户已经登录该网站.

在 ASP.NET Identity 中，使用登录 API 就可以轻松的完成登录，不需要我们编写任何额外的登录逻辑代码，包括用户在客户端 Cookies 中的存储，都是由 ASP.NETIdentity 来完成的。

3.2. 继承 SignInManager<User, string>

在 ASP.NET Identity 中实现用户登录，需要配置应用程序登录管理器。应用程序登录管理器是继承了 SignInManager<User, string>的类来完成的。

在“App_Start”文件夹中的“IdentityConfig.cs”文件中的“Yidosoft.Identity”名称空间下编写如下代码：:

/// <summary>
	/// 配置应用程序登录管理器
	/// </summary>
	public class SignInManager : SignInManager<User, string>
	{
		public SignInManager(UserManager userManager, IAuthenticationManager authenticationManager) : base(userManager, authenticationManager)
		{
		}

		public override Task<ClaimsIdentity> CreateUserIdentityAsync(User user)
		{
			return user.GenerateUserIdentityAsync((UserManager)UserManager);
		}

		public static SignInManager Create(IdentityFactoryOptions<SignInManager> options, IOwinContext context)
		{
			return new SignInManager(context.GetUserManager<UserManager>(), context.Authentication);
		}
	}

　　其实这个内容是一开始就在前面教程中进行了使用。

然后再在“Models”文件夹中打开“User.cs”文件，并在 User 类中添加如下方法，其实上次已加入了。

public class User: IdentityUser
	{
		public async Task<ClaimsIdentity> GenerateUserIdentityAsync(UserManager<User> manager)
		{
			// 请注意，authenticationType 必须与 CookieAuthenticationOptions.AuthenticationType 中定义的相应项匹配
			var userIdentity = await manager.CreateIdentityAsync(this, DefaultAuthenticationTypes.ApplicationCookie);
			// 在此处添加自定义用户声明
			return userIdentity;
		}
		#region 添加字段
		[Display(Name = "微信")]
		public virtual string WX { get; set; }
		 

　　在此代码可以看出，ASP.NET Identity 是完全支持基于声明的身份验证的

 

.3. 注册 SignInManager

配置好的应用程序登录管理器，还需要在“Startup”类中注册一下，打开“App_Start”文件夹下的“Startup.Auth.cs”文件，然后添加如下代码：

app.CreatePerOwinContext<SignInManager>(SignInManager.Create);

　　

4..4. 编写 LoginViewModel

在“ViewModels”文件夹中添加一个名称为“LoginViewModel”的类，然后编写如下代码：因为我使用的userName登录，所以我声明的字段没有Email，而“RememberMe”属性是一个bool 类型，用于让用户选择是否在本地记住账号和密码信息。

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.Linq;
using System.Web;

namespace jsdhh2.ViewModels
{
	public class LoginViewModel
	{
		[Required]
		[Display(Name = "用户名")]
		public string UserName { get; set; }

		[Required]
		[DataType(DataType.Password)]
		[Display(Name = "密码")]
		public string Password { get; set; }

		[Display(Name = "记住我?")]
		public bool RememberMe { get; set; }
	}
}

.5. 编写 Login 方法

在“UserController”控制器中编写一个带有 HttpGet 特性的 Login()方法，用于呈现用户填写登录账户和密码的页面。再编写一个带有 HttpPost 特性的 Login()方法，用于将用户填写的账户和密码提交到服务器进行验证。代码如下：

private SignInManager _signInManager;
		public SignInManager SignInManager
		{
			get
			{
				return _signInManager ?? HttpContext.GetOwinContext().Get<SignInManager>();
			}
			private set
			{
				_signInManager = value;
			}
		}

　　

  private ActionResult RedirectToLocal(string returnUrl)
        {
            if (Url.IsLocalUrl(returnUrl))
            {
                return Redirect(returnUrl);
            }
            return RedirectToAction("Index", "Home");
        }
    }

　　

SignInManager 属性用于获取当前的应用程序登录管理器，然后就可以使用与登录相关的方法或属性。RedirectToLocal()方法用于完成某个某个操作后进行跳转，如果存在返回的 Url，则跳转到返回 Url，如果没有，则跳转到 Home 控制器的 Index()方法上。

 

/// <summary>
		/// 登录
		/// </summary>
		/// <param name="returnUrl"></param>
		/// <returns></returns>
		[HttpGet]
		[AllowAnonymous]
		public ActionResult Login(string returnUrl)
		{
			ViewBag.ReturnUrl = returnUrl;
			return View();
		}

		/// <summary>
		/// 登录
		/// </summary>
		/// <param name="model"></param>
		/// <param name="returnUrl"></param>
		/// <returns></returns>
		[HttpPost]
		[AllowAnonymous]
		[ValidateAntiForgeryToken]
		public async Task<ActionResult> Login(jsdhh2.ViewModels.LoginViewModel model, string returnUrl)
		{
			if (!ModelState.IsValid)
			{
				return View(model);
			}

			// 这不会计入到为执行帐户锁定而统计的登录失败次数中
			// 若要在多次输入错误密码的情况下触发帐户锁定，请更改为 shouldLockout: true
			var result = await SignInManager.PasswordSignInAsync(model.UserName, model.Password, model.RememberMe, shouldLockout: false);
			switch (result)
			{
				case SignInStatus.Success:
					return RedirectToLocal(returnUrl);
				case SignInStatus.LockedOut:
					return View("Lockout");
				case SignInStatus.RequiresVerification:
					return RedirectToAction("SendCode", new { ReturnUrl = returnUrl, RememberMe = model.RememberMe });
				case SignInStatus.Failure:
				default:
					ModelState.AddModelError("", "无效的登录尝试。");
					return View(model);
			}
		}

　　同时还有个新方法

  private ActionResult RedirectToLocal(string returnUrl)
        {
            if (Url.IsLocalUrl(returnUrl))
            {
                return Redirect(returnUrl);
            }
            return RedirectToAction("Index", "Home");
        }
    }

　　

在 HttpPost 的 Login()方法中，如果登录成功，则转到返回 Url，如果用户已锁定，则返回到”Lockout”视图，如果用户未完成验证(邮箱手机验证或双重验证)，则转到“SendCode”方法。其它情况，则添加登录失败的错误信息。

6. 编写 Login 视图

“Views”“User”文件夹中添加一个名称为“Login”的视图，并编写如下代码：

@using jsdhh2.Models
@model jsdhh2.ViewModels.LoginViewModel
@{
	ViewBag.Title = "登录";
}
<div class="row">
	<div class="col-md-8">
		<section id="loginForm">
			@using (Html.BeginForm("Login", "User", new { ReturnUrl = ViewBag.ReturnUrl }, FormMethod.Post, new { @class = "form-horizontal", role = "form" }))
			{
				@Html.AntiForgeryToken()
				<h4>@ViewBag.Title。</h4>
				<hr />
				@Html.ValidationSummary(true, "", new { @class = "text-danger" })
				<div class="form-group">
					@Html.LabelFor(m => m.UserName, new { @class = "col-md-2 control-label" })
					<div class="col-md-10">
						@Html.TextBoxFor(m => m.UserName, new { @class = "form-control" })
						@Html.ValidationMessageFor(m => m.UserName, "", new { @class = "text-danger" })
					</div>
				</div>
				<div class="form-group">
					@Html.LabelFor(m => m.Password, new { @class = "col-md-2 control-label" })
					<div class="col-md-10">
						@Html.PasswordFor(m => m.Password, new { @class = "form-control" })
						@Html.ValidationMessageFor(m => m.Password, "", new { @class = "text-danger" })
					</div>
				</div>
				<div class="form-group">
					<div class="col-md-offset-2 col-md-10">
						<div class="checkbox">
							@Html.CheckBoxFor(m => m.RememberMe)
							@Html.LabelFor(m => m.RememberMe)
						</div>
					</div>
				</div>
				<div class="form-group">
					<div class="col-md-offset-2 col-md-10">
						<input type="submit" value="登录" class="btn btn-default" />
					</div>
				</div>
				<p>
					@Html.ActionLink("注册为新用户", "Add")
				</p>
				@* 在为密码重置功能启用帐户确认后启用此项
					<p>
						@Html.ActionLink("忘记了密码?", "ForgotPassword")
					</p>*@
			}
		</section>
	</div>
</div>

　　

7.登录样式

 输入用户名，秘码登录 

 

 

 

图 7-23 上看，是转到了网站的首页，这个首页在“RouteConfig.cs“中默认配置好的。如下代码

namespace Yidosoft.Identity
{
public class RouteConfig
{
public static void RegisterRoutes(RouteCollection routes)
{
routes.IgnoreRoute("{resource}.axd/{*pathInfo}");
routes.MapRoute(
name: "Default",
url: "{controller}/{action}/{id}",
defaults: new { controller = "Home", action = "Index", id =
UrlParameter.Optional }
);
}
}
}

　　

在此代码中，配置的默认首页就是 Home 控制器下的 Index()方法，默认的首页地址，在浏览器的地址中，控制器和方法名都是可以省略的。所以图 7-23 转向的地址就是” htttp://localhost:6460/Home/Index”，只是省略了而已。在登录逻辑代码中，转向了 Home/Index，表示用户登录成功了。

8.创建首大页

因为我们是用MVC项目first code，所以home的index视图是自动生成的。

我们主要是编写“_LoginPartial.cshtml“视图。用于呈现用户的登录信息。由于网站的顶部导航视图代码是编写在“Views”\“Shared”文件夹下的“_Layout.cshtml”布局视图中的。所以我们也将“_LoginPartial.cshtml”放在“Views”/“Shared”文件夹下。

@using Microsoft.AspNet.Identity
@if (Request.IsAuthenticated)
{
    using (Html.BeginForm("LogOff", "Account", FormMethod.Post, new { id = "logoutForm", @class = "navbar-right" }))
    {
    @Html.AntiForgeryToken()

    <ul class="nav navbar-nav navbar-right">
        <li>
            @Html.ActionLink("你好，" + User.Identity.GetUserName() + "!", "Index", "Manage", routeValues: null, htmlAttributes: new { title = "Manage" })
        </li>
        <li><a href="javascript:document.getElementById('logoutForm').submit()">注销</a></li>
    </ul>
    }
}
else
{
    <ul class="nav navbar-nav navbar-right">
        <li>@Html.ActionLink("注册", "Register", "Account", routeValues: null, htmlAttributes: new { id = "registerLink" })</li>
        <li>@Html.ActionLink("登录", "Login", "Account", routeValues: null, htmlAttributes: new { id = "loginLink" })</li>
    </ul>
}

　　

然后打开“_Layout.cshtml”，将“_LoginPartial.cshtml”以部分视图的形式嵌入。如图7-26 所示：

 

 

@Html.Partial("_LoginPartial")
代码，将部分视图嵌入到布局视图中。现在运行一下首页。

的顶部导航栏上，是不是已经看到在前面登录的账户名了，并且还有注销按钮，注销按钮的功能后面会讲解

5.  确认用户

确认用户是指当用户在网站中注册成功之后，会通过邮件或手机发送一个验证码，然后通过这个验证码来确认用户的正确性。这里主要讲解使用电子邮件来确认用户，使用 163 邮箱的网关来发送确认用户的
电子邮件。

5.1. 配置 EmailService

配置 EmailService 服务，需要继承 IidentityMessageService 接口，实现 SendAsync()方法来发送邮件。在“App_Start”文件夹下的“IdentityConfig.cs”文件中的“Yidosoft.Identity”名称空间
下编写如下代码：

public class EmailService : IIdentityMessageService
	{
		public Task SendAsync(IdentityMessage message)
		{
			//编写发送邮件的代码
			Common.SendMail("smtp.126.com", 25, "lbj$4561200", "yidosoft@126.com", message.Destination, message.Subject, message.Body);
			return Task.FromResult(0);
		}
	}

　　

在 SendAsync()方法中就可以编写发送电子邮件的代码。这里使用了 Common 类中的静态方法 SendMail()来发送邮件，使用的是 smtp.126.com 来发送邮件。在“Yidosoft.Identity”的根目录下添加一个 Common 类文件，然后编写如下代码

 

using System.Net;
using System.Net.Mail;

namespace jsdhh2
{
	public class Common
	{
		public static bool SendMail(string strSmtpServer, int iSmtpPort, string Password, string strFrom, string strto, string strSubject, string strBody)
		{

			//设置发件人信箱,及显示名字 
			MailAddress mailFrom = new MailAddress(strFrom);
			//设置收件人信箱,及显示名字 
			MailAddress mailTo = new MailAddress(strto);
			//创建一个MailMessage对象 
			MailMessage oMail = new MailMessage(mailFrom, mailTo);
			oMail.Subject = strSubject;
			oMail.Body = strBody;
			oMail.IsBodyHtml = true; //指定邮件格式,支持HTML格式 
			oMail.BodyEncoding = System.Text.Encoding.GetEncoding("GB2312");//邮件采用的编码 
			oMail.SubjectEncoding = System.Text.Encoding.GetEncoding("GB2312");//邮件采用的编码 
			oMail.Priority = MailPriority.High;//设置邮件的优先级为高 
											   //发送邮件服务器 
			SmtpClient client = new SmtpClient();
			//发送邮件服务器的smtp
			//每种邮箱都不一致
			client.Host = strSmtpServer; //指定邮件服务器 
										 //发送邮件服务器端口
			client.Port = iSmtpPort;
			//设置超时时间 
			client.Timeout = 9999;
			//设置为发送认证消息
			client.UseDefaultCredentials = true;
			//指定服务器邮件,及密码 
			//发邮件人的邮箱地址和密码
			client.Credentials = new NetworkCredential(strFrom, Password);
			client.Send(oMail); //发送邮件 
								//释放资源
			mailFrom = null;
			mailTo = null;
			client.Dispose();//释放资源
			oMail.Dispose(); //释放资源 
			return true;
		}
	}
}

然后在IdentityConfig.CS中的“UserManager”类中的“Create()”方法中添加如下代码：

  /// <summary>
    /// 配置用户管理器
    /// </summary>
    public class UserManager : UserManager<User>
    {
        public UserManager(IUserStore<User> store) : base(store) { }

        public static UserManager Create(IdentityFactoryOptions<UserManager> options, IOwinContext context)
        {
            var manager = new UserManager(new UserStore<User>(context.Get<Models.IdentityDbContext>()));

            manager.EmailService = new EmailService();
            var dataProtectionProvider = options.DataProtectionProvider;
            if (dataProtectionProvider != null)
            {
                manager.UserTokenProvider =
                    new DataProtectorTokenProvider<User>(dataProtectionProvider.Create("EmailConfirmation"));
            }

            return manager;
        }
    }

　　.5.2. 发送确认用户邮件

带 HttpPost 的 Add()方法中添加发送确认用户的邮件，表示在用户注册后需要验证一下。

打开“UserController.cs”文件，找到带有 HttpPost 特性的 Add()方法。原来的代码如下：

HttpPost]
[AllowAnonymous]
[ValidateAntiForgeryToken]
public async Task<ActionResult> Add(AddUserViewModel addUserModel)
{
if (ModelState.IsValid)
{
var user = new User { UserName = addUserModel.Email, Email = addUserModel.Email,
QQNumber = addUserModel.QQNumber, WechatNumber = addUserModel.WechatNumber };
var result = await UserManager.CreateAsync(user, addUserModel.Password);
if (result.Succeeded)
{
return RedirectToAction("List", "User");
}
AddErrors(result);
}
return View(addUserModel);
}

　　现在修改一下，添加用户登录和发送确认用户电子邮件的代码，如下：

[HttpPost]
[AllowAnonymous]
[ValidateAntiForgeryToken]
public async Task<ActionResult> Add(AddUserViewModel addUserModel)
{
if (ModelState.IsValid)
{
var user = new User { UserName = addUserModel.Email, Email = addUserModel.Email,
QQNumber = addUserModel.QQNumber, WechatNumber = addUserModel.WechatNumber };
var result = await UserManager.CreateAsync(user, addUserModel.Password);
if (result.Succeeded)
{
//登录
await SignInManager.SignInAsync(user, isPersistent: false, rememberBrowser:
false);
// 发送包含此链接的电子邮件
string code = await UserManager.GenerateEmailConfirmationTokenAsync(user.Id);
var callbackUrl = Url.Action("ConfirmEmail", "User", new { userId = user.Id,
code = code }, protocol: Request.Url.Scheme);
await UserManager.SendEmailAsync(user.Id, "确认你的帐户", "请通过单击 <a
href=\"" + callbackUrl + "\">这里</a>来确认你的帐户");
//return RedirectToAction("List", "User");
return RedirectToAction("Index", "Home");
}
AddErrors(result);
}
return View(addUserModel);
}

　　

在此代码中，使用 UserManager.GenerateEmailConfirmationTokenAsync()方法，根据 User.Id 一成一个 Code，然后附加到验证 Url 中。最后使用 UserManager.SendEmailAsync()来发送电子邮件。

5.3. 接收电子邮件:在这要说明，我这没有成功，是因为一是我使用的USERNAME，而非Email,同时我未正确配置邮箱端口。

现在新注册一个用户，使用真实的电子邮件，然后接收该电子邮件，并完成邮件验证。 

先按真实的EMAIL地址注册，并登录。再到邮箱中去查看是否有邮箱。

 

然后登录邮箱

正确转到首页了，并且显示了当前注册的用户信息，表示登录成功了。现在登录注册的邮件，看是否能接收到邮件。如图 7-30 所示：

 

中已经接收到邮件了，点击“这里”链接去确认账户。如图 7-31 所示

由于我们还没有编写邮件验证的代码，所以图 7-31 的页面是不存在的

.5.4. 邮箱验证

在“UserController”控制器中添加一个名称为“ConfirmEmail()”的方法。代码如下：

		/// <summary>
		/// 邮箱验证
		/// </summary>
		/// <param name="userId"></param>
		/// <param name="code"></param>
		/// <returns></returns>
		[HttpGet]
		[AllowAnonymous]
		public async Task<ActionResult> ConfirmEmail(string userId, string code)
		{
			if (userId == null || code == null)
			{
				return View("Error");
			}
			var result = await UserManager.ConfirmEmailAsync(userId, code);
			return View(result.Succeeded ? "ConfirmEmail" : "Error");
		}

　　

ConfirmEmail()方法需要接收到 2 个参数，1 个是 userId，1 个是 code，与图 7-31浏览器中的 Url 参数是相对应的。
在数据库中存储的用户信息表是 AspNetUsers，有一个字段是“EmailConfirmed”，是 bit 类型，未验证时，该字段的值为 false，验证通过后，修改后 true。如图 7-32

 

在 ConfirmEmail()方法中用到了“Error”和“ConfirmEmail”这两个视图，在“Views”“User”中添加“ConfirmEmail.cshtml”视图，并编写如下代码：

@{
ViewBag.Title = "确认电子邮件";
}

<h2>@ViewBag.Title。</h2>
<div>
<p>
感谢你确认电子邮件。请
@Html.ActionLink("单击此处登录", "Login", "Account", routeValues: null, htmlAttributes: new { id = "loginLink" })
</p>
</div>

　　在“Shared”文件夹中添加“Error.cshtml”视图，并编写如下代码：这个基本是自带的

@model System.Web.Mvc.HandleErrorInfo

@{
    ViewBag.Title = "Error";
}

<h1 class="text-danger">Error.</h1>
<h2 class="text-danger">An error occurred while processing your request.</h2>

　　好了，现在重新运行图 7-31 的页面，如图 7-33 所示

 

图 7-33 提示已经确认了电子邮件，可以正常登录了。那么我们回到数据库看一下，如图 7-34 所示：

 

 

在图 7-34 中，“EmailConfirmed”字段的值已经变为“True”了，表示该用户的电子邮
件已经验证过了