Formations — 1 037 leçons en français

Accueil › Fullstack Angular + Spring Boot › CORS en pratique : lire l'erreur et corriger du bon côté

CORS en pratique : lire l'erreur et corriger du bon côté

Authentification de bout en boutintermediaire

CORS n'est pas une protection de votre serveur : c'est le navigateur qui empêche une page d'un autre site de lire les réponses de votre API avec les droits de l'utilisateur. Trois conséquences pratiques :

En développement, la meilleure solution est de supprimer le problème :

// proxy.conf.json
{
  "/api": { "target": "http://localhost:8080", "secure": false, "changeOrigin": true }
}

En production, si le front et l'API ne partagent pas la même origine, la configuration explicite :

@Bean
CorsConfigurationSource cors() {
    CorsConfiguration config = new CorsConfiguration();
    config.setAllowedOrigins(List.of("https://boutique.fr"));
    config.setAllowedMethods(List.of("GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"));
    config.setAllowedHeaders(List.of("Authorization", "Content-Type", "X-XSRF-TOKEN"));
    config.setExposedHeaders(List.of("Location", "X-Total-Count"));
    config.setAllowCredentials(true);
    config.setMaxAge(Duration.ofMinutes(30));

    UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
    source.registerCorsConfiguration("/api/**", config);
    return source;
}

Les termes à connaître

CORS

Cross-Origin Resource Sharing : mécanisme par lequel un serveur autorise un navigateur à laisser une page d'une autre origine lire ses réponses. Ce n'est pas une sécurité du serveur : c'est une protection du navigateur pour l'utilisateur.

Requête préalable (preflight)

Requête OPTIONS envoyée automatiquement par le navigateur avant la vraie requête, quand celle-ci n'est pas « simple ». Le serveur y répond par les en-têtes Access-Control-Allow-*, sans exécuter la logique métier.

Requête simple

Requête qui échappe au préalable : méthode GET, HEAD ou POST, sans en-tête non standard, et avec un Content-Type parmi text/plain, multipart/form-data, application/x-www-form-urlencoded. Un POST en application/json n'est pas simple : il déclenche toujours un préalable.

Access-Control-Allow-Origin

En-tête de réponse qui nomme l'origine autorisée à lire la réponse. Il doit contenir une origine précise (ou *), jamais une liste. Avec Access-Control-Allow-Credentials: true, le joker * est refusé par le navigateur.

Access-Control-Expose-Headers

En-tête par lequel le serveur autorise le JavaScript à lire des en-têtes de réponse non standard. Sans lui, reponse.headers.get('X-Total-Count') renvoie null en multi-origine, même si l'en-tête est bien présent dans l'onglet Réseau.

Proxy de développement

Redirection assurée par le serveur de développement Angular : le navigateur n'appelle que localhost:4200, qui relaie vers localhost:8080. Le navigateur ne voit qu'une seule origine, donc plus de CORS du tout. C'est la solution préférable en développement.

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.