Embedded Routes in Redirect Responses

When the Oracle® Enterprise Session Border Controller recurses as the result of a redirect (3xx) response, the server might need to specify one or more intermediate hops. These hops are reflected in the Contact header for the 3xx response using embedded route headers and look like this:

Contact: <sip:touser@server.example.com?Route=%3Cproxy.example.com%Blr%3E>

The Contact header shows that the request should be sent to server.example.com using proxy.example.com.

You can configure your Oracle® Enterprise Session Border Controller to specify that embedded headers in 3xx Contact headers are to be included in new requests such that they are tied to a session agent representing the new target (server.example.com). This behavior requires you to set the request-uri-headers parameter.

However, you can also use the use-redirect-route in global SIP configuration’s options parameter so that the embedded Route header is used as the next hop to receive the new request.

When you configure this new option, the Oracle® Enterprise Session Border Controller constructs a new request using the redirect Contact, and the SIP URI from the Contact becomes the Request-URI. Then, the system inserts the embedded routes as Route headers in the, using the same order in which they appeared in the redirect Contact. Afterward, the Oracle® Enterprise Session Border Controller determines the next hop in the same way it does with any other request. If the first route is a loose route (i.e., it has the lr URI parameter), then the Oracle® Enterprise Session Border Controller sends a request to host indicated in the first route. Otherwise, strict routing applies, and the Oracle® Enterprise Session Border Controller sends the request to the host indicated in the Request-URI.

  1. In Superuser mode, type configure terminal and press Enter.
    ORACLE# configure terminal
  2. Type session-router and press Enter.
    ORACLE(configure)# session-router
    ORACLE(session-router)#
  3. Type sip-config and press Enter.
    ORACLE(session-router)# sip-config
    ORACLE(sip-config)#

    If you are adding support for this feature to a pre-existing configuration, then you must select (using the ACLI select command) the configuration that you want to edit.

  4. options—Set the options parameter by typing options, a Space, and then the option name.
    ORACLE(sip-config)# options use-redirect-route

    If you type the option without the plus sign, you will overwrite any previously configured options. In order to append the new options to this configuration’s options list, you must prepend the new option with a plus sign as shown in the previous example.

  5. Save and activate your configuration.