Présentation des cookies SameSite

Navigateurs pris en charge

  • Chrome : 51.
  • Edge : 16.
  • Firefox : 60.
  • Safari : 13.

Source

Chaque cookie contient une paire clé-valeur ainsi qu'un certain nombre d'attributs qui contrôlent quand et où ce cookie est utilisé.

L'introduction de l'attribut SameSite (défini dans le RFC6265bis) vous permet d'indiquer si votre cookie est limité à un contexte propriétaire ou au même site. Il est utile de comprendre exactement ce que signifie "site" dans ce contexte. Le site correspond à la combinaison du suffixe de domaine et de la partie du domaine juste avant celui-ci. Par exemple, le domaine www.web.dev fait partie du site web.dev.

Terme clé: Si l'utilisateur se trouve sur www.web.dev et demande une image à static.web.dev, il s'agit d'une requête SameSite.

La liste des suffixes publics définit les pages considérées comme étant sur le même site. Il ne dépend pas uniquement des domaines de premier niveau tels que .com, mais peut également inclure des services tels que github.io. Cela permet de comptabiliser your-project.github.io et my-project.github.io comme des sites distincts.

Terme clé: si l'utilisateur se trouve sur your-project.github.io et demande une image de my-project.github.io, il s'agit d'une requête intersite.

Utilisez l'attribut SameSite pour déclarer l'utilisation des cookies.

L'attribut SameSite d'un cookie propose trois façons différentes de contrôler ce comportement. Vous pouvez choisir de ne pas spécifier l'attribut, ou d'utiliser Strict ou Lax pour limiter le cookie aux requêtes du même site.

Si vous définissez SameSite sur Strict, votre cookie ne peut être envoyé que dans un contexte propriétaire, c'est-à-dire si le site du cookie correspond au site affiché dans la barre d'adresse du navigateur. Par conséquent, si le cookie promo_shown est défini comme suit :

Set-Cookie: promo_shown=1; SameSite=Strict

Lorsque l'utilisateur se trouve sur votre site, le cookie est envoyé avec la requête comme prévu. Toutefois, si l'utilisateur suit un lien vers votre site à partir d'un autre, le cookie n'est pas envoyé lors de cette requête initiale. Cette option est adaptée aux cookies liés à des fonctionnalités qui sont toujours derrière une navigation initiale, comme changer de mot de passe ou effectuer un achat, mais elle est trop restrictive pour un cookie comme promo_shown. Si votre lecteur suit le lien vers le site, il souhaite que le cookie soit envoyé afin que ses préférences puissent être appliquées.

SameSite=Lax permet au navigateur d'envoyer le cookie avec ces navigations de premier niveau. Par exemple, si un autre site fait référence au contenu de votre site, utilisez votre photo de chat et fournissez un lien vers votre article comme suit:

<p>Look at this amazing cat!</p>
<img src="https://blog.example/blog/img/amazing-cat.png" />
<p>Read the <a href="https://blog.example/blog/cat.html">article</a>.</p>

Avec un cookie défini sur Lax comme suit :

Set-Cookie: promo_shown=1; SameSite=Lax

Lorsque le navigateur demande amazing-cat.png pour le blog de l'autre personne, votre site n'envoie pas le cookie. Toutefois, lorsque le lecteur suit le lien vers cat.html sur votre site, cette requête inclut le cookie.

Nous vous recommandons d'utiliser SameSite de cette manière, en définissant les cookies qui affectent l'affichage du site Web sur Lax et les cookies liés aux actions des utilisateurs sur Strict.

Vous pouvez également définir SameSite sur None pour indiquer que vous souhaitez que le cookie soit envoyé dans tous les contextes. Si vous fournissez un service que d'autres sites consomment, comme des widgets, du contenu intégré, des programmes d'affiliation, de la publicité ou la connexion sur plusieurs sites, utilisez None pour vous assurer que votre intent est clair.

Trois cookies libellés &quot;Aucun&quot;, &quot;Laisse-passer&quot; ou &quot;Strict&quot; en fonction de leur contexte
Marquez explicitement le contexte d'un cookie comme None, Lax ou Strict.

Modifications apportées au comportement par défaut sans SameSite

Navigateurs pris en charge

  • Chrome : 80.
  • Edge : 86.
  • Firefox : derrière un indicateur.
  • Safari: non compatible.

L'attribut SameSite est largement accepté, mais il n'a pas été largement adopté. Auparavant, la définition de cookies sans SameSite par défaut les envoyait dans tous les contextes, ce qui rendait les utilisateurs vulnérables au CSRF et aux fuites d'informations involontaires. Pour encourager les développeurs à indiquer leur intention et à offrir aux utilisateurs une expérience plus sécurisée, la proposition de l'IETF, Cookies de meilleure qualité de manière incrémentielle, présente deux changements clés :

  • Les cookies sans attribut SameSite sont traités comme SameSite=Lax.
  • Les cookies avec SameSite=None doivent également spécifier Secure, ce qui signifie qu'ils nécessitent un contexte sécurisé.

Ces deux modifications sont rétrocompatibles avec les navigateurs qui ont correctement implémenté la version précédente de l'attribut SameSite, ainsi que les navigateurs qui ne sont pas compatibles avec les versions SameSite antérieures. Ils visent à réduire la dépendance des développeurs vis-à-vis du comportement par défaut des navigateurs en rendant explicite le comportement et l'utilisation prévue des cookies. Les clients qui ne reconnaissent pas SameSite=None doivent l'ignorer.

SameSite=Lax par défaut

Si vous envoyez un cookie sans spécifier son attribut SameSite, le navigateur le traite comme s'il était défini sur SameSite=Lax. Nous vous recommandons toutefois de définir explicitement SameSite=Lax pour améliorer la cohérence de l'expérience utilisateur sur tous les navigateurs.

SameSite=None doit être sécurisé

Lorsque vous créez des cookies intersites à l'aide de SameSite=None, vous devez également les définir sur Secure pour que le navigateur les accepte:

Set-Cookie: widget_session=abc123; SameSite=None; Secure

Vous pouvez tester ce comportement à partir de Chrome 76 en activant about://flags/#cookies-without-same-site-must-be-secure, et à partir de Firefox 69 en définissant network.cookie.sameSite.noneRequiresSecure dans about:config.

Nous vous recommandons également de mettre à jour les cookies existants vers Secure dès que possible. Si vous avez recours à des services qui fournissent du contenu tiers sur votre site, assurez-vous que votre fournisseur de services met à jour ses cookies et modifiez les extraits ou les dépendances de votre site pour vous assurer qu'il utilise le nouveau comportement.

Pour en savoir plus sur la mise à jour de vos cookies afin de gérer correctement ces modifications apportées à SameSite=None et les différences de comportement du navigateur, consultez l'article de suivi Recettes de cookies SameSite.

Merci à Lily Chen, Malte Ubl, Mike West, Rob Dodson, Tom Steiner et Vivek Sekhar pour leurs contributions et leurs commentaires.

Image principale de cookies par Pille-Riin Priske sur Unsplash