SIP Interface Settings

Proxy Registrations

By default, the Oracle Enterprise Communications Broker (OECB) rejects a REGISTER request from a domain for which it is not the registrar. You can enable the OECB to proxy such registration requests by way of the Proxy Registrations control in the SIP Interface configuration.

In the SIP Interface configuration, select Proxy Registrations to tell the OECB to proxy the registration towards the intended registrar. When you deselect Proxy Registrations, the OECB responds with a 403: Unauthorized message.

Add a SIP Interface

The SIP interface defines the signaling interface through which the Oracle Enterprise Communications Broker (OECB) receives and sends SIP messages.

Consider any SIP options that you want to add.
Configure any inbound and outbound manipulation rules that you want to use with this interface.
Configure any S8HR profiles that you want to use with this interface.

In the configuration, you specify how the OECB handles SIP messages and you can add SIP options.

Access the SIP Interface configuration object.
Configuration, System Administration, SIP Interface, Interfaces.
On the SIP Interface page, click Add.

On the Add Interface page, do the following:

State	Select to enable this configuration. Default: Enabled.
Enable Early Media Inhibit	Select to extract and store Session Description Protocol (SDP) messages from provisional responses before call setup.
Realm ID	Select the realm for this interface. Required to set SIP ports.
Description	Enter a description for this interface.
SIP Ports	Click Add, and do the following: Address—Enter the IP address of this interface. Port—Enter the port. Default: 5060. Range: 1-65535. Transport protocol—Select a protocol from the drop-down list. Default: UDP. Valid values: SCTP \| TCP \| TLS \| UDP Allow anonymous—Set how you want the system to handle requests from a SIP realm. Default: All. Valid values: All (allow all anonymous connections) \| Registered (session agents and registered endpoints, only) TLS profile—Select the TLS profile you want for this port. Click OK. (Optional) Add more SIP ports.
Options	Add optional parameters or features by entering them in comma-separated format.
Stop Recurse	Enter one or more response codes that you want to cause this session agent to stop route recursion. You can enter individual response codes separated by a comma, such as 301,305 or a range such as 300-380. Default: 401,407. Valid values: 300-599.
Inbound Manipulation	Select an inbound manipulation rule from the drop-down list.
Outbound Manipulation	Select an outbound manipulation rule from the drop-down list.
S8hr Profile	Select an S8HR profile from the drop-down list.

Click OK.
(Optional) Add another SIP interface.
Save the configuration.

Configure SIP Config

Use SIP Config to set the parameters that apply to all SIP call traffic on the Oracle Enterprise Communications Broker (OECB).

Access the SIP Interface configuration object.
Configuration, System Administration, SIP Interface, SIP Config.

On the SIP Config page, do the following:

Options

Enter the option syntax for the option. Add more options, separated by a comma.

ENUM SAG Match

Select to enable ENUM session agent group matching.

Default Context

Set the default source context for the system to use for a given call when unable to identify source context by any other method.

Parallel Forking

Select to cause the system to fork all sessions to all contacts of an Agent of Record.

Fork Group Timeout

Set the timeout value, in seconds, after which the OECB tries the next fork group with the highest priority. Default: 0. Range: 0-32.

ASCII Based Routing

Select to enable routing with alphanumeric entries in the user database and routing table.

Proxy Registration

Select to allow the OECB to accept a registration from an unauthorized domain, and proxy the registration to the intended registyrar.

Save the configuration.

Restricting Session Initiation

The Oracle Enterprise Communications Broker (OECB) can restrict the set of end stations that can initiate sessions to those originating through active session agents and previously registered users. By default, the OECB does not restrict session initiation. You can enable the functionality in the SIP Port configuration.

The SIP Port configuration includes theAllow Session Agents and Registered End-Points control that you use to restrict session initiation. When selected, the OECBresponds to session initiation by endpoints that are not behind an agent or not already registered with a 403: Unauthorized message.

Configure a SIP Interface Port

A SIP Interface port configuration defines the transport address and protocol that the Oracle Enterprise Communications Broker (OECB) uses for sending and receiving messages through a SIP interface. You can apply a TLS profile to the configuration, and you can limit SIP requests from session agents and registered end points. You must configure at least one port per SIP interface. You can optionally configure multiple SIP ports per SIP interface. For example, suppose you configure the OECB to receive calls by way of TCP and to send calls by way UDP, you must configure a SIP port for each protocol.

Create the TLS profile that you want for this configuration.

In the following procedure, use step 4 to add more SIP interface ports.

Access the SIP Interface configuration object.
Configuration, System Administration, SIP Interface, Interfaces.

On the SIP Interface page, under SIP Port, click Add, and do the following:

Address	Enter the IP address of the SIP interface.
Port	Enter port number for the SIP interface. Default: 5060. Range: 0-65535.
Transport Protocol	Select a protocol from the drop-down list. Default: UDP. Valid values: SCTP \| TCP \| TLS \| UDP
TLS Profile	Select the TLS profile you want for this port.
Allow Anonymous	Set how you want the system to handle requests from a SIP realm. Default: All. Valid values: All (allow all anonymous connections) \| Registered (session agents and registered endpoints, only)

Click OK.
The system displays the SIP Ports page with a list of SIP Interface ports you configured.
Optional—Click Add to add another SIP Interface port.
Click Back.
The system displays the SIP Interface page, where you can add another SIP Interface.

Optional—Configure SIP monitoring.

SIP Monitor and Trace Filter Configuration

The SIP Monitor and Trace function allows you to monitor SIP sessions for notable events and display the results in the Oracle Enterprise Communications Broker (OECB) SIP Notable Events summary. Such information may help you perform troubleshooting. For more targeted monitoring, you can configure filters on particular users and addresses on the OECB, and on a specific agent.

The OECB Configuration page, located at Configuration, System Administration, SIP Interface, Monitoring Filters, includes the following objects for configuring SIP Monitoring filters:

The SIP Interface configuration page displays the Monitoring Filters object in the navigation pane, which you use to configure individual filters.
The Monitoring object on the SIP interface configuration page displays the Monitoring Filters element in the dialog. Use it to apply filters to the OECB.
The Add Agents configuration page displays theMonitoring Filters configuration element to the Advanced section. Use it to apply filters to an agent.
Note:
After the P-CZ2.0.0m4 release, the system does not support the former "Enable SIP Monitor and Trace" setting. You must re-configure SNMP event traps through the dialogs described in this topic.

Use the following filter configuration process for both new installations and upgrades.

Create one or more filters in the Monitoring Filters object. You may use an asterisk character as a filter, if you want to monitor all session data.
Add one or more filters to the Monitoring object.
(Optional) Add one or more monitoring filters to an agent that you want to monitor.

SIP REFER

SIP REFER provides the Oracle Enterprise Communications Broker with the ability to terminate SIP REFER messages and perform attended or unattended call transfers. You can enable REFER termination at both the agent and SIP interface, with agent configuration taking precedence. You can also configure the SIP interface to send NOTIFY messages for provisional responses.

SIP REFER Method Call Transfer for ECB

The Oracle Enterprise Communications Broker (OECB) supports a handling mode for the REFER method that automatically converts a received REFER method into an INVITE method. This allows the OECB to transfer a call without having to proxy the REFER back to the other User Agent (UA).

The OECB provides the Enable REFER Termination parameter for provisioning the handling of REFER methods as call transfers. When you enable ISP REFER Method Call Transfer, the OECB creates an INVITE message whenever it receives a REFER. The OECB sends the INVITE message to the address in the Refer-To header. The INVITE message includes all of the unmodified information contained in the REFER message. The OECB uses the previously negotiated SDP in the new INVITE message, and sends the NOTIFY and BYE messages to the UA upon call transfer completion. You configure this function at the SIP interface or agent with agent configuration taking precedence.

When a REFER method is received containing no Referred-By header, the OECB adds one, allowing the OECB to support all call agent screen applications.

The SIP REFER method call transfer feature supports the following:

Both unattended and attended call transfers.
Both successful and unsuccessful call transfers.
Early media from the Referred-To party to the transferee.
REFER method transfer from different sources.
The REFER event package as defined in RFC 3515. This applies for situations where multiple REFER methods are used within a single dialog.
Third party initiated REFER method signaling the transfer of a call by associating the REFER method to the dialogue through the REFER TargetDialog.

Unsuccessful Transfer Scenarios

The Oracle Enterprise Communications Broker (OECB) does not successfully handle the following unsuccessful, unusual, and unexpected transfer scenarios:

The new INVITE to the Referred-To party gets challenged, the OECB does not answer the challenge. It is treated with the 401/407 response just as any other unsuccessful final response.
The header of the REFER message contains a method other than INVITE or contains URI-parameters or embedded headers not supported by the OECB.
The OECB allows the Referred-To URI that happens to resolve to the same next-hop as the original INVITE went to, to do so.
The OECB ignores any MIME attachments within a REFER method.
The OECB recurses (when configured to do so) when the new INVITE sent to the Referred-To party receives a 3xx response.
The transferee indicated support for 100rel, and the original two parties agreed on using it, yet the Referred-To party does not support it.
The original parties negotiated SRTP keys.
The original parties agreed on a codec using a dynamic payload type, and the Referred-To party happens to use a different dynamic payload number for that codec.

Call Flows

The following ladder diagram shows an example of call flow for an unattended call transfer:

This ladder diagram shows unattended call transfer from the calling party to the ECB to the SIP Proxy to the IVR to the ACD/SIP server to the Agent and back.

The following ladder diagram shows an example call flow of an attended call transfer:

This ladder diagram shows the attended call transfer from the calling party to the ECB to the SIP Proxy to the IVR to the ACD/SIP server to the Agent and back.

Configure SIP REFER Method

The Oracle Enterprise Communications Broker (OECB) allows you to set REFER termination on a per-agent and SIP interface basis. Agent configuration takes precedence over the SIP interface configuration.

Configure the SIP Interface.

Select Enable REFER Termination in the SIP Interface configuration to allow the specified agent to support SIP REFER method call transfers.

Use the following procedure to enable SIP REFER termination support.

Access the SIP Interface configuration object.
Configuration, System Administration, SIP Interface, Interfaces.
On the SIP Interface page, do one of the following:
- Open an existing interface.
- Add a new interface.
In the interface configuration, select Enable REFER termination.
Exit the SIP Interface configuration.
Click Service Provisioning, Agents, Session Agent.
Do one of the following:
- Select an existing agent to edit.
- Add a new agent.
In the Agent configuration, select Enable REFER termination.
Save and activate the configuration.

180 and 100 NOTIFY in REFER Call Transfers for the ECB

When you configure the Oracle Enterprise Communications Broker (OECB) to support REFER call transfers, you can enable it to send a NOTIFY message after it sends either a 202 Accepted or a 180 Ringing message. If your network contains elements that comply with RFC 5589, and therefore expect the NOTIFY message after the 202 Accepted and each provisional 180 Ringing, set the Send NOTIFY messages for REFER Provisional Responses to either Initial or All, according to your deployment needs.

Without this parameter changed from its default (None), the OECB does not return send the NOTIFY until it receives the 200 OK response from the agent being called. If the time between the REFER and the NOTIFY exceeds time limits, this sequencing can cause the OECB’s NOTIFY to go undetected by devices compliant with RFC 5589. Failures during the routing process can result.

The following ladder diagram shows how a sample call flow times out when the Send NOTIFY Messages for REFER Provisional Responses parameter is not set.

The following ladder diagram shows how a sample call flow times out when the Send NOTIFY messages for REFER provisonal responses is not set. The call times out when too much time passes between the REFER, the second INVITE, and the answer,.

When you compare the call flow above to the following one depicting the scenario when the OECB has the Send NOTIFY Messages for REFER Provisional Responses changed from its default, the difference is that the OECB now responds with a NOTIFY in response to the 202 Accepted and it sends another one after the 180 Ringing. This prevents the timeout and allows the event to be diverted successfully.

The following ladder diagram shows how a sample call flow times out when the Send NOTIFY messages for REFER provisonal responses is set. The call does not time out when too much time passes between the REFER, the second INVITE, and the answer

Sample Messages

In compliance with RFC 5589, the NOTIFY message with 100 Trying as the message body looks like the sample below. Note that the expires value in the subscription state header is populated with a value that equals 2* TIMER C, where the default value of TIMER C is 180000 milliseconds.

NOTIFY sips:4889445d8kjtk3@atlanta.example.com;gr=723jd2d SIP/2.0
Via: SIP/2.0/TLS 192.0.2.4;branch=z9hG4bKnas432
Max-Forwards: 70
To: <sips:transferor@atlanta.example.com>;tag=1928301774
From: <sips:3ld812adkjw@biloxi.example.com;gr=3413kj2ha>;tag=a6c85cf
Call-ID: a84b4c76e66710
CSeq: 73 NOTIFY
Contact: <sips:3ld812adkjw@biloxi.example.com;gr=3413kj2ha>
Allow: INVITE, ACK, CANCEL, OPTIONS, BYE, REFER, NOTIFY
Supported: replaces, tdialog
Event: refer
Subscription-State: active;expires=360
Content-Type: message/sipfrag
Content-Length: ...
SIP/2.0 100 Trying

Also in compliance with RFC 5589, the NOTIFY message with 180 Ringing as the message body looks like the sample below. Again, the expires value in the subscription state header is populated with a value that equals 2* TIMER C, where the default value of TIMER C is 180000 milliseconds.

NOTIFY sips:4889445d8kjtk3@atlanta.example.com;gr=723jd2d SIP/2.0
Via: SIP/2.0/TLS 192.0.2.4;branch=z9hG4bKnas432
Max-Forwards: 70
To: <sips:transferor@atlanta.example.com>;tag=1928301774
From: <sips:3ld812adkjw@biloxi.example.com;gr=3413kj2ha>;tag=a6c85cf
Call-ID: a84b4c76e66710
CSeq: 73 NOTIFY
Contact: <sips:3ld812adkjw@biloxi.example.com;gr=3413kj2ha>
Allow: INVITE, ACK, CANCEL, OPTIONS, BYE, REFER, NOTIFY
Supported: replaces, tdialog
Event: refer
Subscription-State: active;expires=360
Content-Type: message/sipfrag
Content-Length: ...
SIP/2.0 180 Ringing

Also in compliance with RFC 5589, the NOTIFY message with 200 OK as the message body looks like the sample below.

NOTIFY sips:4889445d8kjtk3@atlanta.example.com;gr=723jd2d SIP/2.0
Via: SIP/2.0/TLS 192.0.2.4;branch=z9hG4bKnas432
Max-Forwards: 70
To: <sips:transferor@atlanta.example.com>;tag=1928301774
From: <sips:3ld812adkjw@biloxi.example.com;gr=3413kj2ha>;tag=a6c85cf
Call-ID: a84b4c76e66710
CSeq: 74 NOTIFY
Contact: <sips:3ld812adkjw@biloxi.example.com;gr=3413kj2ha>
Allow: INVITE, ACK, CANCEL, OPTIONS, BYE, REFER, NOTIFY
Supported: replaces, tdialog
Event: refer
Subscription-State: terminated;reason=noresource
Content-Type: message/sipfrag
Content-Length: ...
SIP/2.0 200 OK

180 and 100 NOTIFY Configuration

You can apply the Send NOTIFY Messages for REFER Provisional Responses setting to the SIP Interface. By default, the Oracle Enterprise Communications Broker (OECB) sends only the final result NOTIFY message.

Do the following to enable 100 and 180 NOTIFY messages in REFER call transfers.

Access the SIP Interface configuration object.
Configuration, System Administration, SIP Interface, Interfaces.
On the SIP Interface page, do one of the following:
- Select an existing SIP Interface to edit.
- Add a new SIP Interface.
In the SIP Interface dialog, select one of the following settings for the Send NOTIFY messages for REFER Provisional Responses parameter.
- None—Disable NOTIFY for REFER provisional responses.
- Initial—Send an immediate 100 Trying NOTIFY, and the final result NOTIFY.
- All—Send an immediate 100 Trying NOTIFY, plus a NOTIFY for each non-100 provisional messages the OECB receives; and the final result NOTIFY.
Save and activate the configuration.