Force app update

The Mobile SDK and Mobile Identity module provide the functionality to detect outdated applications and the ability to force an application update.

The administrator of the Mobile Identity module can disable a specific app version to prevent any client using it to perform an authentication flow. The Android SDK returns the OneginiAuthenticationError.OUTDATED_APP error in the OneginiAuthenticationHandler#onError method.

Use this handler method to notify the user that an application update is required.

After the user has updated the application, the Mobile Identity module will detect that a newer application version is installed and perform the required steps to update the internal application configuration and validate whether the current application version is valid.

Example return error on outdated app

OneginiClient.getInstance().getUserClient().authenticateUser(userProfile, new OneginiAuthenticationHandler() {

  @Override
  public void onSuccess(final UserProfile userProfile, final CustomInfo customInfo) {
    // ...
  }

  @Override
  public void onError(final OneginiAuthenticationError error) {
    if (error.getErrorType() == OneginiAuthenticationError.OUTDATED_APP) {
      // Show that the end-user is using a wrong / outdated application version and an update is required.
    } else {
      // other error reason
    }
  }
});