AuthStart Event
Signifies the start of an authentication process.
Syntax
class AuthenticatorAuthStartEventParams { public: const QString &UserID(); const QString &AuthMethods(); void SetAuthMethods(const QString &qsAuthMethods); int EventRetVal(); void SetEventRetVal(int iRetVal); };
// To handle, connect one or more slots to this signal. void AuthStart(AuthenticatorAuthStartEventParams *e);
// Or, subclass Authenticator and override this emitter function. virtual int FireAuthStart(AuthenticatorAuthStartEventParams *e) {...}
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.