Logging out

• Logout a user
• Example code
• Handler methods

Logout a user

In the SDK a user is treated as logged in as long as the user has an access token for the operation to be executed. To logout the user the access token should be removed. This can be done by calling the logout function on the UserClient. The SDK will also send a request to the Token Server to remove the access token to ensure the token is invalidated both on the client as server side. If a refresh token is stored on the device, it will remain after the logout action, so it can be used to login again later.

Example code

Example code to logout a user:

@OnClick(R.id.button_logout)
public void logout() {
  final OneginiClient oneginiClient = OneginiSDK.getOneginiClient(this);
  final UserProfile userProfile = oneginiClient.getUserClient().getAuthenticatedUserProfile();
  OneginiSDK.getOneginiClient(this).getUserClient().logout(
      new OneginiLogoutHandler() {
        @Override
        public void onSuccess() {
          // Go to login screen
          showToast("logoutSuccess");
          startLoginActivity();
        }

        @Override
        public void onError(final OneginiLogoutError oneginiLogoutError) {
          handleLogoutError(oneginiLogoutError, userProfile);
        }
      }
  );
}

private void handleLogoutError(final OneginiLogoutError oneginiLogoutError, final UserProfile userProfile) {
  @OneginiLogoutError.LogoutErrorType final int errorType = oneginiLogoutError.getErrorType();

  if (errorType == OneginiLogoutError.DEVICE_DEREGISTERED) {
    new DeregistrationUtil(this).onDeviceDeregistered();
  } else if (errorType == OneginiLogoutError.USER_DEREGISTERED) {
    new DeregistrationUtil(this).onUserDeregistered(userProfile);
  }

  // other errors don't really require our reaction, but you might consider displaying some message to the user
  showToast("Logout error: " + oneginiLogoutError.getErrorDescription());

  startLoginActivity();
}

Handler methods

• void onSuccess() is called when the logout was successful, so you should redirect user to a login screen.

• If void onError(final OneginiLogoutError oneginiLogoutError) was called, it indicates that some error during logout occurred. For example: the SDK was able to remove the access token from storage, but revoke request that was send to the Token Server failed for some reason. In such scenerio you should still redirect user to login screen.

Please note that you can handle differently errors which are relevant to you. To accomplish that you should compare OneginiLogoutError#getErrorType() value with OneginiLogoutError error type definitions. The OneginiLogoutError will also contain additional error description and possible Exception object which you can get with getErrorDescription() and getException() methods.

For more info on error handling see the error handling topic guide.