/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ /* vim: set sw=2 ts=8 et tw=80 : */ /* This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ #ifndef mozilla_net_HttpBaseChannel_h #define mozilla_net_HttpBaseChannel_h #include #include "OpaqueResponseUtils.h" #include "mozilla/AtomicBitfields.h" #include "mozilla/Atomics.h" #include "mozilla/dom/DOMTypes.h" #include "mozilla/DataMutex.h" #include "mozilla/net/DNS.h" #include "mozilla/net/NeckoChannelParams.h" #include "mozilla/net/NeckoCommon.h" #include "mozilla/net/PrivateBrowsingChannel.h" #include "nsCOMPtr.h" #include "nsHashPropertyBag.h" #include "nsHttp.h" #include "nsHttpHandler.h" #include "nsHttpRequestHead.h" #include "nsIClassOfService.h" #include "nsIClassifiedChannel.h" #include "nsIConsoleReportCollector.h" #include "nsIEncodedChannel.h" #include "nsIForcePendingChannel.h" #include "nsIFormPOSTActionChannel.h" #include "nsIHttpChannel.h" #include "nsIHttpChannelInternal.h" #include "nsILoadInfo.h" #include "nsIResumableChannel.h" #include "nsIStringEnumerator.h" #include "nsISupportsPriority.h" #include "nsIThrottledInputChannel.h" #include "nsITimedChannel.h" #include "nsITraceableChannel.h" #include "nsITransportSecurityInfo.h" #include "nsIURI.h" #include "nsIUploadChannel2.h" #include "nsStringEnumerator.h" #include "nsStringFwd.h" #include "nsTArray.h" #include "nsThreadUtils.h" #define HTTP_BASE_CHANNEL_IID \ { \ 0x9d5cde03, 0xe6e9, 0x4612, { \ 0xbf, 0xef, 0xbb, 0x66, 0xf3, 0xbb, 0x74, 0x46 \ } \ } class nsIProgressEventSink; class nsISecurityConsoleMessage; class nsIPrincipal; namespace mozilla { namespace dom { class PerformanceStorage; class ContentParent; } // namespace dom class LogCollector; namespace net { extern mozilla::LazyLogModule gHttpLog; class OpaqueResponseBlocker; class PreferredAlternativeDataTypeParams; enum CacheDisposition : uint8_t { kCacheUnresolved = 0, kCacheHit = 1, kCacheHitViaReval = 2, kCacheMissedViaReval = 3, kCacheMissed = 4, kCacheUnknown = 5 }; // These need to be kept in sync with // "browser.opaqueResponseBlocking.filterFetchResponse" enum class OpaqueResponseFilterFetch { Never, AllowedByORB, BlockedByORB, All }; /* * This class is a partial implementation of nsIHttpChannel. It contains code * shared by nsHttpChannel and HttpChannelChild. * - Note that this class has nothing to do with nsBaseChannel, which is an * earlier effort at a base class for channels that somehow never made it all * the way to the HTTP channel. */ class HttpBaseChannel : public nsHashPropertyBag, public nsIEncodedChannel, public nsIHttpChannel, public nsIHttpChannelInternal, public nsIFormPOSTActionChannel, public nsIUploadChannel2, public nsISupportsPriority, public nsIClassOfService, public nsIResumableChannel, public nsITraceableChannel, public PrivateBrowsingChannel, public nsITimedChannel, public nsIForcePendingChannel, public nsIConsoleReportCollector, public nsIThrottledInputChannel, public nsIClassifiedChannel { protected: virtual ~HttpBaseChannel(); public: NS_DECL_ISUPPORTS_INHERITED NS_DECL_NSIUPLOADCHANNEL NS_DECL_NSIFORMPOSTACTIONCHANNEL NS_DECL_NSIUPLOADCHANNEL2 NS_DECL_NSITRACEABLECHANNEL NS_DECL_NSITIMEDCHANNEL NS_DECL_NSITHROTTLEDINPUTCHANNEL NS_DECL_NSICLASSIFIEDCHANNEL NS_DECLARE_STATIC_IID_ACCESSOR(HTTP_BASE_CHANNEL_IID) HttpBaseChannel(); [[nodiscard]] virtual nsresult Init(nsIURI* aURI, uint32_t aCaps, nsProxyInfo* aProxyInfo, uint32_t aProxyResolveFlags, nsIURI* aProxyURI, uint64_t aChannelId, ExtContentPolicyType aContentPolicyType, nsILoadInfo* aLoadInfo); // nsIRequest NS_IMETHOD GetName(nsACString& aName) override; NS_IMETHOD IsPending(bool* aIsPending) override; NS_IMETHOD GetStatus(nsresult* aStatus) override; NS_IMETHOD GetLoadGroup(nsILoadGroup** aLoadGroup) override; NS_IMETHOD SetLoadGroup(nsILoadGroup* aLoadGroup) override; NS_IMETHOD GetLoadFlags(nsLoadFlags* aLoadFlags) override; NS_IMETHOD SetLoadFlags(nsLoadFlags aLoadFlags) override; NS_IMETHOD GetTRRMode(nsIRequest::TRRMode* aTRRMode) override; NS_IMETHOD SetTRRMode(nsIRequest::TRRMode aTRRMode) override; NS_IMETHOD SetDocshellUserAgentOverride(); // nsIChannel NS_IMETHOD GetOriginalURI(nsIURI** aOriginalURI) override; NS_IMETHOD SetOriginalURI(nsIURI* aOriginalURI) override; NS_IMETHOD GetURI(nsIURI** aURI) override; NS_IMETHOD GetOwner(nsISupports** aOwner) override; NS_IMETHOD SetOwner(nsISupports* aOwner) override; NS_IMETHOD GetLoadInfo(nsILoadInfo** aLoadInfo) override; NS_IMETHOD SetLoadInfo(nsILoadInfo* aLoadInfo) override; NS_IMETHOD GetIsDocument(bool* aIsDocument) override; NS_IMETHOD GetNotificationCallbacks( nsIInterfaceRequestor** aCallbacks) override; NS_IMETHOD SetNotificationCallbacks( nsIInterfaceRequestor* aCallbacks) override; NS_IMETHOD GetContentType(nsACString& aContentType) override; NS_IMETHOD SetContentType(const nsACString& aContentType) override; NS_IMETHOD GetContentCharset(nsACString& aContentCharset) override; NS_IMETHOD SetContentCharset(const nsACString& aContentCharset) override; NS_IMETHOD GetContentDisposition(uint32_t* aContentDisposition) override; NS_IMETHOD SetContentDisposition(uint32_t aContentDisposition) override; NS_IMETHOD GetContentDispositionFilename( nsAString& aContentDispositionFilename) override; NS_IMETHOD SetContentDispositionFilename( const nsAString& aContentDispositionFilename) override; NS_IMETHOD GetContentDispositionHeader( nsACString& aContentDispositionHeader) override; NS_IMETHOD GetContentLength(int64_t* aContentLength) override; NS_IMETHOD SetContentLength(int64_t aContentLength) override; NS_IMETHOD Open(nsIInputStream** aResult) override; NS_IMETHOD GetBlockAuthPrompt(bool* aValue) override; NS_IMETHOD SetBlockAuthPrompt(bool aValue) override; NS_IMETHOD GetCanceled(bool* aCanceled) override; // nsIEncodedChannel NS_IMETHOD GetApplyConversion(bool* value) override; NS_IMETHOD SetApplyConversion(bool value) override; NS_IMETHOD GetContentEncodings(nsIUTF8StringEnumerator** aEncodings) override; NS_IMETHOD DoApplyContentConversions(nsIStreamListener* aNextListener, nsIStreamListener** aNewNextListener, nsISupports* aCtxt) override; NS_IMETHOD SetHasContentDecompressed(bool value) override; NS_IMETHOD GetHasContentDecompressed(bool* value) override; // HttpBaseChannel::nsIHttpChannel NS_IMETHOD GetRequestMethod(nsACString& aMethod) override; NS_IMETHOD SetRequestMethod(const nsACString& aMethod) override; NS_IMETHOD GetReferrerInfo(nsIReferrerInfo** aReferrerInfo) override; NS_IMETHOD SetReferrerInfo(nsIReferrerInfo* aReferrerInfo) override; NS_IMETHOD SetReferrerInfoWithoutClone( nsIReferrerInfo* aReferrerInfo) override; NS_IMETHOD GetRequestHeader(const nsACString& aHeader, nsACString& aValue) override; NS_IMETHOD SetRequestHeader(const nsACString& aHeader, const nsACString& aValue, bool aMerge) override; NS_IMETHOD SetNewReferrerInfo(const nsACString& aUrl, nsIReferrerInfo::ReferrerPolicyIDL aPolicy, bool aSendReferrer) override; NS_IMETHOD SetEmptyRequestHeader(const nsACString& aHeader) override; NS_IMETHOD VisitRequestHeaders(nsIHttpHeaderVisitor* visitor) override; NS_IMETHOD VisitNonDefaultRequestHeaders( nsIHttpHeaderVisitor* visitor) override; NS_IMETHOD ShouldStripRequestBodyHeader(const nsACString& aMethod, bool* aResult) override; NS_IMETHOD GetResponseHeader(const nsACString& header, nsACString& value) override; NS_IMETHOD SetResponseHeader(const nsACString& header, const nsACString& value, bool merge) override; NS_IMETHOD VisitResponseHeaders(nsIHttpHeaderVisitor* visitor) override; NS_IMETHOD GetOriginalResponseHeader(const nsACString& aHeader, nsIHttpHeaderVisitor* aVisitor) override; NS_IMETHOD VisitOriginalResponseHeaders( nsIHttpHeaderVisitor* aVisitor) override; NS_IMETHOD GetAllowSTS(bool* value) override; NS_IMETHOD SetAllowSTS(bool value) override; NS_IMETHOD GetRedirectionLimit(uint32_t* value) override; NS_IMETHOD SetRedirectionLimit(uint32_t value) override; NS_IMETHOD IsNoStoreResponse(bool* value) override; NS_IMETHOD IsNoCacheResponse(bool* value) override; NS_IMETHOD IsPrivateResponse(bool* value) override; NS_IMETHOD GetResponseStatus(uint32_t* aValue) override; NS_IMETHOD GetResponseStatusText(nsACString& aValue) override; NS_IMETHOD GetRequestSucceeded(bool* aValue) override; NS_IMETHOD RedirectTo(nsIURI* newURI) override; NS_IMETHOD UpgradeToSecure() override; NS_IMETHOD GetRequestContextID(uint64_t* aRCID) override; NS_IMETHOD GetTransferSize(uint64_t* aTransferSize) override; NS_IMETHOD GetRequestSize(uint64_t* aRequestSize) override; NS_IMETHOD GetDecodedBodySize(uint64_t* aDecodedBodySize) override; NS_IMETHOD GetEncodedBodySize(uint64_t* aEncodedBodySize) override; NS_IMETHOD GetSupportsHTTP3(bool* aSupportsHTTP3) override; NS_IMETHOD GetHasHTTPSRR(bool* aHasHTTPSRR) override; NS_IMETHOD SetRequestContextID(uint64_t aRCID) override; NS_IMETHOD GetIsMainDocumentChannel(bool* aValue) override; NS_IMETHOD SetIsMainDocumentChannel(bool aValue) override; NS_IMETHOD GetProtocolVersion(nsACString& aProtocolVersion) override; NS_IMETHOD GetChannelId(uint64_t* aChannelId) override; NS_IMETHOD SetChannelId(uint64_t aChannelId) override; NS_IMETHOD GetTopLevelContentWindowId(uint64_t* aContentWindowId) override; NS_IMETHOD SetTopLevelContentWindowId(uint64_t aContentWindowId) override; NS_IMETHOD GetBrowserId(uint64_t* aId) override; NS_IMETHOD SetBrowserId(uint64_t aId) override; NS_IMETHOD GetIsProxyUsed(bool* aIsProxyUsed) override; using nsIClassifiedChannel::IsThirdPartyTrackingResource; virtual void SetSource(UniquePtr aSource) override { mSource = std::move(aSource); } // nsIHttpChannelInternal NS_IMETHOD GetDocumentURI(nsIURI** aDocumentURI) override; NS_IMETHOD SetDocumentURI(nsIURI* aDocumentURI) override; NS_IMETHOD GetRequestVersion(uint32_t* major, uint32_t* minor) override; NS_IMETHOD GetResponseVersion(uint32_t* major, uint32_t* minor) override; NS_IMETHOD SetCookie(const nsACString& aCookieHeader) override; NS_IMETHOD GetThirdPartyFlags(uint32_t* aForce) override; NS_IMETHOD SetThirdPartyFlags(uint32_t aForce) override; NS_IMETHOD GetForceAllowThirdPartyCookie(bool* aForce) override; NS_IMETHOD SetForceAllowThirdPartyCookie(bool aForce) override; NS_IMETHOD GetChannelIsForDownload(bool* aChannelIsForDownload) override; NS_IMETHOD SetChannelIsForDownload(bool aChannelIsForDownload) override; NS_IMETHOD SetCacheKeysRedirectChain(nsTArray* cacheKeys) override; NS_IMETHOD GetLocalAddress(nsACString& addr) override; NS_IMETHOD GetLocalPort(int32_t* port) override; NS_IMETHOD GetRemoteAddress(nsACString& addr) override; NS_IMETHOD GetRemotePort(int32_t* port) override; NS_IMETHOD GetOnlyConnect(bool* aOnlyConnect) override; NS_IMETHOD SetConnectOnly() override; NS_IMETHOD GetAllowSpdy(bool* aAllowSpdy) override; NS_IMETHOD SetAllowSpdy(bool aAllowSpdy) override; NS_IMETHOD GetAllowHttp3(bool* aAllowHttp3) override; NS_IMETHOD SetAllowHttp3(bool aAllowHttp3) override; NS_IMETHOD GetAllowAltSvc(bool* aAllowAltSvc) override; NS_IMETHOD SetAllowAltSvc(bool aAllowAltSvc) override; NS_IMETHOD GetBeConservative(bool* aBeConservative) override; NS_IMETHOD SetBeConservative(bool aBeConservative) override; NS_IMETHOD GetBypassProxy(bool* aBypassProxy) override; NS_IMETHOD SetBypassProxy(bool aBypassProxy) override; bool BypassProxy(); NS_IMETHOD GetIsTRRServiceChannel(bool* aTRR) override; NS_IMETHOD SetIsTRRServiceChannel(bool aTRR) override; NS_IMETHOD GetIsResolvedByTRR(bool* aResolvedByTRR) override; NS_IMETHOD GetEffectiveTRRMode( nsIRequest::TRRMode* aEffectiveTRRMode) override; NS_IMETHOD GetTrrSkipReason(nsITRRSkipReason::value* aTrrSkipReason) override; NS_IMETHOD GetIsLoadedBySocketProcess(bool* aResult) override; NS_IMETHOD GetIsOCSP(bool* value) override; NS_IMETHOD SetIsOCSP(bool value) override; NS_IMETHOD GetTlsFlags(uint32_t* aTlsFlags) override; NS_IMETHOD SetTlsFlags(uint32_t aTlsFlags) override; NS_IMETHOD GetApiRedirectToURI(nsIURI** aApiRedirectToURI) override; [[nodiscard]] virtual nsresult AddSecurityMessage( const nsAString& aMessageTag, const nsAString& aMessageCategory); NS_IMETHOD TakeAllSecurityMessages( nsCOMArray& aMessages) override; NS_IMETHOD GetResponseTimeoutEnabled(bool* aEnable) override; NS_IMETHOD SetResponseTimeoutEnabled(bool aEnable) override; NS_IMETHOD GetInitialRwin(uint32_t* aRwin) override; NS_IMETHOD SetInitialRwin(uint32_t aRwin) override; NS_IMETHOD ForcePending(bool aForcePending) override; NS_IMETHOD GetLastModifiedTime(PRTime* lastModifiedTime) override; NS_IMETHOD GetCorsIncludeCredentials(bool* aInclude) override; NS_IMETHOD SetCorsIncludeCredentials(bool aInclude) override; NS_IMETHOD GetRequestMode(dom::RequestMode* aRequestMode) override; NS_IMETHOD SetRequestMode(dom::RequestMode aRequestMode) override; NS_IMETHOD GetRedirectMode(uint32_t* aRedirectMode) override; NS_IMETHOD SetRedirectMode(uint32_t aRedirectMode) override; NS_IMETHOD GetFetchCacheMode(uint32_t* aFetchCacheMode) override; NS_IMETHOD SetFetchCacheMode(uint32_t aFetchCacheMode) override; NS_IMETHOD GetTopWindowURI(nsIURI** aTopWindowURI) override; NS_IMETHOD SetTopWindowURIIfUnknown(nsIURI* aTopWindowURI) override; NS_IMETHOD GetProxyURI(nsIURI** proxyURI) override; virtual void SetCorsPreflightParameters( const nsTArray& unsafeHeaders, bool aShouldStripRequestBodyHeader, bool aShouldStripAuthHeader) override; virtual void SetAltDataForChild(bool aIsForChild) override; virtual void DisableAltDataCache() override { StoreDisableAltDataCache(true); }; NS_IMETHOD GetConnectionInfoHashKey( nsACString& aConnectionInfoHashKey) override; NS_IMETHOD GetIntegrityMetadata(nsAString& aIntegrityMetadata) override; NS_IMETHOD SetIntegrityMetadata(const nsAString& aIntegrityMetadata) override; NS_IMETHOD GetLastRedirectFlags(uint32_t* aValue) override; NS_IMETHOD SetLastRedirectFlags(uint32_t aValue) override; NS_IMETHOD GetNavigationStartTimeStamp(TimeStamp* aTimeStamp) override; NS_IMETHOD SetNavigationStartTimeStamp(TimeStamp aTimeStamp) override; NS_IMETHOD CancelByURLClassifier(nsresult aErrorCode) override; NS_IMETHOD SetIPv4Disabled(void) override; NS_IMETHOD SetIPv6Disabled(void) override; NS_IMETHOD GetCrossOriginOpenerPolicy( nsILoadInfo::CrossOriginOpenerPolicy* aCrossOriginOpenerPolicy) override; NS_IMETHOD ComputeCrossOriginOpenerPolicy( nsILoadInfo::CrossOriginOpenerPolicy aInitiatorPolicy, nsILoadInfo::CrossOriginOpenerPolicy* aOutPolicy) override; NS_IMETHOD HasCrossOriginOpenerPolicyMismatch(bool* aIsMismatch) override; NS_IMETHOD GetResponseEmbedderPolicy( bool aIsOriginTrialCoepCredentiallessEnabled, nsILoadInfo::CrossOriginEmbedderPolicy* aOutPolicy) override; inline void CleanRedirectCacheChainIfNecessary() { auto redirectedCachekeys = mRedirectedCachekeys.Lock(); redirectedCachekeys.ref() = nullptr; } NS_IMETHOD HTTPUpgrade(const nsACString& aProtocolName, nsIHttpUpgradeListener* aListener) override; void DoDiagnosticAssertWhenOnStopNotCalledOnDestroy() override; NS_IMETHOD SetWaitForHTTPSSVCRecord() override; NS_IMETHOD SetEarlyHintPreloaderId(uint64_t aEarlyHintPreloaderId) override; NS_IMETHOD GetEarlyHintPreloaderId(uint64_t* aEarlyHintPreloaderId) override; NS_IMETHOD SetEarlyHintLinkType(uint32_t aEarlyHintLinkType) override; NS_IMETHOD GetEarlyHintLinkType(uint32_t* aEarlyHintLinkType) override; NS_IMETHOD SetIsUserAgentHeaderModified(bool value) override; NS_IMETHOD GetIsUserAgentHeaderModified(bool* value) override; NS_IMETHOD SetClassicScriptHintCharset( const nsAString& aClassicScriptHintCharset) override; NS_IMETHOD GetClassicScriptHintCharset( nsAString& aClassicScriptHintCharset) override; NS_IMETHOD SetDocumentCharacterSet( const nsAString& aDocumentCharacterSet) override; NS_IMETHOD GetDocumentCharacterSet(nsAString& aDocumentCharacterSet) override; virtual void SetConnectionInfo( mozilla::net::nsHttpConnectionInfo* aCI) override; // nsISupportsPriority NS_IMETHOD GetPriority(int32_t* value) override; NS_IMETHOD AdjustPriority(int32_t delta) override; // nsIClassOfService NS_IMETHOD GetClassFlags(uint32_t* outFlags) override { *outFlags = mClassOfService.Flags(); return NS_OK; } NS_IMETHOD GetIncremental(bool* outIncremental) override { *outIncremental = mClassOfService.Incremental(); return NS_OK; } // nsIResumableChannel NS_IMETHOD GetEntityID(nsACString& aEntityID) override; // nsIConsoleReportCollector void AddConsoleReport(uint32_t aErrorFlags, const nsACString& aCategory, nsContentUtils::PropertiesFile aPropertiesFile, const nsACString& aSourceFileURI, uint32_t aLineNumber, uint32_t aColumnNumber, const nsACString& aMessageName, const nsTArray& aStringParams) override; void FlushReportsToConsole( uint64_t aInnerWindowID, ReportAction aAction = ReportAction::Forget) override; void FlushReportsToConsoleForServiceWorkerScope( const nsACString& aScope, ReportAction aAction = ReportAction::Forget) override; void FlushConsoleReports( dom::Document* aDocument, ReportAction aAction = ReportAction::Forget) override; void FlushConsoleReports( nsILoadGroup* aLoadGroup, ReportAction aAction = ReportAction::Forget) override; void FlushConsoleReports(nsIConsoleReportCollector* aCollector) override; void StealConsoleReports( nsTArray& aReports) override; void ClearConsoleReports() override; class nsContentEncodings : public nsStringEnumeratorBase { public: NS_DECL_ISUPPORTS NS_DECL_NSIUTF8STRINGENUMERATOR using nsStringEnumeratorBase::GetNext; nsContentEncodings(nsIHttpChannel* aChannel, const char* aEncodingHeader); private: virtual ~nsContentEncodings() = default; [[nodiscard]] nsresult PrepareForNext(void); // We do not own the buffer. The channel owns it. const char* mEncodingHeader; const char* mCurStart; // points to start of current header const char* mCurEnd; // points to end of current header // Hold a ref to our channel so that it can't go away and take the // header with it. nsCOMPtr mChannel; bool mReady; }; nsHttpResponseHead* GetResponseHead() const { return mResponseHead.get(); } nsHttpRequestHead* GetRequestHead() { return &mRequestHead; } nsHttpHeaderArray* GetResponseTrailers() const { return mResponseTrailers.get(); } void SetDummyChannelForImageCache(); const NetAddr& GetSelfAddr() { return mSelfAddr; } const NetAddr& GetPeerAddr() { return mPeerAddr; } [[nodiscard]] nsresult OverrideSecurityInfo( nsITransportSecurityInfo* aSecurityInfo); void LogORBError(const nsAString& aReason, const OpaqueResponseBlockedTelemetryReason aTelemetryReason); public: /* Necko internal use only... */ int64_t GetAltDataLength() { return mAltDataLength; } bool IsNavigation(); bool IsDeliveringAltData() const { return LoadDeliveringAltData(); } static void PropagateReferenceIfNeeded(nsIURI* aURI, nsCOMPtr& aRedirectURI); // Return whether upon a redirect code of httpStatus for method, the // request method should be rewritten to GET. static bool ShouldRewriteRedirectToGET( uint32_t httpStatus, nsHttpRequestHead::ParsedMethodType method); // Like nsIEncodedChannel::DoApplyConversions except context is set to // mListenerContext. [[nodiscard]] nsresult DoApplyContentConversions( nsIStreamListener* aNextListener, nsIStreamListener** aNewNextListener); void AddClassificationFlags(uint32_t aClassificationFlags, bool aIsThirdParty); const uint64_t& ChannelId() const { return mChannelId; } nsresult InternalSetUploadStream(nsIInputStream* uploadStream, int64_t aContentLength = -1, bool aSetContentLengthHeader = false); void SetUploadStreamHasHeaders(bool hasHeaders) { StoreUploadStreamHasHeaders(hasHeaders); } virtual nsresult SetReferrerHeader(const nsACString& aReferrer, bool aRespectBeforeConnect = true) { if (aRespectBeforeConnect) { ENSURE_CALLED_BEFORE_CONNECT(); } return mRequestHead.SetHeader(nsHttp::Referer, aReferrer); } nsresult ClearReferrerHeader() { ENSURE_CALLED_BEFORE_CONNECT(); return mRequestHead.ClearHeader(nsHttp::Referer); } void SetTopWindowURI(nsIURI* aTopWindowURI) { mTopWindowURI = aTopWindowURI; } // Set referrerInfo and compute the referrer header if neccessary. // Pass true for aSetOriginal if this is a new referrer and should // overwrite the 'original' value, false if this is a mutation (like // stripping the path). nsresult SetReferrerInfoInternal(nsIReferrerInfo* aReferrerInfo, bool aClone, bool aCompute, bool aRespectBeforeConnect); struct ReplacementChannelConfig { ReplacementChannelConfig() = default; explicit ReplacementChannelConfig( const dom::ReplacementChannelConfigInit& aInit); uint32_t redirectFlags = 0; ClassOfService classOfService = {0, false}; Maybe privateBrowsing = Nothing(); Maybe method; nsCOMPtr referrerInfo; Maybe timedChannelInfo; nsCOMPtr uploadStream; uint64_t uploadStreamLength = 0; bool uploadStreamHasHeaders = false; Maybe contentType; Maybe contentLength; dom::ReplacementChannelConfigInit Serialize(); }; enum class ReplacementReason { Redirect, InternalRedirect, DocumentChannel, }; // Create a ReplacementChannelConfig object that can be used to duplicate the // current channel. ReplacementChannelConfig CloneReplacementChannelConfig( bool aPreserveMethod, uint32_t aRedirectFlags, ReplacementReason aReason); static void ConfigureReplacementChannel(nsIChannel*, const ReplacementChannelConfig&, ReplacementReason); // Called before we create the redirect target channel. already_AddRefed CloneLoadInfoForRedirect( nsIURI* aNewURI, uint32_t aRedirectFlags); // True if we've already applied content conversion to the data // passed to mListener. bool HasAppliedConversion() { return LoadHasAppliedConversion(); } // https://fetch.spec.whatwg.org/#concept-request-tainted-origin bool HasRedirectTaintedOrigin() { return LoadTaintedOriginFlag(); } bool ChannelBlockedByOpaqueResponse() const { return mChannelBlockedByOpaqueResponse; } bool CachedOpaqueResponseBlockingPref() const { return mCachedOpaqueResponseBlockingPref; } TimeStamp GetOnStartRequestStartTime() const { return mOnStartRequestStartTime; } TimeStamp GetDataAvailableStartTime() const { return mOnDataAvailableStartTime; } TimeStamp GetOnStopRequestStartTime() const { return mOnStopRequestStartTime; } protected: nsresult GetTopWindowURI(nsIURI* aURIBeingLoaded, nsIURI** aTopWindowURI); // Handle notifying listener, removing from loadgroup if request failed. void DoNotifyListener(); virtual void DoNotifyListenerCleanup() = 0; // drop reference to listener, its callbacks, and the progress sink virtual void ReleaseListeners(); // Call AsyncAbort(). virtual void DoAsyncAbort(nsresult aStatus) = 0; // This is fired only when a cookie is created due to the presence of // Set-Cookie header in the response header of any network request. // This notification will come only after the "http-on-examine-response" // was fired. void NotifySetCookie(const nsACString& aCookie); void MaybeReportTimingData(); nsIURI* GetReferringPage(); nsPIDOMWindowInner* GetInnerDOMWindow(); void AddCookiesToRequest(); [[nodiscard]] virtual nsresult SetupReplacementChannel( nsIURI*, nsIChannel*, bool preserveMethod, uint32_t redirectFlags); bool IsNewChannelSameOrigin(nsIChannel* aNewChannel); // WHATWG Fetch Standard 4.4. HTTP-redirect fetch, step 10 virtual bool ShouldTaintReplacementChannelOrigin(nsIChannel* aNewChannel, uint32_t aRedirectFlags); // bundle calling OMR observers and marking flag into one function inline void CallOnModifyRequestObservers() { gHttpHandler->OnModifyRequest(this); MOZ_ASSERT(!LoadRequestObserversCalled()); StoreRequestObserversCalled(true); } // Helper function to simplify getting notification callbacks. template void GetCallback(nsCOMPtr& aResult) { NS_QueryNotificationCallbacks(mCallbacks, mLoadGroup, NS_GET_TEMPLATE_IID(T), getter_AddRefs(aResult)); } // Redirect tracking // Checks whether or not aURI and mOriginalURI share the same domain. virtual bool SameOriginWithOriginalUri(nsIURI* aURI); [[nodiscard]] bool BypassServiceWorker() const; // Returns true if this channel should intercept the network request and // prepare for a possible synthesized response instead. bool ShouldIntercept(nsIURI* aURI = nullptr); #ifdef DEBUG // Check if mPrivateBrowsingId matches between LoadInfo and LoadContext. void AssertPrivateBrowsingId(); #endif static void CallTypeSniffers(void* aClosure, const uint8_t* aData, uint32_t aCount); nsresult CheckRedirectLimit(uint32_t aRedirectFlags) const; bool MaybeWaitForUploadStreamNormalization(nsIStreamListener* aListener, nsISupports* aContext); void MaybeFlushConsoleReports(); bool IsBrowsingContextDiscarded() const; nsresult ProcessCrossOriginEmbedderPolicyHeader(); nsresult ProcessCrossOriginResourcePolicyHeader(); nsresult ComputeCrossOriginOpenerPolicyMismatch(); nsresult ProcessCrossOriginSecurityHeaders(); nsresult ValidateMIMEType(); bool ShouldFilterOpaqueResponse(OpaqueResponseFilterFetch aFilterType) const; bool ShouldBlockOpaqueResponse() const; OpaqueResponse BlockOrFilterOpaqueResponse( OpaqueResponseBlocker* aORB, const nsAString& aReason, const OpaqueResponseBlockedTelemetryReason aTelemetryReason, const char* aFormat, ...); OpaqueResponse PerformOpaqueResponseSafelistCheckBeforeSniff(); OpaqueResponse PerformOpaqueResponseSafelistCheckAfterSniff( const nsACString& aContentType, bool aNoSniff); bool NeedOpaqueResponseAllowedCheckAfterSniff() const; void BlockOpaqueResponseAfterSniff( const nsAString& aReason, const OpaqueResponseBlockedTelemetryReason aTelemetryReason); void AllowOpaqueResponseAfterSniff(); void SetChannelBlockedByOpaqueResponse(); bool Http3Allowed() const; friend class OpaqueResponseBlocker; friend class PrivateBrowsingChannel; friend class InterceptFailedOnStop; friend class HttpChannelParent; protected: // this section is for main-thread-only object // all the references need to be proxy released on main thread. nsCOMPtr mURI; nsCOMPtr mOriginalURI; nsCOMPtr mDocumentURI; nsCOMPtr mLoadGroup; nsCOMPtr mLoadInfo; nsCOMPtr mCallbacks; nsCOMPtr mProgressSink; nsCOMPtr mReferrerInfo; nsCOMPtr mAPIRedirectToURI; nsCOMPtr mProxyURI; nsCOMPtr mPrincipal; nsCOMPtr mTopWindowURI; nsCOMPtr mListener; // An instance of nsHTTPCompressConv nsCOMPtr mCompressListener; nsCOMPtr mCurrentThread; RefPtr mORB; private: // Proxy release all members above on main thread. void ReleaseMainThreadOnlyReferences(); void ExplicitSetUploadStreamLength(uint64_t aContentLength, bool aSetContentLengthHeader); void MaybeResumeAsyncOpen(); protected: nsCString mSpec; // ASCII encoded URL spec nsCString mContentTypeHint; nsCString mContentCharsetHint; nsCString mUserSetCookieHeader; // HTTP Upgrade Data nsCString mUpgradeProtocol; // Resumable channel specific data nsCString mEntityID; // The initiator type (for this resource) - how was the resource referenced in // the HTML file. nsString mInitiatorType; // Holds the name of the preferred alt-data type for each contentType. nsTArray mPreferredCachedAltDataTypes; // Holds the name of the alternative data type the channel returned. nsCString mAvailableCachedAltDataType; nsString mIntegrityMetadata; // Classified channel's matched information nsCString mMatchedList; nsCString mMatchedProvider; nsCString mMatchedFullHash; nsTArray mMatchedTrackingLists; nsTArray mMatchedTrackingFullHashes; nsCOMPtr mOwner; nsHttpRequestHead mRequestHead; // Upload throttling. nsCOMPtr mThrottleQueue; nsCOMPtr mUploadStream; UniquePtr mResponseHead; UniquePtr mResponseTrailers; RefPtr mConnectionInfo; nsCOMPtr mProxyInfo; nsCOMPtr mSecurityInfo; nsCOMPtr mUpgradeProtocolCallback; UniquePtr mContentDispositionFilename; nsCOMPtr mReportCollector; RefPtr mHttpHandler; // keep gHttpHandler alive // Accessed on MainThread and Cache2 IO thread DataMutex>> mRedirectedCachekeys{ "mRedirectedCacheKeys"}; nsCOMPtr mRequestContext; NetAddr mSelfAddr; NetAddr mPeerAddr; nsTArray> mSecurityConsoleMessages; nsTArray mUnsafeHeaders; // A time value equal to the starting time of the fetch that initiates the // redirect. mozilla::TimeStamp mRedirectStartTimeStamp; // A time value equal to the time immediately after receiving the last byte of // the response of the last redirect. mozilla::TimeStamp mRedirectEndTimeStamp; PRTime mChannelCreationTime; TimeStamp mChannelCreationTimestamp; TimeStamp mAsyncOpenTime; TimeStamp mCacheReadStart; TimeStamp mCacheReadEnd; TimeStamp mLaunchServiceWorkerStart; TimeStamp mLaunchServiceWorkerEnd; TimeStamp mDispatchFetchEventStart; TimeStamp mDispatchFetchEventEnd; TimeStamp mHandleFetchEventStart; TimeStamp mHandleFetchEventEnd; TimeStamp mOnStartRequestStartTime; TimeStamp mOnDataAvailableStartTime; TimeStamp mOnStopRequestStartTime; // copied from the transaction before we null out mTransaction // so that the timing can still be queried from OnStopRequest TimingStruct mTransactionTimings; // Gets computed during ComputeCrossOriginOpenerPolicyMismatch so we have // the channel's policy even if we don't know policy initiator. nsILoadInfo::CrossOriginOpenerPolicy mComputedCrossOriginOpenerPolicy; uint64_t mStartPos; uint64_t mTransferSize; uint64_t mRequestSize; uint64_t mDecodedBodySize; // True only when the channel supports any of the versions of HTTP3 bool mSupportsHTTP3; uint64_t mEncodedBodySize; uint64_t mRequestContextID; // ID of the top-level document's inner window this channel is being // originated from. uint64_t mContentWindowId; uint64_t mBrowserId; int64_t mAltDataLength; uint64_t mChannelId; uint64_t mReqContentLength; Atomic mStatus; // Use Release-Acquire ordering to ensure the OMT ODA is ignored while channel // is canceled on main thread. Atomic mCanceled; Atomic mFirstPartyClassificationFlags; Atomic mThirdPartyClassificationFlags; // mutex to guard members accessed during OnDataFinished in // HttpChannelChild.cpp Mutex mOnDataFinishedMutex{"HttpChannelChild::OnDataFinishedMutex"}; UniquePtr mSource; uint32_t mLoadFlags; uint32_t mCaps; ClassOfService mClassOfService; // This should be set the the actual TRR mode used to resolve the request. // Is initially set to TRR_DEFAULT_MODE, but should be updated to the actual // mode used by the request nsIRequest::TRRMode mEffectiveTRRMode = nsIRequest::TRR_DEFAULT_MODE; TRRSkippedReason mTRRSkipReason = TRRSkippedReason::TRR_UNSET; public: void SetEarlyHints( nsTArray&& aEarlyHints); nsTArray&& TakeEarlyHints(); protected: // Storing Http 103 Early Hint preloads. The parent process is responsible to // start the early hint preloads, but the http child needs to be able to look // them up. They are sent via IPC and stored in this variable. This is set on // main document channel nsTArray mEarlyHints; // EarlyHintRegistrar id to connect back to the preload. Set on preload // channels started from the above list uint64_t mEarlyHintPreloaderId = 0; uint32_t mEarlyHintLinkType = 0; nsString mClassicScriptHintCharset; nsString mDocumentCharacterSet; // clang-format off MOZ_ATOMIC_BITFIELDS(mAtomicBitfields1, 32, ( (uint32_t, UpgradeToSecure, 1), (uint32_t, ApplyConversion, 1), // Set to true if DoApplyContentConversions has been applied to // our default mListener. (uint32_t, HasAppliedConversion, 1), (uint32_t, IsPending, 1), (uint32_t, WasOpened, 1), // if 1 all "http-on-{opening|modify|etc}-request" observers have been // called. (uint32_t, RequestObserversCalled, 1), (uint32_t, ResponseHeadersModified, 1), (uint32_t, AllowSTS, 1), (uint32_t, ThirdPartyFlags, 3), (uint32_t, UploadStreamHasHeaders, 1), (uint32_t, ChannelIsForDownload, 1), (uint32_t, TracingEnabled, 1), // True if timing collection is enabled (uint32_t, TimingEnabled, 1), (uint32_t, ReportTiming, 1), (uint32_t, AllowSpdy, 1), (uint32_t, AllowHttp3, 1), (uint32_t, AllowAltSvc, 1), // !!! This is also used by the URL classifier to exempt channels from // classification. If this is changed or removed, make sure we also update // NS_ShouldClassifyChannel accordingly !!! (uint32_t, BeConservative, 1), // If the current channel is used to as a TRR connection. (uint32_t, IsTRRServiceChannel, 1), // If the request was performed to a TRR resolved IP address. // Will be false if loading the resource does not create a connection // (for example when it's loaded from the cache). (uint32_t, ResolvedByTRR, 1), (uint32_t, ResponseTimeoutEnabled, 1), // A flag that should be false only if a cross-domain redirect occurred (uint32_t, AllRedirectsSameOrigin, 1), // Is 1 if no redirects have occured or if all redirects // pass the Resource Timing timing-allow-check (uint32_t, AllRedirectsPassTimingAllowCheck, 1), // True if this channel was intercepted and could receive a synthesized // response. (uint32_t, ResponseCouldBeSynthesized, 1), (uint32_t, BlockAuthPrompt, 1), // If true, we behave as if the LOAD_FROM_CACHE flag has been set. // Used to enforce that flag's behavior but not expose it externally. (uint32_t, AllowStaleCacheContent, 1), // If true, we behave as if the VALIDATE_ALWAYS flag has been set. // Used to force validate the cached content. (uint32_t, ForceValidateCacheContent, 1), // If true, we prefer the LOAD_FROM_CACHE flag over LOAD_BYPASS_CACHE or // LOAD_BYPASS_LOCAL_CACHE. (uint32_t, PreferCacheLoadOverBypass, 1), (uint32_t, IsProxyUsed, 1) )) // Broken up into two bitfields to avoid alignment requirements of uint64_t. // (Too many bits used for one uint32_t.) MOZ_ATOMIC_BITFIELDS(mAtomicBitfields2, 32, ( // True iff this request has been calculated in its request context as // a non tail request. We must remove it again when this channel is done. (uint32_t, AddedAsNonTailRequest, 1), // True if AsyncOpen() is called when the upload stream normalization or // length is still unknown. AsyncOpen() will be retriggered when // normalization is complete and length has been determined. (uint32_t, AsyncOpenWaitingForStreamNormalization, 1), // Defaults to true. This is set to false when it is no longer possible // to upgrade the request to a secure channel. (uint32_t, UpgradableToSecure, 1), // Tainted origin flag of a request, specified by // WHATWG Fetch Standard 2.2.5. (uint32_t, TaintedOriginFlag, 1), // If the channel is being used to check OCSP (uint32_t, IsOCSP, 1), // Used by system requests such as remote settings and updates to // retry requests without proxies. (uint32_t, BypassProxy, 1), // Indicate whether the response of this channel is coming from // socket process. (uint32_t, LoadedBySocketProcess, 1), // Indicates whether the user-agent header has been modifed since the channel // was created. (uint32_t, IsUserAgentHeaderModified, 1) )) // clang-format on // An opaque flags for non-standard behavior of the TLS system. // It is unlikely this will need to be set outside of telemetry studies // relating to the TLS implementation. uint32_t mTlsFlags; // Current suspension depth for this channel object uint32_t mSuspendCount; // Per channel transport window override (0 means no override) uint32_t mInitialRwin; uint32_t mProxyResolveFlags; uint32_t mContentDispositionHint; dom::RequestMode mRequestMode; uint32_t mRedirectMode; // If this channel was created as the result of a redirect, then this value // will reflect the redirect flags passed to the SetupReplacementChannel() // method. uint32_t mLastRedirectFlags; int16_t mPriority; uint8_t mRedirectionLimit; // Performance tracking // Number of redirects that has occurred. int8_t mRedirectCount; // Number of internal redirects that has occurred. int8_t mInternalRedirectCount; enum class SnifferCategoryType { NetContent = 0, OpaqueResponseBlocking, All }; SnifferCategoryType mSnifferCategoryType = SnifferCategoryType::NetContent; // Used to ensure the same pref value is being used across the // lifetime of this http channel. const bool mCachedOpaqueResponseBlockingPref; bool mChannelBlockedByOpaqueResponse; bool mDummyChannelForImageCache; bool mHasContentDecompressed; // clang-format off MOZ_ATOMIC_BITFIELDS(mAtomicBitfields3, 8, ( (bool, AsyncOpenTimeOverriden, 1), (bool, ForcePending, 1), // true if the channel is deliving alt-data. (bool, DeliveringAltData, 1), (bool, CorsIncludeCredentials, 1), // These parameters are used to ensure that we do not call OnStartRequest // and OnStopRequest more than once. (bool, OnStartRequestCalled, 1), (bool, OnStopRequestCalled, 1), // Defaults to false. Is set to true at the begining of OnStartRequest. // Used to ensure methods can't be called before OnStartRequest. (bool, AfterOnStartRequestBegun, 1), (bool, RequireCORSPreflight, 1) )) // Broken up into two bitfields to avoid alignment requirements of uint16_t. // (Too many bits used for one uint8_t.) MOZ_ATOMIC_BITFIELDS(mAtomicBitfields4, 8, ( // This flag will be true if the consumer is requesting alt-data AND the // consumer is in the child process. (bool, AltDataForChild, 1), // This flag will be true if the consumer cannot process alt-data. This // is used in the webextension StreamFilter handler. If true, we bypass // using alt-data for the request. (bool, DisableAltDataCache, 1), (bool, ForceMainDocumentChannel, 1), // This is set true if the channel is waiting for upload stream // normalization or the InputStreamLengthHelper::GetAsyncLength callback. (bool, PendingUploadStreamNormalization, 1), // Set to true if our listener has indicated that it requires // content conversion to be done by us. (bool, ListenerRequiresContentConversion, 1), // True if this is a navigation to a page with a different cross origin // opener policy ( see ComputeCrossOriginOpenerPolicyMismatch ) (uint32_t, HasCrossOriginOpenerPolicyMismatch, 1), // True if HTTPS RR is used during the connection establishment of this // channel. (uint32_t, HasHTTPSRR, 1), // Ensures that ProcessCrossOriginSecurityHeadersCalled has been called // before calling CallOnStartRequest. (uint32_t, ProcessCrossOriginSecurityHeadersCalled, 1) )) // clang-format on bool EnsureRequestContextID(); bool EnsureRequestContext(); // Adds/removes this channel as a non-tailed request in its request context // these helpers ensure we add it only once and remove it only when added // via AddedAsNonTailRequest member tracking. void AddAsNonTailRequest(); void RemoveAsNonTailRequest(); void EnsureBrowserId(); }; NS_DEFINE_STATIC_IID_ACCESSOR(HttpBaseChannel, HTTP_BASE_CHANNEL_IID) // Share some code while working around C++'s absurd inability to handle casting // of member functions between base/derived types. // - We want to store member function pointer to call at resume time, but one // such function--HandleAsyncAbort--we want to share between the // nsHttpChannel/HttpChannelChild. Can't define it in base class, because // then we'd have to cast member function ptr between base/derived class // types. Sigh... template class HttpAsyncAborter { public: explicit HttpAsyncAborter(T* derived) : mThis(derived), mCallOnResume(nullptr) {} // Aborts channel: calls OnStart/Stop with provided status, removes channel // from loadGroup. [[nodiscard]] nsresult AsyncAbort(nsresult status); // Does most the actual work. void HandleAsyncAbort(); // AsyncCall calls a member function asynchronously (via an event). // retval isn't refcounted and is set only when event was successfully // posted, the event is returned for the purpose of cancelling when needed [[nodiscard]] virtual nsresult AsyncCall( void (T::*funcPtr)(), nsRunnableMethod** retval = nullptr); private: T* mThis; protected: // Function to be called at resume time std::function mCallOnResume; }; template [[nodiscard]] nsresult HttpAsyncAborter::AsyncAbort(nsresult status) { MOZ_LOG(gHttpLog, LogLevel::Debug, ("HttpAsyncAborter::AsyncAbort [this=%p status=%" PRIx32 "]\n", mThis, static_cast(status))); mThis->mStatus = status; // if this fails? Callers ignore our return value anyway.... return AsyncCall(&T::HandleAsyncAbort); } // Each subclass needs to define its own version of this (which just calls this // base version), else we wind up casting base/derived member function ptrs template inline void HttpAsyncAborter::HandleAsyncAbort() { MOZ_ASSERT(!mCallOnResume, "How did that happen?"); if (mThis->mSuspendCount) { MOZ_LOG( gHttpLog, LogLevel::Debug, ("Waiting until resume to do async notification [this=%p]\n", mThis)); mCallOnResume = [](T* self) { self->HandleAsyncAbort(); return NS_OK; }; return; } mThis->DoNotifyListener(); // finally remove ourselves from the load group. if (mThis->mLoadGroup) { mThis->mLoadGroup->RemoveRequest(mThis, nullptr, mThis->mStatus); } } template nsresult HttpAsyncAborter::AsyncCall(void (T::*funcPtr)(), nsRunnableMethod** retval) { nsresult rv; RefPtr> event = NewRunnableMethod("net::HttpAsyncAborter::AsyncCall", mThis, funcPtr); rv = NS_DispatchToCurrentThread(event); if (NS_SUCCEEDED(rv) && retval) { *retval = event; } return rv; } class ProxyReleaseRunnable final : public mozilla::Runnable { public: explicit ProxyReleaseRunnable(nsTArray>&& aDoomed) : Runnable("ProxyReleaseRunnable"), mDoomed(std::move(aDoomed)) {} NS_IMETHOD Run() override { mDoomed.Clear(); return NS_OK; } private: virtual ~ProxyReleaseRunnable() = default; nsTArray> mDoomed; }; } // namespace net } // namespace mozilla #endif // mozilla_net_HttpBaseChannel_h