Android Driver#

The Curity HAAPI Android Driver is the lowest-level building block of the HAAPI client stack on Android. It exposes HaapiTokenManager for DPoP access-token retrieval and an OkHttp interceptor that wraps requests with the right Authorization and DPoP headers. The Android SDK and Android UIWidget both compose this driver internally.

This page is a platform-specific entry point: install instructions, the per-language reference, and pointers to the shared topic pages where the configuration knobs are documented.

Installation#

Add the driver to your app/build.gradle:

dependencies {
    // Replace LATEST_VERSION with the latest release on Maven Central.
    implementation("se.curity.identityserver:identityserver.haapi.android.driver:LATEST_VERSION")
}

The OkHttp integration is optional; if you use it, add OkHttp explicitly because the driver does not pull it in as a transitive dependency:

dependencies {
    implementation("com.squareup.okhttp3:okhttp:3.14.9")
}

Code Reference#

The auto-generated Android Driver reference, with the full public API surface, lives at:

• https://curity.io/docs/haapi-android-driver/latest/

For class-level documentation, signatures, and parameter lists, follow the link above. The pages below cover configuration and usage patterns.

Topic Pages#

Foundational#

• HaapiTokenManager — construction, OkHttp integration, direct token retrieval, session-identifier handling, lifecycle
• Attestation (Driver Layer) — Key Attestation, custom policies for emulators

Configuration#

• Token Binding — TokenBoundConfiguration with a Storage implementation
• Risk Assessment — applicationContext from Application.onCreate
• Client Authentication — Secret, MTLS, Signed JWT

Operational#

• Error Handling — IdsvrHaapiException.Retryable and Unrecoverable
• Logging — HaapiLogger.setLevel and tag prefixes

Platform-Only#

• HTTP Integration (Android Only) — HttpURLConnectionProvider timeouts and cookie management