Formations — 1 037 leçons en français

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 OPTIONS pour 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 HttpSecurity avec http.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 CorsConfigurationSource global. Pratique au cas par cas, moins centralisé.

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.