iOS SDK#

The Curity HAAPI iOS SDK sits on top of the iOS Driver. It exposes HaapiManager for flow stepping and OAuthTokenManager for OAuth token lifecycle, wrapped together by HaapiAccessor. The iOS UIKit framework composes this SDK internally.

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

Installation#

The iOS SDK ships as its own artifact, IdsvrHaapiSdk. The iOS Driver is automatically pulled in as a transitive dependency — you do not need to declare it separately. 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: "IdsvrHaapiSdk", package: "ios-idsvr-haapi-sdk-dist")

pod 'IdsvrHaapiSdk'

The SDK requires iOS 14 or later.

Code Reference#

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

• https://curity.io/docs/haapi-ios-sdk/latest/

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

Topic Pages#

Foundational#

• Creating a HaapiAccessor — HaapiAccessorBuilder and the three access patterns
• HAAPI Flow — start → submit → followLink stepping and step models
• iOS Representations — the HaapiResult enum, the 14 step types, actions, form fields, and problems
• OAuthTokenManager — fetch, refresh, revoke

Configuration#

• Token Binding — BoundedTokenConfiguration setup
• DCR — DCRConfiguration fallback for non-attestation devices
• Risk Assessment — RiskAssessmentConfiguration from AppDelegate
• Client Authentication — wiring Secret, MTLS, or Signed JWT

Operational#

• Token Endpoint Response Listener — capture raw headers and JSON
• Error Handling — HaapiError.recoverySuggestion and ErrorTokenResponse
• Logging — HaapiLogger.setLogType with Driver + SDK tags