-
-
Notifications
You must be signed in to change notification settings - Fork 32.5k
gh-136992: Add 'None' as valid SameSite value as per RFC6265bis #137040
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The change looks good to me, but please run pre-commit to fix the failing lint job.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM.
For future reference, you don't need to force push; we squash at the end.
Thanks for the heads-up! I’ll avoid force-pushing next time. |
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
Now, don't touch your branch at all. No need to update it either. |
Thanks @iqra-codes for the PR, and @picnixz for merging it 🌮🎉.. I'm working now to backport this PR to: 3.13, 3.14. |
…bis (pythonGH-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 <iqraakhan2519@gmail.com> Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
Thank you for the contribution! |
…bis (pythonGH-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 <iqraakhan2519@gmail.com> Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
GH-137140 is a backport of this pull request to the 3.14 branch. |
GH-137141 is a backport of this pull request to the 3.13 branch. |
…5bis (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 <iqraakhan2519@gmail.com> Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
This PR adds missing documentation for the samesite attribute in the http.cookies module.
While the attribute was already listed among valid Morsel attributes, it lacked an explanation. This change adds clear and complete documentation explaining:
-The attribute’s role in CSRF protection.
-The valid values: "Strict", "Lax", and "None".
-The requirement that "secure" must be set when using "SameSite=None".
This update brings the documentation in line with RFC6265bis and reflects current browser behaviour.
📚 Documentation preview 📚: https://cpython-previews--137040.org.readthedocs.build/
http.cookies
should mention thatsamesite=None
is valid as per RFC6265bis #136992