Passage iOS passkeys need the Associated Domains entitlement

TL;DR

For iOS passkeys with Passage, publish the Associated Domains file for your domain and add the Associated Domains capability to the iOS app target, following the iOS Complete SDK docs.

Steps

1. For iOS passkeys with Passage, publish the Associated Domains file for your domain and add the Associated Domains capability to the iOS app target, following the iOS Complete SDK docs. If native association is fighting you, consider switching the app to Hosted Login, which skips the asset-links and associated-domains setup entirely. Either way, verify the association file is served correctly before blaming the SDK.

When to use

You are seeing this: Either way, verify the association file is served correctly before blaming the SDK. Use this skill when you run into "Passage iOS passkeys need the Associated Domains entitlement".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Source: Official docs (Cross Platform iOS Configuration): documents a gotcha that trips agents shipping Passage passkeys in iOS apps. Apple requires the app to be associated with a website the app owns by publishing an Associated Domains file, and the iOS app must add the Associated Domains capability/entitlement. Like Android, this whole step can be skipped if the Passage app uses Hosted Login, which is the escape hatch agents miss while debugging native passkey failures.

Verified resolution: For iOS passkeys with Passage, publish the Associated Domains file for your domain and add the Associated Domains capability to the iOS app target, following the iOS Complete SDK docs. If native association is fighting you, consider switching the app to Hosted Login, which skips the asset-links and associated-domains setup entirely. Either way, verify the association file is served correctly before blaming the SDK.

Source URL: https://docs.passage.id/complete/cross-platform-passkey-configuration/cross-platform-ios-configuration