iOS UIKit#
The Curity HAAPI iOS UIKit is the top of the iOS HAAPI stack. It composes IdsvrHaapiSdk internally and ships prebuilt themable view controllers for every step of a HAAPI flow — login forms, BankID, polling, WebAuthn / Passkeys, error screens, authenticator selectors. Both UIKit and SwiftUI hosts are supported.
This page is a platform-specific entry point: install instructions, the per-language reference, and pointers to the shared topic pages.
Installation#
The iOS UIKit ships as its own artifact, IdsvrHaapiUIKit. The iOS SDK and Driver are automatically pulled in as transitive dependencies — you do not need to declare them 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: "IdsvrHaapiUIKit", package: "ios-idsvr-haapi-sdk-dist") pod 'IdsvrHaapiUIKit' Requirements#
- iOS 14.0 or later runtime target.
- iOS 16.0+ and CIS 8.7.0+ for native Passkeys / WebAuthn support.
- iOS 16.0+ and Xcode 15+ for the
#Previewmacro used by Preview Tools ;PreviewProviderworks on earlier Xcode versions. - A
URL Typesentry inInfo.plistmatching yourappRedirectscheme, plus a deep-link manager call inapplication(_:open:options:)(see Quickstart — iOS step 5).
Code Reference#
The auto-generated iOS UIKit reference, with the full public API surface, lives at:
For class-level documentation, signatures, and parameter lists, follow the link above. The pages below cover configuration and usage patterns.
Topic Pages#
Foundational#
- Configuration —
HaapiUIKitConfigurationBuilder, the minimal builder calls - Flow Lifecycle —
HaapiFlow.start,HaapiFlowResult, interruption
Configuration#
- Presentation Options — modal vs stack, polling, selector style, auto-error-feedback
- Theming — colors, fonts, plist-driven component styles
- UI Extensibility — swap individual view controllers
- Passkeys and WebAuthn Fallback — native flow + browser fallback
Operational#
- Preview Tools —
HaapiUIPreviewerfor Xcode Preview canvas - Logging —
HaapiLoggerwith Driver + SDK + UI tags
Platform-Only#
- App Extension Support (iOS Only) — using HAAPI from an App Extension
Related: UI Layer Overview · Android UIWidget (sibling) · iOS SDK · iOS Driver · iOS Reference