Accueil › Spring Boot › CORS et CSRF
CORS et CSRF
Spring Securityintermediaire
CORS et CSRF sont souvent confondus, alors qu'ils répondent à des problèmes opposés.
CSRF protège votre serveur contre un site tiers qui ferait exécuter, à l'insu de l'utilisateur, une action en son nom (le navigateur joint automatiquement les cookies). Cette protection n'a de sens que quand l'authentification repose sur un cookie de session, ce qui est le cas de formLogin(). C'est pourquoi elle est activée par défaut dans ce cas ; pour une API stateless authentifiée par jeton (voir la leçon sur JWT et OAuth2), elle est généralement désactivée puisqu'il n'y a pas de cookie à détourner :
@Bean
SecurityFilterChain apiChain(HttpSecurity http) throws Exception {
http
.sessionManagement(s -> s.sessionCreationPolicy(SessionCreationPolicy.STATELESS))
.csrf(csrf -> csrf.disable()) // pas de cookie de session : pas de risque CSRF ici
.authorizeHttpRequests(auth -> auth.anyRequest().authenticated());
return http.build();
}
CORS protège le navigateur de l'utilisateur : par défaut, une page JavaScript chargée depuis une origine ne peut pas appeler librement une API sur une autre origine. Le serveur doit explicitement l'autoriser :
@Bean
CorsConfigurationSource corsConfigurationSource() {
CorsConfiguration config = new CorsConfiguration();
config.setAllowedOrigins(List.of("https://mon-app.exemple.com"));
config.setAllowedMethods(List.of("GET", "POST", "PUT", "DELETE"));
config.setAllowedHeaders(List.of("Authorization", "Content-Type"));
UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
source.registerCorsConfiguration("/**", config);
return source;
}
http.cors(cors -> cors.configurationSource(corsConfigurationSource()));
Les termes à connaître
- CSRF (Cross-Site Request Forgery)
Attaque où un site malveillant fait exécuter, à l'insu de la victime, une requête vers un autre site où elle est déjà connectée (ex. un formulaire caché qui soumet un virement). Le navigateur joint automatiquement les cookies de session, la requête paraît donc légitime.
- CsrfFilter
Filtre Spring Security actif par défaut avec une authentification à base de session. Il exige un jeton CSRF valide sur les requêtes qui modifient l'état (POST, PUT, PATCH, DELETE) ; sans lui, la requête est rejetée avec un 403.
- CORS (Cross-Origin Resource Sharing)
Mécanisme du navigateur qui autorise (ou non) une page JavaScript chargée depuis une origine (protocole + domaine + port) à appeler une API sur une autre origine. Contrôlé côté serveur par des en-têtes de réponse (
Access-Control-Allow-Origin…).- Requête preflight (OPTIONS)
Avant certaines requêtes cross-origin (méthodes autres que GET/HEAD/POST simple, en-têtes personnalisés…), le navigateur envoie automatiquement une requête
OPTIONSpour demander au serveur s'il autorise l'appel réel. Si la réponse ne l'autorise pas, la vraie requête n'est même pas envoyée.- CorsConfigurationSource
Bean qui décrit les règles CORS (origines, méthodes, en-têtes autorisés) et se branche dans
HttpSecurityavechttp.cors(cors -> cors.configurationSource(...)).- @CrossOrigin
Annotation posée sur un contrôleur ou une méthode pour autoriser des origines spécifiques, sans passer par un bean
CorsConfigurationSourceglobal. Pratique au cas par cas, moins centralisé.
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.