Cross Platform iOS Configuration

Configure your React Native app for iOS

Step 1: Publish Associated Domains file

To enable support for passkeys for the iOS version of your mobile app, Apple requires that you associate your app with a website that your app owns by publishing an Associated Domains file. Instructions can be found in "Step 1" or our iOS SDK docs:

Publish Associated Domains file

Step 2: Add Associated Domains entitlements

The next step is to add the "Associated Domains" capability to the iOS version of your app. Instructions can be found in "Step 2" of our Android SDK docs:

Add Associate Domains entitlements

Step 3: Add Passage app id and auth origin to your iOS app

Lastly, in Xcode in your project's <app root>/ios/ folder you'll need to create a Property List file called Passage.plist. Open the file as source code and paste these contents, replacing YOUR_PASSAGE_APP_ID and YOUR_AUTH_ORIGIN (without "https://" prefix).

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>appId</key>
    <string>YOUR_PASSAGE_APP_ID</string>
    <key>authOrigin</key>
    <string>YOUR_AUTH_ORIGIN</string>
</dict>
</plist>