- User's Guide
- HMR Configuration
- SIP Header Manipulation
- Configure a MIME SDP Rule
Configure a MIME SDP 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 SDP Rule, MIME Header Rule, SDP Session Rule, and SDP Media 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-sdp-rule.
- In the Add or
Modify SIP Manipulation / MIME SDP 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 (instructions for configuring mime-header-rule) (Optional) Click Add, mime-header-rule, and do the following. - Name—Enter a unique name for this header element rule.
- Mime Header Name—Enter header name within the MIME part to which to apply the rule.
- Action—Select an action from the drop-down list to apply to the element rule.
- Comparison Type—Select the type of comparison from the drop-down list to use for the match value.
- Match Value—Enter the match value to compare against the current object.
- New Value—Enter a new value for the object. Quoted display named must be escaped within quotes. For example, \"MyName\" .
- Click OK. The system displays the SIP manipulation / Mime sdp rule dialog.
Do one of the following:- Add another mime-header-rule.
- Configure the sdp-session-rule and sdp-media-rule options, using the steps in the following table cells.
- Finish the MIME SDP rule configuration by completing steps 3-6.
Cfg Rules (instructions for configuring sdp-session-rule) (Optional) Click Add, sdp-session-rule , and do the following. - Name—Enter a unique name for this header element rule.
- Action—Select an action from the drop-down list to apply to the this rule.
- Comparison Type—Select the type of comparison from the drop-down list to use for the match value.
- Match Value—Enter the match value to compare against the current object.
- New Value—Enter a new value for the object. Quoted display named must be escaped within quotes. For example, \"MyName\".
- CfgRules—(Optional) Click Add, sdp-line-rule.
- Name—Enter a unique name for this rule.
- Type—Enter a descriptor type to specify the SDP line to manipulate.
- Action—Select an action from the drop-down list to apply to this rule.
- Comparison Type—Select the type of comparison from the drop-down list to use for the match value.
- Match Value—Enter the match value to compare against the current object.
- New Value—Enter a new value for the object. Quoted display named must be escaped within quotes. For example, \"MyName\".
- Click OK. The system displays the SIP manipulation / Mime sdp rule / Sdp session rule dialog.
- (Optional) Add another sdp-line-rule.
- Click OK. The system displays the SIP manipulation / Mime sdp rule dialog.
Do one of the following:- Add another sdp-session-rule.
- Configure the mime-header-rule and sdp-media-rule options, using the steps in the corresponding table cells in this procedure.
- Finish the MIME SDP rule configuration by completing steps 3-6.
Cfg Rules (instructions for configuring sdp-media-rule) (Optional) Click Add, sdp-media-rule. - Name—Enter a unique name for this header element rule.
- Media Type—Enter the media type to manipulate. For example, audio or video.
- Action—Select an action from the drop-down list to apply to the element rule.
- Comparison Type—Select the type of comparison from the drop-down list to use for the match value.
- Match Value—Enter the match value to compare against the current object.
- New Value—Enter a new value for the object. Quoted display named must be escaped within quotes. For example, "\"MyName\" " .
- Click OK.
- CfgRules—(Optional) Click Add, sdp-line-rule.
- Name—Enter a unique name for this rule.
- Type—Enter a descriptor type to specify the SDP line to manipulate.
- Action—Select an action from the drop-down list to apply to this rule.
- Comparison type—Select the type of comparison from the drop-down list to use for the 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\".
- Click OK. The system displays the SIP manipulation / Mime sdp rule / Sdp media rule dialog.
- (Optional) Add another sdp-line-rule.
- Click OK. The system displays the SIP manipulation / Mime sdp rule dialog.
Do one of the following:
- Add another sdp-media-rule.
- Finish the MIME SDP 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.