注册认证服务

  • 在这里，我们用微软给我们提供的JwtBearer认证方式，实现认证服务注册 。
  1. 引入nuget包：Microsoft.AspNetCore.Authentication.JwtBearer
  • 注册服务，将服务添加到容器中
  1. public void ConfigureServices(IServiceCollection services)
  2. {
  3.     services.AddControllers();
  5.     var Issurer = "JWTBearer.Auth";  //发行人
  6.     var Audience = "api.auth";       //受众人
  7.     var secretCredentials = "q2xiARx$4x3TKqBJ";   //密钥
  9.     //配置认证服务
  10.     services.AddAuthentication(x =>
  11.     {
  12.         x.DefaultAuthenticateScheme = JwtBearerDefaults.AuthenticationScheme;
  13.         x.DefaultChallengeScheme = JwtBearerDefaults.AuthenticationScheme;
  14.     }).AddJwtBearer(o=>{
  15.         o.TokenValidationParameters = new TokenValidationParameters
  16.         {
  17.             //是否验证发行人
  18.             ValidateIssuer = true,
  19.             ValidIssuer = Issurer,//发行人
  20.             //是否验证受众人
  21.             ValidateAudience = true,
  22.             ValidAudience = Audience,//受众人
  23.             //是否验证密钥
  24.             ValidateIssuerSigningKey = true,
  25.             IssuerSigningKey = new SymmetricSecurityKey(Encoding.ASCII.GetBytes(secretCredentials)),
  27.             ValidateLifetime = true, //验证生命周期
  28.             RequireExpirationTime = true, //过期时间
  29.         };
  30.     });
  31. }
  • 注意说明：
  1. 一. TokenValidationParameters的参数默认值：
  2. 1. ValidateAudience = true,  ----- 如果设置为false,则不验证Audience受众人
  3. 2. ValidateIssuer = true ,   ----- 如果设置为false,则不验证Issuer发布人，但建议不建议这样设置
  4. 3. ValidateIssuerSigningKey = false,
  5. 4. ValidateLifetime = true,  ----- 是否验证Token有效期，使用当前时间与Token的Claims中的NotBefore和Expires对比
  6. 5. RequireExpirationTime = true, ----- 是否要求Token的Claims中必须包含Expires
  7. 6. ClockSkew = TimeSpan.FromSeconds(300), ----- 允许服务器时间偏移量300秒，即我们配置的过期时间加上这个允许偏移的时间值

调用方法，配置Http请求管道

  1. public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
  2. {
  3.     if (env.IsDevelopment())
  4.     {
  5.         app.UseDeveloperExceptionPage();
  6.     }
  8.     app.UseRouting();
  9.     //1.先开启认证
  10.     app.UseAuthentication();
  11.     //2.再开启授权
  12.     app.UseAuthorization();
  14.     app.UseEndpoints(endpoints =>
  15.     {
  16.         endpoints.MapControllers();
  17.     });
  18. }
  • 在JwtBearerOptions的配置中，通常IssuerSigningKey(签名秘钥), ValidIssuer(Token颁发机构), ValidAudience(颁发给谁) 三个参数是必须的，后两者用于与TokenClaims中的Issuer和Audience进行对比，不一致则验证失败

接口资源保护

  1. [ApiController]
  2. [Route("[controller]")]
  3. [Authorize]
  4. public class WeatherForecastController : ControllerBase
  5. {
  6.     private static readonly string[] Summaries = new[]
  7.     {
  8.         "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
  9.     };
  11.     private readonly ILogger<WeatherForecastController> _logger;
  13.     public WeatherForecastController(ILogger<WeatherForecastController> logger)
  14.     {
  15.         _logger = logger;
  16.     }
  18.     [HttpGet]
  19.     public IEnumerable<WeatherForecast> Get()
  20.     {
  21.         var rng = new Random();
  22.         return Enumerable.Range(1, 5).Select(index => new WeatherForecast
  23.         {
  24.             Date = DateTime.Now.AddDays(index),
  25.             TemperatureC = rng.Next(-20, 55),
  26.             Summary = Summaries[rng.Next(Summaries.Length)]
  27.         })
  28.         .ToArray();
  29.     }
  30. }

生成Token

运行

  • 访问获取Token方法，获取得到access_token net - 图1

  • 再访问，授权资源接口，可以发现，再没有添加请求头token值的情况下，返回了401没有权限 net - 图2

  • 这次，在请求头通过Authorization加上之前获取的token值后，再次进行访问，发现已经可以获取访问资源控制器，并返回对应的数据 net - 图3