====== sipPassword ======
wrtc.sipPassword is a string parameter containing user's SIP password.

It is used in SIP systems using [[ixnx:wrtc:js:digest_authentication_sequence|digest authentication]] to log in to SIP server.

<WRAP center round important 100%>
As wrtc.sipPassword contains user's SIP password in clear text it is a major security risk!
</WRAP>

To avoid security risks wrtc.sipPassword should only contain //new// passwords freshly entered by user.

[[ixnx:wrtc:js:api:line:authenticate|line.authenticate()]] creates a [[ixnx:wrtc:js:api:wrtc:sipha1|wrtc.sipHa1]] hashsum of the wrtc.sipPassword password upon call.

After [[ixnx:wrtc:js:api:line:authenticate|line.authenticate()]] has been called you should set wrtc.sipPassword=undefined; so that next call to [[ixnx:wrtc:js:api:line:authenticate|line.authenticate()]] uses [[ixnx:wrtc:js:api:wrtc:sipha1|wrtc.sipHa1]] instead, and no clear text copy of the user's password is available anywhere on your page or its code.

===== Value =====
String containing user's SIP password.

===== Default value =====
Undefined.

===== Usage =====
wrtc.sipPassword is used in [[ixnx:wrtc:js:api:line:authenticate|line.authenticate()]].

Usually you set wrtc.sipPassword in your [[ixnx:wrtc:js:api:wrtc:onauthenticate|wrtc.onAuthenticate()]] [[ixnx:wrtc:js:api:eventhandler|event handler]] before it calls [[ixnx:wrtc:js:api:line:authenticate|obj.authenticate()]].

However if you want to change contents of wrtc.sipPassword at some other time you must call wrtc.changeName() to trigger a new SIP authentication (a new [[ixnx:wrtc:js:api:wrtc:onauthenticate|wrtc.onAuthenticate()]] event).

===== See also =====
[[ixnx:wrtc:js:api:wrtc:sipauthname|wrtc.sipAuthName]]

[[ixnx:wrtc:js:api:wrtc:sipha1|wrtc.sipHa1]]

[[ixnx:wrtc:js:api:wrtc:onauthenticate|wrtc.onAuthenticate()]]

[[ixnx:wrtc:js:api:line:authenticate|line.authenticate()]]

[[ixnx:wrtc:js:digest_authentication_sequence|Digest authentication sequence]]