swagger重启_swagger系列三：结合Nginx访问控制及swagger常见问题解决

1. 用HTTP基本身份验证限制访问

在

swagger生成的文档放在公网上的时候，就暴露了接口，有了安全隐患。

nginx的

ngx_http_auth_basic_module模块为我们提供了方便。再结合

Apache模块

htpasswd来增强安全性。需安装Apache服务，这里不赘述。

htpasswd: htpasswd建立和更新存储用户名、密码的文本文件， 用于对HTTP用户的basic认证。

创建一个密码文件和第一个用户。htpasswd使用该

-c标志(创建一个新文件,如果文件存在则不用

-c)，文件路径名作为第一个参数，并将用户名作为第二个参数运行该实用程序,按Enter并在提示中输入user1的密码。如：

$ sudo htpasswd -c /etc/apache2/.htpasswd user1

查看结果：

$ cat /etc/apache2/.htpasswd

user1：$ APR1 $ / woC1jnP $ KAh0SsVn5qeSMjTtn0E9Q0

user2：$ APR1 $ QdR8fNLT $ vbCEEzDj7LyqCMyNpSoBh /

基本认证与IP地址访问限制相结合。配置Nginx：

location /docs {

satisfy all;

deny 192.168.31.2;

allow 192.168.31.0/24;

allow 127.0.0.1;

deny all;

auth_basic "Administrator's area";

auth_basic_user_file /usr/local/etc/nginx/.htpasswd;

}

重启Nginx： nginx -s reload,访问

不输入账户密码或账户密码错误访问：

2.常见问题

右下角 ERR 错误

点击可见

{"schemaValidationMessages":[{"level":"error","message":"Can't read from file swagger.json"}]}

解决方法：在使用

swagger-ui时它会调用一个远程验证，在index.html中添加

validatorUrl:false关闭远程验证即可。