Defender 5.9.3 - Administration Guide

challengeMessageData property

Provides any variable data contained in the message to be displayed to the user after each invocation of the Authenticate method.

C++ syntax
public : HRESULT get_challengeMessageData(BSTR * messageData);

C# syntax
public string challengeMessageData { get; }

IAuthenticator3 interface

.

AddPayload method

Allows RADIUS payload attributes to be added to the authentication request. Typically this method is used when the authenticating server or an intermediary requires additional information about the authenticating party.

The structure used to pass data to this function is defined below:

struct RADIUSPayloadAttribute

{

   DWORD vendorId;

   unsigned char type;

   unsigned char length;

   unsigned char data[253];

};

C++ syntax
public : HRESULT AddPayload(struct RADIUSPayloadAttribute *payload)

C# syntax
void AddPayload(ref RADIUSPayloadAttribute payload);

Parameters

payload  Application specific payload data as a struct RADIUSPayloadAttribute.

Return value

Always returns S_OK.

GetGridData method

After an authentication request this method can be called to determine whether a user has a grid available and the state of that grid.

C++ syntax
public : HRESULT GetGridData(BSTR *grid, VARIANT_BOOL *isRegistrationGrid, VARIANT_BOOL *isGrIDsureOnly, VARIANT_BOOL *hasGrid);

C# syntax
bool GetGridData(out string grid, out bool isRegistrationGrid, out bool isGrIDsureOnly);

Parameters

• grid  A string containing the values for the grid.
• isRegistrationGrid  Returns TRUE if the user has not yet registered a PIP.
• isGrIDsureOnly  Returns TRUE if the user only has a GrIDsure token.
• hasGrid  Returns TRUE if a grid is available.

Return value

Always returns S_OK.