AASA / iOS Universal Links 검증
참고: 브라우저는 CORS 제한이 있으므로, 이 도구는 공개 프록시로 AASA를 가져옵니다. 민감한 내부 주소는 입력하지 마세요. AASA는 공개 접근 가능해야 합니다.
결과
검증/매칭에 사용할 AASA 소스
AASA JSON 붙여넣기
Universal Links 매칭 테스트
유효한 AASA가 선택되지 않음
참고: 여기서는 AASA 규칙 기준 매칭만 확인합니다. 실제 iOS 동작은 캐시, 설치 상태, OS 버전, 진입 경로에 영향을 받습니다.
튜토리얼(빠른 문제 해결)
1) AASA 배포(서버)
- `https://<domain>/.well-known/apple-app-site-association`(권장) 또는 `https://<domain>/apple-app-site-association`에 파일을 배포합니다.
- 확장자 없이( `.json` 금지), HTTPS로 접근 가능하며 200을 반환해야 합니다.
- `Content-Type: application/json` 권장(서명된 AASA는 `application/pkcs7-mime`일 수 있음).
- 일반 구조: `applinks.apps`는 `[]`, `applinks.details`에 `appID`와 `paths`/`components`를 설정합니다.
2) iOS 설정(클라이언트)
- Xcode > Associated Domains에 `applinks:your-domain.com` 추가(필요 시 서브도메인 포함).
- `appID`가 `<TeamID>.<BundleID>` 형식이며 서명 정보와 일치하는지 확인합니다.
- 앱 설치 후 Safari/메모/메시지 등에서 링크를 탭하여 테스트합니다.
3) 자주 실패하는 원인
- 경로/파일명 오류(`.well-known` 누락 또는 `.json` 사용).
- 리다이렉트/인증/WAF로 인해 HTML이 반환됨.
- AASA JSON 구조 오류: `applinks.details[].appID` 또는 `paths/components` 누락.
- iOS 캐시로 인해 반영 지연.
- Apple CDN 캐시: `app-site-association.cdn-apple.com`이 즉시 반영되지 않을 수 있음.
4) 로컬 빠른 점검(선택)
curl -i https://your-domain.com/.well-known/apple-app-site-association
xcrun simctl openurl booted https://your-domain.com/your/path
참고: 명령은 macOS/iOS 버전에 따라 다를 수 있으며, 기업망/프록시 환경이 가져오기에 영향을 줄 수 있습니다.
사용 방법
- '도메인 / 사이트 URL'에 연결 도메인(예: example.com)을 입력합니다.
- AASA 소스를 선택하고 '가져오기 및 검증'을 클릭합니다.
- 결과에서 HTTP 상태, Content-Type, JSON 형식을 확인합니다.
- 매칭 테스트에서 URL을 입력해 규칙 일치를 확인합니다.
팁
브라우저 CORS 제한을 우회하기 위해 공개 프록시로 파일을 가져옵니다.
AASA는 HTTPS로 접근 가능해야 하며 .json 확장자를 사용하지 않습니다.
iOS는 검증 시 `/.well-known/apple-app-site-association`를 우선합니다.
미배포 내용은 '수동 붙여넣기' 모드로 규칙을 검증할 수 있습니다.
