SecureBlackbox 2020 C++ Edition

Questions / Feedback?

AuthStart Event

Signifies the start of an authentication process.

Syntax

ANSI (Cross Platform)
virtual int FireAuthStart(AuthenticatorAuthStartEventParams *e);
typedef struct {
const char *UserID;
char *AuthMethods; int reserved; } AuthenticatorAuthStartEventParams; Unicode (Windows) virtual INT FireAuthStart(AuthenticatorAuthStartEventParams *e);
typedef struct {
LPCWSTR UserID;
LPWSTR AuthMethods; INT reserved; } AuthenticatorAuthStartEventParams;
- (void)onAuthStart:(NSString*)userID :(NSString**)authMethods;
#define EID_AUTHENTICATOR_AUTHSTART 3

virtual INT SECUREBLACKBOX_CALL FireAuthStart(LPSTR &lpszUserID, LPSTR &lpszAuthMethods);

Remarks

This event is fired in response to a StartAuth call, and signifies the start of a (potentially, multi-step) authentication process for UserID. The AuthMethods parameter list the methods to be performed for the user. The application may customize them as needed.

The following default authentication methods are supported:

  • password
  • otp-h
  • otp-t
  • dcauth

The application can define its own authentication methods if needed.

This event is only fired once per user authentication process, at the very start of it. See AuthAttemptStart for per-step notification.

Copyright (c) 2022 /n software inc. - All rights reserved.
SecureBlackbox 2020 C++ Edition - Version 20.0 [Build 8166]