NAME

HTTP::Promise::Headers::Forwarded - Forwarded Header Field

SYNOPSIS

use HTTP::Promise::Headers::Forwarded;
my $fwd = HTTP::Promise::Headers::Forwarded->new || 
    die( HTTP::Promise::Headers::Forwarded->error, "\n" );
$h->by( 'secret' );
$h->for( '192.0.2.43' );
$h->host( 'example.com' );
$h->proto( 'https' );

VERSION

v0.1.0

DESCRIPTION

The following is an extract from Mozilla documentation.

The Forwarded request header contains information that may be added by reverse proxy servers (load balancers, CDNs, and so on) that would otherwise be altered or lost when proxy servers are involved in the path of the request.

For example:

Forwarded: for=192.0.2.60;proto=http;by=203.0.113.43
# Values from multiple proxy servers can be appended using a comma
Forwarded: for=192.0.2.43, for=198.51.100.17

METHODS

as_string

Returns a string representation of the Forwarded object.

by

This is optional.

The interface where the request came in to the proxy server. The identifier can be:

for

This is optional.

The client that initiated the request and subsequent proxies in a chain of proxies. The identifier has the same possible values as the by directive.

host

This is optional.

The Host request header field as received by the proxy.

params

Sets or gets the array object containing all the parameters in their proper order.

properties

Sets or gets an hash or hash reference ot property-value pairs.

proto

This is optional.

Indicates which protocol was used to make the request (typically "http" or "https").

AUTHOR

Jacques Deguest <jack@deguest.jp>

SEE ALSO

See also rfc7239, section 4 and Mozilla documentation

HTTP::Promise, HTTP::Promise::Request, HTTP::Promise::Response, HTTP::Promise::Message, HTTP::Promise::Entity, HTTP::Promise::Headers, HTTP::Promise::Body, HTTP::Promise::Body::Form, HTTP::Promise::Body::Form::Data, HTTP::Promise::Body::Form::Field, HTTP::Promise::Status, HTTP::Promise::MIME, HTTP::Promise::Parser, HTTP::Promise::IO, HTTP::Promise::Stream, HTTP::Promise::Exception

COPYRIGHT & LICENSE

Copyright(c) 2022 DEGUEST Pte. Ltd.

All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

cpanm HTTP::Promise

perl -MCPAN -e shell
install HTTP::Promise