LanScape VOIP Media Engine
AUTHENTICATE_OPERATION
The AUTHENTICATE_OPERATION
enumeration defines the types of authentication operations that
an application can chose to process.
typedef enum
{
AUTHENTICATE_UNDEFINED = 0,
AUTHENTICATE_INCOMING_MESSAGE,
AUTHENTICATE_VERIFY_CREDENTIALS,
AUTHENTICATE_BAD_CREDENTIALS_RECEIVED,
}AUTHENTICATE_OPERATION;
Members:
AUTHENTICATE_UNDEFINED
An undefined operation. Applications should ignore this operation.
AUTHENTICATE_INCOMING_MESSAGE
Specifies that the media engine has received an incoming request that requires application input. When an application receives this operation type, it can determine if it wants to have the media engine challenge the request. Generally speaking, the application will receive this operation type when the media engine receives the SIP messages: REGISTER, INVITE, BYE, SUBSCRIBE and NOTIFY.
AUTHENTICATE_VERIFY_CREDENTIALS
Specifies that the media engine has received a challenge response back from the far end telephony application or device. Processing this operation will allow your application to verify the received authentication response.
AUTHENTICATE_BAD_CREDENTIALS_RECEIVED
The media engine sends this operation code to inform the application about received authentication credential errors. The far end application or device is violating the requirements of challenge authentication by using invalid or possibly missing challenge parameters.