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 :
curlet Postman ignorent CORS : une requête qui marche là et pas dans le navigateur est presque toujours un problème CORS.- Aucun code front ne peut le contourner. La correction est côté serveur, ou dans un proxy.
- Le serveur a bien exécuté la requête. Un
DELETEbloqué par CORS a quand même supprimé la donnée : seule la lecture de la réponse est interdite.
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
OPTIONSenvoyé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êtesAccess-Control-Allow-*, sans exécuter la logique métier.- Requête simple
Requête qui échappe au préalable : méthode
GET,HEADouPOST, sans en-tête non standard, et avec unContent-Typeparmitext/plain,multipart/form-data,application/x-www-form-urlencoded. UnPOSTenapplication/jsonn'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. AvecAccess-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')renvoienullen 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 verslocalhost: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.
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.