---
title: Prepare an apple-app-site-association file
description: You can create an apple-app-site-association file that creates a secure association between your domain and your app. This allows you to share credentials, and use universal links to open your app from your website.
component: sdks
version: latest
page_id: sdks:sdks:use-cases/mobile-biometrics/ios/01-prepare-apple-app-site-association-file
canonical_url: https://docs.pingidentity.com/sdks/latest/sdks/use-cases/mobile-biometrics/ios/01-prepare-apple-app-site-association-file.html
revdate: Wed, 17 May 2023 14:10:20 +0100
keywords: ["PingOne Advanced Identity Cloud", "PingAM", "Journeys", "Setup & Configuration", "Source Code", "Use Case", "SDK"]
---

# Prepare an apple-app-site-association file

You can create an `apple-app-site-association` file that creates a secure association between your domain and your app. This allows you to share credentials, and use universal links to open your app from your website.

To create the secure association, you upload the `apple-app-site-association` file to your domain, and add matching Associated Domains Entitlement keys to your app.

1. Prepare an `apple-app-site-association` file. For example:

   ```json
   {
     "applinks": {
       "details": [
         {
           "appIDs": [
             "XXXXXXXXXX.com.example.AppName"
           ],
           "components": [
             {
               "/": "/reset/*",
               "comment": "Success after reset password journey"
             }
           ]
         }
       ]
     },
     "webcredentials": {
       "apps": [
         "XXXXXXXXXX.com.example.AppName"
       ]
     }
   }
   ```

   For more information, refer to [Supporting associated domains](https://developer.apple.com/documentation/xcode/supporting-associated-domains).

2. Host the file at your domain.

   * For PingOne Advanced Identity Cloud deployments, refer to [Upload an apple-app-site-association file](https://backstage.forgerock.com/docs/idcloud/latest/developer-docs/upload-ios-apple-app-site-association.html) in the *Identity Cloud documentation*.

   * For self-managed deployments, host the file at `https://<your domain>/.well-known/apple-app-site-association`.

3. Configure the associated domains entitlement key in your app.

   For more information, refer to [Associated Domains Entitlement](https://developer.apple.com/documentation/bundleresources/entitlements/com_apple_developer_associated-domains).