Asp.Net Core鉴权授权：在Swagger中的Token验证

合集 - ASP.NET Core技术内幕与项目实战[学习笔记](11)

1.Asp.Net Core鉴权授权：标识框架identity2022-09-212.Asp.Net Core鉴权授权：JWT基本使用2022-09-213.Asp.Net Core鉴权授权：.Net Core对于JWT的封装2022-09-27

4.Asp.Net Core鉴权授权：在Swagger中的Token验证2022-09-27

5.SignalR：基本使用2022-09-276.SignalR：协议协商2022-09-287.SignalR：分布式部署2022-09-288.SignalR：身份认证2022-09-289.SignalR：针对部分客户端的消息推送2022-09-2910.MediatR：实现领域事件2022-10-0811.MediatR：EF Core中发布领域事件2022-10-14

收起

Swagger中默认没有提供设置自定义HTTP请求报文头的方式，因此对于需要传递Authorization报文头的接口，调试起来很麻烦。我们可以通过对OpenAPI进行配置，从而让Swagger中可以发送Authorization报文头。

我们需要修改Program.cs的AddSwaggerGen方法调用。

builder.Services.AddSwaggerGen(c =>
{
    var scheme = new OpenApiSecurityScheme()
    {
        Description = "Authorization header. \r\nExample: 'Bearer 12345abcdef'",
        Reference = new OpenApiReference
        {
            Type = ReferenceType.SecurityScheme,
            Id = "Authorization"
        },
        Scheme = "oauth2",
        Name = "Authorization",
        In = ParameterLocation.Header,
        Type = SecuritySchemeType.ApiKey,
    };
    c.AddSecurityDefinition("Authorization", scheme);
    var requirement = new OpenApiSecurityRequirement();
    requirement[scheme] = new List<string>();
    c.AddSecurityRequirement(requirement);
});

添加完以上代码后，重启并运行项目，会发现在Swagger界面的右上角增加了一个【Authorize】按钮。点击按钮后，弹出对话框的文本框，我们输入“Bearer JWT”，然后单击【Authorize】按钮，这样在这个界面之后的请求中，浏览器都会自动在请求报文头中加入Authorization报文头。当然，如果界面关闭或重启了，我们就必须重新输入Authorization报文头的值。

设置完授权对话框后，再在Swagger界面中发起对需要授权接口的请求，就可以看到服务器端的身份验证成功了。

本文学习参考自：ASP.NET Core技术内幕与项目实战