Accueil › Spring Boot › Tester la sécurité
Tester la sécurité
Tests avancésintermediaire
spring-security-test fournit tout ce qu'il faut pour tester l'authentification et l'autorisation sans vrai jeton ni vrai utilisateur en base : l'annotation @WithMockUser et des post-processors MockMvc.
@WebMvcTest(ProduitController.class)
@Import(SecurityConfig.class)
class ProduitControllerSecuriteTest {
@Autowired
private MockMvc mockMvc;
@MockitoBean
private ProduitService produitService;
@Test
void supprimerProduit_sansAuthentification_renvoie_401() throws Exception {
mockMvc.perform(delete("/produits/1"))
.andExpect(status().isUnauthorized());
}
@Test
@WithMockUser(roles = "USER")
void supprimerProduit_avecRoleInsuffisant_renvoie_403() throws Exception {
mockMvc.perform(delete("/produits/1").with(csrf()))
.andExpect(status().isForbidden());
}
@Test
@WithMockUser(roles = "ADMIN")
void supprimerProduit_avecRoleAdmin_renvoie_204() throws Exception {
mockMvc.perform(delete("/produits/1").with(csrf()))
.andExpect(status().isNoContent());
}
}
@WithMockUser place un utilisateur simulé dans le contexte de sécurité pour toute la durée du test. .with(csrf()) ajoute un jeton CSRF valide à la requête, nécessaire pour les méthodes qui modifient l'état si la protection CSRF est active. @WebMvcTest ne charge pas automatiquement une classe @Configuration personnalisée : il faut @Import(SecurityConfig.class) pour tester les vraies règles d'autorisation de l'application.
Les termes à connaître
- spring-security-test
Dépendance (scope
test) qui apporte les utilitaires de test de Spring Security : l'annotation@WithMockUser, les post-processors MockMvc (with(user(...)),with(csrf()),with(jwt())…) et le support des tests@WebFluxTestréactifs.- @WithMockUser
Annotation posée sur une méthode ou une classe de test : place un utilisateur simulé dans le contexte de sécurité avant l'exécution du test.
@WithMockUser(username = "alice", roles = {"ADMIN"})— lesrolesreçoivent automatiquement le préfixeROLE_, contrairement àauthorities.- roles vs authorities
@WithMockUser(roles = "ADMIN")crée l'autoritéROLE_ADMIN(préfixe ajouté automatiquement).@WithMockUser(authorities = "ADMIN")crée l'autoritéADMINtelle quelle, sans préfixe. Les deux formes ne sont pas interchangeables :hasRole("ADMIN")attendROLE_ADMIN,hasAuthority("ADMIN")attendADMIN.- Post-processors MockMvc (with(...))
Méthodes statiques de
SecurityMockMvcRequestPostProcessorspassées à.with(...)sur une requêteMockMvc, pour simuler un contexte de sécurité au niveau de la requête plutôt que de toute la méthode de test :with(user("alice").roles("ADMIN")),with(csrf()),with(jwt()),with(anonymous()).- with(csrf())
Ajoute un jeton CSRF valide à la requête simulée. Indispensable pour tester un
POST,PUT,DELETEouPATCHsur une application où la protection CSRF est active (typiquement, une application avec sessions et formulaires) : sans lui, la requête est rejetée en 403.- with(jwt())
Simule une requête authentifiée par un jeton JWT valide, pour tester un
resource serverOAuth2 (spring-security-oauth2-resource-server) sans jeton réel ni serveur d'autorisation.with(jwt().jwt(builder -> builder.claim("scope", "produits:lire")))personnalise les claims.- 401 vs 403
401 Unauthorized : la requête n'est pas authentifiée (identité inconnue ou jeton absent/invalide). 403 Forbidden : l'utilisateur est authentifié, mais n'a pas les droits nécessaires pour cette ressource. Confondre les deux dans les tests masque des bugs d'autorisation.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.