Validador de AASA / iOS Universal Links
Nota: navegadores têm limitações de CORS, então esta ferramenta busca o AASA via um proxy público. Não informe endereços internos sensíveis; o AASA deve estar acessível publicamente.
Resultados
Fonte do AASA para validação/compatibilidade
Colar JSON do AASA
Teste de correspondência de Universal Links
Nenhum AASA válido selecionado
Nota: isto faz apenas a correspondência no nível das regras do AASA; o comportamento real do iOS é afetado por cache, estado de instalação, versão do sistema e ponto de entrada.
Tutorial (solução rápida)
1) Publicar o AASA (servidor)
- Coloque o arquivo em `https://<domain>/.well-known/apple-app-site-association` (recomendado) ou `https://<domain>/apple-app-site-association`.
- Sem extensão (sem `.json`), acessível via HTTPS e retornando 200.
- `Content-Type: application/json` é recomendado (AASA assinada pode ser `application/pkcs7-mime`).
- Estrutura típica: `applinks.apps` é `[]`; `applinks.details` contém `appID` e `paths`/`components`.
2) Configurar o iOS (cliente)
- No Xcode > Associated Domains, adicione `applinks:your-domain.com` (inclua subdomínios conforme necessário).
- Garanta que `appID` esteja correto: `<TeamID>.<BundleID>` e corresponda à assinatura.
- Instale o app e teste tocando nos links a partir do Safari/Notas/Mensagens.
3) Causas comuns de falha
- Caminho/nome do arquivo incorreto (faltando `.well-known` ou usando `.json`).
- Redirecionamento/autenticação/WAF retorna HTML.
- JSON do AASA inválido: faltando `applinks.details[].appID` ou `paths/components`.
- Cache do iOS: atualizações podem demorar a entrar em vigor.
- Cache do CDN da Apple: `app-site-association.cdn-apple.com` pode não ser em tempo real.
4) Checagens locais 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: os comandos podem variar por versão do macOS/iOS; redes corporativas/proxys podem afetar a busca.
Como usar
- Informe o domínio associado do app (ex.: example.com) em “Domínio / URL do site”.
- Selecione a fonte do AASA (padrão .well-known) e clique em “Buscar e validar”.
- Em “Resultados”, verifique status HTTP, Content-Type e validade do JSON.
- No “Teste de correspondência de Universal Links”, informe uma URL e veja se corresponde às regras do AASA.
Dicas
Esta ferramenta usa um proxy público para contornar o CORS do navegador.
O arquivo AASA deve ser acessível via HTTPS e não deve ter extensão .json.
O iOS prioriza `/.well-known/apple-app-site-association` ao validar Universal Links.
Use “Colar manualmente” para validar regras antes de publicar o arquivo.
