Interface Orchestrator


  • public interface Orchestrator
    The Orchestrator interface is the entry point of the Orchestration SDK. It allows the execution of orchestration commands providing seamless two-factor authentication.

    Creation

    You can create an orchestrator using the internal class Orchestrator.Builder. This builder will provide you with the minimal required configuration for the orchestrator.

    Subsequent configurations can be done during the lifecycle of the Orchestrator object by using the related setters.

    Provisioning

    In order to provision the SDK with a DIGIPASS instance, a call to startActivation(ActivationParams activationParams) must be performed.
    All subsequent orchestration commands transmission shall be done through the execute(String) method.

    Notification registration

    In order to provision the SDK with a DIGIPASS instance, a call to startNotificationRegistration(NotificationRegistrationParams activationParams) must be performed.

    Commands

    All subsequent orchestration commands transmission shall be done through the execute(String) method.
    • Method Detail

      • execute

        void execute​(@NonNull
                     java.lang.String command)
        Executes an Orchestration Command provided by the server.
        Parameters:
        command - the Orchestration Command provided by the server, as an hexadecimal string.
      • startActivation

        void startActivation​(@NonNull
                             ActivationParams activationParams)
        Starts the activation process.
      • startNotificationRegistration

        void startNotificationRegistration​(@NonNull
                                           NotificationRegistrationParams notificationRegistrationParams)
        Starts registering for push notifications.
      • startChangePassword

        void startChangePassword​(@NonNull
                                 ChangePasswordParams changePasswordParams)
        Starts password changing.
      • startLocalAuthentication

        void startLocalAuthentication​(@NonNull
                                      LocalAuthenticationParams localAuthenticationParams)
        Starts a local authentication process. This method is used to generate a one-time password using a specified protection type and an optional challenge.
      • startLocalTransaction

        void startLocalTransaction​(@NonNull
                                   LocalTransactionParams localTransactionParams)
        Starts a local transaction process. This method is used to generate a signature from specified data fields and using a specified protection type.
      • setRemoteAuthCallback

        void setRemoteAuthCallback​(@NonNull
                                   RemoteAuthenticationCallback remoteAuthenticationCallback)
        Sets the callback to be notified about remote authentication events.
      • setRemoteTranCallback

        void setRemoteTranCallback​(@NonNull
                                   RemoteTransactionCallback remoteTransactionCallback)
        Sets the callback to be notified about remote transaction validation events.
      • setErrorCallback

        void setErrorCallback​(@NonNull
                              OrchestrationErrorCallback orchestrationErrorCallback)
        Sets the callback to be notified of errors.
      • setWarningCallback

        void setWarningCallback​(OrchestrationWarningCallback orchestrationWarningCallback)
        Sets the callback called when warnings happen.