github/awesome-copilot / skills/spring-security
spring-security
UnverifiedConfigure, test and review Spring Security 6/7 in Spring Boot 3/4 apps: SecurityFilterChain lambda DSL, method security, OAuth2 resource server with JWT, OIDC login, CSRF/CORS, password encoding, headers, actuator protection, and MockMvc security tests. Use when adding or auditing authentication and authorization.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.2 KB |
| references/actuator-protection.md | markdown | 2.0 KB |
| references/csrf-cors-sessions-headers.md | markdown | 3.4 KB |
| references/method-security.md | markdown | 1.4 KB |
| references/oauth2-resource-server-jwt.md | markdown | 2.9 KB |
| references/oidc-login-oauth2-client.md | markdown | 2.0 KB |
| references/password-encoding.md | markdown | 650 B |
| references/review-checklist.md | markdown | 729 B |
| references/testing-security.md | markdown | 3.8 KB |
references/testing-security.md
View on GitHub# Testing Spring Security
Dependencies: `org.springframework.security:spring-security-test` (test scope, version managed by Boot). With Boot 4, use the modular test starters (`spring-boot-starter-webmvc-test`, `spring-boot-starter-security-test`).
`@WebMvcTest` package: Boot 3.x `org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest`; Boot 4.x `org.springframework.boot.webmvc.test.autoconfigure.WebMvcTest`. Replace `@MockBean` with `@MockitoBean` (Spring Framework 6.2+/7).
## Slice test (stateless API configuration)
These tests use the stateless resource-server configuration (`SecurityConfig`: `csrf.disable()`, `SessionCreationPolicy.STATELESS`), so no CSRF token is needed. Mock `JwtDecoder` (`org.springframework.security.oauth2.jwt.JwtDecoder`) so the filter chain can initialize without production issuer configuration or an external identity provider. `@WithMockUser` supplies authentication for authorization assertions; it does not provide a decoder or test JWT decoding.
```java
@WebMvcTest(AccountController.class)
@Import(SecurityConfig.class) // the slice does not pick up your config unless imported
class AccountControllerTest {
@Autowired MockMvc mvc;
@MockitoBean AccountService service;
@MockitoBean JwtDecoder jwtDecoder;
@Test void anonymousGets401() throws Exception {
mvc.perform(get("/accounts")).andExpect(status().isUnauthorized());
}
@Test @WithMockUser(roles = "USER")
void userGets403OnAdmin() throws Exception {
mvc.perform(get("/admin/accounts")).andExpect(status().isForbidden());
}
@Test @WithMockUser(roles = "ADMIN")
void adminOk() throws Exception {
mvc.perform(get("/admin/accounts")).andExpect(status().isOk());
}
@Test @WithMockUser
void postWithoutCsrfTokenIsAllowed() throws Exception {
mvc.perform(post("/accounts")).andExpect(status().isCreated());
}
}
```
## CSRF test (session/browser configuration)
CSRF applies whenever the browser attaches credentials automatically (session cookies, HTTP Basic, client certificates); it does not apply to explicit bearer tokens sent in headers. Test it against a separate configuration that keeps CSRF enabled (the default), never against the stateless `SecurityConfig` above:
```java
@Configuration
@EnableWebSecurity
class BrowserSecurityConfig {
@Bean
SecurityFilterChain browser(HttpSecurity http) throws Exception {
http.authorizeHttpRequests(a -> a.anyRequest().authenticated())
.formLogin(Customizer.withDefaults()); // CSRF protection stays enabled
return http.build();
}
}
@WebMvcTest(AccountController.class)
@Import(BrowserSecurityConfig.class) // not SecurityConfig
class AccountControllerCsrfTest {
@Autowired MockMvc mvc;
@MockitoBean AccountService service;
@Test @WithMockUser
void postNeedsCsrf() throws Exception {
mvc.perform(post("/accounts")).andExpect(status().isForbidden());
mvc.perform(post("/accounts").with(csrf())).andExpect(status().isCreated());
}
}
```
## Post processors
- JWT resource server: `mvc.perform(get("/api/me").with(jwt().authorities(new SimpleGrantedAuthority("SCOPE_read"))))` or `jwt().jwt(j -> j.claim("roles", List.of("admin")))`.
- OIDC login: `.with(oidcLogin().idToken(t -> t.claim("email", "a@b.c")))`; OAuth2 login: `oauth2Login()`.
- Opaque token: `opaqueToken()`; basic auth: `httpBasic("user", "pw")`; arbitrary user: `user("u").roles("X")`.
- Method security: `@WithMockUser(roles = "ADMIN")` on service tests, or `@WithUserDetails` to load a real user.
- Full-stack tests: `@SpringBootTest @AutoConfigureMockMvc` (Boot 4 package `org.springframework.boot.webmvc.test.autoconfigure.AutoConfigureMockMvc`). With `MockMvcTester` (AssertJ), use `.with(...)` similarly.
- Test the denied paths as much as the allowed ones; failing to authenticate is the most important behavior.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 464k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 464k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 464k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |