Skip to content

Commit 97f5fdf

Browse files
miss-islingtoniqra-codespicnixz
authored
[3.13] gh-136992: Add "None" as valid SameSite value as per RFC 6265bis (GH-137040) (#137141)
gh-136992: Add "None" as valid `SameSite` value as per RFC 6265bis (GH-137040) The "SameSite" attribute defined in RFC 6265bis [1] allows the "Strict", "Lax" and "None" enforcement modes. We already documented "Strict" and "Lax" as being valid values but "None" was missing from the list. While the RFC has not been formally approved, modern browsers support the "None" value [2, 3] thereby making sense to document it. [1]: https://datatracker.ietf.org/doc/html/draft-ietf-httpbis-rfc6265bis [2]: https://developers.google.com/search/blog/2020/01/get-ready-for-new-samesitenone-secure [3]: https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Set-Cookie#none --------- (cherry picked from commit ae8b7d7) Co-authored-by: Iqra Khan <[email protected]> Co-authored-by: Bénédikt Tran <[email protected]>
1 parent f867711 commit 97f5fdf

File tree

1 file changed

+6
-3
lines changed

1 file changed

+6
-3
lines changed

Doc/library/http.cookies.rst

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -147,9 +147,12 @@ Morsel Objects
147147
in HTTP requests, and is not accessible through JavaScript. This is intended
148148
to mitigate some forms of cross-site scripting.
149149

150-
The attribute :attr:`samesite` specifies that the browser is not allowed to
151-
send the cookie along with cross-site requests. This helps to mitigate CSRF
152-
attacks. Valid values for this attribute are "Strict" and "Lax".
150+
The attribute :attr:`samesite` controls when the browser sends the cookie with
151+
cross-site requests. This helps to mitigate CSRF attacks. Valid values are
152+
"Strict" (only sent with same-site requests), "Lax" (sent with same-site
153+
requests and top-level navigations), and "None" (sent with same-site and
154+
cross-site requests). When using "None", the "secure" attribute must also
155+
be set, as required by modern browsers.
153156

154157
The keys are case-insensitive and their default value is ``''``.
155158

0 commit comments

Comments
 (0)