Apple App Site Association

Spread the love

Apple App Site Association

El archivo Apple App Site Association (AASA) es un pequeño archivo JSON que permite a Apple y a iOS conocer qué apps están autorizadas para abrir enlaces web de un dominio concreto y qué partes del sitio pueden mapearse a tu aplicación a través de Universal Links, App Clips y otras integraciones de plataforma. Aunque sencillo en apariencia, un AASA mal configurado puede romper la navegación profunda (deep linking) y la experiencia del usuario.

En esta guía encontrarás todo lo necesario: estructura del archivo, ejemplos, pasos para publicarlo correctamente, comprobaciones y errores habituales.

¿Por qué importa el Apple App Site Association?

Universal Links: permite que los enlaces HTTP(S) abran directamente la app si está instalada, en lugar del navegador.
Seguridad: garantiza que solo las apps autorizadas por el propietario del dominio puedan reclamar enlaces del mismo.
App Clips & Servicios: algunos servicios de Apple (por ejemplo App Clips, Shared Web Credentials) requieren un AASA bien formado.
Mejora de la experiencia de usuario: navegación más fluida, menor fricción para conversiones y acciones dentro de la app.

Formato y ubicación

Archivo: debe ser un JSON sin extensión de archivo visible (normalmente llamado apple-app-site-association).
Ubicación: puede alojarse en la raíz del dominio /apple-app-site-association o en /.well-known/apple-app-site-association.
Content-Type: la respuesta HTTP debe incluir el header Content-Type: application/json (importante). No debe redirigirse a otro recurso.
Sin extensión .json: no uses apple-app-site-association.json — Apple lo busca sin extensión.

Estructura básica (ejemplo)

{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "TEAMID.com.tuempresa.tuapp",
        "paths": [ "/ruta/*", "/otro-path/index.html", "/" ]
      }
    ]
  }
}

appID: se compone de tu Apple Team ID + el bundle identifier (ej: 9JA89QQLNQ.com.ejemplo.app).
paths: array que define qué rutas del dominio son manejadas por la app.
- "/" coincide con todas las rutas.
- "/blog/*" coincide con /blog/ y cualquier subruta.
- "NOT /admin/*" excluye rutas (prefijando con NOT).
- Se pueden usar expresiones con * y patrones exactos.

Ejemplo avanzado con App Clips y Shared Web Credentials

{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "TEAMID.com.ejemplo.tuapp",
        "paths": [ "/productos/*", "/ofertas/*" ]
      }
    ]
  },
  "appclips": {
    "apps": ["TEAMID.com.ejemplo.tuapp.clip"]
  },
  "webcredentials": {
    "apps": ["TEAMID.com.ejemplo.tuapp"]
  }
}

appclips: lista de App Clip bundle IDs autorizados.
webcredentials: habilita Shared Web Credentials (inicio de sesión con credenciales compartidas entre web y app).

Pasos para crear y publicar el AASA

Obtén tu Apple Team ID desde App Store Connect.
Identifica el bundle identifier (ej. com.miempresa.miapp).
Construye el JSON con las rutas que deseas manejar.
Valida el JSON (asegúrate de que sea UTF-8 y válido).
Sube el archivo a la raíz del dominio /apple-app-site-association o a /.well-known/apple-app-site-association.
Configura el header Content-Type: application/json. Evita redirecciones 301/302 hacia otros hosts.
Prueba con iOS: instala la app y abre un enlace que coincida con paths.

Comprobaciones y herramientas útiles

Verifica que la URL devuelva 200 OK y Content-Type: application/json.
Usa curl para probar la respuesta:

curl -I https://tudominio.com/apple-app-site-association

Asegúrate de que el JSON sea válido y no tenga comentarios ni BOM.
Revisa los logs del servidor si iOS no detecta cambios (a veces el fichero hace cache en la CDN).

Errores comunes y cómo solucionarlos

Content-Type incorrecto: si no es application/json, iOS ignora el archivo. Solución: configurar servidor para devolver el header correcto.
Archivo con extensión .json: Apple no lo leerá. Remuévela.
Redirecciones: iOS no seguirá redirecciones; sirve el archivo directamente en la URL correcta.
appID mal formado: revisa que el TEAMID y el bundle identifier sean exactos.
Problemas con caching/CDN: purga la cache o sirve desde el origen para pruebas.
Permisos de CORS (no crítico): aunque no es requisito, evita configuraciones que bloqueen solicitudes de Applebot.

Conclusión

El archivo Apple App Site Association es una pieza pequeña pero crítica para integrar con éxito Universal Links, App Clips y Shared Web Credentials. Una configuración correcta mejora la experiencia de usuario y asegura que solo las apps autorizadas interactúen con tu dominio. Siguiendo los pasos y comprobaciones de esta guía podrás implementar y depurar tu AASA de forma fiable.

En veselin.es exploramos las curiosidades más increíbles del mundo. Imágenes creadas con IA y ConfyUI y asignadas aleatoriamente: Apple App Site Association. También ciencia, historia, tecnología, cultura, fenómenos inexplicables y datos que te dejarán con la boca abierta. Si te apasiona aprender cosas nuevas cada día, ¡este blog es para ti!

🧠 Aviso: Las entradas de esta web han sido generadas automáticamente con ayuda de inteligencia artificial. Las imágenes mostradas pueden no representar con exactitud la realidad y deben considerarse parte del proceso creativo.

Este sitio es un experimento con fines educativos y de aprendizaje. ¡Disfruta del arte, la tecnología y la creación digital!

Descargo de responsabilidad: Las imágenes presentadas en esta web han sido generadas exclusivamente mediante herramientas de inteligencia artificial. No corresponden a fotografías reales ni a representaciones de personas existentes. Los títulos o nombres de archivo son generados automáticamente y no implican ninguna relación con entidades, marcas o individuos reales. Si tienes dudas o consideras que alguna imagen vulnera derechos, puedes contactarnos para su revisión o retirada.