blob: 0874e48c7c3c5d7c41e4ed16b6b01ab5e8169935 [file] [log] [blame]
[email protected]cf4cae32014-05-27 00:39:101// Copyright (c) 2012 The Chromium Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
5#ifndef NET_HTTP_HTTP_NETWORK_SESSION_H_
6#define NET_HTTP_HTTP_NETWORK_SESSION_H_
7
Avi Drissman13fc8932015-12-20 04:40:468#include <stddef.h>
9#include <stdint.h>
10
avifceb32f62016-10-07 16:30:5211#include <map>
12#include <memory>
[email protected]cf4cae32014-05-27 00:39:1013#include <set>
14#include <string>
rch74da0e1a2016-01-14 02:49:3215#include <unordered_set>
[email protected]cf4cae32014-05-27 00:39:1016#include <vector>
17
maksim.sisov0adf8592016-07-15 06:25:5618#include "base/bind.h"
hajimehoshi8156e7c2016-09-29 06:17:5219#include "base/memory/memory_coordinator_client.h"
maksim.sisov0adf8592016-07-15 06:25:5620#include "base/memory/memory_pressure_monitor.h"
[email protected]cf4cae32014-05-27 00:39:1021#include "base/memory/ref_counted.h"
22#include "base/memory/weak_ptr.h"
gab47aa7da2017-06-02 16:09:4323#include "base/threading/thread_checker.h"
mmenke0d700dd82017-05-26 20:36:1124#include "net/base/host_mapping_rules.h"
[email protected]cf4cae32014-05-27 00:39:1025#include "net/base/host_port_pair.h"
26#include "net/base/net_export.h"
27#include "net/dns/host_resolver.h"
28#include "net/http/http_auth_cache.h"
29#include "net/http/http_stream_factory.h"
rch675757b2016-07-29 16:40:1130#include "net/quic/chromium/quic_stream_factory.h"
[email protected]cf4cae32014-05-27 00:39:1031#include "net/socket/next_proto.h"
bnc8f8f7d302017-04-24 18:08:0632#include "net/spdy/chromium/spdy_session_pool.h"
33#include "net/spdy/core/spdy_protocol.h"
[email protected]cf4cae32014-05-27 00:39:1034#include "net/ssl/ssl_client_auth_cache.h"
35
36namespace base {
37class Value;
xunjieli9f8c5fb52016-12-07 22:59:3338namespace trace_event {
39class ProcessMemoryDump;
40}
[email protected]cf4cae32014-05-27 00:39:1041}
42
43namespace net {
44
estark6f9b3d82016-01-12 21:37:0545class CTPolicyEnforcer;
[email protected]cf4cae32014-05-27 00:39:1046class CertVerifier;
[email protected]6b8a3c742014-07-25 00:25:3547class ChannelIDService;
[email protected]cf4cae32014-05-27 00:39:1048class ClientSocketFactory;
49class ClientSocketPoolManager;
50class CTVerifier;
51class HostResolver;
[email protected]cf4cae32014-05-27 00:39:1052class HttpAuthHandlerFactory;
53class HttpNetworkSessionPeer;
54class HttpProxyClientSocketPool;
55class HttpResponseBodyDrainer;
56class HttpServerProperties;
57class NetLog;
tbansal16196a1e2017-06-09 01:50:0958class NetworkQualityProvider;
rdsmith1d343be52016-10-21 20:37:5059class NetworkThrottleManager;
bengr39e406102014-09-10 23:04:4660class ProxyDelegate;
[email protected]cf4cae32014-05-27 00:39:1061class ProxyService;
62class QuicClock;
63class QuicCryptoClientStreamFactory;
tbansalba8f4112015-09-03 21:57:1964class SocketPerformanceWatcherFactory;
[email protected]cf4cae32014-05-27 00:39:1065class SOCKSClientSocketPool;
66class SSLClientSocketPool;
67class SSLConfigService;
68class TransportClientSocketPool;
69class TransportSecurityState;
70
bnc3171a2432016-12-28 18:40:2671// Specifies the maximum HPACK dynamic table size the server is allowed to set.
72const uint32_t kSpdyMaxHeaderTableSize = 64 * 1024;
73
Bence Béky48c4ddf2017-07-24 23:14:3474// The maximum size of header list that the server is allowed to send.
75const uint32_t kSpdyMaxHeaderListSize = 256 * 1024;
76
bnc3171a2432016-12-28 18:40:2677// Specifies the maximum concurrent streams server could send (via push).
78const uint32_t kSpdyMaxConcurrentPushedStreams = 1000;
79
[email protected]cf4cae32014-05-27 00:39:1080// This class holds session objects used by HttpNetworkTransaction objects.
gab47aa7da2017-06-02 16:09:4381class NET_EXPORT HttpNetworkSession : public base::MemoryCoordinatorClient {
[email protected]cf4cae32014-05-27 00:39:1082 public:
mmenke6ddfbea2017-05-31 21:48:4183 // Self-contained structure with all the simple configuration options
84 // supported by the HttpNetworkSession.
[email protected]cf4cae32014-05-27 00:39:1085 struct NET_EXPORT Params {
86 Params();
vmpstracd23b72016-02-26 21:08:5587 Params(const Params& other);
[email protected]cf4cae32014-05-27 00:39:1088 ~Params();
89
Matt Menke53c59762017-09-14 16:38:1290 enum class TcpFastOpenMode {
91 DISABLED,
92 // If true, TCP fast open will be used for all HTTPS connections.
93 ENABLED_FOR_SSL_ONLY,
94 // TCP fast open will be used for all HTTP/HTTPS connections.
95 // TODO(mmenke): With 0-RTT session resumption, does this option make
96 // sense?
97 ENABLED_FOR_ALL,
98 };
99
zhongyid7dd2db12017-04-14 17:01:25100 bool enable_server_push_cancellation;
mmenke0d700dd82017-05-26 20:36:11101 HostMappingRules host_mapping_rules;
[email protected]cf4cae32014-05-27 00:39:10102 bool ignore_certificate_errors;
Avi Drissman13fc8932015-12-20 04:40:46103 uint16_t testing_fixed_http_port;
104 uint16_t testing_fixed_https_port;
Matt Menke53c59762017-09-14 16:38:12105 TcpFastOpenMode tcp_fast_open_mode;
rch1546ccd2017-04-20 02:14:23106 bool enable_user_alternate_protocol_ports;
[email protected]cf4cae32014-05-27 00:39:10107
rchd502a302015-10-16 03:57:21108 // Use SPDY ping frames to test for connection health after idle.
[email protected]cf4cae32014-05-27 00:39:10109 bool enable_spdy_ping_based_connection_checking;
bnc3f0118e2016-02-02 15:42:22110 bool enable_http2;
bnc8f0f3b62015-04-08 04:37:23111 size_t spdy_session_max_recv_window_size;
bnc3171a2432016-12-28 18:40:26112 // HTTP/2 connection settings.
113 // Unknown settings will still be sent to the server.
114 SettingsMap http2_settings;
rchd502a302015-10-16 03:57:21115 // Source of time for SPDY connections.
[email protected]cf4cae32014-05-27 00:39:10116 SpdySessionPool::TimeFunc time_func;
bnca86731e2017-04-17 12:31:28117 // Whether to enable HTTP/2 Alt-Svc entries.
118 bool enable_http2_alternative_service;
[email protected]cf4cae32014-05-27 00:39:10119
rchd502a302015-10-16 03:57:21120 // Enables QUIC support.
[email protected]cf4cae32014-05-27 00:39:10121 bool enable_quic;
rch1546ccd2017-04-20 02:14:23122
123 // QUIC runtime configuration options.
124
125 // Versions of QUIC which may be used.
126 QuicVersionVector quic_supported_versions;
127 // User agent description to send in the QUIC handshake.
128 std::string quic_user_agent_id;
129 // Limit on the size of QUIC packets.
130 size_t quic_max_packet_length;
rch1546ccd2017-04-20 02:14:23131 // Maximum number of server configs that are to be stored in
132 // HttpServerProperties, instead of the disk cache.
133 size_t quic_max_server_configs_stored_in_properties;
134 // QUIC will be used for all connections in this set.
135 std::set<HostPortPair> origins_to_force_quic_on;
136 // Set of QUIC tags to send in the handshake's connection options.
137 QuicTagVector quic_connection_options;
Yixin Wang46a425f2017-08-10 23:02:20138 // Set of QUIC tags to send in the handshake's connection options that only
139 // affect the client.
140 QuicTagVector quic_client_connection_options;
rch1546ccd2017-04-20 02:14:23141
142 // Active QUIC experiments
143
rch9ecde09b2017-04-08 00:18:23144 // Marks a QUIC server broken when a connection blackholes after the
145 // handshake is confirmed.
146 bool mark_quic_broken_when_network_blackholes;
rch2f2991c2017-04-13 19:28:17147 // Retry requests which fail with QUIC_PROTOCOL_ERROR, and mark QUIC
148 // broken if the retry succeeds.
149 bool retry_without_alt_svc_on_quic_errors;
jri8c44d692015-10-23 23:53:41150 // If true, all QUIC sessions are closed when any local IP address changes.
151 bool quic_close_sessions_on_ip_change;
zhongyi6ba0f4252016-08-23 05:20:04152 // Specifies QUIC idle connection state lifetime.
rtenneti41c09992015-11-30 18:24:01153 int quic_idle_connection_timeout_seconds;
zhongyidd1439f62016-09-02 02:02:26154 // Specifies the reduced ping timeout subsequent connections should use when
155 // a connection was timed out with open streams.
156 int quic_reduced_ping_timeout_seconds;
jrid36ada62016-02-06 02:42:08157 // If true, active QUIC sessions may be migrated onto a new network when
158 // the platform indicates that the default network is changing.
jri7e636642016-01-14 06:57:08159 bool quic_migrate_sessions_on_network_change;
jrid36ada62016-02-06 02:42:08160 // If true, active QUIC sessions experiencing poor connectivity may be
161 // migrated onto a new network.
162 bool quic_migrate_sessions_early;
jri217455a12016-07-13 20:15:09163 // If true, allows migration of QUIC connections to a server-specified
164 // alternate server address.
165 bool quic_allow_server_migration;
xunjieli888c29922016-03-18 21:05:09166 // If true, bidirectional streams over QUIC will be disabled.
167 bool quic_disable_bidirectional_streams;
ckrasicda193a82016-07-09 00:39:36168 // If true, enable force HOL blocking. For measurement purposes.
169 bool quic_force_hol_blocking;
rtennetid073dd22016-08-04 01:58:33170 // If true, race cert verification with host resolution.
171 bool quic_race_cert_verification;
rchd6163f32017-01-30 23:50:38172 // If true, estimate the initial RTT for QUIC connections based on network.
173 bool quic_estimate_initial_rtt;
xunjieli888c29922016-03-18 21:05:09174
nharperb7441ef2016-01-25 23:54:14175 // Enable support for Token Binding.
176 bool enable_token_binding;
mmenkea7da6da2016-09-01 21:56:52177
178 // Enable HTTP/0.9 for HTTP/HTTPS on ports other than the default one for
179 // each protocol.
180 bool http_09_on_non_default_ports_enabled;
[email protected]cf4cae32014-05-27 00:39:10181 };
182
mmenke6ddfbea2017-05-31 21:48:41183 // Structure with pointers to the dependencies of the HttpNetworkSession.
184 // These objects must all outlive the HttpNetworkSession.
185 struct NET_EXPORT Context {
186 Context();
187 Context(const Context& other);
188 ~Context();
189
190 ClientSocketFactory* client_socket_factory;
191 HostResolver* host_resolver;
192 CertVerifier* cert_verifier;
193 ChannelIDService* channel_id_service;
194 TransportSecurityState* transport_security_state;
195 CTVerifier* cert_transparency_verifier;
196 CTPolicyEnforcer* ct_policy_enforcer;
197 ProxyService* proxy_service;
198 SSLConfigService* ssl_config_service;
199 HttpAuthHandlerFactory* http_auth_handler_factory;
200 HttpServerProperties* http_server_properties;
201 NetLog* net_log;
202 SocketPerformanceWatcherFactory* socket_performance_watcher_factory;
tbansal16196a1e2017-06-09 01:50:09203 NetworkQualityProvider* network_quality_provider;
mmenke6ddfbea2017-05-31 21:48:41204
205 // Source of time for QUIC connections.
206 QuicClock* quic_clock;
207 // Source of entropy for QUIC connections.
208 QuicRandom* quic_random;
209 // Optional factory to use for creating QuicCryptoClientStreams.
210 QuicCryptoClientStreamFactory* quic_crypto_client_stream_factory;
211
212 ProxyDelegate* proxy_delegate;
213 };
214
[email protected]cf4cae32014-05-27 00:39:10215 enum SocketPoolType {
216 NORMAL_SOCKET_POOL,
217 WEBSOCKET_SOCKET_POOL,
218 NUM_SOCKET_POOL_TYPES
219 };
220
mmenke6ddfbea2017-05-31 21:48:41221 HttpNetworkSession(const Params& params, const Context& context);
hajimehoshi8156e7c2016-09-29 06:17:52222 ~HttpNetworkSession() override;
[email protected]cf4cae32014-05-27 00:39:10223
224 HttpAuthCache* http_auth_cache() { return &http_auth_cache_; }
225 SSLClientAuthCache* ssl_client_auth_cache() {
226 return &ssl_client_auth_cache_;
227 }
228
avifceb32f62016-10-07 16:30:52229 void AddResponseDrainer(std::unique_ptr<HttpResponseBodyDrainer> drainer);
[email protected]cf4cae32014-05-27 00:39:10230
avifceb32f62016-10-07 16:30:52231 // Removes the drainer from the session. Does not dispose of it.
[email protected]cf4cae32014-05-27 00:39:10232 void RemoveResponseDrainer(HttpResponseBodyDrainer* drainer);
233
234 TransportClientSocketPool* GetTransportSocketPool(SocketPoolType pool_type);
235 SSLClientSocketPool* GetSSLSocketPool(SocketPoolType pool_type);
236 SOCKSClientSocketPool* GetSocketPoolForSOCKSProxy(
237 SocketPoolType pool_type,
238 const HostPortPair& socks_proxy);
239 HttpProxyClientSocketPool* GetSocketPoolForHTTPProxy(
240 SocketPoolType pool_type,
241 const HostPortPair& http_proxy);
242 SSLClientSocketPool* GetSocketPoolForSSLWithProxy(
243 SocketPoolType pool_type,
244 const HostPortPair& proxy_server);
245
246 CertVerifier* cert_verifier() { return cert_verifier_; }
247 ProxyService* proxy_service() { return proxy_service_; }
248 SSLConfigService* ssl_config_service() { return ssl_config_service_.get(); }
249 SpdySessionPool* spdy_session_pool() { return &spdy_session_pool_; }
250 QuicStreamFactory* quic_stream_factory() { return &quic_stream_factory_; }
251 HttpAuthHandlerFactory* http_auth_handler_factory() {
252 return http_auth_handler_factory_;
253 }
bnc525e175a2016-06-20 12:36:40254 HttpServerProperties* http_server_properties() {
[email protected]cf4cae32014-05-27 00:39:10255 return http_server_properties_;
256 }
257 HttpStreamFactory* http_stream_factory() {
258 return http_stream_factory_.get();
259 }
260 HttpStreamFactory* http_stream_factory_for_websocket() {
261 return http_stream_factory_for_websocket_.get();
262 }
rdsmith1d343be52016-10-21 20:37:50263 NetworkThrottleManager* throttler() {
264 return network_stream_throttler_.get();
265 }
[email protected]cf4cae32014-05-27 00:39:10266 NetLog* net_log() {
267 return net_log_;
268 }
[email protected]cf4cae32014-05-27 00:39:10269
payal.pandey62a400292015-05-28 09:29:54270 // Creates a Value summary of the state of the socket pools.
danakj1fd259a02016-04-16 03:17:09271 std::unique_ptr<base::Value> SocketPoolInfoToValue() const;
[email protected]cf4cae32014-05-27 00:39:10272
payal.pandey91cb2312015-05-27 07:41:51273 // Creates a Value summary of the state of the SPDY sessions.
danakj1fd259a02016-04-16 03:17:09274 std::unique_ptr<base::Value> SpdySessionPoolInfoToValue() const;
[email protected]cf4cae32014-05-27 00:39:10275
276 // Creates a Value summary of the state of the QUIC sessions and
payal.pandeya18956a2015-05-27 05:57:55277 // configuration.
danakj1fd259a02016-04-16 03:17:09278 std::unique_ptr<base::Value> QuicInfoToValue() const;
[email protected]cf4cae32014-05-27 00:39:10279
280 void CloseAllConnections();
281 void CloseIdleConnections();
282
283 // Returns the original Params used to construct this session.
284 const Params& params() const { return params_; }
mmenke6ddfbea2017-05-31 21:48:41285 // Returns the original Context used to construct this session.
286 const Context& context() const { return context_; }
[email protected]cf4cae32014-05-27 00:39:10287
bnc3472afd2016-11-17 15:27:21288 bool IsProtocolEnabled(NextProto protocol) const;
[email protected]cf4cae32014-05-27 00:39:10289
zhongyiaf257542016-12-19 03:36:01290 void SetServerPushDelegate(std::unique_ptr<ServerPushDelegate> push_delegate);
291
bnc1f295372015-10-21 23:24:22292 // Populates |*alpn_protos| with protocols to be used with ALPN.
293 void GetAlpnProtos(NextProtoVector* alpn_protos) const;
294
nharper8cdb0fb2016-04-22 21:34:59295 // Populates |server_config| and |proxy_config| based on this session and
296 // |request|.
297 void GetSSLConfig(const HttpRequestInfo& request,
298 SSLConfig* server_config,
299 SSLConfig* proxy_config) const;
300
xunjieli9f8c5fb52016-12-07 22:59:33301 // Dumps memory allocation stats. |parent_dump_absolute_name| is the name
302 // used by the parent MemoryAllocatorDump in the memory dump hierarchy.
303 void DumpMemoryStats(base::trace_event::ProcessMemoryDump* pmd,
304 const std::string& parent_absolute_name) const;
305
pmarko6ab8be242017-01-11 11:02:55306 // Evaluates if QUIC is enabled for new streams.
307 bool IsQuicEnabled() const;
308
309 // Disable QUIC for new streams.
310 void DisableQuic();
311
[email protected]cf4cae32014-05-27 00:39:10312 private:
[email protected]cf4cae32014-05-27 00:39:10313 friend class HttpNetworkSessionPeer;
314
[email protected]cf4cae32014-05-27 00:39:10315 ClientSocketPoolManager* GetSocketPoolManager(SocketPoolType pool_type);
316
maksim.sisov0adf8592016-07-15 06:25:56317 // Flush sockets on low memory notifications callback.
318 void OnMemoryPressure(
319 base::MemoryPressureListener::MemoryPressureLevel memory_pressure_level);
320
hajimehoshi8156e7c2016-09-29 06:17:52321 // base::MemoryCoordinatorClient implementation:
bashi56b23f302017-02-09 01:24:57322 void OnPurgeMemory() override;
hajimehoshi8156e7c2016-09-29 06:17:52323
[email protected]cf4cae32014-05-27 00:39:10324 NetLog* const net_log_;
bnc525e175a2016-06-20 12:36:40325 HttpServerProperties* const http_server_properties_;
[email protected]cf4cae32014-05-27 00:39:10326 CertVerifier* const cert_verifier_;
327 HttpAuthHandlerFactory* const http_auth_handler_factory_;
328
329 // Not const since it's modified by HttpNetworkSessionPeer for testing.
330 ProxyService* proxy_service_;
331 const scoped_refptr<SSLConfigService> ssl_config_service_;
332
333 HttpAuthCache http_auth_cache_;
334 SSLClientAuthCache ssl_client_auth_cache_;
danakj1fd259a02016-04-16 03:17:09335 std::unique_ptr<ClientSocketPoolManager> normal_socket_pool_manager_;
336 std::unique_ptr<ClientSocketPoolManager> websocket_socket_pool_manager_;
zhongyiaf257542016-12-19 03:36:01337 std::unique_ptr<ServerPushDelegate> push_delegate_;
[email protected]cf4cae32014-05-27 00:39:10338 QuicStreamFactory quic_stream_factory_;
339 SpdySessionPool spdy_session_pool_;
danakj1fd259a02016-04-16 03:17:09340 std::unique_ptr<HttpStreamFactory> http_stream_factory_;
341 std::unique_ptr<HttpStreamFactory> http_stream_factory_for_websocket_;
avifceb32f62016-10-07 16:30:52342 std::map<HttpResponseBodyDrainer*, std::unique_ptr<HttpResponseBodyDrainer>>
343 response_drainers_;
rdsmith1d343be52016-10-21 20:37:50344 std::unique_ptr<NetworkThrottleManager> network_stream_throttler_;
[email protected]cf4cae32014-05-27 00:39:10345
bnc0d23cf42014-12-11 14:09:46346 NextProtoVector next_protos_;
[email protected]cf4cae32014-05-27 00:39:10347
348 Params params_;
mmenke6ddfbea2017-05-31 21:48:41349 Context context_;
maksim.sisov0adf8592016-07-15 06:25:56350
351 std::unique_ptr<base::MemoryPressureListener> memory_pressure_listener_;
gab47aa7da2017-06-02 16:09:43352
353 THREAD_CHECKER(thread_checker_);
[email protected]cf4cae32014-05-27 00:39:10354};
355
356} // namespace net
357
358#endif // NET_HTTP_HTTP_NETWORK_SESSION_H_