SIP Local Response Code Mapping

The SIP local response code mapping feature enhances the SIP response code mapping. The SIP response code map feature lets you establish a table that maps SIP response-received messages (entries) to response-to-send messages (entries).

SIP local response code mapping is used with the SIP responses generated by the Oracle® Enterprise Session Border Controller towards a specific SIP session agent. This feature lets you provision the mapping of the response codes used by the Oracle® Enterprise Session Border Controller when it generates the responses towards a session agent.

You create the SIP local response code map using the existing mapping functionality, and then assigning that map to a session agent or to a SIP interface.

Note:

The configured response map is not used when the Oracle® Enterprise Session Border Controller is acting as proxy for the responses to this session agent.

The parameters method and register-response-expires enable a SIP registration response mapping feature that allows you to configure the Oracle® Enterprise Session Border Controller to remap a SIP failure response—which it receives from another network device or that it generates locally—to a 200 OK. You might want the Oracle® Enterprise Session Border Controller to perform this type of mapping for circumstances where non-malicious endpoints continually attempt registration, but will stop (and still not be registered) when they receive a 200 OK. This response mapping does not actually register the client with the Oracle® Enterprise Session Border Controller, meaning that there is neither a registration cache entry or a CAM ACL for it.

For the 200 OK it generates, the Oracle® Enterprise Session Border Controller removes any Reason or Retry-After header in the 200 OK and sets the expires time. By default, the expires time is the Retry-After time (if there is one in the response) or the expires value in the Register request (if there is no Retry-After expires time). You can also set this value using the register-response-expires parameter, but the value you set should never exceed the Register request’s expires time.

SIP Local Response Code Mapping Configuration

The following instructions explain how to create the SIP response code map and then how to assign it to a specific session agent.

Creating a SIP Response Code Map

To create a SIP local response code map:

Access the sip-response-map configuration element.

ORACLE# configure terminal
ORACLE(configure)# session-router
ORACLE(session-router)# sip-response-map
ORACLE(sip-response-map)#

name—Enter the name of the SIP response map you want to configure.
This value is required and must be unique.
```
ORACLE(response-map)# name busy
```
entries—Configure the entries for this mapping.
Typing a question mark will show you the response code entry parameters that you can configure.
```
ORACLE(response-map)# entries
ORACLE(response-map-entries)#
```
1. recv-code—Enter original SIP response code for the recv-mode parameter.
  The valid range is:
  - Minimum—100
  - Maximum—699
```
ORACLE(response-map-entries)# recv-mode 486
```
2. xmit-code—Enter the SIP response code into which you want the original response code to be translated.
  This valid range is:
  - Minimum—100
  - Maximum—699
```
ORACLE(response-map-entries)# xmit-mode 600
```
3. reason—Enter a reason for the translated code into the reason parameter.
  This response comment is sent with the translated code. Make your entry in quotation marks.
```
ORACLE(response-map-entries)# reason "Busy Everywhere"
```
4. method—Enter the name of the received SIP failure response message you want to map to a 200 OK.
  
  Note:
  There is no default for this parameter, and leaving the parameter empty turns off the SIP registration response mapping feature.
5. register-response-expires—Enter the time you want to use for the expires time what mapping the SIP method you identified in the method parameter.
  The maximum is 999999999. By default, the expires time is the Retry-After time (if there is one in the response) or the expires value in the Register request (if there is no Retry-After expires time). Any value you configure in this parameter (when not using the defaults) should never exceed the Register request’s expires time.
Note the name that you gave the SIP response code map so that you can use it when you configure a session agent to support SIP response code mapping.
Save and activate your changes.

Assigning SIP Response Code Maps to Session Agents

To assign a SIP local response code map to a session agent:

In Superuser mode, type configure terminal and press Enter.
```
ORACLE# configure terminal
```

Type session-router and press Enter.

ORACLE(configure)# session-router
ORACLE(session-router)#

Type session-agent and press Enter. The system prompt changes to let you know that you can begin configuring individual parameters.
```
ORACLE(session-router)# session-agent
ORACLE(session-agent)#
```
local-response-map—Enter the name of the configured SIP response map that you want to use for this session-agent and press Enter.
```
ORACLE(session-agent)# local-response-map busy
```
Save and activate your configuration.

Assigning SIP Response Code Maps to SIP Interfaces

To apply SIP response codes maps to a SIP interface:

In Superuser mode, type configure terminal and press Enter.
```
ORACLE# configure terminal
```
Type session-router and press Enter to access the signaling-level configuration elements.
```
ORACLE(configure)# session-router
ORACLE(session-router)#
```

Type sip-interface and press Enter.

ORACLE(session-router)# sip-interface
ORACLE(sip-interface)#

local-response-map—Enter the name of the configured SIP response map that you want to apply to this SIP interface for locally-generated SIP responses. This parameter is blank by default.
Save and activate your configuration.