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.