SIP Proxies Panel

To use SIP proxies, they must be defined and then assigned to a SIP Proxy Group (a collection of SIP Proxies). For further information on SIP Proxy Groups, please refer to SIP Proxy Groups.

Table 1. BAM Command Line Utility SIP Proxies options
Name	Description
View SIP Proxies	View already defined SIP Proxies
Add SIP Proxies	Add a new SIP Proxy
Update SIP Proxies	Update an already defined SIP Proxy
Remove SIP Proxies	Remove an already defined SIP Proxy
Assign SIP Custom Headers to SIP Proxies	Assign a SIP Custom Header to a SIP Proxy
Unassign SIP Custom Headers from SIP Proxies	Remove a SIP Custom Header from a SIP Proxy

Table 2. Mandatory Parameters
Name	Description
Name	A user defined name for the proxy
Description	A user defined description for the proxy
Mode	Specifies the proxy mode. This can be LOOSE_ROUTING or REWRITE_DESTINATION. LOOSE_ROUTING is how SIP proxies normally work, where any outbound requests with this proxy attached will set the Route: header REWRITE_DESTINATION simply rewrites the destination's address to the address specified in the "SIP Address" parameter. The user part of the destination address will be original user part of the destination, or the phone number from a tel: URI if a tel: URI is specified.
SIP Address	The full SIP address for the proxy (e.g. `sip:proxy@192.168.0.5`). Can include further information if necessary, e.g. port and transport (`sip:proxy@192.168.0.5:5060;transport=udp`)
RTP Mode	Specifies the allowed RTP methods for data transport on calls using this proxy, allowing you to override platform defaults. This can be RTP_USE_SYSTEM_DEFAULT; RTP_USE_INSECURE_ONLY; RTP_USE_SECURE_ONLY or RTP_USE_BOTH. RTP_USE_SYSTEM_DEFAULT will use the configuration file defaults for whether RTP, secure RTP or both are available when connecting calls. RTP_USE_INSECURE_ONLY will only allow regular RTP and not secure RTP connections to be made for calls on this proxy RTP_USE_SECURE_ONLY will only allow secure RTP and not regular RTP connections to be made for calls on this proxy RTP_USE_BOTH will explicitly allow both regular RTP and secure RTP connections to be made for calls on this proxy

Table 3. Optional Parameters
Name	Description	Default
Priority	Sets the priority of this proxy for any group it is assigned to (please see Weight and Priority usage in the Blueworx Platform)	1
Weight	Sets the weight of this proxy for any group it is assigned to (please see Weight and Priority usage in the Blueworx Platform)	1
Caller ID	Caller Id to use in SIP as the user part of a From header.
Try Anonymous?	Determines whether this proxy should try using anonymous credentials if an authentication challenge is received	False
OPTIONS ping enabled?	Enables OPTIONS ping, which is used by BVR to monitor the status of the proxy. If the OPTIONS ping receives a SIP 2xx response (e.g. 200 OK), the proxy will be set to UP. Otherwise, if it receives a non-2xx final response OR the request times out, it will be set to DOWN)	False
OPTIONS ping frequency if proxy is up	How frequently (in seconds) to send a SIP OPTIONS message when the proxy is UP	60
OPTIONS ping frequency if proxy is down	How frequently (in seconds) to send a SIP OPTIONS message when the proxy is DOWN	60

Note: If OPTIONS ping is not enabled, a proxy will be set to DOWN if requests to it time out. The proxy will not be used again until every other proxy in the group is also DOWN.

Note: If a proxy is edited in BAM and the SIP address has changed, the status will be reset to UP.