Manual:SameSite cookies/en

SameSite is a recent addition to the syntax of HTTP cookies. If a cookie is marked as  or , the browser will not send it with cross-domain requests. (The difference between the two is in the interpretation of "cross-domain": for Lax, it only covers "hidden" requests such as AJAX or iframes, while for Strict, top-level user navigation such as clicking on a link going to another domain is also included.) Browsers are planning to default cookies with no SameSite specification to Lax; as of 2020 autumn, Chrome is the only one actually doing it. Sites running over multiple domains that are not prepared for this change might experience various issues, such as authentication failures. (Sites running on a single domain will not be affected.)

As of 1.34, MediaWiki supports setting the SameSite flag on cookies. The default for authentication-related cookies is determined by the setting. Setting this to  (and enabling, as use of secure HTTPS cookies is required by browsers for SameSite=None) can fix issues such as MediaWiki seeing the user as not logged in when using cross-domain features. Setting the flag on non-authentication cookies is the responsibility of the code handling the cookie; this can only be decided individually, and in most cases it is not needed.

Browser compatibility
An older version of the standard defined SameSite as a boolean flag; older versions of browsers which implement this interpret  as. To work around this, MediaWiki can set a second, fallback cookie which is compatible with old browsers but not new ones. This behavior is enabled by setting to.

Browser warnings
Browsers can show various warnings on cookies which do not have the SameSite flag, e.g. Firefox tends to show errors like this in the developer console: Cookie “&lt;name>” will be soon rejected because it has the “sameSite” attribute set to “none” or an invalid value, without the “secure” attribute. This is a confusing and poorly worded message; what it is supposed to mean is that the cookie will soon be treated as  and thus not sent with cross-domain AJAX requests. For most non-authentication cookies this is not a problem and the warning can be ignored.

It might be worth to explicitly set  to get rid of the warning, though.

Using SameSite cookies in MediaWiki
In PHP, to set the SameSite flag on a cookie, use  with   or similar. To take  compatibility cookie into account when reading cookies, use   instead of.

In Javascript, use the  property of the options object passed to   to set the SameSite flag on a cookie.

Debugging and bug reports

 * https://samesite-sandbox.glitch.me/ can be used to check a browser's standard compliance. With the new default-to-Lax SameSite behavior, it should be all green.
 * Set specific SameSite handling behavior for testing:
 * Chrome:  and   flags (see also their debugging tutorial)
 * Firefox:  and   configuration keys