VOS3000 gateway call authentication
Every call from a customer must be tied to the right mapping gateway, and so to the right account. This setting decides how.
Updated · By the VOS3000 Web team
Quick answer: Call authentication mode on a VOS3000 mapping gateway decides how an incoming call is matched to the customer: by IP, by IP Address and Port, or with Password authentication required. A call that fails the check ends with CallAuthenticationFailure (-6) in the CDR.
- Where
- Mapping gateway, Additional settings, Protocol, SIP
- Modes
- IP, IP Address and Port, Password authentication required
- Failed check
- CallAuthenticationFailure (-6)
- Unknown IP and number
- IllegalCall (-9)
Where the setting is
Open Navigation → Operation management → Gateway operation → Mapping gateway, edit the customer's gateway and go to Additional settings → Protocol → SIP. The field is Call authentication mode. It works together with the Ip field in Additional settings → Normal, where you can list several addresses, with a signaling port, separated by commas.
The three modes
| Mode | What VOS3000 checks | Use it when |
|---|---|---|
| IP | The source IP address. | The customer sends from fixed IPs that only they use. |
| IP Address and Port | The source IP and port. | Several customers or trunks send from one IP on different ports. |
| Password authentication required | A password challenge. | The customer's IP changes, or you want a second check on top of the address. |
Static and dynamic gateways matter here too. A Static gateway (Gateway type in Additional settings → Normal) is matched directly by IP address; a Dynamic gateway must register, and its Gateway name is used to authenticate it, with the Configuration password as the registration password. If two static gateways share an IP, Priority decides which one matches.
Password authentication settings
| Parameter | Default | What it does |
|---|---|---|
| SS_SIP_AUTHENTICATION_CODE | Unauthorized(401) | The reply to a REGISTER or INVITE without Authorization or Proxy-Authorization. |
| SS_SIP_AUTHENTICATION_TIMEOUT | 10 s | A caller that has not authenticated in this time is rejected. |
| SS_AUTHENTICATION_MAX_RETRY | 6 | Maximum terminal password retries (0 to 999). |
| SS_AUTHENTICATION_FAILED_SUSPEND | 180 s | How long a terminal is disabled after too many retries (60 to 3600). |
These limits also slow down password guessing; see fraud protection.
Fixing CallAuthenticationFailure (-6)
A CallAuthenticationFailure (-6) in the CDR means VOS3000 refused the call at the authentication step. Work through it in this order:
- Which IP did the call come from? Compare the caller IP in the CDR with the gateway's Ip list. A new server or a second outbound IP at the customer is the usual cause.
- Which port? In IP Address and Port mode, a customer behind NAT or with several servers may send from a port you did not list. Switch to IP if the address is theirs alone.
- Password mode: the customer's switch must answer the 401 challenge with the right credentials within the timeout. Many trunk-side devices never answer an INVITE challenge, so ask before you turn it on.
- Look at the signalling. Turn on debug trace and read the INVITE and the reply; see debug trace.
Do not confuse it with IllegalCall (-9): the manual defines an illegal call as one from an unauthorised IP whose caller number is not registered on the platform, so no mapping gateway matched at all. The system parameter SS_CDR_RECORD_ILLEGAL (On) records these calls, which helps you spot scanners. For other codes, see calls failing.
Questions about this topic
What is Call authentication mode in VOS3000?
A mapping gateway setting that decides how VOS3000 recognises calls from a customer: by IP, by IP Address and Port, or with Password authentication required.
What does CallAuthenticationFailure (-6) mean?
VOS3000 refused the call because it could not authenticate it against the mapping gateway. Check the IP, the port and the password the customer sends.
What is the difference between -6 and -9 IllegalCall?
IllegalCall means the caller's IP is on no mapping gateway and the caller's number is not a phone on the platform. With -6 the call was refused by the authentication check.
Can two customers share one IP address?
Yes. Use IP Address and Port with a different signaling port for each, or password authentication. For static gateways with the same IP, Priority decides which one matches.
Run VOS3000 without the server work
Pick a VOS3000 server hosted by us, or have us install VOS3000 on your own server. VOS3000 Web and the Android app come with it.
Keep reading
Add a mapping gateway
Set up a customer gateway: types, IPs, line limits, prefixes and billing.
Calls failing: 403, 404, 408, 503 and -69
What the common SIP errors and VOS3000 reasons mean, and where to look first.
Fraud protection settings
Authentication lockouts, dynamic blacklists, geofencing and call limits that cap fraud losses.
Debug trace and SIP capture
Trace call signalling in the desktop client, read Call analysis, or capture SIP with tcpdump and sngrep.