CORS c'est quoi : rôle, fonctionnement et sécurité
Réponse courte
Le partage de ressources entre origines multiples (CORS) est un mécanisme de sécurité exécuté par les navigateurs web pour autoriser ou bloquer les requêtes réseau adressées à un domaine distinct. Il s'appuie sur des en-têtes HTTP dédiés afin de permettre à un serveur d'indiquer explicitement quelles origines ont le droit d'accéder à ses données.
L’essentiel
- Protocole de sécurité géré par le navigateur pour encadrer les échanges de données entre domaines distincts.
- Assouplissement ciblé de la politique de même origine (Same-Origin Policy) par le biais d'en-têtes HTTP.
- Déclenchement automatique de requêtes préliminaires OPTIONS pour valider les opérations complexes.
- Configuration côté serveur indispensable pour définir les origines, méthodes et autorisations admises.
Quand on aborde l'architecture web, comprendre cors c'est quoi s'avère indispensable dès qu'un script client tente d'interroger un serveur externe. L'acronyme CORS désigne le Cross-Origin Resource Sharing, soit le partage de ressources entre origines distinctes. Il s'agit d'une convention technique basée sur le protocole HTTP permettant à un serveur de spécifier les domaines, protocoles ou ports distants autorisés à charger ses données via un navigateur.
CORS c'est quoi : définition et mécanismes fondamentaux
Une origine web se définit par un triplet précis : le schéma (comme HTTP ou HTTPS), le nom d'hôte (par exemple api.domaine.com) et le port réseau (comme 443 ou 8080). Si l'un de ces trois paramètres diffère entre la page consultée par l'internaute et la destination d'un appel réseau, la demande est considérée comme inter-origine. Par défaut, le navigateur applique une stricte barrière de confinement pour neutraliser les transferts non autorisés.
Le mécanisme CORS ne constitue pas une faille, mais une passerelle contrôlée mise en place pour autoriser des échanges légitimes. Lorsqu'une application web hébergée sur un domaine A cherche à récupérer des données stockées sur une infrastructure B, le navigateur exige un accord explicite du serveur distant. Cette validation s'opère par l'envoi d'en-têtes HTTP spécifiques que le serveur joint à ses réponses pour instruire l'agent utilisateur sur la conduite à tenir.
La politique de même origine et la protection des données
Le modèle de sécurité des navigateurs repose traditionnellement sur la politique de même origine, couramment abrégée SOP pour Same-Origin Policy. Ce principe isole les contextes de navigation pour empêcher un site externe malveillant d'accéder aux données privées d'une autre session active. Sans cette séparation, un internaute connecté à un service bancaire pourrait voir ses données de compte dérobées par un simple script exécuté en arrière-plan depuis un autre onglet ouvert.
La politique d'origine restreint principalement la lecture programmatique des données. Si une page HTML intègre couramment des éléments passifs comme des images, des feuilles de style ou des scripts hébergés ailleurs, elle ne peut pas lire le contenu brut de ces ressources via du code JavaScript. Dès qu'une interface utilise des outils comme fetch() ou XMLHttpRequest, la vérification s'enclenche. Le protocole CORS intervient pour assouplir cette règle de façon granulaire, ce qui est requis dès que l'on connecte un frontal web moderne à une API REST dédiée.
Le cycle d'une requête : distinctions entre requêtes simples et preflight
Les navigateurs segmentent les requêtes inter-origines en deux catégories distinctes selon leur niveau d'impact potentiel sur les données de l'utilisateur. Certaines opérations partent directement vers le serveur cible, tandis que d'autres exigent une autorisation préalable.
Une requête dite simple répond à des critères précis : elle utilise exclusivement les méthodes GET, HEAD ou POST, n'intègre aucun en-tête personnalisé en dehors de ceux définis automatiquement par le client, et applique un type de contenu standard comme text/plain ou application/x-www-form-urlencoded. Dans cette situation, le navigateur transmet immédiatement la requête en y apposant l'en-tête Origin. Le serveur retourne ensuite la réponse accompagnée des autorisations CORS, et le navigateur décide d'exposer ou de bloquer le résultat au code JavaScript.
Dès qu'une requête s'écarte de ces critères basiques, le navigateur émet une requête préliminaire, appelée preflight, utilisant la méthode HTTP OPTIONS. Ce test préalable sert à interroger le serveur sur sa capacité et son consentement à traiter l'action réelle. Les facteurs provoquant cette vérification préliminaire comprennent :
- L'utilisation de méthodes modifiant des ressources, telles que PUT, DELETE ou PATCH.
- L'envoi d'en-têtes HTTP personnalisés, comme Authorization ou X-Requested-With.
- L'emploi du format application/json pour transmettre un corps de requête.
| Type de requête | Méthodes autorisées | En-tête Content-Type admis | Requête préliminaire (OPTIONS) |
|---|---|---|---|
| Requête simple | GET, HEAD, POST | text/plain, application/x-www-form-urlencoded, multipart/form-data | Aucune émission préalable |
| Requête complexe | PUT, DELETE, PATCH et verbes personnalisés | application/json et formats non standards | Requête preflight systématique |
Les en-têtes HTTP de configuration
La négociation entre le client et le serveur s'articule autour d'en-têtes précis. Côté client, le navigateur prend en charge l'injection de l'en-tête Origin, qui reflète l'origine exacte du document ayant initié l'appel. Le code JavaScript ne peut pas modifier ni interdire cet en-tête.
Côté serveur, plusieurs directives définissent le périmètre d'accès :
- Access-Control-Allow-Origin : spécifie les origines admises. Le serveur peut inscrire une URL précise ou le symbole générique * pour une ressource totalement publique.
- Access-Control-Allow-Methods : énumère les verbes HTTP autorisés lors de l'appel réel.
- Access-Control-Allow-Headers : valide les en-têtes personnalisés que le navigateur a le droit d'envoyer.
- Access-Control-Max-Age : définit la durée de validité en secondes du résultat de la requête preflight, évitant de répéter l'appel OPTIONS à chaque opération.
- Access-Control-Allow-Credentials : indique si la réponse peut être partagée lorsque la requête contient des éléments de session.
L'utilisation de données d'authentification implique des règles strictes. Si l'application échange des identifiants ou s'appuie sur le fonctionnement des cookies web, l'en-tête Access-Control-Allow-Origin ne peut en aucun cas contenir le caractère générique *. Le serveur doit renvoyer nominativement l'origine exacte du client. Pour les canaux de communication continus non régis par le cycle requête-réponse habituel, d'autres protocoles comme le protocole WebSocket appliquent leur propre logique de vérification lors de l'établissement de la liaison.
Diagnostic des erreurs et règles de sécurité
Une caractéristique courante du protocole concerne la façon dont les refus sont rapportés. Pour des impératifs de confidentialité, le navigateur ne transmet aucun détail sur l'erreur au script appelant. Du point de vue de l'application JavaScript, la promesse émise par fetch() est rejetée avec un message générique. Le développeur doit consulter la console des outils d'inspection du navigateur pour connaître le motif exact du blocage, qu'il s'agisse d'un en-tête absent ou d'une méthode non prise en charge.
Une erreur fréquente consiste à configurer le serveur pour qu'il recopie systématiquement l'en-tête Origin reçu dans l'en-tête de réponse Access-Control-Allow-Origin, tout en activant la transmission des identifiants. Ce comportement crée une faille majeure : n'importe quelle page web malveillante peut alors interroger le service avec les droits de la victime connectée et lire le contenu des réponses. Une infrastructure robuste repose sur une liste stricte de domaines autorisés, vérifiée côté serveur avant toute émission d'autorisation.
Autres questions fréquentes
CORS protège-t-il directement le serveur contre les attaques ?
Non, CORS est une sécurité appliquée par le navigateur pour protéger l'internaute. Un outil tiers ou un script hors navigateur peut envoyer des requêtes HTTP sans respecter ces restrictions.
Pourquoi mon script JavaScript ne peut-il pas lire le détail d'une erreur CORS ?
Le navigateur dissimule les détails d'un échec CORS au code JavaScript pour éviter que des scripts hostiles n'obtiennent des informations sur la topologie du réseau ou la configuration du serveur distant.
Le caractère générique (*) est-il compatible avec l'envoi de cookies ?
Non, les navigateurs refusent l'accès aux réponses si le serveur utilise l'en-tête générique (*) alors que la requête transporte des cookies ou des identifiants d'authentification.
Pages liées
- Rendu côté client vs côté serveur : différences clés
Le rendu côté client génère le HTML dans le navigateur avec JavaScript, tandis que le rendu côté serveur l'envoie déjà complet. Le premier favorise l'interactivité, le second l'affichage initial et le référencement. Le bon choix dépend du contenu, du trafic et des contraintes serveur.
- Cookies web : fonctionnement et gestion des données
Les cookies web constituent des fichiers de données émis par un serveur web et stockés par le navigateur pour préserver l'état d'une connexion. Ils permettent de reconnaître un utilisateur d'une page à l'autre et de mémoriser ses préférences de navigation, compensant ainsi la nature sans état du protocole HTTP.
- Cache webcam : comprendre le cache web
Le cache web est une copie locale de ressources déjà téléchargées. Il accélère l'affichage des pages et réduit les transferts réseau. Le vider corrige surtout des fichiers obsolètes ou corrompus, pas les mots de passe.
- WebSocket what is it : guide pratique
WebSocket est un protocole qui garde une connexion persistante et bidirectionnelle entre client et serveur. Il convient aux applications temps réel qui échangent souvent des données. Il ne remplace pas HTTP pour les pages et les API classiques.
- GraphQL : langage de requête pour API
GraphQL est un langage de requête pour API et un runtime qui exécute les requêtes selon un schéma typé. Le client choisit les champs à recevoir, ce qui évite de récupérer des données inutiles. Les requêtes, mutations et abonnements couvrent la lecture, la modification et, lorsqu'ils sont implémentés, le temps réel.
- Qu'est-ce qu'une API REST ? Guide clair
Une API sert de pont entre programmes pour échanger des données. Une API REST applique les règles REST aux échanges HTTP, généralement autour de ressources et de JSON. Toute API REST appartient à la famille des API, sans que toute API soit REST.
Comment cette page a été préparée
Avant la rédaction, le sujet a été étudié dans les sources ci-dessous. La page a ensuite passé des contrôles de qualité automatiques.