Customize macro field names

We can customize the names that WebSEAL uses for the Location URL macros in the generated query strings. To configure these values, place a colon after the macro name followed by the customized name.

For example:

[local-response-macros]
macro = TAM_OP:myOperation
#macro = USERNAME
#macro = METHOD
#macro = REFERER
#macro = HOSTNAME
#macro = AUTHNLEVEL
#macro = FAILREASON
#macro = PROTOCOL
#macro = ERROR_CODE
#macro = ERROR_TEXT
#macro = HTTPHDR{header_name}#macro = CREDATTR{name}macro = URL:destination

This example configuration causes WebSEAL to generate a Location URI containing the URL and TAM_OP macros. WebSEAL inserts the specified custom values, rather than the WebSEAL macro name, into the query string. For this example, the generated Location URI is similar to the following query string:

Location: https://webseal/jct/handler-svr/handler?myOperation=login&destination
=%2FjctB%2Fresource.html

If we configure a custom name for the HTTPHDR macro then the name of the header (header_name) is not included in the query string. For example, consider the following example entry in the [local-response-macros] stanza:

macro = HTTPHDR{Host}:myHost

The resulting query string looks similar to the following example:

Location: https://webseal/jct/handler-svr/handler?myOperation=login&destination=
%2FjctB%2Fresource.html&myHost=webseal 

We can configure multiple HTTPHDR entries to be included in the query string. We can customize the macro field names for each of these entries. WebSEAL inserts the TAM_OP macro in all local redirect responses regardless of Whether it is included in the configuration file. We can configure the name that WebSEAL uses for this macro by including a customized name in the configuration file.

Parent topic: Macro support for local response redirection