58 lines
2.4 KiB
C#
58 lines
2.4 KiB
C#
|
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授权方案的名称
|
|||
|
|
});
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|