iOS Driver#

The Curity HAAPI iOS Driver is the lowest-level building block of the HAAPI client stack on iOS. It exposes HaapiTokenManager for DPoP access-token retrieval and HaapiClient for HTTP requests that automatically carry the right Authorization and DPoP headers. The iOS SDK and iOS UIKit frameworks 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#

The iOS Driver ships as its own artifact, IdsvrHaapiDriver. It is the lowest layer in the iOS HAAPI stack; higher-layer frameworks (IdsvrHaapiSdk, IdsvrHaapiUIKit) pull it in transitively when installed. The Swift Package Manager dist repository exposes each framework as a separate product; the CocoaPods registry exposes them as three separate pods.

dependencies: [
    .package(url: "https://github.com/curityio/ios-idsvr-haapi-sdk-dist")
]
// ... and in your target's dependencies:
.product(name: "IdsvrHaapiDriver", package: "ios-idsvr-haapi-sdk-dist")

pod 'IdsvrHaapiDriver'

Code Reference#

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

• https://curity.io/docs/haapi-ios-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, direct token retrieval, session-identifier handling, lifecycle
• Attestation (Driver Layer) — DCAppAttestService usage, custom policies for emulators

Configuration#

• Token Binding — BoundedTokenConfiguration setup
• Risk Assessment — RiskAssessmentConfiguration from AppDelegate
• Client Authentication — Secret, MTLS, Signed JWT

Operational#

• Error Handling — HaapiError and recoverySuggestion
• Logging — HaapiLogger.setLogType and follow-up tags