一 Abp.Zero 手机号免密登录验证与号码绑定功能的实现:验证码模块

这是一篇系列博文 , 我将使用Abp.Zero搭建一套集成手机号免密登录验证与号码绑定功能的用户系统:

  • Abp.Zero 手机号免密登录验证与号码绑定功能的实现(一):验证码模块
  • Abp.Zero 手机号免密登录验证与号码绑定功能的实现(二):改造Abp默认实现
  • Abp.Zero 手机号免密登录验证与号码绑定功能的实现(三):网页端开发
第三方身份验证在Abp中称之为外部身份验证(ExternalAuthentication), 区别于Abp的外部身份授权(ExternalAuth) , 这里Auth的全称应为Authorization , 即授权 。
首先来厘清这两个不同的业务在Abp中的实现 , 我之前写的这篇 Abp.Zero 搭建第三方登录模块 系列文章中描述的业务 , 即使用的Abp外部身份授权(ExternalAuth)的相关扩展而实现的 。还记得我们实现的WeChatAuthProvider吗?它继承于ExternalAuthProviderApi这个抽象类 , 实现的微信授权功能 。所以微信登录这个动作 , 实际是在授权(Authorization)已有的微信账号 , 访问服务端资源 , 而身份验证(Authentication)步骤 , 已在其他端完成了(手机微信扫码) , 在服务端获取已验证好身份的第三方账户并生成Token则可以抽象的认为是授权(Authorization)行为 。
所以“搭建第三方登录模块”应该更准确地描述为“第三方授权模块” 。
从Abp接口设计上 , 也能看得出来两者的差别 。
外部身份验证(ExternalAuthentication)关注的是校验 , 实现TryAuthenticateAsync并返回是否成功 , 而CreateUserAsync和UpdateUserAsync仅是校验流程里的一部分 , 不实现它并不影响身份验证结果 , 外部授权源的接口定义如下 , 
public interface IExternalAuthenticationSource<TTenant, TUser> where TTenant : AbpTenant<TUser> where TUser : AbpUserBase{...Task<bool> TryAuthenticateAsync(string userNameOrEmailAddress, string plainPassword, TTenant tenant);Task<TUser> CreateUserAsync(string userNameOrEmailAddress, TTenant tenant);Task UpdateUserAsync(TUser user, TTenant tenant);}外部授权(ExternalAuth)这一步关注的业务是拿到外部账号 , 如微信的OpenId , 所以IExternalAuthManager重点则是GetUserInfo , 而IsValidUser并没有在默认实现中使用到
public interface IExternalAuthManager{Task<bool> IsValidUser(string provider, string providerKey, string providerAccessCode);Task<ExternalAuthUserInfo> GetUserInfo(string provider, string accessCode);}然而这些是从LoginManager原本实现看出的 , 我们可以重写这个类原本的方法 , 加入电话号码的处理逻辑 。
在搞清楚这两个接口后 , 相信你会对Abp用户系统的理解更加深刻
短信获取验证码来校验 , 是比较常用的第三方身份验证方式 , 今天来做一个手机号码免密登录 , 并且具有绑定/解绑手机号功能的小案例 , 效果如图:
一 Abp.Zero 手机号免密登录验证与号码绑定功能的实现:验证码模块

文章插图
示例代码已经放在了GitHub上:Github:matoapp-samples
用户验证码校验模块首先定义DomainService接口 , 我们将实现手机验证码的发送、验证码校验、解绑手机号、绑定手机号
这4个功能 , 并且定义用途以校验行为合法性 , 和用它来区分短信模板
public interface ICaptchaManager{Task BindAsync(string token);Task UnbindAsync(string token);Task SendCaptchaAsync(long userId, string phoneNumber, string purpose);Task<bool> VerifyCaptchaAsync(string token, string purpose = "IDENTITY_VERIFICATION");}

经验总结扩展阅读