概述

最近接到一个租赁商城的单子，在 litemall 的基础上定制改造了一番，完成了基本的下单租赁流程。部署到生产环境之后发现 swagger2 没有鉴权，直接对外暴露了所有的 api 接口，安全性过低，于是为 swagger2 增加了基本的鉴权功能。

一、 增加 maven 依赖

<dependency>
  <groupId>io.springfox</groupId>
  <artifactId>springfox-swagger2</artifactId>
  <version>2.9.2</version>
</dependency>
<dependency>
  <groupId>io.springfox</groupId>
  <artifactId>springfox-swagger-ui</artifactId>
  <version>2.10.0</version>
</dependency>
<dependency>
  <groupId>com.github.xiaoymin</groupId>
  <artifactId>swagger-bootstrap-ui</artifactId>
  <version>1.9.6</version>
</dependency>

二、 swagger2 配置文件调整

swagger2 配置文件中启用 @EnableSwagger2和@EnableSwaggerBootstrapUI 两个注解：

@Configuration
@EnableSwagger2
@EnableSwaggerBootstrapUI
public class WxSwagger2Configuration {
    @Bean
    public Docket wxDocket() {
    }
}

三、 application.yml 增加如下配置

swagger:
  basic:
    enable: true
    username: aaa
    password: bbb
  production: false

重新启动应用，再次查看 api 文档时，就需要输入用户名和密码了：