header-data
Use the header-data stanza entry to add HTTP headers to the request that WebSEAL sends to junctioned applications.
Syntax
<header-data> = [+]<header-name>Description
Controls the addition of HTTP headers into the request that is passed to junctioned applications.
To include the same <header-data> in different headers, specify multiple entries with the same <header-data> value.
Note: Do
not include more than one entry with the same <header-name> value.
The <header-name> values must be unique. If
there is more than one entry for a particular <header-name>,
WebSEAL processes the last entry for that <header-name>.
Any preceding entries are disregarded.
Options
- <header-data>
- The type of data that WebSEAL adds to the <header-name> header
of the request. The valid values for this entry are as follows:
- server-name
- The Security Access Manager authorization server name for the WebSEAL server. This name is the name of the authorization API administration server that is used in the server task commands.
- client-ip-v4
- The IPv4 address of the client of this request.
- client-ip-v6
- The IPv6 address of the client of this request.
- client-port
- The port that is used by the client of this request. This port is the client source port and not the destination port.
- host-name
- The host name of the WebSEAL server. WebSEAL obtains this host name from the web-host-name configuration entry in the [server] stanza if specified. Otherwise, WebSEAL returns the host name of the server itself.
- httphdr{<name>}
- An HTTP header from the request as specified by the <name> field. If the HTTP header is not found in the request, WebSEAL uses the value in the [server] tag-value-missing-attr-tag configuration entry as the value for the header.
- <header-name>
- The name of the HTTP header that holds the data. The <header-name> can be prefixed with the plus (+) character if you want to append to any existing header instead of overwriting the existing header. Valid strings are limited to the following characters: A-Z, a-z, 0–9, hyphen ( - ), or underscore ( _ ).
Usage
This stanza entry is required.
Default value
server-name = iv_server_name
Example
server-name = iv_server_nameIn
this example, WebSEAL passes the following header and value to the
junction if the WebSEAL instance is default-webseald-diamond.example.com:
iv_server_name:default-webseald-diamond.example.comOther example entries:
client-ip-v4 = +X-Forwarded-For
client-ip-v4 = X-Header
httphdr{host} = X-Forwarded-Host
host-name = X-Forwarded-Server