AuthAttemptStart Event

Signifies the start of an authentication attempt.

Syntax

ANSI (Cross Platform)
virtual int FireAuthAttemptStart(AuthenticatorAuthAttemptStartEventParams *e);

typedef struct {
  const char *UserID;
  const char *AuthMethod;
  const char *RemainingAuthMethods;
  int reserved;
} AuthenticatorAuthAttemptStartEventParams;

Unicode (Windows)
virtual INT FireAuthAttemptStart(AuthenticatorAuthAttemptStartEventParams *e);

typedef struct {
  LPCWSTR UserID;
  LPCWSTR AuthMethod;
  LPCWSTR RemainingAuthMethods;
  INT reserved;
} AuthenticatorAuthAttemptStartEventParams;

- (void)onAuthAttemptStart:(NSString*)userID :(NSString*)authMethod :(NSString*)remainingAuthMethods;

#define EID_AUTHENTICATOR_AUTHATTEMPTSTART 2

virtual INT SECUREBLACKBOX_CALL FireAuthAttemptStart(LPSTR &lpszUserID, LPSTR &lpszAuthMethod, LPSTR &lpszRemainingAuthMethods);

Remarks

This event reports the start of an atomic authentication step. The AuthMethod parameter contains the authentication method that has started. The following authentication methods are currently supported, but the application may define its own methods in AuthStart, and tune them up in CustomAuthStart:

password
otp-h
otp-t
dcauth

RemainingAuthMethods contains a list of authentication methods that will follow.

This event is thrown from StartAuth and ContinueAuth methods.

SecureBlackbox 2020 C++ Edition

AuthAttemptStart Event

Syntax

Remarks