Aller au contenu
Réussir mon BTS SIO

Tape une notion, une commande ou le nom d'une épreuve.

Par exemple

Exercice 2 / 8Moyen

Middleware CORS

À toi

Écris un middleware factory cors(originAutorise) qui pose les headers CORS attendus :

  • Toujours : access-control-allow-origin: <originAutorise>
  • Si la requête est OPTIONS (preflight) : pose en plus access-control-allow-methods: GET,POST,PUT,DELETE,OPTIONS et access-control-allow-headers: content-type,authorization. Réponds immédiatement avec 204 (sans appeler next()).
  • Sinon : appelle next().

CORS : Cross-Origin Resource Sharing

Le navigateur bloque par défaut les appels JS d'un site A vers un autre site B. C'est la same-origin policy.

Ton API (api.exemple.com) sera appelée par ton front (app.exemple.com) — deux origines différentes. Sans CORS, le navigateur refuse.

Le mécanisme

  1. Le front fait fetch("https://api.exemple.com/data")
  2. Le navigateur envoie la requête et regarde la réponse
  3. Si l'API a posé Access-Control-Allow-Origin: https://app.exemple.com → OK
  4. Sinon → le navigateur cache la réponse au JS (même si l'API a répondu)

CORS est appliqué par le navigateur, pas par l'API. Curl, Postman, un autre serveur peuvent ignorer ces headers.

Preflight : le pré-vol

Pour les requêtes "non simples" (PUT, DELETE, ou avec headers custom), le navigateur envoie d'abord une requête OPTIONS :

OPTIONS /api/data HTTP/1.1
Origin: https://app.exemple.com
Access-Control-Request-Method: PUT
Access-Control-Request-Headers: content-type

Le serveur doit répondre :

HTTP/1.1 204 No Content
Access-Control-Allow-Origin: https://app.exemple.com
Access-Control-Allow-Methods: GET, POST, PUT, DELETE
Access-Control-Allow-Headers: content-type, authorization

Si OK, le navigateur envoie la vraie requête. Sinon, il abandonne.

Implémentation minimale

Exemple avec une liste d'origines autorisées, lue dans le header Origin de la requête :

javascript
function corsListe(originesOK) {
  return (req, res, next) => {
    const origine = req.headers.origin;
    if (originesOK.includes(origine)) {
      res.setHeader("access-control-allow-origin", origine);
    }
    if (req.method !== "OPTIONS") return next(); // requête normale : on continue

    // preflight : on répond tout de suite, sans passer aux routes
    res.writeHead(204, {
      "access-control-allow-methods": "GET,POST",
      "access-control-allow-headers": "content-type",
    });
    res.end();
  };
}

app.use(corsListe(["https://app.exemple.com", "https://admin.exemple.com"]));

Le point clé : sur un preflight, le middleware répond lui-même et n'appelle pas next().

La lib cors en prod

javascript
const cors = require("cors");
app.use(cors({
  origin: ["https://app.exemple.com", "https://admin.exemple.com"],
  credentials: true,
}));

Plus complète (whitelist multiple, regex, credentials, expose-headers, etc.).

⚠️ Le piège de *

javascript
res.setHeader("access-control-allow-origin", "*");

Autorise toutes les origines. C'est OK pour une API publique vraiment publique (genre données ouvertes), catastrophique pour une API qui requiert auth :

  • * est incompatible avec Allow-Credentials: true
  • N'importe quel site peut faire des requêtes en ton nom

Pour une API privée → liste blanche d'origines explicites.

Credentials (cookies, Authorization)

Par défaut le navigateur n'envoie pas les cookies cross-origin. Pour les inclure :

Côté front :

javascript
fetch("https://api...", { credentials: "include" });

Côté API :

Access-Control-Allow-Credentials: true
Access-Control-Allow-Origin: <origine spécifique, pas *>
Ton code

Connecte-toi pour faire cet exercice

C'est gratuit, avec ton compte Google : un clic, et tu reviens ici. Ta progression te suit ensuite sur tous tes appareils.

Le site garde ton nom et ton email, rien d'autre. Tes données