,NetFamework4.5.2+搭建带有Token验证的Swagger

2020-12-16 22:11

阅读:813

标签:mes   width   parameter   play   sem   add   生成   view   names   

十年河东,十年河西,莫欺少年穷

学无止境,精益求精

1、新建一个webApi项目,并引用Swashbuckle,版本:5.6.0

技术图片

 2、引用成功后,系统会自动生成一个SwaggerConfig.cs的文件,位于App_Start文件夹内,修改这个配置文件为:

using System.Web.Http;
using WebActivatorEx;
using Swashbuckle.Application;
using Swashbuckle.Swagger;
using System.Web.Http.Description;
using System.Collections.Generic;
using SwaggerSite;

[assembly: PreApplicationStartMethod(typeof(SwaggerConfig), "Register")]

namespace SwaggerSite
{
    public class SwaggerConfig
    {
        public static void Register()
        {
            var thisAssembly = typeof(SwaggerConfig).Assembly;

            GlobalConfiguration.Configuration
                .EnableSwagger(c =>
                {

                    c.SingleApiVersion("v1", "SwaggerSite");
                    c.IncludeXmlComments(string.Format("{0}/bin/SwaggerSite.XML", System.AppDomain.CurrentDomain.BaseDirectory));
                    c.OperationFilter();

                })
                .EnableSwaggerUi(c =>
                {

                });
        }
    }
    public class HttpAuthHeaderFilter : IOperationFilter
    {
        public void Apply(Operation operation, SchemaRegistry schemaRegistry, ApiDescription apiDescription)
        {
            if (operation.parameters == null)
                operation.parameters = new List();

            operation.parameters.Add(new Parameter { name = "Authorization", @in = "header", description = "授权", required = false, type = "header" });

        }
    }
}

3、右键项目,选择属性-生成一栏,输出路径,XML文档文件为:bin\SwaggerSite.xml

技术图片

 4、修改Api控制器为:

技术图片技术图片
    /// 
    /// 测试接口
    /// 
    [RoutePrefix("api/Values")]
    public class ValuesController : ApiController
    {
        /// 
        /// GET api/values
        /// 
        /// 
        public IEnumerablestring> Get()
        {
            return new string[] { "value1", "value2" };
        }

        /// 
        /// GET api/values/5
        /// 
        /// 
        /// 
        public string Get(int id)
        {
            return "value";
        }

        /// 
        /// POST api/values
        /// 
        /// 
        public void Post([FromBody] string value)
        {
        }

        /// 
        /// PUT api/values/5
        /// 
        /// 
        /// 
        public void Put(int id, [FromBody] string value)
        {
        }

        /// 
        /// DELETE api/values/5
        /// 
        /// 
        public void Delete(int id)
        {
        }
    }
View Code

运行项目:https://localhost:44372/swagger

技术图片

安全性方面,生成的swagger可以使用授权,关于授权,C#这块可以使用JWT+Token验证。

技术图片

关于JWT授权,可以参考大牛博客:JSON WEB TOKEN,简单谈谈TOKEN的使用及在C#中的实现

 纯属记录下,用到时,迅速搭建,万事大吉。

@天才卧龙的博客

,NetFamework4.5.2+搭建带有Token验证的Swagger

标签:mes   width   parameter   play   sem   add   生成   view   names   

原文地址:https://www.cnblogs.com/chenwolong/p/Swashbuckle.html


评论


亲,登录后才可以留言!