Comment on page
Add Passage to your iOS project
You can easily install Passage through Swift Package Manager or Cocoapods.
To install via Swift Package Manager, simply enter this url Xcode's Swift Package Manager's search bar:
If your app uses Cocoapods instead, add this dependency to your
Import Passage and delcare an instance, like this:
let passage = PassageAuth(appId: "YOUR_APP_ID")
If you are NOT using passkeys, that's it - you're ready to start using Passage!
If you ARE using passkeys, follow the below instructions
Apple uses Associated Domains to establish a secure association between your domain and your app so you can securely authenticate your users with passkeys. You'll need to create and serve the associated domains file in order to use passkeys or magic links in your iOS app.
Create a file called
apple-app-site-association(no file extension). You can copy and paste the content below, replacing
Note that you only need the
applinksobject if your app uses magic links.
Serve this file from your site’s
The next step is to enable the appropriate entitlements for your project in Xcode. These entitlements will associate your iOS app with your domain and use the apple-app-site-association file to verify this association.
To add the capability and entitlements to your application:
- 1.Open the target's "Signing & Capabilities" tab in Xcode and add Associate Domains capability.
- 2.Click Add(+) at the bottom of the Associate Domains section.
webcredentials:YOUR_DOMAINlike in the screenshot below. Add
applinks:YOUR_DOMAINif your app uses magic links.
Add your associated domains entitlements.