优化swagger 接口授权验证

ZR.Admin.WebApi/Extensions/SwaggerExtension.cs

@@ -0,0 +1,57 @@
+using Infrastructure;
+using Microsoft.AspNetCore.Authentication.JwtBearer;
+using Microsoft.AspNetCore.Hosting;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.OpenApi.Models;
+using Swashbuckle.AspNetCore.Filters;
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using System.Threading.Tasks;
+
+namespace ZR.Admin.WebApi.Extensions
+{
+    public static class SwaggerExtension
+    {
+        public static void AddSwaggerConfig(this IServiceCollection services)
+        {
+            if (services == null) throw new ArgumentNullException(nameof(services));
+            IWebHostEnvironment hostEnvironment = App.GetRequiredService<IWebHostEnvironment>();
+
+            services.AddSwaggerGen(c =>
+            {
+                c.SwaggerDoc("v1", new OpenApiInfo
+                {
+                    Title = "ZrAdmin.NET Api - .NET5",
+                    Version = "v1",
+                    Description = "",
+                });
+                //if (CurrentEnvironment.IsDevelopment())
+                //{
+                //添加文档注释
+                c.IncludeXmlComments(Path.Combine(hostEnvironment.ContentRootPath, "ZRAdmin.xml"), true);
+                //}
+                //参考文章：http://www.zyiz.net/tech/detail-134965.html
+                //需要安装包Swashbuckle.AspNetCore.Filters
+                // 开启权限小锁 需要在对应的Action上添加[Authorize]才能看到
+                c.OperationFilter<AddResponseHeadersFilter>();
+                c.OperationFilter<AppendAuthorizeToSummaryOperationFilter>();
+
+                //在header 中添加token，传递到后台
+                c.OperationFilter<SecurityRequirementsOperationFilter>();
+
+                c.AddSecurityDefinition(JwtBearerDefaults.AuthenticationScheme,
+                    new OpenApiSecurityScheme
+                    {
+                        In = ParameterLocation.Header,
+                        Description = "请输入Login接口返回的Token，前置Bearer。示例：Bearer {Token}",
+                        Name = "Authorization",//jwt默认的参数名称,
+                        Type = SecuritySchemeType.ApiKey, //指定ApiKey
+                        BearerFormat = "JWT",//标识承载令牌的格式 该信息主要是出于文档目的
+                        Scheme = JwtBearerDefaults.AuthenticationScheme//授权中要使用的HTTP授权方案的名称
+                    });
+            });
+        }
+    }
+}