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
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
- 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.
- 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.
- 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.
- 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.
- 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 fictive | Vérification concrète | Dé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.
| Champ | Information à consigner |
|---|---|
| Réponse | Publique ou personnalisée ; dimensions |
| Couche | Cache, propriétaire et clé |
| Politique | Conservation, fraîcheur et revalidation |
| Essai | Compte 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écanisme | Utilité | Point de vigilance |
|---|---|---|
| no-cache | Autoriser stockage avec validation requise | Ne pas le lire comme absence de stockage |
| private non qualifié | Exclure le cache partagé | Ne pas le lire comme une garantie de confidentialité |
| no-store | Empêcher la conservation HTTP concernée | Vérifier séparément caches applicatifs et historiques |
Indicateurs de pilotage
| Indicateur | Ce qu’il mesure | Première action |
|---|---|---|
| Séparation entre comptes | Absence de marqueur d’un autre compte | Inspecter corps, liens et métadonnées |
| Âge et revalidation | Réemploi conforme à la politique | Tester expiration et origine indisponible |
| Délai d’invalidation | Temps jusqu’à représentation corrigée | Nommer 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.
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.
| Tag courant | Tag reçu | Comparaison forte | Comparaison faible |
|---|---|---|---|
| "v1" | "v1" | Correspond | Correspond |
| "v1" | W/"v1" | Ne correspond pas | Correspond |
| W/"v1" | W/"v1" | Ne correspond pas | Correspond |
| "v1" | "v2" | Ne correspond pas | Ne correspond pas |
| "v1" | "V1" | Ne correspond pas | Ne 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 : 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-cacheExtraits 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
| Situation fictive | Condition et résultat attendu | Interprétation |
|---|---|---|
| Lecture avec un tag faible | GET · "v1"Accès autorisé · Champ conditionnel facultatif | W/"v1" et "v1" correspondent en comparaison faible. |
| Version du client différente | GET · "v1"Accès autorisé · Champ conditionnel facultatif | Le client doit recevoir la représentation sélectionnée. |
| Revalidation avec HEAD | HEAD · "v1"Accès autorisé · Champ conditionnel facultatif | Le statut peut être 304 ; la réponse reste sans contenu. |
| Écriture sur une ancienne version | PUT · "v2"Accès autorisé · Champ conditionnel facultatif | Relire et résoudre le conflit avant de réessayer. |
| Tag faible pour If-Match | PUT · "v1"Accès autorisé · Champ conditionnel facultatif | La comparaison forte refuse un tag faible. |
| PUT sans condition exigée | PUT · "v1"Accès autorisé · Champ conditionnel requis | 428 relève de la politique annoncée par cette API. |
| Accès refusé malgré le tag | GET · "v1"Accès refusé · Champ conditionnel facultatif | L’autorisation précède les conditions HTTP. |
| Écriture sur la bonne version | PUT · "v1"Accès autorisé · Champ conditionnel requis | Le modèle accepte PUT et sélectionne un succès 204. |
| If-None-Match: * sur l’existant | PUT · "v1"Accès autorisé · Champ conditionnel facultatif | L’astérisque correspond à toute représentation existante. |
| If-Match: * sur l’existant | PUT · W/"v1"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
| Champ de réponse | Effet HTTP dans ce périmètre | Vérification à conserver |
|---|---|---|
| Cache-Control: no-cache | Sans 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-store | Interdit 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: private | Sans 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. |
| Vary | Ajoute 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.
- IETF · RFC 9110 — HTTP Semantics · June 2022 · STD 97
§8.8.3.2; §13.1.1–13.1.2; §13.2; §15.3.5; §15.4.5 - IETF · RFC 9111 — HTTP Caching · June 2022 · STD 98
§4.1; §4.3; §5.2.2.4–5.2.2.5; §5.2.2.7 - IETF · RFC 6585 — Additional HTTP Status Codes · April 2012 · Standards Track
§3 · 428 Precondition Required
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.
