Merge Header filter

Purpose

The Merge Header filter combines multiple headers by the same name into a single, comma-separated value. You can use the filter with the request and the response. 

General filter information

Filter name: merge-header

Filter configuration: merge-header.cfg.xml

Release: 7.1.0.0

Prerequisites

Headers: The Merge Header filter has no required request headers.

Preceding filters: The Merge Header filter has no required preceding filters.

Standard filter order: You may use two instances of this filter.

  • If you plan use the filter for responses, place it at the beginning of the filter sequence. 
  • If you plan to use the the filter for requests, place it at the end of the filter sequence.

Basic configuration

Configurable parameters

XML schema definition

Example configuration

The merge-header.cfg.xml file contains the following elements and attributes. Add the filter to your Repose deployment through the system model configuration.

ElementsAttributes

Required/

Optional

Description
<merge-header>-RequiredSpecifies the sub-elements and attributes to define your merge-header configuration.
<request>-OptionalSpecifies a list of headers to merge for a request.
<response>-OptionalSpecifies a list of headers to merge for a response.
<header>-RequiredName of each header to merge for request or response.

Headers 

Repose splits the following headers by default:

Headers that Repose splits by default
acceptproxy-authenticateX-Impersonator-Id
accept-charsetteX-Impersonator-Name
accept-encodingtrailerX-PP-Groups

accept-language

transfer-encodingX-PP-Next-Route
allowupgradeX-PP-User
cache-controlwarningX-Roles
connectionX-AuthorizationX-Token-Expires
content-encodingX-CatalogX-TTL
content-languageX-Contact-IdX-User-Id
expectX-Default-RegionX-User-Name
pragmaX-Identity-Status 

 

Return codes and conditions

This filter does not return specific response codes. The request will simply pass through to the next filter or to the origin service.

Request headers created

The Merge Header filter does not create unique request headers; it merges multiple headers into a single, comma-separated value.