SecureBlackbox 2020 macOS Edition

Questions / Feedback?

StartAuth Method

Initiates an authentication process.

Syntax

public func startAuth(userID: String) throws -> Int32

Remarks

Call this method to start an authentication process for UserID.

The authentication process may consist of multiple atomic steps. Each step represents a single authentication transaction, such as provision of a password, a PIN, or a one-time token. The exact authentication step sequence for the user is chosen according to the following rules:

  • If the user is found in the Users database, all authentication methods specified for that user are activated;
  • otherwise, the methods assigned to DefaultAuthMethods are activated;
  • AuthStart event is thrown, allowing the application to tune up the selection of authentication methods if needed.
  • the first method from the list is initiated.

This method may return one of the three results:

arAuthFurtherAuthNeeded0
arAuthSucceeded1
arAuthFailed2

The authentication succeeded result is returned if the authentication method selection procedure completed with an empty method list. A typical result of this method though is further authentication required, which indicates that the next authentication method has kicked off. Use rpAuthInfo; property to find out which authentication method should be used on this step, and solicit the relevant authentication token from the user. Pass the received token to the ContinueAuth method for validation.

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