/* Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright ownership. * The ASF licenses this file to You under the Apache License, Version 2.0 * (the "License"); you may not use this file except in compliance with * the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "ap_config.h" #include "ap_mmn.h" #include "ap_listen.h" #include "httpd.h" #include "http_config.h" #include "http_connection.h" #include "http_protocol.h" #include "http_log.h" #include "http_main.h" #include "apr_strings.h" #include "apr_lib.h" #define APR_WANT_BYTEFUNC #include "apr_want.h" #include "apr_network_io.h" module AP_MODULE_DECLARE_DATA remoteip_module; typedef struct { /** A proxy IP mask to match */ apr_ipsubnet_t *ip; /** Flagged if internal, otherwise an external trusted proxy */ void *internal; } remoteip_proxymatch_t; typedef struct remoteip_addr_info { struct remoteip_addr_info *next; apr_sockaddr_t *addr; server_rec *source; } remoteip_addr_info; typedef struct { /** The header to retrieve a proxy-via IP list */ const char *header_name; /** A header to record the proxied IP's * (removed as the physical connection and * from the proxy-via IP header value list) */ const char *proxies_header_name; /** A list of trusted proxies, ideally configured * with the most commonly encountered listed first */ apr_array_header_t *proxymatch_ip; remoteip_addr_info *proxy_protocol_enabled; remoteip_addr_info *proxy_protocol_optional; remoteip_addr_info *proxy_protocol_disabled; /** A flag indicating whether or not proxyprotocol * is optoinal for this specific server */ int pp_optional; apr_pool_t *pool; } remoteip_config_t; typedef struct { apr_sockaddr_t *useragent_addr; char *useragent_ip; /** The list of proxy IP's ignored as remote IP's */ const char *proxy_ips; /** The remaining list of untrusted proxied remote IP's */ const char *proxied_remote; } remoteip_req_t; /* For PROXY protocol processing */ static const char *remoteip_filter_name = "REMOTEIP_INPUT"; typedef struct { char line[108]; } proxy_v1; typedef union { struct { /* for TCP/UDP over IPv4, len = 12 */ uint32_t src_addr; uint32_t dst_addr; uint16_t src_port; uint16_t dst_port; } ip4; struct { /* for TCP/UDP over IPv6, len = 36 */ uint8_t src_addr[16]; uint8_t dst_addr[16]; uint16_t src_port; uint16_t dst_port; } ip6; struct { /* for AF_UNIX sockets, len = 216 */ uint8_t src_addr[108]; uint8_t dst_addr[108]; } unx; } proxy_v2_addr; typedef struct { uint8_t sig[12]; /* hex 0D 0A 0D 0A 00 0D 0A 51 55 49 54 0A */ uint8_t ver_cmd; /* protocol version and command */ uint8_t fam; /* protocol family and address */ uint16_t len; /* number of following bytes part of the header */ proxy_v2_addr addr; } proxy_v2; typedef union { proxy_v1 v1; proxy_v2 v2; } proxy_header; static const char v2sig[12] = "\x0D\x0A\x0D\x0A\x00\x0D\x0A\x51\x55\x49\x54\x0A"; #define MIN_V1_HDR_LEN 15 #define MIN_V2_HDR_LEN 16 #define MIN_HDR_LEN MIN_V1_HDR_LEN /* XXX: Unsure if this is needed if v6 support is not available on this platform */ #ifndef INET6_ADDRSTRLEN #define INET6_ADDRSTRLEN 46 #endif typedef struct { char header[sizeof(proxy_header)]; apr_size_t rcvd; apr_size_t need; int version; ap_input_mode_t mode; apr_bucket_brigade *bb; int done; } remoteip_filter_context; /** Holds the resolved proxy info for this connection and any addition configurable parameters */ typedef struct { /** The parsed client address in native format */ apr_sockaddr_t *client_addr; /** Character representation of the client */ char *client_ip; /** Flag indicating that the PROXY header may be omitted on this connection (do not abort if it is missing). */ int proxy_protocol_optional; } remoteip_conn_config_t; typedef enum { HDR_DONE, HDR_ERROR, HDR_MISSING, HDR_NEED_MORE } remoteip_parse_status_t; static void *create_remoteip_server_config(apr_pool_t *p, server_rec *s) { remoteip_config_t *config = apr_pcalloc(p, sizeof *config); /* config->header_name = NULL; * config->proxies_header_name = NULL; */ config->proxy_protocol_enabled = NULL; config->proxy_protocol_optional = NULL; config->proxy_protocol_disabled = NULL; config->pp_optional = 0; config->pool = p; return config; } static void *merge_remoteip_server_config(apr_pool_t *p, void *globalv, void *serverv) { remoteip_config_t *global = (remoteip_config_t *) globalv; remoteip_config_t *server = (remoteip_config_t *) serverv; remoteip_config_t *config; config = (remoteip_config_t *) apr_palloc(p, sizeof(*config)); config->header_name = server->header_name ? server->header_name : global->header_name; config->proxies_header_name = server->proxies_header_name ? server->proxies_header_name : global->proxies_header_name; config->proxymatch_ip = server->proxymatch_ip ? server->proxymatch_ip : global->proxymatch_ip; config->pp_optional = server->pp_optional ? server->pp_optional : global->pp_optional; return config; } static const char *header_name_set(cmd_parms *cmd, void *dummy, const char *arg) { remoteip_config_t *config = ap_get_module_config(cmd->server->module_config, &remoteip_module); config->header_name = arg; return NULL; } static const char *proxies_header_name_set(cmd_parms *cmd, void *dummy, const char *arg) { remoteip_config_t *config = ap_get_module_config(cmd->server->module_config, &remoteip_module); config->proxies_header_name = arg; return NULL; } /* Would be quite nice if APR exported this */ /* apr:network_io/unix/sockaddr.c */ static int looks_like_ip(const char *ipstr) { if (ap_strchr_c(ipstr, ':')) { /* definitely not a hostname; assume it is intended to be an IPv6 address */ return 1; } /* simple IPv4 address string check */ while ((*ipstr == '.') || apr_isdigit(*ipstr)) ipstr++; return (*ipstr == '\0'); } static const char *proxies_set(cmd_parms *cmd, void *cfg, const char *arg) { remoteip_config_t *config = ap_get_module_config(cmd->server->module_config, &remoteip_module); remoteip_proxymatch_t *match; apr_status_t rv; char *ip = apr_pstrdup(cmd->temp_pool, arg); char *s = ap_strchr(ip, '/'); if (s) { *s++ = '\0'; } if (!config->proxymatch_ip) { config->proxymatch_ip = apr_array_make(cmd->pool, 1, sizeof(*match)); } match = (remoteip_proxymatch_t *) apr_array_push(config->proxymatch_ip); match->internal = cmd->info; if (looks_like_ip(ip)) { /* Note s may be null, that's fine (explicit host) */ rv = apr_ipsubnet_create(&match->ip, ip, s, cmd->pool); } else { apr_sockaddr_t *temp_sa; if (s) { return apr_pstrcat(cmd->pool, "RemoteIP: Error parsing IP ", arg, " the subnet /", s, " is invalid for ", cmd->cmd->name, NULL); } rv = apr_sockaddr_info_get(&temp_sa, ip, APR_UNSPEC, 0, APR_IPV4_ADDR_OK, cmd->temp_pool); while (rv == APR_SUCCESS) { apr_sockaddr_ip_get(&ip, temp_sa); rv = apr_ipsubnet_create(&match->ip, ip, NULL, cmd->pool); if (!(temp_sa = temp_sa->next)) { break; } match = (remoteip_proxymatch_t *) apr_array_push(config->proxymatch_ip); match->internal = cmd->info; } } if (rv != APR_SUCCESS) { return apr_psprintf(cmd->pool, "RemoteIP: Error parsing IP %s (%pm error) for %s", arg, &rv, cmd->cmd->name); } return NULL; } static const char *proxylist_read(cmd_parms *cmd, void *cfg, const char *filename) { char lbuf[MAX_STRING_LEN]; char *arg; const char *args; const char *errmsg; ap_configfile_t *cfp; apr_status_t rv; filename = ap_server_root_relative(cmd->temp_pool, filename); rv = ap_pcfg_openfile(&cfp, cmd->temp_pool, filename); if (rv != APR_SUCCESS) { return apr_psprintf(cmd->pool, "%s: Could not open file %s: %pm", cmd->cmd->name, filename, &rv); } while (!(ap_cfg_getline(lbuf, MAX_STRING_LEN, cfp))) { args = lbuf; while (*(arg = ap_getword_conf(cmd->temp_pool, &args)) != '\0') { if (*arg == '#') { break; } errmsg = proxies_set(cmd, cfg, arg); if (errmsg) { ap_cfg_closefile(cfp); errmsg = apr_psprintf(cmd->pool, "%s at line %d of %s", errmsg, cfp->line_number, filename); return errmsg; } } } ap_cfg_closefile(cfp); return NULL; } /** Similar apr_sockaddr_equal, except that it compares ports too. */ static int remoteip_sockaddr_equal(apr_sockaddr_t *addr1, apr_sockaddr_t *addr2) { return (addr1->port == addr2->port && apr_sockaddr_equal(addr1, addr2)); } /** Similar remoteip_sockaddr_equal, except that it handles wildcard addresses * and ports too. */ static int remoteip_sockaddr_compat(apr_sockaddr_t *addr1, apr_sockaddr_t *addr2) { /* test exact address equality */ if (apr_sockaddr_equal(addr1, addr2) && (addr1->port == addr2->port || addr1->port == 0 || addr2->port == 0)) { return 1; } /* test address wildcards */ if (apr_sockaddr_is_wildcard(addr1) && (addr1->port == 0 || addr1->port == addr2->port)) { return 1; } if (apr_sockaddr_is_wildcard(addr2) && (addr2->port == 0 || addr2->port == addr1->port)) { return 1; } return 0; } static int remoteip_addr_in_list(remoteip_addr_info *list, apr_sockaddr_t *addr) { for (; list; list = list->next) { if (remoteip_sockaddr_compat(list->addr, addr)) { return 1; } } return 0; } static void remoteip_warn_enable_conflict(remoteip_addr_info *prev, server_rec *new, const char* arg) { char buf[INET6_ADDRSTRLEN]; apr_sockaddr_ip_getbuf(buf, sizeof(buf), prev->addr); ap_log_error(APLOG_MARK, APLOG_NOTICE, 0, new, APLOGNO(03491) "RemoteIPProxyProtocol: previous setting for %s:%hu from virtual " "host {%s:%hu in %s} is being overriden by virtual host " "{%s:%hu in %s}; new setting is '%s'", buf, prev->addr->port, prev->source->server_hostname, prev->source->addrs->host_port, prev->source->defn_name, new->server_hostname, new->addrs->host_port, new->defn_name, arg); } static const char *remoteip_enable_proxy_protocol(cmd_parms *cmd, void *config, const char *arg) { remoteip_config_t *global_conf; remoteip_config_t *server_conf; server_addr_rec *addr; remoteip_addr_info **add; int list_len = 2; remoteip_addr_info **rem_list[list_len]; remoteip_addr_info *list; int i; global_conf = ap_get_module_config(ap_server_conf->module_config, &remoteip_module); server_conf = ap_get_module_config(cmd->server->module_config, &remoteip_module); if (strcasecmp(arg, "On") == 0) { add = &global_conf->proxy_protocol_enabled; rem_list[0] = &global_conf->proxy_protocol_optional; rem_list[1] = &global_conf->proxy_protocol_disabled; } else if (strcasecmp(arg, "Optional") == 0) { add = &global_conf->proxy_protocol_optional; rem_list[0] = &global_conf->proxy_protocol_enabled; rem_list[1] = &global_conf->proxy_protocol_disabled; server_conf->pp_optional = 1; } else if (strcasecmp(arg, "Off") == 0 ) { add = &global_conf->proxy_protocol_disabled; rem_list[0] = &global_conf->proxy_protocol_enabled; rem_list[1] = &global_conf->proxy_protocol_optional; } else { return apr_pstrcat(cmd->pool, "Unrecognized option for RemoteIPProxyProtocol `%s'", arg, NULL); } for (addr = cmd->server->addrs; addr; addr = addr->next) { /* remove address from other lists */ for (i = 0; i < list_len ; i++) { remoteip_addr_info **rem = rem_list[i]; if (*rem) { if (remoteip_sockaddr_equal((*rem)->addr, addr->host_addr)) { remoteip_warn_enable_conflict(*rem, cmd->server, arg); *rem = (*rem)->next; } else { for (list = *rem; list->next; list = list->next) { if (remoteip_sockaddr_equal(list->next->addr, addr->host_addr)) { remoteip_warn_enable_conflict(list->next, cmd->server, arg); list->next = list->next->next; break; } } } } } /* add address to desired list */ if (!remoteip_addr_in_list(*add, addr->host_addr)) { remoteip_addr_info *info = apr_palloc(global_conf->pool, sizeof(*info)); info->addr = addr->host_addr; info->source = cmd->server; info->next = *add; *add = info; } } return NULL; } static int remoteip_hook_pre_config(apr_pool_t *pconf, apr_pool_t *plog, apr_pool_t *ptemp) { remoteip_config_t *config = (remoteip_config_t *) create_remoteip_server_config(pconf, NULL); ap_set_module_config(ap_server_conf->module_config, &remoteip_module, config); return OK; } static int remoteip_hook_post_config(apr_pool_t *pconf, apr_pool_t *plog, apr_pool_t *ptemp, server_rec *s) { remoteip_config_t *conf; remoteip_addr_info *info; char buf[INET6_ADDRSTRLEN]; conf = ap_get_module_config(ap_server_conf->module_config, &remoteip_module); for (info = conf->proxy_protocol_enabled; info; info = info->next) { apr_sockaddr_ip_getbuf(buf, sizeof(buf), info->addr); ap_log_error(APLOG_MARK, APLOG_NOTICE, 0, s, APLOGNO(03492) "RemoteIPProxyProtocol: enabled on %s:%hu", buf, info->addr->port); } for (info = conf->proxy_protocol_optional; info; info = info->next) { apr_sockaddr_ip_getbuf(buf, sizeof(buf), info->addr); ap_log_error(APLOG_MARK, APLOG_NOTICE, 0, s, APLOGNO(03493) "RemoteIPProxyProtocol: optional on %s:%hu", buf, info->addr->port); } for (info = conf->proxy_protocol_disabled; info; info = info->next) { apr_sockaddr_ip_getbuf(buf, sizeof(buf), info->addr); ap_log_error(APLOG_MARK, APLOG_NOTICE, 0, s, APLOGNO(03494) "RemoteIPProxyProtocol: disabled on %s:%hu", buf, info->addr->port); } return OK; } static int remoteip_modify_request(request_rec *r) { conn_rec *c = r->connection; remoteip_config_t *config = (remoteip_config_t *) ap_get_module_config(r->server->module_config, &remoteip_module); remoteip_conn_config_t *conn_config = (remoteip_conn_config_t *) ap_get_module_config(r->connection->conn_config, &remoteip_module); remoteip_req_t *req = NULL; apr_sockaddr_t *temp_sa; apr_status_t rv; char *remote; char *proxy_ips = NULL; char *parse_remote; char *eos; unsigned char *addrbyte; /* If no RemoteIPInternalProxy, RemoteIPInternalProxyList, RemoteIPTrustedProxy or RemoteIPTrustedProxyList directive is configured, all proxies will be considered as external trusted proxies. */ void *internal = NULL; /* No header defined or results from our input filter */ if (!config->header_name && !conn_config) { return DECLINED; } /* Easy parsing case - just position the data we already have from PROXY protocol handling allowing it to take precedence and return */ if (conn_config) { /* We may have gotten here if processing was optional - check for that */ if (!conn_config->client_addr) { if (config->pp_optional) { ap_log_rerror(APLOG_MARK, APLOG_DEBUG, 0, r, APLOGNO(03495) "RemoteIPProxyProtocol data is missing, but was optional. Allowing request."); return OK; } else { ap_log_rerror(APLOG_MARK, APLOG_WARNING, 0, r, APLOGNO(03496) "RemoteIPProxyProtocol data is missing, but required! Aborting request."); return HTTP_BAD_REQUEST; } } r->useragent_addr = conn_config->client_addr; r->useragent_ip = conn_config->client_ip; ap_log_rerror(APLOG_MARK, APLOG_TRACE1, 0, r, "Using %s as client's IP from PROXY protocol", r->useragent_ip); return OK; } if (config->proxymatch_ip) { /* This indicates that a RemoteIPInternalProxy, RemoteIPInternalProxyList, RemoteIPTrustedProxy or RemoteIPTrustedProxyList directive is configured. In this case, default to internal proxy. */ internal = (void *) 1; } remote = (char *) apr_table_get(r->headers_in, config->header_name); if (!remote) { return OK; } remote = apr_pstrdup(r->pool, remote); temp_sa = r->useragent_addr ? r->useragent_addr : c->client_addr; while (remote) { /* verify user agent IP against the trusted proxy list */ if (config->proxymatch_ip) { int i; remoteip_proxymatch_t *match; match = (remoteip_proxymatch_t *)config->proxymatch_ip->elts; for (i = 0; i < config->proxymatch_ip->nelts; ++i) { if (apr_ipsubnet_test(match[i].ip, temp_sa)) { if (internal) { /* Allow an internal proxy to present an external proxy, but do not allow an external proxy to present an internal proxy. In this case, the presented internal proxy will be considered external. */ internal = match[i].internal; } break; } } if (i && i >= config->proxymatch_ip->nelts) { break; } } if ((parse_remote = strrchr(remote, ',')) == NULL) { parse_remote = remote; remote = NULL; } else { *(parse_remote++) = '\0'; } while (*parse_remote == ' ') { ++parse_remote; } eos = parse_remote + strlen(parse_remote) - 1; while (eos >= parse_remote && *eos == ' ') { *(eos--) = '\0'; } if (eos < parse_remote) { if (remote) { *(remote + strlen(remote)) = ','; } else { remote = parse_remote; } break; } /* We map as IPv4 rather than IPv6 for equivalent host names * or IPV4OVERIPV6 */ rv = apr_sockaddr_info_get(&temp_sa, parse_remote, APR_UNSPEC, temp_sa->port, APR_IPV4_ADDR_OK, r->pool); if (rv != APR_SUCCESS) { ap_log_rerror(APLOG_MARK, APLOG_DEBUG, rv, r, APLOGNO(01568) "RemoteIP: Header %s value of %s cannot be parsed " "as a client IP", config->header_name, parse_remote); if (remote) { *(remote + strlen(remote)) = ','; } else { remote = parse_remote; } break; } addrbyte = (unsigned char *) &temp_sa->sa.sin.sin_addr; /* For intranet (Internal proxies) ignore all restrictions below */ if (!internal && ((temp_sa->family == APR_INET /* For internet (non-Internal proxies) deny all * RFC3330 designated local/private subnets: * 10.0.0.0/8 169.254.0.0/16 192.168.0.0/16 * 127.0.0.0/8 172.16.0.0/12 */ && (addrbyte[0] == 10 || addrbyte[0] == 127 || (addrbyte[0] == 169 && addrbyte[1] == 254) || (addrbyte[0] == 172 && (addrbyte[1] & 0xf0) == 16) || (addrbyte[0] == 192 && addrbyte[1] == 168))) #if APR_HAVE_IPV6 || (temp_sa->family == APR_INET6 /* For internet (non-Internal proxies) we translated * IPv4-over-IPv6-mapped addresses as IPv4, above. * Accept only Global Unicast 2000::/3 defined by RFC4291 */ && ((temp_sa->sa.sin6.sin6_addr.s6_addr[0] & 0xe0) != 0x20)) #endif )) { ap_log_rerror(APLOG_MARK, APLOG_DEBUG, rv, r, APLOGNO(01569) "RemoteIP: Header %s value of %s appears to be " "a private IP or nonsensical. Ignored", config->header_name, parse_remote); if (remote) { *(remote + strlen(remote)) = ','; } else { remote = parse_remote; } break; } /* save away our results */ if (!req) { req = (remoteip_req_t *) apr_palloc(r->pool, sizeof(remoteip_req_t)); req->useragent_ip = r->useragent_ip; } /* Set useragent_ip string */ if (!internal) { if (proxy_ips) { proxy_ips = apr_pstrcat(r->pool, proxy_ips, ", ", req->useragent_ip, NULL); } else { proxy_ips = req->useragent_ip; } } req->useragent_addr = temp_sa; apr_sockaddr_ip_get(&req->useragent_ip, req->useragent_addr); } /* Nothing happened? */ if (!req) { return OK; } /* Port is not known so set it to zero; otherwise it can be misleading */ req->useragent_addr->port = 0; req->proxied_remote = remote; req->proxy_ips = proxy_ips; if (req->proxied_remote) { apr_table_setn(r->headers_in, config->header_name, req->proxied_remote); } else { apr_table_unset(r->headers_in, config->header_name); } if (req->proxy_ips) { apr_table_setn(r->notes, "remoteip-proxy-ip-list", req->proxy_ips); if (config->proxies_header_name) { apr_table_setn(r->headers_in, config->proxies_header_name, req->proxy_ips); } } r->useragent_addr = req->useragent_addr; r->useragent_ip = req->useragent_ip; ap_log_rerror(APLOG_MARK, APLOG_TRACE1, 0, r, req->proxy_ips ? "Using %s as client's IP by proxies %s" : "Using %s as client's IP by internal proxies%s", req->useragent_ip, (req->proxy_ips ? req->proxy_ips : "")); return OK; } static int remoteip_is_server_port(apr_port_t port) { ap_listen_rec *lr; for (lr = ap_listeners; lr; lr = lr->next) { if (lr->bind_addr && lr->bind_addr->port == port) { return 1; } } return 0; } /* * Human readable format: * PROXY {TCP4|TCP6|UNKNOWN} */ static remoteip_parse_status_t remoteip_process_v1_header(conn_rec *c, remoteip_conn_config_t *conn_conf, proxy_header *hdr, apr_size_t len, apr_size_t *hdr_len) { char *end, *word, *host, *valid_addr_chars, *saveptr; char buf[sizeof(hdr->v1.line)]; apr_port_t port; apr_status_t ret; apr_int32_t family; #define GET_NEXT_WORD(field) \ word = apr_strtok(NULL, " ", &saveptr); \ if (!word) { \ ap_log_cerror(APLOG_MARK, APLOG_ERR, 0, c, APLOGNO(03497) \ "RemoteIPProxyProtocol: no " field " found in header '%s'", \ hdr->v1.line); \ return HDR_ERROR; \ } end = memchr(hdr->v1.line, '\r', len - 1); if (!end || end[1] != '\n') { return HDR_NEED_MORE; /* partial or invalid header */ } *end = '\0'; *hdr_len = end + 2 - hdr->v1.line; /* skip header + CRLF */ /* parse in separate buffer so have the original for error messages */ strcpy(buf, hdr->v1.line); apr_strtok(buf, " ", &saveptr); /* parse family */ GET_NEXT_WORD("family") if (strcmp(word, "UNKNOWN") == 0) { conn_conf->client_addr = c->client_addr; conn_conf->client_ip = c->client_ip; return HDR_DONE; } else if (strcmp(word, "TCP4") == 0) { family = APR_INET; valid_addr_chars = "0123456789."; } else if (strcmp(word, "TCP6") == 0) { #if APR_HAVE_IPV6 family = APR_INET6; valid_addr_chars = "0123456789abcdefABCDEF:"; #else ap_log_cerror(APLOG_MARK, APLOG_ERR, 0, c, APLOGNO(03498) "RemoteIPProxyProtocol: Unable to parse v6 address - APR is not compiled with IPv6 support", word, hdr->v1.line); return HDR_ERROR; #endif } else { ap_log_cerror(APLOG_MARK, APLOG_ERR, 0, c, APLOGNO(03499) "RemoteIPProxyProtocol: unknown family '%s' in header '%s'", word, hdr->v1.line); return HDR_ERROR; } /* parse client-addr */ GET_NEXT_WORD("client-address") if (strspn(word, valid_addr_chars) != strlen(word)) { ap_log_cerror(APLOG_MARK, APLOG_ERR, 0, c, APLOGNO(03500) "RemoteIPProxyProtocol: invalid client-address '%s' found in " "header '%s'", word, hdr->v1.line); return HDR_ERROR; } host = word; /* parse dest-addr */ GET_NEXT_WORD("destination-address") /* parse client-port */ GET_NEXT_WORD("client-port") if (sscanf(word, "%hu", &port) != 1) { ap_log_cerror(APLOG_MARK, APLOG_ERR, 0, c, APLOGNO(03501) "RemoteIPProxyProtocol: error parsing port '%s' in header '%s'", word, hdr->v1.line); return HDR_ERROR; } /* parse dest-port */ /* GET_NEXT_WORD("destination-port") - no-op since we don't care about it */ /* create a socketaddr from the info */ ret = apr_sockaddr_info_get(&conn_conf->client_addr, host, family, port, 0, c->pool); if (ret != APR_SUCCESS) { conn_conf->client_addr = NULL; ap_log_cerror(APLOG_MARK, APLOG_ERR, ret, c, APLOGNO(03502) "RemoteIPProxyProtocol: error converting family '%d', host '%s'," " and port '%hu' to sockaddr; header was '%s'", family, host, port, hdr->v1.line); return HDR_ERROR; } conn_conf->client_ip = apr_pstrdup(c->pool, host); return HDR_DONE; } /** Add our filter to the connection if it is requested */ static int remoteip_hook_pre_connection(conn_rec *c, void *csd) { remoteip_config_t *conf; remoteip_conn_config_t *conn_conf; int optional; conf = ap_get_module_config(ap_server_conf->module_config, &remoteip_module); /* Used twice - do the check only once */ optional = remoteip_addr_in_list(conf->proxy_protocol_optional, c->local_addr); /* check if we're enabled for this connection */ if ((!remoteip_addr_in_list(conf->proxy_protocol_enabled, c->local_addr) && !optional ) || remoteip_addr_in_list(conf->proxy_protocol_disabled, c->local_addr)) { return DECLINED; } /* mod_proxy creates outgoing connections - we don't want those */ if (!remoteip_is_server_port(c->local_addr->port)) { return DECLINED; } /* add our filter */ if (!ap_add_input_filter(remoteip_filter_name, NULL, NULL, c)) { /* XXX: Shouldn't this WARN in log? */ return DECLINED; } ap_log_cerror(APLOG_MARK, APLOG_DEBUG, 0, c, APLOGNO(03503) "RemoteIPProxyProtocol: enabled on connection to %s:%hu", c->local_ip, c->local_addr->port); /* this holds the resolved proxy info for this connection */ conn_conf = apr_pcalloc(c->pool, sizeof(*conn_conf)); /* Propagate the optional flag so the connection handler knows not to abort if the header is mising. NOTE: This means we must check after we read the request that the header was NOT optional, too. */ conn_conf->proxy_protocol_optional = optional; ap_set_module_config(c->conn_config, &remoteip_module, conn_conf); return OK; } /* Binary format: * * sig = \x0D \x0A \x0D \x0A \x00 \x0D \x0A \x51 \x55 \x49 \x54 \x0A * cmd = <4-bits-version><4-bits-command> * 4-bits-version = \x02 * 4-bits-command = {\x00|\x01} (\x00 = LOCAL: discard con info; \x01 = PROXY) * proto = <4-bits-family><4-bits-protocol> * 4-bits-family = {\x00|\x01|\x02|\x03} (AF_UNSPEC, AF_INET, AF_INET6, AF_UNIX) * 4-bits-protocol = {\x00|\x01|\x02} (UNSPEC, STREAM, DGRAM) */ static remoteip_parse_status_t remoteip_process_v2_header(conn_rec *c, remoteip_conn_config_t *conn_conf, proxy_header *hdr) { apr_status_t ret; switch (hdr->v2.ver_cmd & 0xF) { case 0x01: /* PROXY command */ switch (hdr->v2.fam) { case 0x11: /* TCPv4 */ ret = apr_sockaddr_info_get(&conn_conf->client_addr, NULL, APR_INET, ntohs(hdr->v2.addr.ip4.src_port), 0, c->pool); if (ret != APR_SUCCESS) { conn_conf->client_addr = NULL; ap_log_cerror(APLOG_MARK, APLOG_ERR, ret, c, APLOGNO(03504) "RemoteIPPProxyProtocol: error creating sockaddr"); return HDR_ERROR; } conn_conf->client_addr->sa.sin.sin_addr.s_addr = hdr->v2.addr.ip4.src_addr; break; case 0x21: /* TCPv6 */ #if APR_HAVE_IPV6 ret = apr_sockaddr_info_get(&conn_conf->client_addr, NULL, APR_INET6, ntohs(hdr->v2.addr.ip6.src_port), 0, c->pool); if (ret != APR_SUCCESS) { conn_conf->client_addr = NULL; ap_log_cerror(APLOG_MARK, APLOG_ERR, ret, c, APLOGNO(03505) "RemoteIPProxyProtocol: error creating sockaddr"); return HDR_ERROR; } memcpy(&conn_conf->client_addr->sa.sin6.sin6_addr.s6_addr, hdr->v2.addr.ip6.src_addr, 16); break; #else ap_log_cerror(APLOG_MARK, APLOG_ERR, 0, c, APLOGNO(03506) "RemoteIPProxyProtocol: APR is not compiled with IPv6 support"); return HDR_ERROR; #endif default: /* unsupported protocol, keep local connection address */ return HDR_DONE; } break; /* we got a sockaddr now */ case 0x00: /* LOCAL command */ /* keep local connection address for LOCAL */ return HDR_DONE; default: /* not a supported command */ ap_log_cerror(APLOG_MARK, APLOG_ERR, 0, c, APLOGNO(03507) "RemoteIPProxyProtocol: unsupported command %.2hx", (unsigned short)hdr->v2.ver_cmd); return HDR_ERROR; } /* got address - compute the client_ip from it */ ret = apr_sockaddr_ip_get(&conn_conf->client_ip, conn_conf->client_addr); if (ret != APR_SUCCESS) { conn_conf->client_addr = NULL; ap_log_cerror(APLOG_MARK, APLOG_ERR, ret, c, APLOGNO(03508) "RemoteIPProxyProtocol: error converting address to string"); return HDR_ERROR; } return HDR_DONE; } /** Determine if this is a v1 or v2 PROXY header. */ static int remoteip_determine_version(conn_rec *c, const char *ptr) { proxy_header *hdr = (proxy_header *) ptr; /* assert len >= 14 */ if (memcmp(&hdr->v2, v2sig, sizeof(v2sig)) == 0 && (hdr->v2.ver_cmd & 0xF0) == 0x20) { return 2; } else if (memcmp(hdr->v1.line, "PROXY ", 6) == 0) { return 1; } else { return -1; } } /* Capture the first bytes on the protocol and parse the PROXY protocol header. * Removes itself when the header is complete. */ static apr_status_t remoteip_input_filter(ap_filter_t *f, apr_bucket_brigade *bb_out, ap_input_mode_t mode, apr_read_type_e block, apr_off_t readbytes) { apr_status_t ret; remoteip_filter_context *ctx = f->ctx; remoteip_conn_config_t *conn_conf; apr_bucket *b; remoteip_parse_status_t psts; const char *ptr; apr_size_t len; if (f->c->aborted) { return APR_ECONNABORTED; } /* allocate/retrieve the context that holds our header */ if (!ctx) { ctx = f->ctx = apr_palloc(f->c->pool, sizeof(*ctx)); ctx->rcvd = 0; ctx->need = MIN_HDR_LEN; ctx->version = 0; ctx->mode = AP_MODE_READBYTES; ctx->bb = apr_brigade_create(f->c->pool, f->c->bucket_alloc); ctx->done = 0; } if (ctx->done) { /* Note: because we're a connection filter we can't remove ourselves * when we're done, so we have to stay in the chain and just go into * passthrough mode. */ return ap_get_brigade(f->next, bb_out, mode, block, readbytes); } conn_conf = ap_get_module_config(f->c->conn_config, &remoteip_module); /* try to read a header's worth of data */ while (!ctx->done) { if (APR_BRIGADE_EMPTY(ctx->bb)) { ret = ap_get_brigade(f->next, ctx->bb, ctx->mode, block, ctx->need - ctx->rcvd); if (ret != APR_SUCCESS) { return ret; } } if (APR_BRIGADE_EMPTY(ctx->bb)) { return APR_EOF; } while (!ctx->done && !APR_BRIGADE_EMPTY(ctx->bb)) { b = APR_BRIGADE_FIRST(ctx->bb); ret = apr_bucket_read(b, &ptr, &len, block); if (APR_STATUS_IS_EAGAIN(ret) && block == APR_NONBLOCK_READ) { return APR_SUCCESS; } if (ret != APR_SUCCESS) { return ret; } memcpy(ctx->header + ctx->rcvd, ptr, len); ctx->rcvd += len; /* Remove instead of delete - we may put this bucket back into bb_out if the header was optional and we pass down the chain */ APR_BUCKET_REMOVE(b); psts = HDR_NEED_MORE; if (ctx->version == 0) { /* reading initial chunk */ if (ctx->rcvd >= MIN_HDR_LEN) { ctx->version = remoteip_determine_version(f->c, ctx->header); if (ctx->version < 0) { psts = HDR_MISSING; } else if (ctx->version == 1) { ctx->mode = AP_MODE_GETLINE; ctx->need = sizeof(proxy_v1); } else if (ctx->version == 2) { ctx->need = MIN_V2_HDR_LEN; } } } else if (ctx->version == 1) { psts = remoteip_process_v1_header(f->c, conn_conf, (proxy_header *) ctx->header, ctx->rcvd, &ctx->need); } else if (ctx->version == 2) { if (ctx->rcvd >= MIN_V2_HDR_LEN) { ctx->need = MIN_V2_HDR_LEN + ntohs(((proxy_header *) ctx->header)->v2.len); } if (ctx->rcvd >= ctx->need) { psts = remoteip_process_v2_header(f->c, conn_conf, (proxy_header *) ctx->header); } } else { ap_log_cerror(APLOG_MARK, APLOG_ERR, 0, f->c, APLOGNO(03509) "RemoteIPProxyProtocol: internal error: unknown version " "%d", ctx->version); f->c->aborted = 1; apr_bucket_delete(b); apr_brigade_destroy(ctx->bb); return APR_ECONNABORTED; } switch (psts) { case HDR_MISSING: if (conn_conf->proxy_protocol_optional) { /* Same as DONE, but don't delete the bucket. Rather, put it back into the brigade and move the request along the stack */ ctx->done = 1; APR_BRIGADE_INSERT_HEAD(bb_out, b); return ap_pass_brigade(f->next, ctx->bb); } else { ap_log_cerror(APLOG_MARK, APLOG_ERR, 0, f->c, APLOGNO(03510) "RemoteIPProxyProtocol: no valid PROXY header found"); /* fall through to error case */ } case HDR_ERROR: f->c->aborted = 1; apr_bucket_delete(b); apr_brigade_destroy(ctx->bb); return APR_ECONNABORTED; case HDR_DONE: apr_bucket_delete(b); ctx->done = 1; break; case HDR_NEED_MORE: /* It is safe to delete this bucket if we get here since we know that we are definitely processing a header (we've read enough to know if the signatures exist on the line) */ apr_bucket_delete(b); break; } } } /* we only get here when done == 1 */ if (psts == HDR_DONE) { ap_log_cerror(APLOG_MARK, APLOG_DEBUG, 0, f->c, APLOGNO(03511) "RemoteIPProxyProtocol: received valid PROXY header: %s:%hu", conn_conf->client_ip, conn_conf->client_addr->port); } else { ap_log_cerror(APLOG_MARK, APLOG_DEBUG, 0, f->c, APLOGNO(03512) "RemoteIPProxyProtocol: PROXY header was missing"); } if (ctx->rcvd > ctx->need || !APR_BRIGADE_EMPTY(ctx->bb)) { ap_log_cerror(APLOG_MARK, APLOG_ERR, 0, f->c, APLOGNO(03513) "RemoteIPProxyProtocol: internal error: have data left over; " " need=%lu, rcvd=%lu, brigade-empty=%d", ctx->need, ctx->rcvd, APR_BRIGADE_EMPTY(ctx->bb)); f->c->aborted = 1; apr_brigade_destroy(ctx->bb); return APR_ECONNABORTED; } /* clean up */ apr_brigade_destroy(ctx->bb); ctx->bb = NULL; /* now do the real read for the upper layer */ return ap_get_brigade(f->next, bb_out, mode, block, readbytes); } static const command_rec remoteip_cmds[] = { AP_INIT_TAKE1("RemoteIPHeader", header_name_set, NULL, RSRC_CONF, "Specifies a request header to trust as the client IP, " "e.g. X-Forwarded-For"), AP_INIT_TAKE1("RemoteIPProxiesHeader", proxies_header_name_set, NULL, RSRC_CONF, "Specifies a request header to record proxy IP's, " "e.g. X-Forwarded-By; if not given then do not record"), AP_INIT_ITERATE("RemoteIPTrustedProxy", proxies_set, 0, RSRC_CONF, "Specifies one or more proxies which are trusted " "to present IP headers"), AP_INIT_ITERATE("RemoteIPInternalProxy", proxies_set, (void*)1, RSRC_CONF, "Specifies one or more internal (transparent) proxies " "which are trusted to present IP headers"), AP_INIT_TAKE1("RemoteIPTrustedProxyList", proxylist_read, 0, RSRC_CONF | EXEC_ON_READ, "The filename to read the list of trusted proxies, " "see the RemoteIPTrustedProxy directive"), AP_INIT_TAKE1("RemoteIPInternalProxyList", proxylist_read, (void*)1, RSRC_CONF | EXEC_ON_READ, "The filename to read the list of internal proxies, " "see the RemoteIPInternalProxy directive"), AP_INIT_TAKE1("RemoteIPProxyProtocol", remoteip_enable_proxy_protocol, NULL, RSRC_CONF, "Enable proxy-protocol handling (`on', `off')"), { NULL } }; static void register_hooks(apr_pool_t *p) { /* mod_ssl is CONNECTION + 5, so we want something higher (earlier); * mod_reqtimeout is CONNECTION + 8, so we want something lower (later) */ ap_register_input_filter(remoteip_filter_name, remoteip_input_filter, NULL, AP_FTYPE_CONNECTION + 7); ap_hook_pre_config(remoteip_hook_pre_config, NULL, NULL, APR_HOOK_MIDDLE); ap_hook_post_config(remoteip_hook_post_config, NULL, NULL, APR_HOOK_MIDDLE); ap_hook_pre_connection(remoteip_hook_pre_connection, NULL, NULL, APR_HOOK_MIDDLE); ap_hook_post_read_request(remoteip_modify_request, NULL, NULL, APR_HOOK_FIRST); } AP_DECLARE_MODULE(remoteip) = { STANDARD20_MODULE_STUFF, NULL, /* create per-directory config structure */ NULL, /* merge per-directory config structures */ create_remoteip_server_config, /* create per-server config structure */ merge_remoteip_server_config, /* merge per-server config structures */ remoteip_cmds, /* command apr_table_t */ register_hooks /* register hooks */ };