allowed-elements-profile > rule-sets > header-rules
This configuration subelement is used to
configure SIP allowlists which controls the passage of unknown headers and parameters in
request and response traffic.
Parameters
- header-name
- The name of the header in the allowlist that theOracle Communications Session Border Controller allows from incoming messages. It is case-insensitive and supports abbreviated forms of header names. For example, “Via”, “via”, or “v” all match against the same header. A header name of “request-uri” refers to the request URI of requests, while a header name of “*” applies to any header-type not matched by any other header-rule. The default value is “*”. This default value provides the ability to have header-rules for commonly known headers that remove unknown parameters, but leave unknown headers alone.
- unmatched-action
- The action for the Oracle Communications Session Border Controller to perform when an incoming header’s
parameters do not match the relevant allowed parameters specified for this
header-name. This parameter applies to non-matching header names only (not
non-matching URI parameters).
- Default: reject
- Values:
- reject—Rejects all incoming messages that have header parameters that do not match the parameters specified in this header-name.
- delete — Deletes the non-matching elements from incoming messages with header parameters that do not match those specified in this header-name.
- allow-header-param
- The header parameter that the
Oracle Communications Session Border Controller allows from the headers in incoming messages. You can enter up to 255 characters, including a comma (,), semi-colon (;), equal sign (=), question mark (?), at-symbol (@), backslash (\), or plus sign (+). The default value is “*”, which allows all header parameters to pass through. If you leave this field empty, no header parameters are allowed.
- Deafult: *
- allow-uri-param
- The URI parameter that the Oracle Communications Session Border Controller allows from the headers in incoming
messages. You can enter up to 255 characters, including a comma (,),
semi-colon (;), equal sign (=), question mark (?), at-symbol (@), backslash
(\), or plus sign (+). The default value is “*”, which allows all URI
parameters to pass through. If you leave this field empty, no URI parameters
are allowed.
- Deafult: *
- allow-uri-user-param
- The URI user parameter that the Oracle Communications Session Border Controller allows from the headers in incoming
messages. You can enter up to 255 characters, including a comma (,),
semi-colon (;), equal sign (=), question mark (?), at-symbol (@), backslash
(\), or plus sign (+). The default value is “*”, which allows all URI user
parameters to pass through. If you leave this field empty, no URI user
parameters are allowed.
- Deafult: *
- allow-uri-header-name
- The URI header name that the Oracle Communications Session Border Controller allows from the headers in incoming
messages. You can enter up to 255 characters, including a comma (,),
semi-colon (;), equal sign (=), question mark (?), at-symbol (@), backslash
(\), or plus sign (+). The default value is “*”, which allows all URI header
name parameters to pass through. If you leave this field empty, no URI
header name parameters are allowed.
- Deafult: *
Path
header-rulesheader-rules is a subelement under rule-sets under the allowed-elements-profile element under the session router path. The full path from the topmost ACLI prompt is: configure terminal >terminal > session-router > allowed-elements-profile rule-sets header-rules