OutOfBandRegistration class abstract

The operation handling an out-of-band registration. This is the object returned by the SDK, when a OutOfBandPayload was processed and the OutOfBandPayload corresponds to a registration operation.

Usage example:

  class AuthenticatorSelectorImpl implements AuthenticatorSelector {
    @override
    void selectAuthenticator(
      AuthenticatorSelectionContext context,
      AuthenticatorSelectionHandler handler,
    ) {
      handler.aaid(aaid);
    }
  }

  class PinEnrollerImpl implements PinEnroller {
    @override
    void enrollPin(
      PinEnrollmentContext context,
      PinEnrollmentHandler handler,
    ) {
      handler.pin(pin);
    }
  }

  class PasswordEnrollerImpl implements PasswordEnroller {
    @override
    void enrollPassword(
      PasswordEnrollmentContext context,
      PasswordEnrollmentHandler handler,
    ) {
      handler.password(password);
    }
  }

  class BiometricUserVerifierImpl implements BiometricUserVerifier {
    @override
    void verifyBiometric(
      BiometricUserVerificationContext context,
      BiometricUserVerificationHandler handler,
    ) {
      handler.verifyBiometric();
    }
  }

  [...]
  Future<void> registerWithOutOfBand({
    required MobileAuthenticationClient client,
    required OutOfBandPayload payload,
    required DeviceInformation deviceInformation,
  }) async {
    await client.operations.outOfBandOperation
      .payload(payload)
      .onRegistration((registration) {
        registration
          .deviceInformation(deviceInformation)
          .authenticatorSelector(AuthenticatorSelectorImpl(...))
          .pinEnroller(PinEnrollerImpl(...))
          .passwordEnroller(PasswordEnrollerImpl(...))
          .biometricUserVerifier(BiometricUserVerifierImpl(...))
          .onSuccess(() {
            // handle success
          })
          .onError((error) {
            // handle error
          })
      })
      .onAuthentication((authentication) {
        // handle authentication
      })
      .onError((error) {
        // handle out-of-band error
      })
      .execute();
  }
  [...]

The biometric, device passcode and fingerprint authenticators are enrolled at the OS level. That is why, if one of them must be registered, the user must authenticate through BiometricUserVerifier, DevicePasscodeUserVerifier or FingerprintUserVerifier. In the case of the PIN and password, the credentials are enrolled during registration, so no authentication is needed.

See OutOfBandOperation.onRegistration