Account Management

Account management is a key part of the communicating with the Imageware Authenticate server. In order to perform secured tasks, the active device needs to be registered with an account.

Registering a Device

Use the AccountServiceManager to register devices as described below.

note

In the default setup, device registration triggers the server to send an email to the account so the user can confirm their device registration using PIN codes sent via email. You validate device registration by having the user enter the PIN and calling the validate call with the PIN as a parameter (see below).

iOS

accountServiceManager.register(profile: account) { [weak self] (response) in

switch response {

case .success:

self?.alertTitle = "Registration started, please enter your PIN in the next screen"

self?.showingAlert.toggle()

case .error(let error):

self?.alertTitle = "Error"

self?.showingAlert.toggle()

@unknown default: break

}

}

// later, when the user types in their PIN

accountServiceManager.validate(profile: account, validationCode: theValidationCode) { [weak self] (response) in

switch response {

case .success:

self?.alertTitle = "Account registration successfully completed"

self?.showingAlert.toggle()

case .error(let error):

self?.alertTitle = "Error"

self?.showingAlert.toggle()

@unknown default: break

}

}

Android

accountServiceManager.register(profile, appCode, appVersion).collect(::handleResendPinCodesResult)

private suspend fun handleResendPinCodesGmiResult(it: GmiResult<RegistrationStatus>) {

when (it) {

is GmiResult.Success -> {

showAlert("Account registration successfully completed")

}

is GmiResult.Error -> {

showAlert("Error")

}

}

}

// later, when the user types in their PIN

accountServiceManager.validate(profile, pin).collect(::handleValidationResult)

private suspend fun handleValidationResult(it: GmiResult<Profile>) {

when (it) {

is GmiResult.Success -> {

// done

}

is GmiResult.Error -> {

when (it.error) {

GmiError.PIN_NOT_VALIDATED -> {

showAlert("You entered an incorrect PIN")

}

else -> {

showAlert("Error")

}

}

}

}

}

The register function will only register the current device's ID once. Subsequent register calls will make the server call but will not trigger a new email to be sent. To resend the email, call the function above with resendConfirmation set to true.

Unregistering a Device

Removing a profile from a device is easy, just call AccountServiceManager's remove function as shown below.

iOS

self.deviceManager.remove(profile: account) { [weak self] (response) in

guard let self = self else { return }

switch response {

case .success:

// profile was successfully disconnected from this device on the server

case .error:

// the error enum will include additional information about the issue

@unknown default: break

}

}

Android

accountServiceManager.remove(profile)

This call breaks the association between the device and the profile on the server, so if you re-register the user to the same device it will require the user to confirm their email again.