Formations — 1 037 leçons en français

Accueil › Spring Boot › Autorisation : protéger les URL et les méthodes

Autorisation : protéger les URL et les méthodes

Spring Securityintermediaire

L'autorisation répond à une question différente de l'authentification : une fois qu'on sait qui vous êtes, avez-vous le droit ? Spring Security la contrôle à deux niveaux, souvent combinés.

Par URL, avec authorizeHttpRequests :

@Bean
SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
    http.authorizeHttpRequests(auth -> auth
        .requestMatchers("/api/public/**").permitAll()
        .requestMatchers(HttpMethod.POST, "/api/produits").hasRole("ADMIN")
        .requestMatchers("/api/admin/**").hasRole("ADMIN")
        .anyRequest().authenticated()
    );
    return http.build();
}

Règle essentielle : l'ordre compte. Ces règles sont évaluées de haut en bas, la première qui correspond au chemin l'emporte. Il faut donc placer les règles les plus précises en premier, et anyRequest() toujours en dernier.

Par méthode, avec @EnableMethodSecurity sur la configuration, puis @PreAuthorize sur les méthodes à protéger :

@PreAuthorize("hasRole('ADMIN') or #id == authentication.principal.id")
public Commande annuler(Long id) { ... }

hasRole("ADMIN") exige l'autorité ROLE_ADMIN (le préfixe ROLE_ est ajouté automatiquement) ; hasAuthority("ADMIN") exige l'autorité exacte ADMIN, sans préfixe.

Les termes à connaître

authorizeHttpRequests

Méthode de configuration sur HttpSecurity (DSL lambda) qui déclare les règles d'autorisation par URL, évaluées dans l'ordre d'écriture : la première règle dont le requestMatcher correspond à la requête s'applique.

requestMatchers

Sélectionne un ensemble de requêtes par chemin (requestMatchers("/admin/**")), éventuellement combiné à une méthode HTTP (requestMatchers(HttpMethod.POST, "/produits")). Remplace antMatchers, supprimé dans Spring Security 6.

hasRole / hasAuthority

hasAuthority("X") exige l'autorité exacte X. hasRole("ADMIN") est un raccourci qui exige l'autorité ROLE_ADMIN : Spring Security ajoute automatiquement le préfixe ROLE_. Ne pas l'ajouter soi-même dans hasRole, au risque de chercher ROLE_ROLE_ADMIN.

anyRequest().authenticated()

Règle « filet de sécurité » placée en dernier : toute requête qui n'a matché aucune règle précédente doit être authentifiée. Bonne pratique pour ne jamais laisser une route oubliée en accès libre.

@EnableMethodSecurity

Active la sécurité au niveau des méthodes (@PreAuthorize, @PostAuthorize, @Secured…), posée sur une classe @Configuration. Remplace @EnableGlobalMethodSecurity, dépréciée.

@PreAuthorize / @PostAuthorize

Annotations posées sur une méthode (service ou contrôleur), avec une expression SpEL évaluée respectivement avant (@PreAuthorize) ou après (@PostAuthorize) son exécution. @PreAuthorize peut accéder aux paramètres de la méthode (#id), @PostAuthorize peut accéder à la valeur retournée (returnObject).

@Secured

Annotation plus ancienne et plus limitée : accepte seulement une liste de rôles/autorités, sans expression SpEL (@Secured("ROLE_ADMIN")). @PreAuthorize est préféré pour sa souplesse.

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.