Springboot配置security basic path无效解决方案

问题

springcloud 版本 为 Finchley.RELEASE

springboot 版本为 2.0.3.RELEASE

现在有需求，/swagger-ui.html 页面需要添加登录认证，但是本来的接口不需要登录认证

升级springboot之前的做法是直接在application.yml 文件中添加以下配置：

security:
basic:
 enabled: true # 启用SpringSecurity的安全配置项
 path: /swagger-ui.html
user:
 name: aijianzi # 认证用户名
 password: course # 认证密码
 role:    # 授权角色
 - USER

升级后这种配置就出错了，连编译都出错，如下图：

解决过程

查找源代码，找到如下：

来自：https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-2.0-Migration-Guide

Security
Spring Boot 2 greatly simplifies the default security configuration and makes adding custom security easy. Rather than having several security-related auto-configurations, Spring Boot now has a single behavior that backs off as soon as you add your own WebSecurityConfigurerAdapter.

You are affected if you were using any of the following properties:

security.basic.authorize-mode
security.basic.enabled
security.basic.path
security.basic.realm
security.enable-csrf
security.headers.cache
security.headers.content-security-policy
security.headers.content-security-policy-mode
security.headers.content-type
security.headers.frame
security.headers.hsts
security.headers.xss
security.ignored
security.require-ssl
security.sessions

翻译：Spring Boot 2极大地简化了默认的安全配置，并使添加定制安全性变得更加容易。Spring Boot并没有使用几个与安全相关的自动配置，而是在添加自己的WebSecurityConfigurerAdapter时就有了一个单独的行为。如果您使用以下属性，您将受到影响

再找到：https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-Security-2.0

Security Auto-configuration
Spring Boot 2.0 does not provide separate auto-configuration for user-defined endpoints and actuator endpoints. When Spring Security is on the classpath, the auto-configuration secures all endpoints by default. It adds the @EnableWebSecurity annotation and relies on Spring Security's content-negotiation strategy to determine whether to use httpBasic or formLogin. A user with a a default username and generated password is added, which can be used to login.

翻译：Spring Boot 2.0没有为用户定义的端点和执行器端点提供单独的自动配置。当Spring Security在类路径上时，自动配置默认为所有端点。它添加了@EnableWebSecurity 注释，并依赖于Spring Security的内容协商策略来决定是否使用httpBasic或formLogin。添加了一个默认用户名和生成密码的用户，这可以用来登录。

解决

对于不同的URL，安全性是不同的，关键在于重载WebSecurityConfigurerAdapter 类的configure(HttpSecurity) 方法。具体可以参考以上的两个链接

我的完整实现如下：

1、pom.xml 中添加依赖：

<dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-security</artifactId>
</dependency>

2、application.yml 文件中配置登录用户名和密码（如果只到这里，那么所有的请求都会被拦截）

spring:
security:
user:
 name: admin
 password: admin

3、添加自定义的配置类，注解@Configuration @EnableWebSecurity

import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;

/**
* @author jiashubing
* @since 2018/7/16
*/
@Configuration
@EnableWebSecurity
public class ActuatorWebSecurityConfigurationAdapter extends WebSecurityConfigurerAdapter {
 @Override
 protected void configure(HttpSecurity http) throws Exception {
   http
       .authorizeRequests()
       //普通的接口不需要校验
       .antMatchers("/courseApi/**").permitAll()
       // swagger页面需要添加登录校验
       .antMatchers("/swagger-ui.html").authenticated()
       .and()
       .formLogin();
 }
}

当然也可以配置成需要某个角色的用户才能查看某些URL

来源：https://www.cnblogs.com/acm-bingzi/p/springboot-security.html