一, 前言
ASP.NET Core 中 IdentityServer4 的应用分析中会以一个电商系统架构升级过程中普遍会遇到的场景进行实战性讲述分析, 同时最后会把我的实战性的代码放到 GitHub 上, 敬请大家关注!
这里就直接开始撸代码, 概念性东西就已经不概述了, 想要了解概念推荐大家查看我之前的文章和官方文档:
ASP.NET Core IdentityServer4 中的基本概念
IdentityServer4 官方文档 https://identityserver4.readthedocs.io/en/latest/
二, 应用实战
2.1 模拟场景
最初小团队的电商系统场景如下图:
这张架构图缺点:
发布频繁, 发布影响整个电商系统
很难做到敏捷开发
维护性可能会存在一定的弊端, 主要看内部架构情况.
大多数小电商团队对于多客户端登录授权来说可能已经实现了 OAuth 2.0 的身份授权验证, 但是是和电商业务集成在一个网关里面, 这样不是很好的方式; 由于公司业务横向扩大, 产品经理调研了代理商业务, 最终让技术开发代理商业务系统. 架构师出于后续发展的各方面考虑, 把代理商业务单独建立了一个独立的网关, 并且把授权服务一并给独立出来, 调整后的电商系统架构图如下:
身份授权从业务系统中拆分出来后, 有了如下的优势:
授权服务不受业务的影响, 如果业务网关宕机了, 那至少不会影响代理商网关的业务授权系统的使用
授权服务一旦建立, 一般就很难进行升级, 除非特殊情况.
在敏捷开发中, 业务系统可能发布频繁, 电商业务系统可能每天都是在频繁升级更新, 这样也不至于影响了授权系统服务导致代理商业务受到影响
代理商业务引入进来后, 同时又增加了秒杀活动, 发现成交量大大增大, 支付订单集中在某一时刻翻了十几倍, 这时候整个电商业务 API 网关已经扛不住了, 负载了几台可能也有点吃力; 开发人员经过跟架构师一起讨论, 得出了扛不住的原因: 主要是秒杀活动高并发的支付, 以至于整个电商业务系统受到影响, 故准备把支付系统从业务系统中拆分出成独立的支付网关, 并做了一定的负载, 成功解决了以上问题, 这时候整个电商系统架构图就演变成如下:
支付网关服务抽离后的优势:
支付网关服务更新不会太频繁, 可以减少整个系统的因为发布导致的一系列问题, 增强稳定性
支付系统出现宕机不影响整个电商系统的使用, 用户还可以浏览商品等等其他操作, 技术和运维人员也比较好排查定位问题所在; 提升用户体验, 同时提升排查问题的效率.
授权中心: 单独一个服务网关, 访问支付业务网关, 电商业务网关及代理商业务网关都需要先通过授权中心获得授权拿到访问令牌 AccessToken 才能正常的访问这些网关, 这样授权模块就不会受任何的业务影响, 同时各个业务网关也不需要写同样的授权业务的代码; 业务网关仅仅只需关注本身的业务即可, 授权中心仅仅只需要关注维护授权; 经过这样升级改造后整个系统维护性得到很大的提高, 相关的业务也可以针对具体情况进行选择性的扩容.
上面的电商网关演变架构图中我这里没有画出具体的请求流向, 偷了个赖, 这里还是先把 OAuth2.0 的授权大体的流程图单独贴出来:
由于授权网关服务之前单独抽离出来了, 这次把支付业务网关拆分出来就也比较顺利, 一下子就完成了电商系统的架构升级. 今天这篇文章的目的架构升级也就完成了, 想要深入后续电商系统架构升级的同学可以关注后续给大家带来的微服务的相关教程, 到时继续以这个例子来进行微服务架构上的演变升级, 敬请大家关注. 好了下面我们来回归该升级的和核心主题授权网关服务 IdentityServer4 的应用.
2.2 IdentityServer4 密码授权模式
授权网关服务
静态内存配置方式
定义资源
分资源分为身份资源 (Identity resources) 和 API 资源(API resources).
我们先创建 Jlion.NetCore.Identity.Service 网关服务项目, 在网关服务中添加受保护的 API 资源, 创建 OAuthMemoryData 类代码如下:
- /// <summary>
- /// API 资源 静态方式定义
- /// </summary>
- /// <returns></returns>
- public static IEnumerable<ApiResource> GetApiResources()
- {
- return new List<ApiResource>
- {
- new ApiResource(OAuthConfig.UserApi.ApiName,OAuthConfig.UserApi.ApiName),
- };
- }
定义客户端 Client
接下来 OAuthMemoryData 类中定义一个客户端应用程序的 Client, 我们将使用它来访问我们的 API 资源代码如下:
- public static IEnumerable<Client> GetClients()
- {
- return new List<Client>
- {
- new Client()
- {
- ClientId =OAuthConfig.UserApi.ClientId,
- AllowedGrantTypes = new List<string>()
- {
- GrantTypes.ResourceOwnerPassword.FirstOrDefault(),//Resource Owner Password 模式
- },
- ClientSecrets = {new Secret(OAuthConfig.UserApi.Secret.Sha256()) },
- AllowedScopes= {OAuthConfig.UserApi.ApiName},
- AccessTokenLifetime = OAuthConfig.ExpireIn,
- },
- };
- }
AllowedGrantTypes : 配置授权类型, 可以配置多个授权类型
ClientSecrets: 客户端加密方式
AllowedScopes: 配置授权范围, 这里指定哪些 API 受此方式保护
AccessTokenLifetime
: 配置 Token 失效时间
GrantTypes: 授权类型, 这里使用的是密码模式
ResourceOwnerPassword
代码中可以看到有一个 OAuthConfig 类, 这个类是我单独建的, 是用于统一管理, 方便维护, 代码如下:
- public class OAuthConfig
- {
- /// <summary>
- /// 过期秒数
- /// </summary>
- public const int ExpireIn = 36000;
- /// <summary>
- /// 用户 API 相关
- /// </summary>
- public static class UserApi
- {
- public static string ApiName = "user_api";
- public static string ClientId = "user_clientid";
- public static string Secret = "user_secret";
- }
- }
如果后续架构升级, 添加了其他的网关服务, 则只需要在这里添加所需要保护的 API 资源, 也可以通过读取数据库方式读取受保护的 API 资源.
接下来 OAuthMemoryData 类添加测试用户, 代码如下:
- /// <summary>
- /// 测试的账号和密码
- /// </summary>
- /// <returns></returns>
- public static List<TestUser> GetTestUsers()
- {
- return new List<TestUser>
- {
- new TestUser()
- {
- SubjectId = "1",
- Username = "test",
- Password = "123456"
- }
- };
- }
上面受保护的资源, 和客户端以及测试账号都已经建立好了, 现在需要把 IdentityServer4 注册到 DI 中:
Startup 中的 ConfigureServices 代码如下:
- public void ConfigureServices(IServiceCollection services)
- {
- services.AddControllers();
- #region 内存方式
- services.AddIdentityServer()
- .AddDeveloperSigningCredential()
- .AddInMemoryApiResources(OAuthMemoryData.GetApiResources())
- .AddInMemoryClients(OAuthMemoryData.GetClients())
- .AddTestUsers(OAuthMemoryData.GetTestUsers());
- #endregion
- }
代码解读:
AddDeveloperSigningCredential
: 添加证书加密方式, 执行该方法, 会先判断 tempkey.rsa 证书文件是否存在, 如果不存在的话, 就创建一个新的 tempkey.rsa 证书文件, 如果存在的话, 就使用此证书文件.
AddInMemoryApiResources
: 把受保护的 API 资源添加到内存中
AddInMemoryClients : 客户端配置添加到内存中
AddTestUsers : 测试的用户添加进来
最后通过 UseIdentityServer()需要把 IdentityServer4 中间件添加到 Http 管道中, 代码如下:
- public void Configure(IApplicationBuilder App, IwebHostEnvironment env)
- {
- if (env.IsDevelopment())
- {
- App.UseDeveloperExceptionPage();
- }
- App.UseIdentityServer();
- App.UseRouting();
- App.UseAuthorization();
- App.UseEndpoints(endpoints =>
- {
- endpoints.MapControllers();
- });
- }
好了, 现在授权网关服务代码已经完成, 现在直接通过命令行方式启动, 命令行启动如下, 我指定 5000 端口, 如下图:
电商用户网关 API 项目
现在我来新建一个 WebApi 大的用户网关服务项目, 取名为 Jlion.NetCore.Identity.UserApiService, 新建后会默认有一个天气预报的 API 接口, 代码如下:
- [ApiController]
- [Route("[controller]")]
- public class WeatherForecastController : ControllerBase
- {
- private static readonly string[] Summaries = new[]
- {
- "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
- };
- private readonly ILogger<WeatherForecastController> _logger;
- public WeatherForecastController(ILogger<WeatherForecastController> logger)
- {
- _logger = logger;
- }
- [HttpGet]
- public IEnumerable<WeatherForecast> Get()
- {
- var rng = new Random();
- return Enumerable.Range(1, 5).Select(index => new WeatherForecast
- {
- Date = DateTime.Now.AddDays(index),
- TemperatureC = rng.Next(-20, 55),
- Summary = Summaries[rng.Next(Summaries.Length)]
- })
- .ToArray();
- }
- }
接下来在 Startup 类中添加授权网关服务的配置到 DI 中, 代码如下:
- public void ConfigureServices(IServiceCollection services)
- {
- services.AddControllers();
- services.AddAuthorization();
- services.AddAuthentication("Bearer")
- .AddIdentityServerAuthentication(options =>
- {
- options.Authority = "http://localhost:5000"; // 配置 Identityserver 的授权地址
- options.RequireHttpsMetadata = false; // 不需要 https
- options.ApiName = OAuthConfig.UserApi.ApiName; //API 的 name, 需要和 config 的名称相同
- });
- }
这里的 options.ApiName 需要和网关服务中的 API 资源配置中的 ApiName 一致
接下来需要把授权和认证中间件分别注册到 Http 管道中, 代码如下:
- public void Configure(IApplicationBuilder App, IWebHostEnvironment env)
- {
- if (env.IsDevelopment())
- {
- App.UseDeveloperExceptionPage();
- }
- App.UseRouting();
- App.UseAuthentication();
- App.UseAuthorization();
- App.UseEndpoints(endpoints =>
- {
- endpoints.MapControllers();
- });
- }
现在授权服务网关启用已经完成, 只需要在需要保护的 Controller 中添加 Authorize 过滤器即可, 现在我也通过命令行把需要保护的网关服务启动, 如图:
现在我通过 postman 工具来单独访问 用户网关服务 API, 不携带任何信息的情况下, 如图:
从访问结果可以看出返回 401 Unauthorized 未授权.
我们接下来再来访问授权服务网关, 如图:
请求网关服务中 body 中携带了用户名及密码等相关信息, 这是返回了 access_token 及有效期等相关信息, 我们再拿 access_token 来继续上面的操作, 访问用户业务网关的接口, 如图:
访问结果中已经返回了我们所需要的接口数据, 大家目前已经对密码模式的使用有了一定的了解, 但是这时候可能会有人问我, 我生产环境中可能需要通过数据库的方式进行用户信息的判断, 以及客户端授权方式需要更加灵活的配置, 可通过后台来配置 ClientId 以及授权方式等, 那应该怎么办呢? 下面我再来给大家带来生存环境中的实现方式.
数据库匹配验证方式
我们需要通过用户名和密码到数据库中验证方式则需要实现 IResourceOwnerPasswordValidator 接口, 并实现 ValidateAsync 验证方法, 简单的代码如下:
- public class ResourceOwnerPasswordValidator : IResourceOwnerPasswordValidator
- {
- public async Task ValidateAsync(ResourceOwnerPasswordValidationContext context)
- {
- try
- {
- var userName = context.UserName;
- var password = context.Password;
- // 验证用户, 这么可以到数据库里面验证用户名和密码是否正确
- var claimList = await ValidateUserAsync(userName, password);
- // 验证账号
- context.Result = new GrantValidationResult
- (
- subject: userName,
- authenticationMethod: "custom",
- claims: claimList.ToArray()
- );
- }
- catch (Exception ex)
- {
- // 验证异常结果
- context.Result = new GrantValidationResult()
- {
- IsError = true,
- Error = ex.Message
- };
- }
- }
- #region Private Method
- /// <summary>
- /// 验证用户
- /// </summary>
- /// <param name="loginName"></param>
- /// <param name="password"></param>
- /// <returns></returns>
- private async Task<List<Claim>> ValidateUserAsync(string loginName, string password)
- {
- //TODO 这里可以通过用户名和密码到数据库中去验证是否存在,
- // 以及角色相关信息, 我这里还是使用内存中已经存在的用户和密码
- var user = OAuthMemoryData.GetTestUsers();
- if (user == null)
- throw new Exception("登录失败, 用户名和密码不正确");
- return new List<Claim>()
- {
- new Claim(ClaimTypes.Name, $"{loginName}"),
- };
- }
- #endregion
- }
用户密码验证器已经实现完成, 现在需要把之前的通过 AddTestUsers 方式改成 AddResourceOwnerValidator<ResourceOwnerPasswordValidator>() 方式, 修改后的代码如下:
- public void ConfigureServices(IServiceCollection services)
- {
- services.AddControllers();
- #region 数据库存储方式
- services.AddIdentityServer()
- .AddDeveloperSigningCredential()
- .AddInMemoryApiResources(OAuthMemoryData.GetApiResources())
- .AddInMemoryClients(OAuthMemoryData.GetClients())
- //.AddTestUsers(OAuthMemoryData.GetTestUsers());
- .AddResourceOwnerValidator<ResourceOwnerPasswordValidator>();
- #endregion
- }
目前已经实现了用户名和密码数据库验证的方式, 但是现在有人会考虑另外一个场景, 客户端的授权方式等也需要通过后台可配置的方式, 这样比较灵活, 不通过代码中静态配置的方式, 那应该这么办呢?
官方考虑的很周到, 我们可以使用 IClientStore 接口, 同时需要实现 FindClientByIdAsync 方法, 代码如下:
- public class ClientStore : IClientStore
- {
- public async Task<Client> FindClientByIdAsync(string clientId)
- {
- #region 用户名密码
- var memoryClients = OAuthMemoryData.GetClients();
- if (memoryClients.Any(oo => oo.ClientId == clientId))
- {
- return memoryClients.FirstOrDefault(oo => oo.ClientId == clientId);
- }
- #endregion
- #region 通过数据库查询 Client 信息
- return GetClient(clientId);
- #endregion
- }
- private Client GetClient(string client)
- {
- //TODO 根据数据库查询
- return null;
- }
- }
Startup 中 ConfigureServices 代码 AddInMemoryClients 改成 AddClientStore<> 代码如下:
- public void ConfigureServices(IServiceCollection services)
- {
- services.AddControllers();
- #region 数据库存储方式
- services.AddIdentityServer()
- .AddDeveloperSigningCredential()
- .AddInMemoryApiResources(OAuthMemoryData.GetApiResources())
- //.AddInMemoryClients(OAuthMemoryData.GetClients())
- .AddClientStore<ClientStore>()
- .AddResourceOwnerValidator<ResourceOwnerPasswordValidator>();
- #endregion
- }
好了数据库查询匹配方式也已经改造完了, 业务网关服务不需要改动如何代码, 运行结果这里就不在运行演示了. Demo 代码已经上传到 GitHub 上了, GitHub 源代码地址: https://github.com/a312586670/IdentityServerDemo
结语: 通过 IdentityServer4 实现的简单授权中心的思想也就完成了, 后续继续学习, 有错误地方还请留言指出! 感谢!!!
来源: https://www.cnblogs.com/jlion/p/12447081.html