NetIQ AccessManager Mobile SDK 2.0 for Android

This page is the entry point for the Microfocus Android Mobile Software Development Kit (the SDK). The SDK consists of the SDK implementation in an .AAR file, integration and API documentation, and a sample application that utilizes the SDK for OAuth2 authentication.

The target audience for the SDK is integrators who are crating Android applications that use Microfocus authentication products, like Access Manager, for authentication.

The SDK provides:

Abstracted OAuth2 Authentication.

A single authentication callback for the client application to implement.

A single un-authentication callback for the client application to implement.

Automatic refreshing of OAuth2 access tokens.

Encrypted persistance of an Identity Provider and OAuth2 Tokens.

Achieve native-app SSO if configured.

Note: To get to complete features provided by the SDK, admin will need to enable MobileAccess. Start here:

The SDK integration guide is provided in the JavaDoc for the main SDK Java package overview. This documentation may be found at the following location by scrolling down to the package overview section.

How do I integrate the SDK into my Android native application?

To include the SDK in your application's build environment, place the /mobilesdklibrary-release/mobilesdklibrary-release.aar file into your application's Android Studio project as a dependant library.

The sample application is provided as part of the SDK in the "app" subdirectory. The SDK itself is in the form of an Android Studio project. Importing the SDK into Android Studio will allow the Sample Application to be built and subsequently executed in an emulator or on a device following standard Android Studio procedures.

If you do not want to use the project provided with the SDK, you may alternatively create a new empty Android Studio project and do the following:
1) Add the sample application source code and resource definitions at /app/src/main/* to your empty project.
2) Integrate the /app/src/main/AndroidManifest.xml file into your new empty Android Studio project's manifest file.
3) Add the /mobilesdklibrary-release/mobilesdklibrary-release.aar as a dependant library of your new empty Android Studio project.

During AuthService initialization, to gain access to all features provided by the sdk - - If using individual OAuth Urls then, make sure token exchange Url is specified as .../mobiletoken - Utilizing OIDC Discovery will not work. Logout does not remove the device from the device management sub system. App crashes if device orientation is changed during authentication.