VOS3000 how-to

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

ModeWhat VOS3000 checksUse it when
IPThe source IP address.The customer sends from fixed IPs that only they use.
IP Address and PortThe source IP and port.Several customers or trunks send from one IP on different ports.
Password authentication requiredA 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

ParameterDefaultWhat it does
SS_SIP_AUTHENTICATION_CODEUnauthorized(401)The reply to a REGISTER or INVITE without Authorization or Proxy-Authorization.
SS_SIP_AUTHENTICATION_TIMEOUT10 sA caller that has not authenticated in this time is rejected.
SS_AUTHENTICATION_MAX_RETRY6Maximum terminal password retries (0 to 999).
SS_AUTHENTICATION_FAILED_SUSPEND180 sHow 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:

  1. 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.
  2. 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.
  3. 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.
  4. 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.