SDK 업그레이드 후 탈옥 감지로 사용자가 차단되는 상황이 발생했다면, 지원팀에 문의하기 전에 아래 정보를 먼저 수집해 주세요. 정보가 충분할수록 원인 파악이 빠릅니다.
최종 사용자에게 DFU 복원 등의 테스트를 요청하기 어려운 경우가 많습니다.
이 가이드는 필수 수집 항목과 가능한 경우 수집 항목으로 구분되어 있습니다. 재현 테스트도 단계별로 구성되어 있으니, 가능한 범위까지만 진행하셔도 됩니다.
이 가이드는 필수 수집 항목과 가능한 경우 수집 항목으로 구분되어 있습니다. 재현 테스트도 단계별로 구성되어 있으니, 가능한 범위까지만 진행하셔도 됩니다.
1. 탐지 범위 및 패턴 확인 필수 — 가장 먼저 확인하세요
-
특정 사용자 1명에게만 발생하는지, 여러 사용자에게 발생하는지
여러 명인 경우: 특정 기기 모델 / iOS 버전 / 국가·지역에 집중되는 패턴이 있는지 함께 확인해 주세요. -
탐지가 매 실행마다 발생하는지, 간헐적으로 발생하는지
간헐적인 경우: 특정 상황(특정 시간대, 네트워크 환경, 앱 상태 등)에서 주로 발생하는지 기록해 주세요. - 어느 앱 버전 또는 SDK 버전부터 발생하기 시작했는지
2. 기기 및 환경 정보 필수
- 기기 모델 (예: iPhone 14 Pro)
- iOS 버전
- 앱 버전
- DoveRunner iOS SDK 버전
- 탐지 발생 일시 (타임존 포함)
-
AppSealing SDK에서 제공하는 Device UUID
가능한 경우 수집 — SDK API를 통해 확인할 수 있습니다.
3. 발생 시점 상관관계 가능하면
- iOS 업데이트 직후 발생했는지 여부
- iCloud 또는 iTunes 백업 복원 이후 발생했는지 여부
- MDM 또는 기업 프로파일이 설치된 기기인지 여부
4. SDK 디버그 로그 내부 테스트 기기에서만
SDK 디버그 로그는 원인 분석에 가장 중요한 정보입니다. 단, 디버그 로그가 활성화된 빌드는 SDK 내부 동작이 상세히 출력되므로 실사용자에게 배포해서는 안 됩니다.
고객사 내부 테스트 기기에서 동일한 탐지 현상을 재현할 수 있는 경우에만 수집해 주세요.
- DoveRunner SDK 초기화 시 디버그 로그 레벨 활성화 (디버그 SDK 사용해 빌드)
- 탐지를 재현하거나 앱을 재시작하여 탐지 유도
- 탐지 발생 전후 최소 5분 분량의 로그 수집
-
전체 콘솔 로그를
.txt파일로 내보내기
전송 전, 사용자 ID·이름·이메일 등 개인정보는 반드시 제거하거나 마스킹해 주세요.
권장 파일명 형식:
권장 파일명 형식:
[회사명]_[기기모델]_[YYYY-MM-DD]_doverunner.txt
5. 재현 테스트 필수 가능한 범위까지
단계 1 — 간이 테스트 (사용자 협조 최소화)
- 앱을 삭제 후 재설치 (기기 초기화 없이) — 탐지가 여전히 발생하는지
- 동일 모델·동일 iOS 버전의 다른 기기에서 앱 설치 — 탐지가 발생하는지
단계 2 — 정밀 테스트 (가능한 경우에만)
- DFU 모드로 기기 복원 후 앱 재설치 — 탐지가 발생하는지
DFU 복원 후 탐지가 사라진 경우, 이전 탈옥의 잔재가 원인일 가능성이 있습니다. 해당 결과를 반드시 포함해서 제출해 주세요 — 원인 판단에
결정적인 근거가 됩니다.
| 순서 | 기기 | iOS | 테스트 내용 | 탐지 여부 |
|---|---|---|---|---|
| 1 | — | — | 앱 재설치 (초기화 없음) | Y / N |
| 2 | — | — | 다른 기기 (동일 모델) | Y / N |
| 3 | — | — | DFU 복원 후 재설치 | Y / N |
6. 사용자 배경 정보 가능하면 — 자진 응답 가능
- 해당 기기의 탈옥 이력 여부
- 중고 기기 여부
- 이전에 탈옥 관련 앱이 설치된 적 있는지 여부
7. 제출 정보 요약
| 항목 | 우선순위 |
|---|---|
| 탐지 범위 및 패턴 (발생 규모, 재현 조건, 최초 발생 버전) | 필수 |
| 기기 모델 · iOS 버전 · 앱 버전 · SDK 버전 · 탐지 일시 | 필수 |
| 간이 재현 테스트 결과 (앱 재설치 / 다른 기기) | 필수 |
| SDK 디버그 로그 (.txt, 내부 테스트 기기에서 재현 가능한 경우) | 가능하면 |
| Device UUID (AppSealing SDK 제공) | 가능하면 |
| 발생 시점 상관관계 (iOS 업데이트, 백업 복원, MDM 여부) | 가능하면 |
| DFU 복원 테스트 결과 | 가능하면 |
| 사용자 배경 정보 (탈옥 이력, 중고 기기 여부 등) | 가능하면 |
참고: DFU 복원 후 탐지가 해소된 경우, SDK 오탐보다는 이전
탈옥의 잔재가 원인일 가능성이 높습니다. 반대로 DFU 복원 후에도 동일한 탐지가 발생한다면, SDK 로직 검토가 필요한 오탐일 가능성이
높습니다. 어느 쪽이든 테스트 결과를 포함해 제출해 주시면 원인 규명에 큰 도움이 됩니다.