> ACS x-header Format Configuration Mode Commands
> The ACS x-header Format Configuration Mode is used to create and configure extension-header (x-header) formats.
> Important: This feature is license dependent. Please contact your Cisco sales representative for more information.
> Important: The commands or keywords/variables that are available are dependent on platform type, product version, and installed license(s).
> end
> Exits the current configuration mode and returns to the Exec mode.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> end
> Usage
> Use this command to return to the Exec mode.
> exit
> Exits the current mode and returns to the parent configuration mode.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> exit
> Usage
> Use this command to return to the parent configuration mode.
> insert
> This command allows you to configure the x-header fields to be inserted in HTTP/WSP GET and POST request packets.
> Important: This command is license dependent. Please contact your Cisco accounts representative for more information.
> Product
> ACS
> Privilege
> Security Administrator, Administrator
> Syntax
> In StarOS 8.0:
> insert xheader_field_name { string-constant xheader_field_value | variable { bearer { 3gpp charging-id | ggsn-address | imsi | radius-calling-station-id | sgsn-address | sn-rulebase | subscriber-ip-address } | http { host | url } }
> no insert xheader_field_name
> In StarOS 8.1, StarOS 9.0, and later releases:
> insert xheader_field_name { string-constant xheader_field_value | variable { bearer { 3gpp { apn | charging-characteristics | charging-id | imei | imsi | qos | rat-type | s-mcc-mnc | sgsn-address } | acr | customer-id | ggsn-address | mdn | msisdn-no-cc | radius-calling-station-id | session-id | sn-rulebase | subscriber-ip-address | username } [ encrypt ] | http { host | url } }
> no insert xheader_field_name
> no
> If previously configured, removes the specified x-header field configuration.
> xheader_field_name
> Specifies the x-header field name to be inserted in the packets.
> xheader_field_name must be an alphanumeric string of 1 through 31 characters.
> Up to ten fields can be inserted in each x-header format.
> string-constant xheader_field_value
> Specifies constant a string value for x-header field to be inserted in the packets.
> xheader_field_value must be the x-header field value, and must be an alphanumeric string of 1 through 63 characters.
> variable
> Specifies name of the x-header field whose value must be inserted in the packets.
> bearer { 3gpp { apn | charging-characteristics | charging-id | imei | imsi | qos | rat-type | s-mcc-mnc | sgsn-address } | acr | customer-id | ggsn-address | mdn | msisdn-no-cc | radius-calling-station-id | session-id | sn-rulebase | subscriber-ip-address | username } [ encrypt ]
> Specifies value of x-header field to be inserted:

> • | 3gpp: 3GPP service.

> • | apn: APN of the bearer flow. This field is deprecated from under bearer apn and has been added within bearer 3gpp apn.

> • | charging-characteristics: Charging characteristics of the bearer flow.

> • | charging-id: Charging ID of the bearer flow.

> • | imei: IMEI or IMEISV (depending on the case) associated with the bearer flow.

> • | imsi: Specific Mobile Station Identification number.

> • | qos: EPC QoS associated with the bearer flow.

> The inserted x-header is seen as:
> x-bearer-qos: 020400000100000002000000010000000200\r\n

> • | rat-type: This field is deprecated from under bearer rat-type and has been added within bearer 3gpp rat-type.

> • | s-mcc-mnc: 3GPP serving node MCC + MNC associated with the bearer.

> The inserted x-header is seen as: x-s-mcc-mnc: 123765\r\n

> • | sgsn-address: SGSN associated with the bearer flow.

> • | acr: Anonymous Customer Reference. Only MSISDN part of this is encrypted, if encrypt flag is set.

> • | customer-id: Customer ID of the bearer.

> • | ggsn-address: GGSN IP address field.

> • | imsi: This field is deprecated from within bearer imsi and has been moved within bearer 3gpp imsi. The IMSI as added via bearer 3gpp imsi.

> • | mdn: MDN of the bearer flow.

> • | msisdn-no-cc: MSISDN of the mobile handling the flow without the country code.

> • | radius-calling-station-id: Calling Station ID of the mobile handling the flow. Use this for MSISDN of the mobile handling the flow with the country code.

> • | session-id: Accounting session ID of the bearer flow.

> • | sn-rulebase: Name of the ACS rulebase.

> • | sgsn-address: This field is deprecated from under bearer sgsn-address and has been moved within bearer 3gpp sgsn-address.

> • | subscriber-ip-address: Subscriber IP address.

> • | username: User name of the bearer flow.

> encrypt: Specifies encryption of x-header field configuration. This option must only be configured when x-header encryption is enabled.
> http { host | url }
> Specifies value of the x-header field to be inserted:

> • | host: Host

> • | url: Uniform Resource Locator

> Usage
> Use this command to configure the x-header fields to be inserted in HTTP/WSP GET and POST request packets. The x-headers would be inserted at the end of the HTTP/WSP header. This CLI command may be used up to 10 times. There is no control over the order of the fields that are to be inserted. Any of the indicated ruledef variables may be inserted using the variable option, or a static string may be inserted using the string-constant option.
> Operators may insert x-headers in some HTTP/WSP packets, for which some rules will be configured. The charging-action associated with these rules will contain the list of x-headers to be inserted in the packets.
> Example
> The following command configures an x-header field named test12 with a constant string value of testing to be inserted in HTTP/WSP GET and POST request packets:
> insert test12 string-constant testing

Cisco Systems Inc.
Tel: 408-526-4000
Fax: 408-527-0883