/* * nghttp2 - HTTP/2 C Library * * Copyright (c) 2012 Tatsuhiro Tsujikawa * * Permission is hereby granted, free of charge, to any person obtaining * a copy of this software and associated documentation files (the * "Software"), to deal in the Software without restriction, including * without limitation the rights to use, copy, modify, merge, publish, * distribute, sublicense, and/or sell copies of the Software, and to * permit persons to whom the Software is furnished to do so, subject to * the following conditions: * * The above copyright notice and this permission notice shall be * included in all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ #ifndef SHRPX_CONFIG_H #define SHRPX_CONFIG_H #include "shrpx.h" #include #ifdef HAVE_SYS_SOCKET_H #include #endif // HAVE_SYS_SOCKET_H #include #ifdef HAVE_NETINET_IN_H #include #endif // HAVE_NETINET_IN_H #ifdef HAVE_ARPA_INET_H #include #endif // HAVE_ARPA_INET_H #include #include #include #include #include #include #include #include #include "template.h" using namespace nghttp2; namespace shrpx { struct LogFragment; namespace ssl { class CertLookupTree; } // namespace ssl constexpr char SHRPX_UNIX_PATH_PREFIX[] = "unix:"; constexpr char SHRPX_OPT_PRIVATE_KEY_FILE[] = "private-key-file"; constexpr char SHRPX_OPT_PRIVATE_KEY_PASSWD_FILE[] = "private-key-passwd-file"; constexpr char SHRPX_OPT_CERTIFICATE_FILE[] = "certificate-file"; constexpr char SHRPX_OPT_DH_PARAM_FILE[] = "dh-param-file"; constexpr char SHRPX_OPT_SUBCERT[] = "subcert"; constexpr char SHRPX_OPT_BACKEND[] = "backend"; constexpr char SHRPX_OPT_FRONTEND[] = "frontend"; constexpr char SHRPX_OPT_WORKERS[] = "workers"; constexpr char SHRPX_OPT_HTTP2_MAX_CONCURRENT_STREAMS[] = "http2-max-concurrent-streams"; constexpr char SHRPX_OPT_LOG_LEVEL[] = "log-level"; constexpr char SHRPX_OPT_DAEMON[] = "daemon"; constexpr char SHRPX_OPT_HTTP2_PROXY[] = "http2-proxy"; constexpr char SHRPX_OPT_HTTP2_BRIDGE[] = "http2-bridge"; constexpr char SHRPX_OPT_CLIENT_PROXY[] = "client-proxy"; constexpr char SHRPX_OPT_ADD_X_FORWARDED_FOR[] = "add-x-forwarded-for"; constexpr char SHRPX_OPT_STRIP_INCOMING_X_FORWARDED_FOR[] = "strip-incoming-x-forwarded-for"; constexpr char SHRPX_OPT_NO_VIA[] = "no-via"; constexpr char SHRPX_OPT_FRONTEND_HTTP2_READ_TIMEOUT[] = "frontend-http2-read-timeout"; constexpr char SHRPX_OPT_FRONTEND_READ_TIMEOUT[] = "frontend-read-timeout"; constexpr char SHRPX_OPT_FRONTEND_WRITE_TIMEOUT[] = "frontend-write-timeout"; constexpr char SHRPX_OPT_BACKEND_READ_TIMEOUT[] = "backend-read-timeout"; constexpr char SHRPX_OPT_BACKEND_WRITE_TIMEOUT[] = "backend-write-timeout"; constexpr char SHRPX_OPT_STREAM_READ_TIMEOUT[] = "stream-read-timeout"; constexpr char SHRPX_OPT_STREAM_WRITE_TIMEOUT[] = "stream-write-timeout"; constexpr char SHRPX_OPT_ACCESSLOG_FILE[] = "accesslog-file"; constexpr char SHRPX_OPT_ACCESSLOG_SYSLOG[] = "accesslog-syslog"; constexpr char SHRPX_OPT_ACCESSLOG_FORMAT[] = "accesslog-format"; constexpr char SHRPX_OPT_ERRORLOG_FILE[] = "errorlog-file"; constexpr char SHRPX_OPT_ERRORLOG_SYSLOG[] = "errorlog-syslog"; constexpr char SHRPX_OPT_BACKEND_KEEP_ALIVE_TIMEOUT[] = "backend-keep-alive-timeout"; constexpr char SHRPX_OPT_FRONTEND_HTTP2_WINDOW_BITS[] = "frontend-http2-window-bits"; constexpr char SHRPX_OPT_BACKEND_HTTP2_WINDOW_BITS[] = "backend-http2-window-bits"; constexpr char SHRPX_OPT_FRONTEND_HTTP2_CONNECTION_WINDOW_BITS[] = "frontend-http2-connection-window-bits"; constexpr char SHRPX_OPT_BACKEND_HTTP2_CONNECTION_WINDOW_BITS[] = "backend-http2-connection-window-bits"; constexpr char SHRPX_OPT_FRONTEND_NO_TLS[] = "frontend-no-tls"; constexpr char SHRPX_OPT_BACKEND_NO_TLS[] = "backend-no-tls"; constexpr char SHRPX_OPT_BACKEND_TLS_SNI_FIELD[] = "backend-tls-sni-field"; constexpr char SHRPX_OPT_PID_FILE[] = "pid-file"; constexpr char SHRPX_OPT_USER[] = "user"; constexpr char SHRPX_OPT_SYSLOG_FACILITY[] = "syslog-facility"; constexpr char SHRPX_OPT_BACKLOG[] = "backlog"; constexpr char SHRPX_OPT_CIPHERS[] = "ciphers"; constexpr char SHRPX_OPT_CLIENT[] = "client"; constexpr char SHRPX_OPT_INSECURE[] = "insecure"; constexpr char SHRPX_OPT_CACERT[] = "cacert"; constexpr char SHRPX_OPT_BACKEND_IPV4[] = "backend-ipv4"; constexpr char SHRPX_OPT_BACKEND_IPV6[] = "backend-ipv6"; constexpr char SHRPX_OPT_BACKEND_HTTP_PROXY_URI[] = "backend-http-proxy-uri"; constexpr char SHRPX_OPT_READ_RATE[] = "read-rate"; constexpr char SHRPX_OPT_READ_BURST[] = "read-burst"; constexpr char SHRPX_OPT_WRITE_RATE[] = "write-rate"; constexpr char SHRPX_OPT_WRITE_BURST[] = "write-burst"; constexpr char SHRPX_OPT_WORKER_READ_RATE[] = "worker-read-rate"; constexpr char SHRPX_OPT_WORKER_READ_BURST[] = "worker-read-burst"; constexpr char SHRPX_OPT_WORKER_WRITE_RATE[] = "worker-write-rate"; constexpr char SHRPX_OPT_WORKER_WRITE_BURST[] = "worker-write-burst"; constexpr char SHRPX_OPT_NPN_LIST[] = "npn-list"; constexpr char SHRPX_OPT_TLS_PROTO_LIST[] = "tls-proto-list"; constexpr char SHRPX_OPT_VERIFY_CLIENT[] = "verify-client"; constexpr char SHRPX_OPT_VERIFY_CLIENT_CACERT[] = "verify-client-cacert"; constexpr char SHRPX_OPT_CLIENT_PRIVATE_KEY_FILE[] = "client-private-key-file"; constexpr char SHRPX_OPT_CLIENT_CERT_FILE[] = "client-cert-file"; constexpr char SHRPX_OPT_FRONTEND_HTTP2_DUMP_REQUEST_HEADER[] = "frontend-http2-dump-request-header"; constexpr char SHRPX_OPT_FRONTEND_HTTP2_DUMP_RESPONSE_HEADER[] = "frontend-http2-dump-response-header"; constexpr char SHRPX_OPT_HTTP2_NO_COOKIE_CRUMBLING[] = "http2-no-cookie-crumbling"; constexpr char SHRPX_OPT_FRONTEND_FRAME_DEBUG[] = "frontend-frame-debug"; constexpr char SHRPX_OPT_PADDING[] = "padding"; constexpr char SHRPX_OPT_ALTSVC[] = "altsvc"; constexpr char SHRPX_OPT_ADD_REQUEST_HEADER[] = "add-request-header"; constexpr char SHRPX_OPT_ADD_RESPONSE_HEADER[] = "add-response-header"; constexpr char SHRPX_OPT_WORKER_FRONTEND_CONNECTIONS[] = "worker-frontend-connections"; constexpr char SHRPX_OPT_NO_LOCATION_REWRITE[] = "no-location-rewrite"; constexpr char SHRPX_OPT_NO_HOST_REWRITE[] = "no-host-rewrite"; constexpr char SHRPX_OPT_BACKEND_HTTP1_CONNECTIONS_PER_HOST[] = "backend-http1-connections-per-host"; constexpr char SHRPX_OPT_BACKEND_HTTP1_CONNECTIONS_PER_FRONTEND[] = "backend-http1-connections-per-frontend"; constexpr char SHRPX_OPT_LISTENER_DISABLE_TIMEOUT[] = "listener-disable-timeout"; constexpr char SHRPX_OPT_TLS_TICKET_KEY_FILE[] = "tls-ticket-key-file"; constexpr char SHRPX_OPT_RLIMIT_NOFILE[] = "rlimit-nofile"; constexpr char SHRPX_OPT_BACKEND_REQUEST_BUFFER[] = "backend-request-buffer"; constexpr char SHRPX_OPT_BACKEND_RESPONSE_BUFFER[] = "backend-response-buffer"; constexpr char SHRPX_OPT_NO_SERVER_PUSH[] = "no-server-push"; constexpr char SHRPX_OPT_BACKEND_HTTP2_CONNECTIONS_PER_WORKER[] = "backend-http2-connections-per-worker"; constexpr char SHRPX_OPT_FETCH_OCSP_RESPONSE_FILE[] = "fetch-ocsp-response-file"; constexpr char SHRPX_OPT_OCSP_UPDATE_INTERVAL[] = "ocsp-update-interval"; constexpr char SHRPX_OPT_NO_OCSP[] = "no-ocsp"; constexpr char SHRPX_OPT_HEADER_FIELD_BUFFER[] = "header-field-buffer"; constexpr char SHRPX_OPT_MAX_HEADER_FIELDS[] = "max-header-fields"; constexpr char SHRPX_OPT_INCLUDE[] = "include"; constexpr char SHRPX_OPT_TLS_TICKET_KEY_CIPHER[] = "tls-ticket-key-cipher"; constexpr char SHRPX_OPT_HOST_REWRITE[] = "host-rewrite"; constexpr char SHRPX_OPT_TLS_SESSION_CACHE_MEMCACHED[] = "tls-session-cache-memcached"; constexpr char SHRPX_OPT_TLS_TICKET_KEY_MEMCACHED[] = "tls-ticket-key-memcached"; constexpr char SHRPX_OPT_TLS_TICKET_KEY_MEMCACHED_INTERVAL[] = "tls-ticket-key-memcached-interval"; constexpr char SHRPX_OPT_TLS_TICKET_KEY_MEMCACHED_MAX_RETRY[] = "tls-ticket-key-memcached-max-retry"; constexpr char SHRPX_OPT_TLS_TICKET_KEY_MEMCACHED_MAX_FAIL[] = "tls-ticket-key-memcached-max-fail"; constexpr char SHRPX_OPT_REQUEST_PHASE_FILE[] = "request-phase-file"; constexpr char SHRPX_OPT_RESPONSE_PHASE_FILE[] = "response-phase-file"; constexpr char SHRPX_OPT_ACCEPT_PROXY_PROTOCOL[] = "accept-proxy-protocol"; union sockaddr_union { sockaddr_storage storage; sockaddr sa; sockaddr_in6 in6; sockaddr_in in; sockaddr_un un; }; struct Address { size_t len; union sockaddr_union su; }; enum shrpx_proto { PROTO_HTTP2, PROTO_HTTP }; struct AltSvc { AltSvc() : port(0) {} std::string protocol_id, host, origin, service; uint16_t port; }; struct DownstreamAddr { DownstreamAddr() : addr{}, port(0), host_unix(false) {} DownstreamAddr(const DownstreamAddr &other); DownstreamAddr(DownstreamAddr &&) = default; DownstreamAddr &operator=(const DownstreamAddr &other); DownstreamAddr &operator=(DownstreamAddr &&other) = default; Address addr; // backend address. If |host_unix| is true, this is UNIX domain // socket path. std::unique_ptr host; std::unique_ptr hostport; // backend port. 0 if |host_unix| is true. uint16_t port; // true if |host| contains UNIX domain socket path. bool host_unix; }; struct DownstreamAddrGroup { DownstreamAddrGroup(std::string pattern) : pattern(std::move(pattern)) {} std::string pattern; std::vector addrs; }; struct TicketKey { const EVP_CIPHER *cipher; const EVP_MD *hmac; size_t hmac_keylen; struct { // name of this ticket configuration std::array name; // encryption key for |cipher| std::array enc_key; // hmac key for |hmac| std::array hmac_key; } data; }; struct TicketKeys { ~TicketKeys(); std::vector keys; }; struct Config { // The list of (private key file, certificate file) pair std::vector> subcerts; std::vector altsvcs; std::vector> add_request_headers; std::vector> add_response_headers; std::vector alpn_prefs; std::vector accesslog_format; std::vector downstream_addr_groups; std::vector tls_ticket_key_files; // list of supported NPN/ALPN protocol strings in the order of // preference. std::vector npn_list; // list of supported SSL/TLS protocol strings. std::vector tls_proto_list; // binary form of http proxy host and port Address downstream_http_proxy_addr; Address session_cache_memcached_addr; Address tls_ticket_key_memcached_addr; std::chrono::seconds tls_session_timeout; ev_tstamp http2_upstream_read_timeout; ev_tstamp upstream_read_timeout; ev_tstamp upstream_write_timeout; ev_tstamp downstream_read_timeout; ev_tstamp downstream_write_timeout; ev_tstamp stream_read_timeout; ev_tstamp stream_write_timeout; ev_tstamp downstream_idle_read_timeout; ev_tstamp listener_disable_timeout; ev_tstamp ocsp_update_interval; ev_tstamp tls_ticket_key_memcached_interval; // address of frontend connection. This could be a path to UNIX // domain socket. In this case, |host_unix| must be true. std::unique_ptr host; std::unique_ptr private_key_file; std::unique_ptr private_key_passwd; std::unique_ptr cert_file; std::unique_ptr dh_param_file; std::unique_ptr backend_tls_sni_name; std::unique_ptr pid_file; std::unique_ptr conf_path; std::unique_ptr ciphers; std::unique_ptr cacert; // userinfo in http proxy URI, not percent-encoded form std::unique_ptr downstream_http_proxy_userinfo; // host in http proxy URI std::unique_ptr downstream_http_proxy_host; std::unique_ptr http2_upstream_dump_request_header_file; std::unique_ptr http2_upstream_dump_response_header_file; // // Rate limit configuration per connection // ev_token_bucket_cfg *rate_limit_cfg; // // Rate limit configuration per worker (thread) // ev_token_bucket_cfg *worker_rate_limit_cfg; // Path to file containing CA certificate solely used for client // certificate validation std::unique_ptr verify_client_cacert; std::unique_ptr client_private_key_file; std::unique_ptr client_cert_file; std::unique_ptr accesslog_file; std::unique_ptr errorlog_file; std::unique_ptr fetch_ocsp_response_file; std::unique_ptr user; std::unique_ptr session_cache_memcached_host; std::unique_ptr tls_ticket_key_memcached_host; std::unique_ptr request_phase_file; std::unique_ptr response_phase_file; FILE *http2_upstream_dump_request_header; FILE *http2_upstream_dump_response_header; nghttp2_session_callbacks *http2_upstream_callbacks; nghttp2_session_callbacks *http2_downstream_callbacks; nghttp2_option *http2_option; nghttp2_option *http2_client_option; const EVP_CIPHER *tls_ticket_key_cipher; const char *server_name; char **argv; char *cwd; size_t num_worker; size_t http2_max_concurrent_streams; size_t http2_upstream_window_bits; size_t http2_downstream_window_bits; size_t http2_upstream_connection_window_bits; size_t http2_downstream_connection_window_bits; size_t http2_downstream_connections_per_worker; size_t downstream_connections_per_host; size_t downstream_connections_per_frontend; size_t read_rate; size_t read_burst; size_t write_rate; size_t write_burst; size_t worker_read_rate; size_t worker_read_burst; size_t worker_write_rate; size_t worker_write_burst; size_t padding; size_t worker_frontend_connections; size_t rlimit_nofile; size_t downstream_request_buffer_size; size_t downstream_response_buffer_size; size_t header_field_buffer; size_t max_header_fields; // The index of catch-all group in downstream_addr_groups. size_t downstream_addr_group_catch_all; // Maximum number of retries when getting TLS ticket key from // mamcached, due to network error. size_t tls_ticket_key_memcached_max_retry; // Maximum number of consecutive error from memcached, when this // limit reached, TLS ticket is disabled. size_t tls_ticket_key_memcached_max_fail; // Bit mask to disable SSL/TLS protocol versions. This will be // passed to SSL_CTX_set_options(). long int tls_proto_mask; // downstream protocol; this will be determined by given options. shrpx_proto downstream_proto; int syslog_facility; int backlog; int argc; uid_t uid; gid_t gid; pid_t pid; // frontend listening port. 0 if frontend listens on UNIX domain // socket, in this case |host_unix| must be true. uint16_t port; // port in http proxy URI uint16_t downstream_http_proxy_port; uint16_t session_cache_memcached_port; uint16_t tls_ticket_key_memcached_port; bool verbose; bool daemon; bool verify_client; bool http2_proxy; bool http2_bridge; bool client_proxy; bool add_x_forwarded_for; bool strip_incoming_x_forwarded_for; bool no_via; bool upstream_no_tls; bool downstream_no_tls; // Send accesslog to syslog, ignoring accesslog_file. bool accesslog_syslog; // Send errorlog to syslog, ignoring errorlog_file. bool errorlog_syslog; bool client; // true if --client or --client-proxy are enabled. bool client_mode; bool insecure; bool backend_ipv4; bool backend_ipv6; bool http2_no_cookie_crumbling; bool upstream_frame_debug; bool no_location_rewrite; bool no_host_rewrite; bool no_server_push; // true if host contains UNIX domain socket path bool host_unix; bool no_ocsp; // true if --tls-ticket-key-cipher is used bool tls_ticket_key_cipher_given; bool accept_proxy_protocol; }; const Config *get_config(); Config *mod_config(); void create_config(); // Parses option name |opt| and value |optarg|. The results are // stored into statically allocated Config object. This function // returns 0 if it succeeds, or -1. The |included_set| contains the // all paths already included while processing this configuration, to // avoid loop in --include option. int parse_config(const char *opt, const char *optarg, std::set &included_set); // Loads configurations from |filename| and stores them in statically // allocated Config object. This function returns 0 if it succeeds, or // -1. See parse_config() for |include_set|. int load_config(const char *filename, std::set &include_set); // Read passwd from |filename| std::string read_passwd_from_file(const char *filename); // Parses header field in |optarg|. We expect header field is formed // like "NAME: VALUE". We require that NAME is non empty string. ":" // is allowed at the start of the NAME, but NAME == ":" is not // allowed. This function returns pair of NAME and VALUE. std::pair parse_header(const char *optarg); std::vector parse_log_format(const char *optarg); // Returns a copy of NULL-terminated string [first, last). template std::unique_ptr strcopy(InputIt first, InputIt last) { auto res = make_unique(last - first + 1); *std::copy(first, last, res.get()) = '\0'; return res; } // Returns a copy of NULL-terminated string |val|. inline std::unique_ptr strcopy(const char *val) { return strcopy(val, val + strlen(val)); } // Returns a copy of val.c_str(). inline std::unique_ptr strcopy(const std::string &val) { return strcopy(std::begin(val), std::end(val)); } // Returns string for syslog |facility|. const char *str_syslog_facility(int facility); // Returns integer value of syslog |facility| string. int int_syslog_facility(const char *strfacility); FILE *open_file_for_write(const char *filename); // Reads TLS ticket key file in |files| and returns TicketKey which // stores read key data. The given |cipher| and |hmac| determine the // expected file size. This function returns TicketKey if it // succeeds, or nullptr. std::unique_ptr read_tls_ticket_key_file(const std::vector &files, const EVP_CIPHER *cipher, const EVP_MD *hmac); // Selects group based on request's |hostport| and |path|. |hostport| // is the value taken from :authority or host header field, and may // contain port. The |path| may contain query part. We require the // catch-all pattern in place, so this function always selects one // group. The catch-all group index is given in |catch_all|. All // patterns are given in |groups|. size_t match_downstream_addr_group( const std::string &hostport, const std::string &path, const std::vector &groups, size_t catch_all); } // namespace shrpx #endif // SHRPX_CONFIG_H