Ressources · 63

Cache HTTP : protéger les réponses personnalisées

Distinguer cache partagé, cache privé et cache applicatif, contrôler les clés, la revalidation et l’invalidation après un changement de droits.

· 8 min

Allée sécurisée de serveurs et de réseaux, sans personnel Illustration éditoriale générée par IA

Ce que ce guide permet

  • Inventorier les couches
  • Choisir la conservation
  • Examiner la clé
  • Exercer revalidation et changement

Contrôle express

  • no-cache signifie-t-il ne rien conserver ?
  • Vary protège-t-il les droits d’accès ?
  • Faut-il toujours cacher une API ?

Méthode pas à pas

  1. 01

    Inventorier les couches

    Listez navigateur, CDN, proxy, service worker et cache applicatif. Classez les réponses publiques et personnalisées. Une politique HTTP ne décrit pas automatiquement le comportement d’un cache géré dans le code.

    Livrable : diagramme des couches et propriétaires.

  2. 02

    Choisir la conservation

    RFC 9111 distingue les directives : no-cache impose une validation avant réemploi, no-store interdit la conservation HTTP concernée et private non qualifié exclut le stockage partagé. Aucune de ces directives ne garantit seule la confidentialité du système.

    Livrable : politique de conservation par réponse.

  3. 03

    Examiner la clé

    Vérifiez méthode, URI et dimensions qui changent la représentation. Vary concerne des champs de requête ; ce mécanisme n’est pas une autorisation. Recherchez langues, négociation de format et contexte de compte oubliés dans les couches applicatives.

    Livrable : clés et tests de séparation.

  4. 04

    Exercer revalidation et changement

    Testez réponse fraîche, périmée, modification de donnée et retrait de droit. Examinez ETag, validation conditionnelle et comportement si l’origine est indisponible. Une ancienne réponse correcte peut devenir sensible après révocation.

    Livrable : traces avant et après changement.

  5. 05

    Rejouer avec deux comptes

    Utilisez des identités et marqueurs fictifs. Alternez les demandes sur la même URI, avec caches chauds et froids. Vérifiez aussi déconnexion, liens directs et journalisation, sans consigner de jetons réels.

    Livrable : tests négatifs et stratégie d’invalidation.

Quatre situations pour éprouver la méthode

Cas pédagogiques fictifs. Chaque situation relie un signal à une vérification et à une décision limitée par les preuves ; aucun résultat client n’est représenté.

Situation fictiveVérification concrèteDécision et limite
Ne pas partager un résultat d’analyse entre contextes privés — Une réponse d’analyse vocale est réutilisée pour une autre session parce que la clé de cache ne distingue pas le contexte autorisé.Avec des données fictives, croiser deux comptes et tester clés, permissions, durée de conservation et purge. Examiner aussi les réponses d’erreur et les journaux.Empêcher la réutilisation hors contexte et limiter les données conservées. Une réponse techniquement cacheable n’est pas forcément appropriée à un cache partagé.
Le cache doit distinguer les représentations JSON — Deux versions d’une route renvoient des schémas différents ; le client reçoit une réponse mise en cache pour une autre version.Tester la sélection de version et les dimensions qui déterminent la représentation, puis comparer les clés du cache et les validations du client.Séparer les représentations et traiter explicitement les incompatibilités. Une réponse JSON analysable peut rester incompatible avec le contrat attendu.
Vérifier les mêmes règles de cache dans chaque client — Les clients Python, PHP et JavaScript traitent différemment un validateur et un contenu déjà conservé ; leurs résultats divergent après mise à jour.Rejouer la même séquence de requêtes et de réponses avec leurs en-têtes. Vérifier quand le client réutilise, revalide ou remplace son contenu local.Documenter le comportement commun attendu plutôt que supposer qu’une bibliothèque applique la politique souhaitée. Examiner aussi les caches intermédiaires.
Mesurer aussi la fraîcheur d’un cache distribué — Deux lectures sont rapides, mais l’une affiche encore une ancienne disponibilité après une modification de la source.Comparer valeur, version, point de lecture et délai après modification. Tester invalidation, expiration et accès direct à la source selon le contrat du système.Fixer la fraîcheur acceptable par usage et surveiller les divergences. Un gain de latence ne démontre pas la cohérence des données servies.

Fiche de travail à réutiliser

À compléter avec vos observations autorisées. Ces champs constituent une trame de travail, pas des résultats observés.

ChampInformation à consigner
RéponsePublique ou personnalisée ; dimensions
CoucheCache, propriétaire et clé
PolitiqueConservation, fraîcheur et revalidation
EssaiCompte fictif, changement et observé

Exemple d’application

Situation illustrative

Exemple fictif : un CDN réutilise une réponse de profil sur la même URI pour deux comptes de test.

Décision et preuve attendue

Le scénario détecte la fuite, examine la politique et les clés, puis rejoue après correction et retrait de droit.

Distinguer les mécanismes

MécanismeUtilitéPoint de vigilance
no-cacheAutoriser stockage avec validation requiseNe pas le lire comme absence de stockage
private non qualifiéExclure le cache partagéNe pas le lire comme une garantie de confidentialité
no-storeEmpêcher la conservation HTTP concernéeVérifier séparément caches applicatifs et historiques

Indicateurs de pilotage

IndicateurCe qu’il mesurePremière action
Séparation entre comptesAbsence de marqueur d’un autre compteInspecter corps, liens et métadonnées
Âge et revalidationRéemploi conforme à la politiqueTester expiration et origine indisponible
Délai d’invalidationTemps jusqu’à représentation corrigéeNommer chaque couche encore périmée

Erreurs fréquentes

  • Ne pas le lire comme absence de stockage
  • Ne pas le lire comme une garantie de confidentialité
  • Vérifier séparément caches applicatifs et historiques

Questions fréquentes

no-cache signifie-t-il ne rien conserver ?

Non. La directive demande une validation avant réutilisation ; elle n’interdit pas le stockage comme no-store.

Vary protège-t-il les droits d’accès ?

Non. Il participe à la sélection de représentation ; l’autorisation reste une décision distincte.

Faut-il toujours cacher une API ?

Non. Le bénéfice dépend du coût, de la fraîcheur et du risque. Une réponse sensible peut justifier l’absence de cache partagé.

ETag, cache HTTP et modifications concurrentes

ETag : revalider une réponse et éviter les écrasements

Un ETag est un validateur opaque de la représentation sélectionnée. Il sert à comparer des versions ; il ne constitue ni une autorisation, ni un jeton d’accès, ni nécessairement le hash d’un fichier. Pour une réponse personnalisée, il faut traiter séparément les droits, la clé de cache et la condition HTTP.

Modèle pédagogique local : une représentation existe déjà, un seul champ conditionnel est présent et sa valeur est un seul ETag ou *. Il couvre GET, HEAD et PUT. Les listes de tags, dates, plages, créations, conditions combinées et l’exception d’une modification déjà réussie sont exclues. Aucun appel réseau, stockage ou changement d’état : ce modèle ne vérifie pas votre API.

Laboratoire réseau fictif sans personne, passerelles sur un établi sombre éclairé en ambre. Illustration éditoriale générée par IA
Scène conceptuelle générée : laboratoire réseau fictif, sans personne. Elle ne montre ni une installation réelle ni une mesure du protocole.

Comparer un ETag : fort et faible ne répondent pas au même besoin

If-Match impose une comparaison forte : aucun des deux tags ne doit commencer par W/. If-None-Match utilise une comparaison faible, en comparant les valeurs opaques sans tenir compte de W/. Ces valeurs restent sensibles à la casse. Le joker * teste ici l’existence de la représentation, pas une version précise.

Comparer un ETag : fort et faible ne répondent pas au même besoin
Tag courantTag reçuComparaison forteComparaison faible
"v1""v1"CorrespondCorrespond
"v1"W/"v1"Ne correspond pasCorrespond
W/"v1"W/"v1"Ne correspond pasCorrespond
"v1""v2"Ne correspond pasNe correspond pas
"v1""V1"Ne correspond pasNe correspond pas

Simuler une décision HTTP, sans interroger de serveur

Les six paramètres donnent 432 combinaisons. La politique « champ conditionnel requis » et les succès PUT en 204 sont des choix de ce scénario fictif. Exiger n’importe quelle condition n’empêche pas tous les écrasements : If-Match: * ne compare aucune version.

Décision du modèle : 304

304 : If-None-Match trouve une correspondance faible pour GET ou HEAD. Réutiliser la représentation stockée selon les règles du cache, avec les métadonnées de revalidation.

304 et 204 : aucune donnée de contenu dans la réponse.

Extrait de requête

GET /demo/resource HTTP/1.1
Host: api.example.test
If-None-Match: W/"v1"

Extrait de réponse

HTTP/1.1 304 Not Modified
Date: Thu, 22 Oct 2026 00:00:00 GMT
ETag: "v1"
Cache-Control: private, no-cache

Extraits HTTP/1.1 fictifs à lire : les corps sont omis, même lorsqu’ils seraient possibles. api.example.test est un domaine d’exemple. La date est fixe. Le modèle ne modifie pas l’ETag après PUT ; le parcours ci-dessous montre séparément une succession de versions.

Dix situations à reproduire

Dix situations à reproduire
Situation fictiveCondition et résultat attenduInterprétation
Lecture avec un tag faibleGET · "v1"
If-None-Match: W/"v1" → 304

Accès autorisé · Champ conditionnel facultatif

W/"v1" et "v1" correspondent en comparaison faible.
Version du client différenteGET · "v1"
If-None-Match: "v2" → 200

Accès autorisé · Champ conditionnel facultatif

Le client doit recevoir la représentation sélectionnée.
Revalidation avec HEADHEAD · "v1"
If-None-Match: "v1" → 304

Accès autorisé · Champ conditionnel facultatif

Le statut peut être 304 ; la réponse reste sans contenu.
Écriture sur une ancienne versionPUT · "v2"
If-Match: "v1" → 412

Accès autorisé · Champ conditionnel facultatif

Relire et résoudre le conflit avant de réessayer.
Tag faible pour If-MatchPUT · "v1"
If-Match: W/"v1" → 412

Accès autorisé · Champ conditionnel facultatif

La comparaison forte refuse un tag faible.
PUT sans condition exigéePUT · "v1"
none → 428

Accès autorisé · Champ conditionnel requis

428 relève de la politique annoncée par cette API.
Accès refusé malgré le tagGET · "v1"
If-None-Match: "v1" → 403

Accès refusé · Champ conditionnel facultatif

L’autorisation précède les conditions HTTP.
Écriture sur la bonne versionPUT · "v1"
If-Match: "v1" → 204

Accès autorisé · Champ conditionnel requis

Le modèle accepte PUT et sélectionne un succès 204.
If-None-Match: * sur l’existantPUT · "v1"
If-None-Match: * → 412

Accès autorisé · Champ conditionnel facultatif

L’astérisque correspond à toute représentation existante.
If-Match: * sur l’existantPUT · W/"v1"
If-Match: * → 204

Accès autorisé · Champ conditionnel requis

Le joker passe même avec un tag courant faible : il ne protège pas une version.

Quatre règles pour une réponse personnalisée

Quatre règles pour une réponse personnalisée
Champ de réponseEffet HTTP dans ce périmètreVérification à conserver
Cache-Control: no-cacheSans qualification de champs, le stockage est possible, mais toute réutilisation exige une validation réussie auprès du serveur d’origine.Observer un aller-retour conditionnel ; ne pas interpréter no-cache comme une interdiction de stockage.
Cache-Control: no-storeInterdit le stockage par les caches HTTP privés et partagés. Ce n’est pas une garantie générale de confidentialité.Examiner aussi les journaux, l’historique, les captures et les stockages applicatifs.
Cache-Control: privateSans qualification de champs, interdit le stockage par un cache partagé ; un cache privé peut stocker sous les autres contraintes.Distinguer le navigateur, le proxy et le CDN. Une directive ne remplace pas le contrôle d’accès.
VaryAjoute les champs de requête cités à la sélection d’une réponse stockée. Ne décide pas si une personne a accès à une ressource.Tester les variantes pertinentes. Ne pas supposer qu’un cookie ou Authorization bloque automatiquement toute mise en cache.

Pièces utiles dans une recette API

  • Requête et statut attendus : méthode, ressource de test, droits, champ conditionnel et ETag courant. Utiliser des données fictives et expurger les secrets.
  • Réponse observée : statut, ETag, Date, Cache-Control, Vary et absence de contenu pour HEAD, 204 ou 304. Un 304 doit porter les métadonnées requises qui auraient accompagné le 200.
  • Concurrence : vérifier qu’une écriture périmée échoue sans modifier la ressource, puis conserver la décision de résolution du conflit. Ne pas remplacer aveuglément l’ETag et renvoyer la même écriture.

Suivre le conflit entre deux clients →

Références primaires et limites

Les normes décrivent les conditions HTTP et le cache. Les dix cas, le laboratoire et le parcours à deux clients sont des illustrations originales. Les résultats affichés sont calculés par ce modèle local, pas des mesures du site ni de votre infrastructure.

Références relues le

Références officielles

Date de consultation des références : . La méthode et la fiche de travail proposent des contrôles à adapter à votre contexte ; elles ne constituent pas une certification.