#include "net/cookies/cookie_base.h"
#include "base/containers/contains.h"
#include "base/feature_list.h"
#include "base/logging.h"
#include "base/strings/strcat.h"
#include "base/types/pass_key.h"
#include "net/base/features.h"
#include "net/cookies/cookie_access_params.h"
#include "net/cookies/cookie_constants.h"
#include "net/cookies/cookie_inclusion_status.h"
#include "net/cookies/cookie_util.h"
#include "net/cookies/ref_unique_cookie_key.h"
#include "net/cookies/unique_cookie_key.h"
#include "url/gurl.h"
namespace net {
namespace {
bool IsBreakingStrictToLaxDowngrade(
CookieOptions::SameSiteCookieContext::ContextType context,
CookieOptions::SameSiteCookieContext::ContextType schemeful_context,
CookieEffectiveSameSite effective_same_site,
bool is_cookie_being_set) {
if (context ==
CookieOptions::SameSiteCookieContext::ContextType::SAME_SITE_STRICT &&
schemeful_context ==
CookieOptions::SameSiteCookieContext::ContextType::SAME_SITE_LAX &&
effective_same_site == CookieEffectiveSameSite::STRICT_MODE) {
return !is_cookie_being_set;
}
return false;
}
bool IsBreakingStrictToCrossDowngrade(
CookieOptions::SameSiteCookieContext::ContextType context,
CookieOptions::SameSiteCookieContext::ContextType schemeful_context,
CookieEffectiveSameSite effective_same_site) {
bool breaking_schemeful_context =
schemeful_context ==
CookieOptions::SameSiteCookieContext::ContextType::CROSS_SITE ||
schemeful_context == CookieOptions::SameSiteCookieContext::ContextType::
SAME_SITE_LAX_METHOD_UNSAFE;
bool strict_lax_enforcement =
effective_same_site == CookieEffectiveSameSite::STRICT_MODE ||
effective_same_site == CookieEffectiveSameSite::LAX_MODE ||
effective_same_site == CookieEffectiveSameSite::LAX_MODE_ALLOW_UNSAFE;
if (context ==
CookieOptions::SameSiteCookieContext::ContextType::SAME_SITE_STRICT &&
breaking_schemeful_context && strict_lax_enforcement) {
return true;
}
return false;
}
bool IsBreakingLaxToCrossDowngrade(
CookieOptions::SameSiteCookieContext::ContextType context,
CookieOptions::SameSiteCookieContext::ContextType schemeful_context,
CookieEffectiveSameSite effective_same_site,
bool is_cookie_being_set) {
bool lax_enforcement =
effective_same_site == CookieEffectiveSameSite::LAX_MODE ||
effective_same_site == CookieEffectiveSameSite::LAX_MODE_ALLOW_UNSAFE;
if (context ==
CookieOptions::SameSiteCookieContext::ContextType::SAME_SITE_LAX &&
schemeful_context ==
CookieOptions::SameSiteCookieContext::ContextType::CROSS_SITE) {
return effective_same_site == CookieEffectiveSameSite::STRICT_MODE
? is_cookie_being_set
: lax_enforcement;
}
return false;
}
void ApplySameSiteCookieWarningToStatus(
CookieSameSite samesite,
CookieEffectiveSameSite effective_samesite,
bool is_secure,
const CookieOptions::SameSiteCookieContext& same_site_context,
CookieInclusionStatus* status,
bool is_cookie_being_set) {
if (samesite == CookieSameSite::UNSPECIFIED &&
same_site_context.GetContextForCookieInclusion() <
CookieOptions::SameSiteCookieContext::ContextType::SAME_SITE_LAX) {
status->AddWarningReason(CookieInclusionStatus::WarningReason::
WARN_SAMESITE_UNSPECIFIED_CROSS_SITE_CONTEXT);
}
if (effective_samesite == CookieEffectiveSameSite::LAX_MODE_ALLOW_UNSAFE &&
same_site_context.GetContextForCookieInclusion() ==
CookieOptions::SameSiteCookieContext::ContextType::
SAME_SITE_LAX_METHOD_UNSAFE) {
status->RemoveWarningReason(
CookieInclusionStatus::WarningReason::
WARN_SAMESITE_UNSPECIFIED_CROSS_SITE_CONTEXT);
status->AddWarningReason(CookieInclusionStatus::WarningReason::
WARN_SAMESITE_UNSPECIFIED_LAX_ALLOW_UNSAFE);
}
if (samesite == CookieSameSite::NO_RESTRICTION && !is_secure) {
status->AddWarningReason(
CookieInclusionStatus::WarningReason::WARN_SAMESITE_NONE_INSECURE);
}
if (IsBreakingStrictToLaxDowngrade(same_site_context.context(),
same_site_context.schemeful_context(),
effective_samesite, is_cookie_being_set)) {
status->AddWarningReason(CookieInclusionStatus::WarningReason::
WARN_STRICT_LAX_DOWNGRADE_STRICT_SAMESITE);
} else if (IsBreakingStrictToCrossDowngrade(
same_site_context.context(),
same_site_context.schemeful_context(), effective_samesite)) {
if (effective_samesite == CookieEffectiveSameSite::STRICT_MODE) {
status->AddWarningReason(CookieInclusionStatus::WarningReason::
WARN_STRICT_CROSS_DOWNGRADE_STRICT_SAMESITE);
} else {
status->AddWarningReason(CookieInclusionStatus::WarningReason::
WARN_STRICT_CROSS_DOWNGRADE_LAX_SAMESITE);
}
} else if (IsBreakingLaxToCrossDowngrade(
same_site_context.context(),
same_site_context.schemeful_context(), effective_samesite,
is_cookie_being_set)) {
if (effective_samesite == CookieEffectiveSameSite::STRICT_MODE) {
status->AddWarningReason(CookieInclusionStatus::WarningReason::
WARN_LAX_CROSS_DOWNGRADE_STRICT_SAMESITE);
} else {
status->AddWarningReason(CookieInclusionStatus::WarningReason::
WARN_LAX_CROSS_DOWNGRADE_LAX_SAMESITE);
}
}
using ContextDowngradeType = CookieOptions::SameSiteCookieContext::
ContextMetadata::ContextDowngradeType;
const auto& metadata = same_site_context.GetMetadataForCurrentSchemefulMode();
bool apply_cross_site_redirect_downgrade_warning = false;
switch (effective_samesite) {
case CookieEffectiveSameSite::STRICT_MODE:
apply_cross_site_redirect_downgrade_warning =
is_cookie_being_set ? metadata.cross_site_redirect_downgrade ==
ContextDowngradeType::kLaxToCross
: (metadata.cross_site_redirect_downgrade ==
ContextDowngradeType::kStrictToLax ||
metadata.cross_site_redirect_downgrade ==
ContextDowngradeType::kStrictToCross);
break;
case CookieEffectiveSameSite::LAX_MODE:
case CookieEffectiveSameSite::LAX_MODE_ALLOW_UNSAFE:
apply_cross_site_redirect_downgrade_warning =
metadata.cross_site_redirect_downgrade ==
(is_cookie_being_set ? ContextDowngradeType::kLaxToCross
: ContextDowngradeType::kStrictToCross);
break;
default:
break;
}
if (apply_cross_site_redirect_downgrade_warning) {
status->AddWarningReason(
CookieInclusionStatus::WarningReason::
WARN_CROSS_SITE_REDIRECT_DOWNGRADE_CHANGES_INCLUSION);
}
status->MaybeClearSameSiteWarning();
}
}
CookieAccessResult CookieBase::IncludeForRequestURL(
const GURL& url,
const CookieOptions& options,
const CookieAccessParams& params) const {
CookieInclusionStatus status;
if (options.exclude_httponly() && IsHttpOnly()) {
status.AddExclusionReason(
CookieInclusionStatus::ExclusionReason::EXCLUDE_HTTP_ONLY);
}
bool is_allowed_to_access_secure_cookies = false;
CookieAccessScheme cookie_access_scheme =
cookie_util::ProvisionalAccessScheme(url);
if (cookie_access_scheme == CookieAccessScheme::kNonCryptographic &&
params.delegate_treats_url_as_trustworthy) {
cookie_access_scheme = CookieAccessScheme::kTrustworthy;
}
switch (cookie_access_scheme) {
case CookieAccessScheme::kNonCryptographic:
if (SecureAttribute()) {
status.AddExclusionReason(
CookieInclusionStatus::ExclusionReason::EXCLUDE_SECURE_ONLY);
}
break;
case CookieAccessScheme::kTrustworthy:
is_allowed_to_access_secure_cookies = true;
if (SecureAttribute() ||
(cookie_util::IsSchemeBoundCookiesEnabled() &&
source_scheme_ == CookieSourceScheme::kSecure &&
params.scope_semantics != net::CookieScopeSemantics::LEGACY)) {
status.AddWarningReason(
CookieInclusionStatus::WarningReason::
WARN_SECURE_ACCESS_GRANTED_NON_CRYPTOGRAPHIC);
}
break;
case CookieAccessScheme::kCryptographic:
is_allowed_to_access_secure_cookies = true;
break;
}
if (source_scheme_ == CookieSourceScheme::kSecure &&
cookie_access_scheme == CookieAccessScheme::kNonCryptographic &&
!status.HasExclusionReason(
CookieInclusionStatus::ExclusionReason::EXCLUDE_SECURE_ONLY)) {
if (cookie_util::IsSchemeBoundCookiesEnabled() &&
params.scope_semantics != net::CookieScopeSemantics::LEGACY) {
status.AddExclusionReason(
CookieInclusionStatus::ExclusionReason::EXCLUDE_SCHEME_MISMATCH);
} else {
status.AddWarningReason(
CookieInclusionStatus::WarningReason::WARN_SCHEME_MISMATCH);
}
}
else if (source_scheme_ == CookieSourceScheme::kNonSecure &&
cookie_access_scheme == CookieAccessScheme::kCryptographic) {
if (cookie_util::IsSchemeBoundCookiesEnabled() &&
params.scope_semantics != net::CookieScopeSemantics::LEGACY) {
status.AddExclusionReason(
CookieInclusionStatus::ExclusionReason::EXCLUDE_SCHEME_MISMATCH);
} else {
status.AddWarningReason(
CookieInclusionStatus::WarningReason::WARN_SCHEME_MISMATCH);
}
}
int url_port = url.EffectiveIntPort();
CHECK(url_port != url::PORT_INVALID);
bool port_matches = url_port == source_port_ ||
source_port_ == url::PORT_UNSPECIFIED || IsDomainCookie();
bool trustworthy_and_443 =
cookie_access_scheme == CookieAccessScheme::kTrustworthy &&
source_port_ == 443;
if (!port_matches && !trustworthy_and_443) {
if (cookie_util::IsPortBoundCookiesEnabled() &&
params.scope_semantics != net::CookieScopeSemantics::LEGACY) {
status.AddExclusionReason(
CookieInclusionStatus::ExclusionReason::EXCLUDE_PORT_MISMATCH);
} else {
status.AddWarningReason(
CookieInclusionStatus::WarningReason::WARN_PORT_MISMATCH);
}
}
if (!IsDomainMatch(url.host())) {
status.AddExclusionReason(
CookieInclusionStatus::ExclusionReason::EXCLUDE_DOMAIN_MISMATCH);
}
if (!IsOnPath(url.path())) {
status.AddExclusionReason(
CookieInclusionStatus::ExclusionReason::EXCLUDE_NOT_ON_PATH);
}
const CookieOptions::SameSiteCookieContext::ContextType
cookie_inclusion_context =
params.access_semantics == CookieAccessSemantics::LEGACY
? options.same_site_cookie_context().context()
: options.same_site_cookie_context()
.GetContextForCookieInclusion();
CookieEffectiveSameSite effective_same_site =
GetEffectiveSameSite(params.access_semantics);
DCHECK(effective_same_site != CookieEffectiveSameSite::UNDEFINED);
switch (effective_same_site) {
case CookieEffectiveSameSite::STRICT_MODE:
if (cookie_inclusion_context <
CookieOptions::SameSiteCookieContext::ContextType::SAME_SITE_STRICT) {
status.AddExclusionReason(
CookieInclusionStatus::ExclusionReason::EXCLUDE_SAMESITE_STRICT);
}
break;
case CookieEffectiveSameSite::LAX_MODE:
if (cookie_inclusion_context <
CookieOptions::SameSiteCookieContext::ContextType::SAME_SITE_LAX) {
status.AddExclusionReason(
(SameSite() == CookieSameSite::UNSPECIFIED)
? CookieInclusionStatus::ExclusionReason::
EXCLUDE_SAMESITE_UNSPECIFIED_TREATED_AS_LAX
: CookieInclusionStatus::ExclusionReason::EXCLUDE_SAMESITE_LAX);
}
break;
case CookieEffectiveSameSite::LAX_MODE_ALLOW_UNSAFE:
DCHECK(SameSite() == CookieSameSite::UNSPECIFIED);
if (cookie_inclusion_context <
CookieOptions::SameSiteCookieContext::ContextType::
SAME_SITE_LAX_METHOD_UNSAFE) {
status.AddExclusionReason(
CookieInclusionStatus::ExclusionReason::
EXCLUDE_SAMESITE_UNSPECIFIED_TREATED_AS_LAX);
}
break;
default:
break;
}
if (params.access_semantics != CookieAccessSemantics::LEGACY &&
SameSite() == CookieSameSite::NO_RESTRICTION && !SecureAttribute()) {
status.AddExclusionReason(
CookieInclusionStatus::ExclusionReason::EXCLUDE_SAMESITE_NONE_INSECURE);
}
ApplySameSiteCookieWarningToStatus(SameSite(), effective_same_site,
SecureAttribute(),
options.same_site_cookie_context(),
&status, false );
CookieAccessResult result{effective_same_site, status,
params.access_semantics, params.scope_semantics,
is_allowed_to_access_secure_cookies};
PostIncludeForRequestURL(result, options, cookie_inclusion_context);
return result;
}
CookieAccessResult CookieBase::IsSetPermittedInContext(
const GURL& source_url,
const CookieOptions& options,
const CookieAccessParams& params,
const std::vector<std::string>& cookieable_schemes,
const std::optional<CookieAccessResult>& cookie_access_result) const {
CookieAccessResult access_result;
if (cookie_access_result) {
access_result = *cookie_access_result;
}
if (!base::Contains(cookieable_schemes, source_url.scheme())) {
access_result.status.AddExclusionReason(
CookieInclusionStatus::ExclusionReason::EXCLUDE_NONCOOKIEABLE_SCHEME);
}
if (!IsDomainMatch(source_url.host())) {
access_result.status.AddExclusionReason(
CookieInclusionStatus::ExclusionReason::EXCLUDE_DOMAIN_MISMATCH);
}
CookieAccessScheme access_scheme =
cookie_util::ProvisionalAccessScheme(source_url);
if (access_scheme == CookieAccessScheme::kNonCryptographic &&
params.delegate_treats_url_as_trustworthy) {
access_scheme = CookieAccessScheme::kTrustworthy;
}
switch (access_scheme) {
case CookieAccessScheme::kNonCryptographic:
access_result.is_allowed_to_access_secure_cookies = false;
if (SecureAttribute()) {
access_result.status.AddExclusionReason(
CookieInclusionStatus::ExclusionReason::EXCLUDE_SECURE_ONLY);
}
break;
case CookieAccessScheme::kCryptographic:
access_result.is_allowed_to_access_secure_cookies = true;
break;
case CookieAccessScheme::kTrustworthy:
access_result.is_allowed_to_access_secure_cookies = true;
if (SecureAttribute()) {
access_result.status.AddWarningReason(
CookieInclusionStatus::WarningReason::
WARN_SECURE_ACCESS_GRANTED_NON_CRYPTOGRAPHIC);
}
break;
}
access_result.access_semantics = params.access_semantics;
if (options.exclude_httponly() && IsHttpOnly()) {
DVLOG(net::cookie_util::kVlogSetCookies)
<< "HttpOnly cookie not permitted in script context.";
access_result.status.AddExclusionReason(
CookieInclusionStatus::ExclusionReason::EXCLUDE_HTTP_ONLY);
}
if (params.access_semantics != CookieAccessSemantics::LEGACY &&
SameSite() == CookieSameSite::NO_RESTRICTION && !SecureAttribute()) {
DVLOG(net::cookie_util::kVlogSetCookies)
<< "SetCookie() rejecting insecure cookie with SameSite=None.";
access_result.status.AddExclusionReason(
CookieInclusionStatus::ExclusionReason::EXCLUDE_SAMESITE_NONE_INSECURE);
}
CookieOptions::SameSiteCookieContext::ContextType cookie_inclusion_context =
params.access_semantics == CookieAccessSemantics::LEGACY
? options.same_site_cookie_context().context()
: options.same_site_cookie_context().GetContextForCookieInclusion();
access_result.effective_same_site =
GetEffectiveSameSite(params.access_semantics);
DCHECK(access_result.effective_same_site !=
CookieEffectiveSameSite::UNDEFINED);
switch (access_result.effective_same_site) {
case CookieEffectiveSameSite::STRICT_MODE:
if (cookie_inclusion_context <
CookieOptions::SameSiteCookieContext::ContextType::SAME_SITE_LAX) {
DVLOG(net::cookie_util::kVlogSetCookies)
<< "Trying to set a `SameSite=Strict` cookie from a "
"cross-site URL.";
access_result.status.AddExclusionReason(
CookieInclusionStatus::ExclusionReason::EXCLUDE_SAMESITE_STRICT);
}
break;
case CookieEffectiveSameSite::LAX_MODE:
case CookieEffectiveSameSite::LAX_MODE_ALLOW_UNSAFE:
if (cookie_inclusion_context <
CookieOptions::SameSiteCookieContext::ContextType::SAME_SITE_LAX) {
if (SameSite() == CookieSameSite::UNSPECIFIED) {
DVLOG(net::cookie_util::kVlogSetCookies)
<< "Cookies with no known SameSite attribute being treated as "
"lax; attempt to set from a cross-site URL denied.";
access_result.status.AddExclusionReason(
CookieInclusionStatus::ExclusionReason::
EXCLUDE_SAMESITE_UNSPECIFIED_TREATED_AS_LAX);
} else {
DVLOG(net::cookie_util::kVlogSetCookies)
<< "Trying to set a `SameSite=Lax` cookie from a cross-site URL.";
access_result.status.AddExclusionReason(
CookieInclusionStatus::ExclusionReason::EXCLUDE_SAMESITE_LAX);
}
}
break;
default:
break;
}
ApplySameSiteCookieWarningToStatus(
SameSite(), access_result.effective_same_site, SecureAttribute(),
options.same_site_cookie_context(), &access_result.status,
true );
PostIsSetPermittedInContext(access_result, options);
return access_result;
}
bool CookieBase::IsOnPath(const std::string_view url_path) const {
return cookie_util::IsOnPath(path_, url_path);
}
bool CookieBase::IsDomainMatch(const std::string_view host) const {
return cookie_util::IsDomainMatch(domain_, host);
}
bool CookieBase::IsSecure() const {
return SecureAttribute() || (cookie_util::IsSchemeBoundCookiesEnabled() &&
source_scheme_ == CookieSourceScheme::kSecure);
}
bool CookieBase::IsFirstPartyPartitioned() const {
return IsPartitioned() && !CookiePartitionKey::HasNonce(partition_key_) &&
partition_key_->site().IsSameSiteWith(GURL(
base::StrCat({url::kHttpsScheme, url::kStandardSchemeSeparator,
DomainWithoutDot()})));
}
bool CookieBase::IsThirdPartyPartitioned() const {
return IsPartitioned() && !IsFirstPartyPartitioned();
}
std::string CookieBase::DomainWithoutDot() const {
return cookie_util::CookieDomainAsHost(domain_);
}
UniqueCookieKey CookieBase::StrictlyUniqueKey() const {
return UniqueCookieKey::Strict(base::PassKey<CookieBase>(), partition_key_,
name_, domain_, path_, source_scheme_,
source_port_);
}
UniqueCookieKey CookieBase::UniqueKey() const {
std::optional<CookieSourceScheme> source_scheme =
cookie_util::IsSchemeBoundCookiesEnabled()
? std::make_optional(source_scheme_)
: std::nullopt;
if (IsDomainCookie()) {
return UniqueCookieKey::Domain(base::PassKey<CookieBase>(), partition_key_,
name_, domain_, path_, source_scheme);
}
std::optional<int> source_port = cookie_util::IsPortBoundCookiesEnabled()
? std::make_optional(source_port_)
: std::nullopt;
return UniqueCookieKey::Host(base::PassKey<CookieBase>(), partition_key_,
name_, domain_, path_, source_scheme,
source_port);
}
RefUniqueCookieKey CookieBase::RefUniqueKey() const {
std::optional<CookieSourceScheme> source_scheme =
cookie_util::IsSchemeBoundCookiesEnabled()
? std::make_optional(source_scheme_)
: std::nullopt;
if (IsDomainCookie()) {
return RefUniqueCookieKey::Domain(base::PassKey<CookieBase>(),
partition_key_, name_, domain_, path_,
source_scheme);
}
std::optional<int> source_port = cookie_util::IsPortBoundCookiesEnabled()
? std::make_optional(source_port_)
: std::nullopt;
return RefUniqueCookieKey::Host(base::PassKey<CookieBase>(), partition_key_,
name_, domain_, path_, source_scheme,
source_port);
}
UniqueCookieKey CookieBase::LegacyUniqueKey() const {
return UniqueCookieKey::Legacy(base::PassKey<CookieBase>(), partition_key_,
name_, domain_, path_);
}
void CookieBase::SetSourcePort(int port) {
source_port_ = ValidateAndAdjustSourcePort(port);
}
CookieBase::CookieBase() = default;
CookieBase::CookieBase(const CookieBase& other) = default;
CookieBase::CookieBase(CookieBase&& other) = default;
CookieBase& CookieBase::operator=(const CookieBase& other) = default;
CookieBase& CookieBase::operator=(CookieBase&& other) = default;
CookieBase::~CookieBase() = default;
CookieBase::CookieBase(std::string name,
std::string domain,
std::string path,
base::Time creation,
bool secure,
bool httponly,
CookieSameSite same_site,
std::optional<CookiePartitionKey> partition_key,
CookieSourceScheme source_scheme,
int source_port)
: name_(std::move(name)),
domain_(std::move(domain)),
path_(std::move(path)),
creation_date_(creation),
secure_(secure),
httponly_(httponly),
same_site_(same_site),
partition_key_(std::move(partition_key)),
source_scheme_(source_scheme),
source_port_(source_port) {}
CookieEffectiveSameSite CookieBase::GetEffectiveSameSite(
CookieAccessSemantics access_semantics) const {
base::TimeDelta lax_allow_unsafe_threshold_age =
GetLaxAllowUnsafeThresholdAge();
switch (SameSite()) {
case CookieSameSite::UNSPECIFIED:
return (access_semantics == CookieAccessSemantics::LEGACY)
? CookieEffectiveSameSite::NO_RESTRICTION
: (IsRecentlyCreated(lax_allow_unsafe_threshold_age)
? CookieEffectiveSameSite::LAX_MODE_ALLOW_UNSAFE
: CookieEffectiveSameSite::LAX_MODE);
case CookieSameSite::NO_RESTRICTION:
return CookieEffectiveSameSite::NO_RESTRICTION;
case CookieSameSite::LAX_MODE:
return CookieEffectiveSameSite::LAX_MODE;
case CookieSameSite::STRICT_MODE:
return CookieEffectiveSameSite::STRICT_MODE;
}
}
base::TimeDelta CookieBase::GetLaxAllowUnsafeThresholdAge() const {
return base::TimeDelta::Min();
}
bool CookieBase::IsRecentlyCreated(base::TimeDelta age_threshold) const {
return (base::Time::Now() - creation_date_) <= age_threshold;
}
int CookieBase::ValidateAndAdjustSourcePort(int port) {
if ((port >= 0 && port <= 65535) || port == url::PORT_UNSPECIFIED) {
return port;
}
return url::PORT_INVALID;
}
}