Undertow 2.3.12.Final · io.undertow.util.SameSiteNoneIncompatibleClientChecker

A utility class that can check known user agents which are known to be incompatible with SameSite=None attribute.

Versions of Chrome from Chrome 51 to Chrome 66 (inclusive on both ends). These Chrome versions will reject a cookie with `SameSite=None`. This also affects older versions of Chromium-derived browsers, as well as Android WebView. This behavior was correct according to the version of the cookie specification at that time, but with the addition of the new "None" value to the specification, this behavior has been updated in Chrome 67 and newer. (Prior to Chrome 51, the SameSite attribute was ignored entirely and all cookies were treated as if they were `SameSite=None`.)
Versions of UC Browser on Android prior to version 12.13.2. Older versions will reject a cookie with `SameSite=None`. This behavior was correct according to the version of the cookie specification at that time, but with the addition of the new "None" value to the specification, this behavior has been updated in newer versions of UC Browser.
Versions of Safari and embedded browsers on MacOS 10.14 and all browsers on iOS 12. These versions will erroneously treat cookies marked with `SameSite=None` as if they were marked `SameSite=Strict`. This bug has been fixed on newer versions of iOS and MacOS.

Field Summary

Modifier and Type	Field and Description
private static final Pattern	CHROMIUM_PATTERN
private static final Pattern	CHROMIUM_VERSION_PATTERN
private static final Pattern	IOS_PATTERN User Agents Regex Patterns
private static final Pattern	MAC_EMBEDDED_BROWSER_PATTERN
private static final Pattern	MACOSX_PATTERN
private static final Pattern	SAFARI_PATTERN
private static final Pattern	UC_BROWSER_VERSION_PATTERN

Access	Constructor and Description
public	SameSiteNoneIncompatibleClientChecker()

Modifier and Type	Method and Description
private static boolean	dropsUnrecognizedSameSiteCookies(String useragent)
private static boolean	hasWebKitSameSiteBug(String useragent)
private static boolean	isChromiumBased(String useragent)
private static boolean	isChromiumVersionAtLeast(int major, String useragent)
private static boolean	isIosVersion(int major, String useragent)
private static boolean	isMacEmbeddedBrowser(String useragent)
private static boolean	isMacosxVersion(int major, int minor, String useragent)
private static boolean	isSafari(String useragent)
public static boolean	isSameSiteNoneIncompatible(String useragent)
pack-priv static boolean	isUcBrowser(String useragent)
private static boolean	isUcBrowserVersionAtLeast(int major, int minor, int build, String useragent)
public static boolean	shouldSendSameSiteNone(String useragent)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

CHROMIUM_PATTERN	back to summary
private static final Pattern CHROMIUM_PATTERN

CHROMIUM_VERSION_PATTERN	back to summary
private static final Pattern CHROMIUM_VERSION_PATTERN

IOS_PATTERN	back to summary
private static final Pattern IOS_PATTERN User Agents Regex Patterns

MAC_EMBEDDED_BROWSER_PATTERN	back to summary
private static final Pattern MAC_EMBEDDED_BROWSER_PATTERN

MACOSX_PATTERN	back to summary
private static final Pattern MACOSX_PATTERN

SAFARI_PATTERN	back to summary
private static final Pattern SAFARI_PATTERN

UC_BROWSER_VERSION_PATTERN	back to summary
private static final Pattern UC_BROWSER_VERSION_PATTERN

SameSiteNoneIncompatibleClientChecker	back to summary
public SameSiteNoneIncompatibleClientChecker()

dropsUnrecognizedSameSiteCookies	back to summary
private static boolean dropsUnrecognizedSameSiteCookies(String useragent)

hasWebKitSameSiteBug	back to summary
private static boolean hasWebKitSameSiteBug(String useragent)

isChromiumBased	back to summary
private static boolean isChromiumBased(String useragent)

isChromiumVersionAtLeast	back to summary
private static boolean isChromiumVersionAtLeast(int major, String useragent)

isIosVersion	back to summary
private static boolean isIosVersion(int major, String useragent)

isMacEmbeddedBrowser	back to summary
private static boolean isMacEmbeddedBrowser(String useragent)

isMacosxVersion	back to summary
private static boolean isMacosxVersion(int major, int minor, String useragent)

isSafari	back to summary
private static boolean isSafari(String useragent)

isSameSiteNoneIncompatible	back to summary
public static boolean isSameSiteNoneIncompatible(String useragent)

isUcBrowser	back to summary
pack-priv static boolean isUcBrowser(String useragent)

isUcBrowserVersionAtLeast	back to summary
private static boolean isUcBrowserVersionAtLeast(int major, int minor, int build, String useragent)

shouldSendSameSiteNone	back to summary
public static boolean shouldSendSameSiteNone(String useragent)