Formations — 1 037 leçons en français

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 @WebFluxTest ré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"}) — les roles reçoivent automatiquement le préfixe ROLE_, 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é ADMIN telle quelle, sans préfixe. Les deux formes ne sont pas interchangeables : hasRole("ADMIN") attend ROLE_ADMIN, hasAuthority("ADMIN") attend ADMIN.

Post-processors MockMvc (with(...))

Méthodes statiques de SecurityMockMvcRequestPostProcessors passées à .with(...) sur une requête MockMvc, 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, DELETE ou PATCH sur 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 server OAuth2 (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.

Lire l'explication détaillée et faire le quiz →

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.