AASA / iOS Universal Links Validator
Hinweis: Browser sind durch CORS eingeschränkt, daher ruft dieses Tool die AASA über einen öffentlichen Proxy ab. Keine sensiblen internen Adressen eingeben; AASA sollte öffentlich erreichbar sein.
Ergebnisse
AASA-Quelle für Validierung/Matching
AASA-JSON einfügen
Universal Links Matching-Test
Keine gültige AASA ausgewählt
Hinweis: Hier wird nur auf Regel-Ebene gematcht; das tatsächliche iOS-Verhalten hängt u. a. von Cache, Installationsstatus, iOS-Version und Einstiegspunkt ab.
Anleitung (schnelles Troubleshooting)
1) AASA bereitstellen (Server)
- Datei unter `https://<domain>/.well-known/apple-app-site-association` (empfohlen) oder `https://<domain>/apple-app-site-association` ablegen.
- Keine Erweiterung (kein `.json`), per HTTPS erreichbar und 200 zurückgeben.
- `Content-Type: application/json` wird empfohlen (signierte AASA kann `application/pkcs7-mime` sein).
- Typische Struktur: `applinks.apps` ist `[]`; `applinks.details` enthält `appID` und `paths`/`components`.
2) iOS konfigurieren (Client)
- In Xcode > Associated Domains `applinks:your-domain.com` hinzufügen (Subdomains nach Bedarf).
- Sicherstellen, dass `appID` korrekt ist: `<TeamID>.<BundleID>` und zur Signatur passt.
- App installieren und Links z. B. aus Safari/Notizen/Nachrichten testen.
3) Häufige Fehlerursachen
- Falscher Pfad/Dateiname (`.well-known` fehlt oder versehentlich `.json`).
- Redirect/Auth/WAF liefert HTML zurück.
- Ungültiges AASA-JSON: `applinks.details[].appID` fehlt oder `paths/components` fehlen.
- iOS-Cache: Änderungen greifen ggf. verzögert.
- Apple-CDN-Cache: `app-site-association.cdn-apple.com` ist ggf. nicht in Echtzeit.
4) Lokale Schnellchecks (optional)
curl -i https://your-domain.com/.well-known/apple-app-site-association
xcrun simctl openurl booted https://your-domain.com/your/path
Hinweis: Befehle können je nach macOS/iOS-Version variieren; Unternehmensnetze/Proxys können das Abrufen beeinflussen.
So geht’s
- Im Feld „Domain / Website-URL“ die zugeordnete Domain eingeben (z. B. example.com).
- AASA-Quelle auswählen (Standard: .well-known) und „Abrufen & validieren“ klicken.
- Im Bereich „Ergebnisse“ HTTP-Status, Content-Type und JSON-Format prüfen.
- Im „Universal Links Matching-Test“ eine URL eingeben und prüfen, ob Regeln matchen.
Tipps
Dieses Tool nutzt einen öffentlichen Proxy, um Browser-CORS zu umgehen.
Die AASA-Datei muss per HTTPS erreichbar sein und darf nicht auf .json enden.
iOS priorisiert `/.well-known/apple-app-site-association` bei der Universal-Links-Validierung.
Mit „Manuell einfügen“ lassen sich Regeln prüfen, bevor Inhalte deployed sind.
