HTTP_CLIENT(3mp)

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

AUTHORS

Index Data