/* * 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 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_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"; union sockaddr_union { sockaddr_storage storage; sockaddr sa; sockaddr_in6 in6; sockaddr_in in; sockaddr_un un; }; enum shrpx_proto { PROTO_HTTP2, PROTO_HTTP }; struct AltSvc { AltSvc() : protocol_id(nullptr), host(nullptr), origin(nullptr), protocol_id_len(0), host_len(0), origin_len(0), port(0) {} char *protocol_id; char *host; char *origin; size_t protocol_id_len; size_t host_len; size_t origin_len; uint16_t port; }; struct DownstreamAddr { DownstreamAddr() : addr{{0}}, addrlen(0), port(0), host_unix(false) {} sockaddr_union addr; // backend address. If |host_unix| is true, this is UNIX domain // socket path. std::unique_ptr host; std::unique_ptr hostport; size_t addrlen; // backend port. 0 if |host_unix| is true. uint16_t port; // true if |host| contains UNIX domain socket path. bool host_unix; }; struct TicketKey { uint8_t name[16]; uint8_t aes_key[16]; uint8_t hmac_key[16]; }; 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_response_headers; std::vector alpn_prefs; std::vector accesslog_format; std::vector downstream_addrs; std::vector tls_ticket_key_files; // binary form of http proxy host and port sockaddr_union downstream_http_proxy_addr; 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; // 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; const char *server_name; 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; // list of supported NPN/ALPN protocol strings in the order of // preference. The each element of this list is a NULL-terminated // string. std::vector npn_list; // list of supported SSL/TLS protocol strings. The each element of // this list is a NULL-terminated string. std::vector tls_proto_list; // 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; 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; 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; // actual size of downstream_http_proxy_addr size_t downstream_http_proxy_addrlen; 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; // 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; std::unique_ptr user; 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; 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; }; 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. int parse_config(const char *opt, const char *optarg); // Loads configurations from |filename| and stores them in statically // allocated Config object. This function returns 0 if it succeeds, or // -1. int load_config(const char *filename); // Read passwd from |filename| std::string read_passwd_from_file(const char *filename); // Parses comma delimited strings in |s| and returns the array of // pointers, each element points to the each substring in |s|. The // |s| must be comma delimited list of strings. The strings must be // delimited by a single comma and any white spaces around it are // treated as a part of protocol strings. This function may modify // |s| and the caller must leave it as is after this call. This // function copies |s| and first element in the return value points to // it. It is caller's responsibility to deallocate its memory. std::vector parse_config_str_list(const char *s); // Clears all elements of |list|, which is returned by // parse_config_str_list(). If list is not empty, list[0] is freed by // free(2). After this call, list.empty() must be true. void clear_config_str_list(std::vector &list); // 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 |val|. std::unique_ptr strcopy(const char *val); // Returns a copy of string |val| of length |n|. The returned string // will be NULL-terminated. std::unique_ptr strcopy(const char *val, size_t n); // Returns a copy of val.c_str(). std::unique_ptr strcopy(const std::string &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. This function returns TicketKey if it // succeeds, or nullptr. std::unique_ptr read_tls_ticket_key_file(const std::vector &files); } // namespace shrpx #endif // SHRPX_CONFIG_H