- User's Guide
- HMR Configuration
- SIP Header Manipulation
- Configure a MIME Rule
Configure a MIME Rule
You can configure Multi-Purpose Internet Mail Extensions (MIME) header rules and element rules on the Oracle Enterprise Communications Broker (OECB) from the "CfgRules" section of the "SIP Manipulations" page.
In the following procedure, you set the SIP Header Manipulation, MIME Rule, and MIME Header Rule parameters.
- Access the SIP
Manipulation configuration object.
Configuration, System Administration, SIP Manipulation.
- On the SIP
Manipulation configuration page, do one of the following:
- Select and existing SIP manipulation configuration from the table, right-click, and click Edit. (Subsequent SIP manipulation pages use "Modify" in the title.)
- Click Add. (Subsequent SIP manipulation pages use "Add" in the title.)
- On the Add or Modify SIP Manipulation page, do one of the
following.
- If you chose Add, you must enter a name for this SIP Manipulation. (You can optionally complete the Description, Split Headers, and Join Headers parameters, at this time. See "Configure SIP Manipulation.") Proceed to the next step.
- If you chose to edit an existing configuration, proceed to the next step.
- On the Add or Modify SIP Manipulation page under Cfg Rules, click Add and click mime-rule.
- On the Add or
Modify SIP Manipulation / Mime Rule page, do the following.
Name Enter a unique name for this rule set. Valid values: Alpha-numeric. Content Type Enter the name of the header on which you want the OECB to use this HMR. Set this parameter to @status-line, where the at-sign (@)—not allowed in SIP header names—to prevent undesired matches with header having the name status-code. Default: Blank. Msg Type Specify the message type this rule applies to. Default: Any. Valid Values: Any | Out of Dialog | Reply | Request | Out of Dialog. Methods Enter the method type to use when this SIP HMR is used. Default: Blank. Valid values" ACK | CANCEL | INVITE. When you do not set the method, the OECB applies the rule to all SIP methods. Format Select the encode - decode format from the drop-down list for the MIME content. Action Select an action from the drop-down list for the header rule. Default: None. Valid values: Add | Delete | Find Replace All | Log | Manipulate | Monitor | None | Reject | SIP Manip | Store. Comparison Type Specify how the OECB processes the match rules against the SIP header. Default: Refer Case Sensitive. Valid values: Boolean | Case Insensitive | Case Sensitive | Pattern Rule | Refer Case Insensitive | Refer Case Sensitive. Match Value Enter the value to match against the header value in SIP packets; the OECB matches these against the entire SIP header value. This is where you can enter values to match using regular expression values. Your entries can contain Boolean operators. When you configure HMR (using SIP manipulation rules and elements rules, you can use escape characters in the match-value parameter to support escaping Boolean and string manipulation operators. You can also escape the escape character itself, so that it is used as a literal string. For example, the OECB treats the string \+1234 as +1234. The following are escape characters: +, -, +^, -^, &, |, \, (, ), ., $, ^, and “. You can also use the variables, $REMOTE_PORT and $LOCAL_PORT, which resolve respectively to the far-end and remote UDP or TCP port value.
New Value When you set the action parameter Add or to Manipulate, enter the new value that you want to substitute for the entire header value. This is where you can set stored regular expression values for the OECB to use when it adds or manipulates SIP headers. When you configure HMR (using SIP manipulation rules and elements rules, you can use escape characters in the match-value parameter to support escaping Boolean and string manipulation operators. You can also escape the escape character itself, so that it is used as a literal string. For example, the OECB treats the string \+1234 as +1234. The following are escape characters: +, -, +^, -^, &, |, \, (, ), ., $, ^, and “. You can also use the variables, $REMOTE_PORT and $LOCAL_PORT, which resolve respectively to the far-end and remote UDP or TCP port value.
Cfg Rules Click Add, mime-header-rule, and do the following. - Name—Enter a unique name for this header element rule. You can enter up to 128 alphanumeric characters with no spaces. The name can include the _, ., or - characters, but cannot begin with either the . or the - characters.
- Mime Header Name—Enter header name within the MIME part to which to apply the rule. Use headername@peramble to change the preamble of a SIP body. Use headername@epilogue to change the epilog of a SIP body.
- Action—Select an action from the drop-down list to apply to the element rule. Default: None.
- Comparison Type—Select the type of comparison from the drop-down list to use for the match value. Default: Match Value. (To clear the value, enter and empty string.)
- Match Value—Enter the match value to compare against the current object. (To clear the value, enter and empty string.)
- New Value—Enter a new value for the object. Quoted display named must be escaped within quotes. For example, \"MyName\". (To clear the value, enter and empty string.)
- Click OK. The system displays the SIP Manipulation / Mime Rule dialog.
Do one of the following:- Add another mime-header-rule.
- Finish the MIME Rule configuration by completing the following steps.
- Click
Back.
The system displays the Add or Modify SIP Manipulation page.
- Click
Back.
The system displays the SIP Manipulation page.
- Save the configuration.