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授权方案的名称
|
||
});
|
||
});
|
||
}
|
||
}
|
||
}
|