Name

http_client — Metaproxy HTTP Client Module

DESCRIPTION

This module implements HTTP client functionality. Filter frontend_net + http_client in combo - acts as a normal, non-transparent, proxy.

The element default-host of configuration specifies the default host in the remote URL. If this is set, frontend_net + http_client acts as a transparent HTTP proxy as well.

The configuration element, proxy, is optional and enables a remote HTTP proxy to be in use.

default-host

Specifies host for transparent proxy mode.

max-redirects

Maximum number of HTTP redirects. Default value is 0 (HTTP redirect disabled).

proxy

Specifies HTTP proxy for outgoing connections.

x-forwarded-for

Is a boolean value (false, true). If true, the peer IP address as seen in frontend_net will be added to x-forwarded HTTP header.

bind_host

Is a boolean value (false, true). If true, the out going TCP connection will be bound to the same as listening IP.

SCHEMA

# Metaproxy XML config file schemas
#
#   Copyright (C) Index Data
#   See the LICENSE file for details.

namespace mp = "http://indexdata.com/metaproxy"

filter_http_client =
  attribute type { "http_client" },
  attribute id { xsd:NCName }?,
  attribute name { xsd:NCName }?,
  element mp:default-host { xsd:string }?,
  element mp:max-redirects { xsd:integer }?,
  element mp:proxy { xsd:string }?,
  element mp:x-forwarded-for { xsd:boolean }?,
  element mp:bind_host { xsd:boolean }?

   

EXAMPLES

A typical configuration looks like this:

   <filter type="http_client">
    <proxy>localhost:3128</proxy>
   </filter>

   

SEE ALSO

metaproxy(1)

COPYRIGHT

Copyright (C) 2005-2023 Index Data