SIP Configuration Options

Configure various SIP parameters

This section is OPTIONAL

The header for this section is [sip]

Table 1. sip
Name Mandatory Type Default Description
bind_address no string any The IP address that the SIP stack binds to. This is the IP that must be called into in order to reach BVR, however it must be an IP address that is defined to the system. "any" will listen on any IP address. Changing this option is useful if the system has multiple network adapters with different IP addresses and the administrator wishes to limit inbound calls to one of those adapters
presentation_address no string auto The IP address to present as the local address (affects "Contact" and "Via" headers). Overrides default_presentation_address in [general]
ignore_sent_by_check no boolean false Determines whether BVR ignores the SIP sent-by check
dns_servers no string array   Specifies which DNS server(s) to use for SIP communication. If one fails the number of times specified by dns_failure_threshold, it will move to the next in the list. If this option is not specified, the DNS servers used will be determined by the system's configuration in /etc/resolv.conf

Note: This variable is an array of strings. Each item should be individually quoted and comma separated, with the entire variable surrounded by [] brackets. e.g. ["a", "b", "c"]
dns_timeout no integer 5000 Specifies the timeout (in milliseconds) of a DNS request. If set to 0, DNS requests will have no timeout - this is not recommended, however, as it will not be possible to detect if a DNS server is failing. If this is not specified, the dns timeout will be determined by the timeout parameter in the system's configuration in /etc/resolv.conf

Min: 0, Max: 30000
dns_failure_threshold no integer 2 Specifies the number of times connection to a DNS server can fail before the next DNS server is used. If this is not specified, the threshold will be determined by the attempts parameter in the system's configuration in /etc/resolv.conf

Min: 1, Max: 5
dns_retry_interval no time 1 second This parameter was introduced in version 7.22.0

Specifies the amount of time to wait before retrying a DNS query if the last attempt returned no results

This is a time unit value and can be written in human readable form (e.g. "1 day", "3 weeks" etc.) If just a number is supplied, it will be interpreted as MILLISECONDS

Min: 0 milliseconds, Max: 20 years
user_sources no string array ["To"] Specifies where to get the "user" part of the SIP URI. This can one or more of "To", "Request_URI". Setting user_sources to both "To" and "Request_URI" allows the Blueworx Platform to check both sources, in the order defined, to find an application mapping.

Note: This variable is an array of strings. Each item should be individually quoted and comma separated, with the entire variable surrounded by [] brackets. e.g. ["a", "b", "c"]
caller_id no string bvr This parameter was introduced in version 7.27.1

Caller Id used as SIP user part of the From header for outbound SIP requests. Should be set to just the user part of the header without an IP address or sip: identifier.
application_call_logging no boolean false This parameter was introduced in version 7.32.0

Log SIP messages in application call logs.