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 lerequestMatchercorrespond à 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")). RemplaceantMatchers, supprimé dans Spring Security 6.- hasRole / hasAuthority
hasAuthority("X")exige l'autorité exacteX.hasRole("ADMIN")est un raccourci qui exige l'autoritéROLE_ADMIN: Spring Security ajoute automatiquement le préfixeROLE_. Ne pas l'ajouter soi-même danshasRole, au risque de chercherROLE_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.@PreAuthorizepeut accéder aux paramètres de la méthode (#id),@PostAuthorizepeut 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")).@PreAuthorizeest préféré pour sa souplesse.
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.