Driver Layer#
The Driver Layer is the lowest level of the HAAPI SDK stack. It gives you direct access to HaapiTokenManager, HAAPI HTTP clients, and the attestation flow on iOS and Android. Most applications do not need this layer — pick it only when you need full control over the HTTP transport or token lifecycle.
There is no Driver Layer page for React Native: the React Native SDK consumes the iOS SDK Layer and Android Driver + SDK Layers internally and does not expose Driver primitives to JavaScript.
Reading order. Start with the Driver Layer Overview, then jump to your platform’s entry page. The shared topic pages (HaapiTokenManager, Attestation, Client Authentication, …) use platform tabs and can be read in any order once the platform entry page is familiar.
Foundational#
The starting points for working at the Driver Layer.
| Page | Topic |
|---|---|
| Driver Layer Overview | What the Driver Layer is, when to choose it, and what it costs |
| iOS Driver | Install IdsvrHaapiDriver, build HaapiTokenManagerBuilder, link to the autodoc |
| Android Driver | Install the Maven artifact, build HaapiTokenManager, link to the autodoc |
| HTTP Integration (Android Only) | HttpURLConnectionProvider defaults, cookie handling on Android |
Configuration and Topics#
Cross-platform topics shown with iOS / Android tabs. Each page covers configuration parameters, runtime behaviour, and platform-specific notes.
| Page | Topic |
|---|---|
| HaapiTokenManager | Direct token retrieval and DPoP proof generation at the Driver Layer |
| Attestation (Driver Layer) | iOS App Attest / Android Key Attestation, fallback paths |
| Client Authentication (Driver Layer) | Secret, MTLS, and Signed JWT wired directly on the Driver builders |
| Token Binding (Driver Layer) | DPoP-bound authorization codes and refresh tokens at the Driver Layer |
| Risk Assessment (Driver Layer) | Device-context fields collected for BankID-style risk integrations |
Operational#
Cross-cutting operational concerns that apply to every Driver Layer integration.
| Page | Topic |
|---|---|
| Error Handling (Driver Layer) | Retryable / unrecoverable categorisation, IdsvrHaapiException hierarchy |
| Logging (Driver Layer) | HaapiLogger.setLogType / setLevel, sensitive-value masking, sinks |
Related layers: SDK Layer · UI Layer · Choose Your Layer