Free Online AASA / iOS Universal Links Validator - ATools

Validate Apple App Site Association (AASA): check reachability, Content-Type, JSON structure and applinks rules; includes a Universal Links matcher and a troubleshooting guide.

Edit this tool

AASA / iOS Universal Links Validator

Note: Browsers are restricted by CORS, so this tool fetches AASA via a public proxy. Do not input sensitive internal addresses; AASA should be publicly accessible.

Results

Domain / Site URL

AASA source for validation/matching

.well-knownRoot pathApple Official CDNPaste manually

Paste AASA JSON

Universal Links Matcher

No valid AASA selected

Universal Link URL

App ID (TeamID.BundleID)

Note: this is rule-level matching only; real iOS behavior is affected by caching, install state, OS version, and entry points.

Tutorial (quick troubleshooting)

1) Deploy AASA (server)

Place the file at https://<domain>/.well-known/apple-app-site-association (recommended) or https://<domain>/apple-app-site-association.
No extension (no .json), HTTPS accessible, and return 200.
Content-Type: application/json is recommended (signed AASA may be application/pkcs7-mime).
Typical structure: applinks.apps is []; applinks.details contains appID and paths/components.

2) Configure iOS (client)

In Xcode > Associated Domains, add applinks:your-domain.com (include subdomains as needed).
Make sure appID is correct: <TeamID>.<BundleID> and matches your signing.
Install the app and test by tapping links from Safari/Notes/Messages.

3) Common failure causes

Wrong path/filename (missing .well-known or mistakenly using .json).
Redirect/auth/WAF returns HTML.
Invalid AASA JSON: missing applinks.details[].appID or missing paths/components.
iOS caching: updates may take time to take effect.
Apple CDN may cache: app-site-association.cdn-apple.com may not be real-time.

4) Local quick checks (optional)

curl -i https://your-domain.com/.well-known/apple-app-site-association

xcrun simctl openurl booted https://your-domain.com/your/path

Note: commands may vary across macOS/iOS versions; enterprise networks/proxies may affect fetching.

Free Online AASA / iOS Universal Links Validator - ATools

Validate Apple App Site Association (AASA): check reachability, Content-Type, JSON structure and applinks rules; includes a Universal Links matcher and a troubleshooting guide.