onAuthenticateFailed()

wrtc.onAuthenticateFailed() is an event function called when RTCgate or SIP authentication has failed.

You must write your own wrtc.onAuthenticateFailed() function to be able to inform user about authentication failure.

Arguments

wrtc.onAuthenticateFailed(obj, err)

obj - line object that raised the event
err - JSON structure containing information about the error:
- errorCode - error number
- errorMsg - string containing informative description of the error

errorCode	errorMsg	Description:
423	"expired"	REST authentication token expired (wrtc_kit will now automatically try to fetch a new one)
401	"rejected (sub)"	authentication attempt rejected, sub indicates error subcode (see table below)
other error codes may also occur

Error 401 subcodes:

sub	Description:
0	rejected by SIP server (most probably dure incorrect password)
-1001	REST token received but not REST token authentication mode
-1002	REST token empty
-1003	REST token wrong checksum
-1004	REST token attempted to select disabled/illegal template
-1010	websocket origin blocked by template (occurs after obj.authenticate())
-1100	websocket origin blocked by template (occurs after wrtc.changeCredentials())
-1200	no SIP address specified (no @ in wrtc.addressName)
-1201	SIP address blocked by template
-1301	disabled/illegal template number specified in wrtc.adv.template
-9999	unspecified error
other error subcodes may also occur

Ignored.

wrtc.onAuthenticateFailed = function(obj, err) {
  window.alert("Authentication failed: " + err.errorCode + ": " + err.errorMsg);
}