sip-nat
The sip-nat element is used for configuring SIP-NAT across realms.
Parameters
- realm-id
- Enter the name of the external realm. This required realm-id must be unique.
- domain-suffix
- Enter the domain name suffix of the external realm. This suffix is appended to encoded hostnames that the SIP-NAT function creates. This is a required field.
- ext-proxy-address
- Enter the IP address of the default next-hop SIP element (a SIP proxy) in the external network. This is a required field. Entries in this field must follow the IP Address Format.
- ext-proxy-port
- Enter the port number of the default next-hop SIP element (a SIP proxy) in the external network
- Default: 5060
- Values: Min: 1025 / Max: 65535
- ext-address
- Enter the IP address on the network interface in the external realm. This required entry must follow the IP address format.
- home-address
- Enter the IP address on the network interface in the home realm. This required entry must follow the IP address format.
- home-proxy-address
- Enter the IP address for the home proxy (from the perspective of the external realm). An empty home-proxy-address field value signifies that there is no home proxy, and the external address will translate to the address of the Oracle Communications Session Border Controller’s SIP proxy. Entries in this field must follow the IP Address Format.
- home-proxy-port
- Enter the home realm proxy port number
- Default: 0
- Values: Min: 0; 1025 / Max: 65535
- route-home-proxy
- Enable or disable requests being routed from a given SIP-NAT to the home proxy
- Default: disabled
- Values: enabled | disabled | forced
- address-prefix
- Enter the address prefix subject to SIP-NAT encoding. This field is used to override the address prefix from the realm config for the purpose of SIP-NAT encoding.
- Default: *
- Values:
- <IP address>:[/num-bits]
- *—indicates that the addr-prefix in the realm-config is to be used
- 0.0.0.0—indicates that addresses NOT matching the address prefix of the home realm should be encoded
- tunnel-redirect
- Enable or disable certain headers in a 3xx Response message being received and NATed when sent to the initiator of the SIP INVITE message
- Default: disabled
- Values: enabled | disabled
- use-url-parameter
- Select how SIP headers use the URL parameter (parameter-name) for encoded addresses that the SIP-NAT function creates. A value of none indicates that
Oracle Communications Session Border Controller functionality remains unchanged and results in the existing behavior of the
Oracle Communications Session Border Controller. From-to and phone are used for billing issues related to extracting digits from the encoded portion of SIP messages along with the parameter-name field.
- Default: none
- Values:
- none
- from-to
- phone
- all
- parameter-name
- Enter the URL parameter name used when constructing messages. This field is used in SIP-NAT encoding addresses that have a use-url-parameter field value of either from-to or all. This field can hold any value, but it should not be a recognized name that another proxy might use.
- user-nat-tag
- Enter the username prefix used for SIP URLs
- Default: -acme-
- host-nat-tag
- Enter the hostname prefix used for SIP URLs
- Default: ACME-
- headers
- Enter the type of SIP headers to be affected by the
Oracle Communications Session Border Controller’s sip-nat function. The URIs in these headers will be translated and encrypted, and encryption will occur according to the rules of this sip-nat element. Entries in this field must follow this format: <header-name>=<tag>.
- Default: Type headers -d <enter>
- delete-headers
- Remove headers from the list of SIP headers configured in the headers field
Path
sip-nat is an element under the session-router path. The full path from the topmost ACLI prompt is:
Note:
This is a multiple instance configuration element.