Validador AASA / iOS Universal Links
Nota: Los navegadores tienen restricciones de CORS, por eso esta herramienta obtiene el AASA mediante un proxy público. No introduzcas direcciones internas sensibles; el AASA debe ser accesible públicamente.
Resultados
Fuente AASA para validar/empatar
Pegar JSON de AASA
Prueba de coincidencia de Universal Links
No hay un AASA válido seleccionado
Nota: esto solo comprueba la coincidencia a nivel de reglas del AASA; el comportamiento real de iOS depende de caché, estado de instalación, versión del sistema y punto de entrada.
Tutorial (solución rápida)
1) Desplegar AASA (servidor)
- Coloca el archivo en `https://<domain>/.well-known/apple-app-site-association` (recomendado) o `https://<domain>/apple-app-site-association`.
- Sin extensión (sin `.json`), accesible por HTTPS y que devuelva 200.
- Se recomienda `Content-Type: application/json` (AASA firmada puede ser `application/pkcs7-mime`).
- Estructura típica: `applinks.apps` es `[]`; `applinks.details` contiene `appID` y `paths`/`components`.
2) Configurar iOS (cliente)
- En Xcode > Associated Domains, añade `applinks:your-domain.com` (incluye subdominios si hace falta).
- Asegúrate de que `appID` sea correcto: `<TeamID>.<BundleID>` y coincida con la firma.
- Instala la app y prueba tocando enlaces desde Safari/Notas/Mensajes.
3) Causas comunes de fallo
- Ruta/nombre de archivo incorrecto (falta `.well-known` o se usa `.json`).
- Redirección/autenticación/WAF devuelve HTML.
- JSON de AASA inválido: falta `applinks.details[].appID` o faltan `paths/components`.
- Caché de iOS: los cambios pueden tardar en aplicarse.
- Caché del CDN de Apple: `app-site-association.cdn-apple.com` puede no estar en tiempo real.
4) Comprobaciones locales rápidas (opcional)
curl -i https://your-domain.com/.well-known/apple-app-site-association
xcrun simctl openurl booted https://your-domain.com/your/path
Nota: los comandos pueden variar según versiones de macOS/iOS; redes corporativas/proxys pueden afectar la obtención.
Cómo usar
- Introduce el dominio asociado de tu app (p. ej., example.com) en «Dominio / URL del sitio».
- Selecciona la fuente del AASA (por defecto .well-known) y haz clic en «Obtener y validar».
- En «Resultados», comprueba el estado HTTP, Content-Type y la validez del JSON.
- En «Prueba de coincidencia de Universal Links», introduce una URL para verificar si coincide con las reglas del AASA.
Consejos
Esta herramienta usa un proxy público para evitar el CORS del navegador.
El archivo AASA debe ser accesible por HTTPS y no debe tener extensión .json.
iOS prioriza `/.well-known/apple-app-site-association` al validar Universal Links.
Usa «Pegar manualmente» para validar reglas antes de desplegar.
