AuthVerify Event

Requests the application to validate an authentication token.

Syntax

class AuthenticatorAuthVerifyEventParams {
public:
  const QString &UserID();
  const QString &AuthMethod();
  const QString &AuthToken();
  const QString &AuthMethodData();
  bool Valid();
  void SetValid(bool bValid);
  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void AuthVerify(AuthenticatorAuthVerifyEventParams *e);

// Or, subclass Authenticator and override this emitter function.
virtual int FireAuthVerify(AuthenticatorAuthVerifyEventParams *e) {...}

Remarks

Class fires this event to ask the application to validate an authentication token that it can't validate automatically. This can happen if UserID was not found in the user database or a custom authentication method is used.

AuthMethod and AuthToken specify the authentication method being used and the authentication token provided by the user. AuthMethodData contains an application-specific data provided by the application at the beginning of the authentication step.

An event handler subscribed to this event should validate the authentication token provided by the user and set the Valid parameter accordingly.