Filter
Top Products
287
Dialogic Corporation
appropriate authentication quadruplet was configured in the interim. The reason code for such a
termination is IPEC_SIPReasonStatus401Unauthorized or
IPEC_SIPReasonStatus407ProxyAuthenticationRequired.
Digest authentication is supported for the following SIP message types:
• BYE
• INFO within a dialog
• INVITE and re-INVITE (subsequent INVITE within a dialog)
• NOTIFY within a dialog
• OPTIONS within a dialog
• REFER within a dialog
• REGISTER
• SUBSCRIBE
Authentication is specifically not supported for the following SIP message types:
• INFO outside of a dialog
• NOTIFY outside of a dialog
• OPTIONS outside of a dialog
Applications configure authentication quadruplets for virtual board by constructing a
GC_PARM_BLK that contains a separate parameter element for each quadruplet, then calling the
gc_SetAuthenticationInfo( ) function with that parameter block. Authentication quadruplets are
removed in the same way but using a different parameter ID in the parameter element. The same
function call can configure or remove any number of quadruplets for a given virtual board by
including the appropriate combination of parameter elements in the GC_PARM_BLK. For a given
function call, each parameter in the GC_PARM_BLK should have a unique realm/identity pair; if
multiple parameter elements have the same realm/identity pair, only the last of these elements in
the parameter block becomes effective.
To add or modify an authentication quadruplet, the relevant set ID and parameter ID are:
IPSET_CONFIG
IPPARM_AUTHENTICATION_CONFIGURE
• value = IP_AUTHENTICATION data structure containing the desired quadruplet values.
If the realm/identity pair is unique for the virtual board, a new quadruplet is added to the
library’s authentication database. If the realm/identity pair matches an existing quadruplet,
the existing username/password pair is replaced by the new username/password pair.
To remove an existing authentication quadruplet, the relevant set ID and parameter ID are:
IPSET_CONFIG
IPPARM_AUTHENTICATION_REMOVE
• value = IP_AUTHENTICATION data structure that identifies the realm and identity of the
quadruplet to be removed. The username and password elements of this structure are
ignored. If the specified realm and identity do not match those of an existing quadruplet,
the function call produces an IPERR_UNAVAILABLE error.