本文介绍如何在Linux系统中使用Swagger实现API权限控制。 主要步骤如下：
集成Spring Security框架:
首先，确保你的Spring Boot项目已正确集成Spring Security。这通常需要在
文件中添加必要的依赖。
配置Spring Security安全规则:
创建一个Spring Security配置类（例如
），继承
，并重写
方法。在这个方法中，定义访问控制规则，指定哪些URL需要身份验证，哪些不需要，以及采用何种认证机制（例如，Basic Auth, JWT, OAuth 2.0）。
Swagger配置:
创建一个Swagger配置类（例如
），使用
注解。 在这个类中，配置
bean，设置API信息、扫描的包路径等。
整合Spring Security与Swagger:
为了使Swagger UI也受到Spring Security的保护，需要自定义
并将其添加到Swagger配置中。 这通常涉及创建
和
bean，并将它们添加到
bean的配置中。
CentOS Linux 7.9.2009
CentOS Linux 7.9.2009是传统CentOS Linux 7的最后主要版本，也是很多企业历史服务器中仍可能遇到的系统版本。它以稳定、兼容RHEL 7生态、文档丰富和软件支持广泛著称，曾长期用于Web服务、数据库、虚拟化节点和企业内部业务系统。不过CentOS Linux 7已于2024年6月30日停止维护，现在继续使用会面临安全补丁缺失风险。该版本更适合旧业务迁移、历史环境恢复或离线兼容性测试。
下载
测试权限控制:
部署应用后，访问Swagger UI页面。尝试访问受保护的API端点，验证只有经过身份验证的用户才能访问。
以下是一个简化的代码示例，演示如何在Spring Boot应用中集成Spring Security和Swagger，并实现基本的权限控制（使用Basic Auth）：
请注意，你需要将
替换成你实际的控制器包路径。 这个示例使用了Basic Auth，你可以根据你的安全需求选择其他的认证机制。 此外，确保你的Spring Security配置与Swagger配置相匹配。
pom.xmlSecurityConfigWebSecurityConfigurerAdapterconfigure(HttpSecurity http)SwaggerConfig@ConfigurationDocketSecuritySchemeSecuritySchemeSecurityContextDocketimport org.springframework.context.annotation.Bean;
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;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;
import springfox.documentation.service.*;
import java.util.Arrays;
import java.util.List;
@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {
@Override
protected void configure(HttpSecurity http) throws Exception {
http.authorizeRequests()
.antMatchers("/swagger-ui.html", "/webjars/**", "/swagger-resources/**", "/v2/api-docs").authenticated()
.anyRequest().permitAll()
.and()
.httpBasic();
}
}
@Configuration
@EnableSwagger2
public class SwaggerConfig {
@Bean
public Docket api() {
return new Docket(DocumentationType.SWAGGER_2)
.select()
.apis(RequestHandlerSelectors.basePackage("com.example.demo.controller")) // 替换成你的controller包路径
.paths(PathSelectors.any())
.build()
.securitySchemes(Arrays.asList(basicAuth()))
.securityContexts(Arrays.asList(securityContext()));
}
private SecurityScheme basicAuth() {
return new ApiKey("Basic Auth", "Authorization", "header");
}
private SecurityContext securityContext() {
return SecurityContext.builder()
.securityReferences(defaultAuth())
.forPaths(PathSelectors.any())
.build();
}
private List defaultAuth() {
AuthorizationScope authorizationScope = new AuthorizationScope("global", "accessEverything");
AuthorizationScope[] authorizationScopes = new AuthorizationScope[1];
authorizationScopes[0] = authorizationScope;
return Arrays.asList(new SecurityReference("Basic Auth", authorizationScopes));
}
} "com.example.demo.controller"