---
title: "Android 실링 옵션"
description: "Android 실링 위저드의 상시 적용 보호 기능, 위협 대응 동작, 단계별 전체 옵션을 설명합니다."
---
> For the complete documentation index, see [llms.txt](https://docs.doverunner.com/llms.txt).

이 문서는 Android 실링 위저드의 보호 기능과 옵션을 설명합니다. 실링 절차와 실링 전후 확인 사항은 [DoveRunner Mobile App Security 적용](https://docs.doverunner.com/ko/mobile-app-security/android/android-sealing/) 문서를, 보호 기능의 전체 구조는 [Mobile App Security 동작 방식](https://docs.doverunner.com/ko/mobile-app-security/how-it-works/) 문서를 참고하세요.

## 상시 적용 보호 기능

아래 보호 기능은 실링된 모든 앱에 적용되며 설정할 수 없습니다. 1단계의 **상시 적용 기능** 영역에서 확인할 수 있습니다.

| 그룹 | 보호 기능 |
| :--- | :-------- |
| **코드 암호화** | 네이티브 코드를 위한 SO 암호화, Unity·Xamarin(Mono) 앱을 위한 DLL 암호화, React Native 앱을 위한 JavaScript 번들 암호화 |
| **디버깅 및 동적 공격 방어** | 프로세스·쓰레드 상태 감시, 디버거 연결 차단, Frida 프레임워크 탐지, Xposed 프레임워크 탐지, 트램폴린 코드 후킹 탐지, 메모리 덤프 탐지, SSL Pinning 우회 방지 |
| **앱 변조 방어** | 코드 무결성 검증, 리소스·에셋 무결성 검증, 패키지 이름 변조 탐지, `AndroidManifest` 변조 탐지, 메모리 변조 차단 |
| **가상 환경** | 가상 OS, Virtual Space 도구, 샤오미 듀얼앱, 샤오미 보조공간 |
| **치트툴** | 게임가디언, 럭키패처, 스피드핵, 앱 변조 도구(APK Editor) |
| **해킹 탐지 및 애널리틱스** | 실시간 해킹 탐지 데이터 대시보드 전송(`ANDROID_ID` 기준 식별), 해킹 탐지 메시지 지역화(영어, 한국어, 중국어, 일본어, 인도네시아어, 베트남어, 스페인어 등 계속 추가 중) |

---

## 위협 대응 동작

실링 버전 **3.3.0.0**부터 대부분의 위협 탐지 항목에 **차단**, **허용** 외에 두 가지 동작이 추가되었습니다. 3.3.0.0 미만 버전에서는 차단과 허용(표시되는 경우 선택 허용 포함)만 사용할 수 있습니다.

| 동작 | 설명 |
| :--- | :--- |
| **차단** | 위협을 탐지하면 앱을 종료합니다. |
| **모니터링** <br/>(3.3.0.0+) | 위협을 탐지하여 로그를 남기고, 앱은 종료하지 않습니다. |
| **콜백** <br/>(3.3.0.0+) | 위협을 탐지하여 로그를 남기고 앱의 위협 콜백 핸들러를 호출하며, 앱은 종료하지 않습니다. [위협 탐지 콜백](#위협-탐지-콜백)을 참고하세요. |
| **허용** | 위협에 대응하지 않습니다. |

모니터링과 콜백은 무결성 검사, 루팅, 개발자옵션, USB 디버깅, 에뮬레이터, 직장 프로필 및 삼성 보안 폴더, 매크로 도구, 패킷 공격, 키로거, 오버레이 윈도우에서 사용할 수 있습니다. Wi-Fi 보안 프로토콜, 스크린 미러링 & 캡처, 악성 툴 탐지는 기존 옵션을 그대로 사용합니다.

---

## 2단계 — 기본 설정

| 옵션 | 설명 |
| :--- | :--- |
| **앱 프레임워크 선택** | 앱 개발에 사용한 프레임워크입니다. Native(Java/Kotlin), Unity, Unreal, Flutter, Xamarin, React Native, Ionic, Cordova, Others를 지원합니다. |
| **앱실링 버전 선택** | 적용할 실링 버전입니다. 최신 보안 기능과 프레임워크 지원을 받으려면 최신 버전을 사용하세요. React Native 등 하이브리드 프레임워크는 현재 `3.x` 계열과 별도로 레거시 `1.7.x` 계열도 제공합니다. |
| **실링 모드** | `테스트` — 릴리스와 동일한 보호 수준이지만 화면에 테스트 모드 메시지가 주기적으로 표시됩니다. 과금되지 않습니다.<br/><br/>`릴리스` — 테스트 모드 메시지가 제거되며 과금이 발생합니다. |

### SO 암호화

APK 내 네이티브 라이브러리(`.so`) 파일을 암호화하여 리버스 엔지니어링으로부터 보호합니다.

| 값 | 동작 |
| :-- | :--- |
| **예** (기본값) | APK 내 호환되는 모든 `.so` 파일이 자동으로 암호화됩니다. |
| **아니오** | `.so` 파일을 암호화하지 않습니다. |
| **부분 암호화** | 암호화할 `.so` 파일을 직접 선택합니다. 콘솔이 암호화할 수 없는 파일 목록을 보여주며, 검색·개별 선택 또는 **지원 항목 전체 선택**를 사용할 수 있습니다. 서로 다른 아키텍처에서 파일명이 같은 `.so` 파일은 함께 암호화됩니다. |

### Dex 보호

Dex 보호는 컴파일된 Dex 바이트코드에 대한 정적·동적 분석을 크게 어렵게 만듭니다. 표준 ProGuard/R8 난독화를 대체하는 것이 아니라 그 위에 적용됩니다.

**Caution:** 
콘솔의 기본 설정 단계에는 다음 안내가 표시됩니다.

> **필수 조치: ProGuard/R8 난독화를 먼저 적용하세요**
>
> 고급 커스텀 난독화 기법인 Dex Protection을 적용하기 전에, 반드시 ProGuard/R8을 통한 표준 기본 난독화가 일관되게 올바르게 적용되도록 해야 합니다. 기본 난독화(ProGuard/R8)와 고급 난독화(Dex Protection)를 계층적으로 결합하는 것이 가장 강력한 보안 방어 체계를 구축합니다.

필요한 룰과 피해야 할 룰은 [Dex 보호를 위한 ProGuard 설정](https://docs.doverunner.com/ko/mobile-app-security/android/android-proguard-guide/)을 참고하세요.


| 옵션 | 값 | 설명 |
| :--- | :-- | :--- |
| **Dex 암호화** <br/>(3.x는 3.2.0.0+) | 아니오(기본값) / 부분 암호화 | Dex 파일을 암호화하여 Java 코드를 위변조로부터 보호합니다. 활성화하면 설치·업데이트 후 최초 실행 시간이 다소 증가할 수 있습니다.<br/><br/>`부분 암호화`는 [앱 구성](https://docs.doverunner.com/ko/mobile-app-security/android/android-app-configurations/)의 **Package Selection for Dex Encryption** 목록에 등록된 패키지만 암호화합니다. 목록이 비어 있으면 암호화가 적용되지 않습니다. |
| **String 난독화** | 예 / 아니오(기본값) / 부분 암호화 | Dex 코드의 문자열을 난독화하여 정적 분석으로부터 보호합니다.<br/><br/>`예`는 앱 전체를 난독화하며 강도 설정이 함께 표시됩니다.<br/>`부분 암호화`는 [앱 구성](https://docs.doverunner.com/ko/mobile-app-security/android/android-app-configurations/)의 **Package Selection for Dex String Obfuscation** 포함(Inclusion)·제외(Exclusion) 목록을 사용합니다. |
| **Call Hiding (함수 호출 난독화)** | 예 / 아니오(기본값) | Dex 파일의 함수 호출과 코드 흐름을 난독화하여 흐름 분석을 어렵게 만듭니다. 활성화하면 강도 설정이 함께 표시됩니다. |

String 난독화 또는 Call Hiding을 **예**로 설정하면 난독화 강도를 선택할 수 있습니다.

| 강도 | 특성 |
| :--- | :--- |
| **Fast** (기본값) | 난독화 강도는 낮고 실행 성능은 높습니다. |
| **Balance** | 강도와 성능의 중간 지점입니다. |
| **Maximum** | 가장 강력한 난독화이며 성능 저하가 일부 발생할 수 있습니다. |

### 무결성 옵션

실링 버전 3.2.0.0부터 사용할 수 있습니다.

| 옵션 | 기본값 | 설명 |
| :--- | :----- | :--- |
| **무결성 검사** <br/>(3.3.0.0+) | 차단 | 아래 두 검사를 총괄하는 상위 설정입니다. 파일 무결성 검사 또는 서명 인증서 신원 검사에서 변조가 감지되었을 때의 동작(차단 / 모니터링 / 콜백 / 허용)을 정합니다. **허용**으로 설정하면 두 검사가 모두 비활성화됩니다. |
| **파일 무결성 검사 비활성화** | 해제 | 실링 이후 앱 파일이 변조되지 않았는지 확인하는 런타임 검사를 비활성화합니다. DoveRunner 지원팀의 안내가 없다면 해제 상태로 두세요. |
| **서명 인증서 신원 검사 사용** | 해제 | 런타임에 앱의 서명 인증서를 등록된 SHA-256 지문과 비교하여 재서명되거나 리패키징된 사본을 탐지합니다. 켜면 위저드에서 바로 허용할 서명 인증서(최대 5개)를 추가할 수 있습니다. [앱 구성](https://docs.doverunner.com/ko/mobile-app-security/android/android-app-configurations/)에서도 관리할 수 있습니다. |

---

## 3단계 — 환경 탐지

변조되었거나 감시 중일 수 있는 기기 환경을 탐지했을 때 앱이 어떻게 동작할지 설정합니다. 모니터링과 콜백은 실링 버전 3.3.0.0 이상이 필요합니다. [위협 대응 동작](#위협-대응-동작)을 참고하세요.

| 옵션 | 값 | 기본값 | 설명 |
| :--- | :-- | :----- | :--- |
| **루팅** | 차단 / 모니터링 / 콜백 / 허용 | 차단 | 루팅된 기기와 루팅 툴을 탐지합니다. 루팅 환경에서의 실행은 심각한 보안 위험이므로 차단을 강력히 권장합니다. |
| **개발자옵션** | 차단 / 모니터링 / 콜백 / 허용 | 허용 | 개발자 옵션 활성화 여부를 탐지합니다. 개발자 옵션은 USB 디버깅을 포함해 공격자에게 강력하고 위험한 기능을 제공합니다. |
| **USB 디버깅** | 차단 / 모니터링 / 콜백 / 허용 | 차단 | USB 디버깅 활성화 여부를 탐지합니다. USB 디버깅이 켜져 있으면 공격자가 디버그 도구를 연결해 시스템의 민감한 영역에 접근할 수 있습니다. |
| **Wi-Fi 보안 프로토콜** | 정보 수집 / 미사용 | 미사용 | Android 12 이상에서 연결된 Wi-Fi의 보안 프로토콜 정보를 모니터링 목적으로 수집합니다. **정보 수집**을 선택하면 앱에 `ACCESS_WIFI_STATE` 권한이 추가됩니다. 앱 동작에는 영향을 주지 않습니다. |
| **에뮬레이터** | 차단 / 선택 허용 / 모니터링 / 콜백 / 허용 | 차단 | 안드로이드 에뮬레이터 환경을 탐지합니다.<br/><br/>`선택 허용`은 LDPlayer, Nox App Player, BlueStacks, GameLoop 중 특정 에뮬레이터만 허용하고 나머지는 차단합니다. |
| **직장 프로필 및 삼성 보안 폴더** | 차단 / 선택 허용 / 모니터링 / 콜백 / 허용 | 차단 | 일부 치트툴이 작업 프로필을 이용해 앱을 공격합니다. 차단하면 삼성 보안 폴더에서도 앱이 실행되지 않습니다.<br/><br/>`선택 허용`은 삼성 보안 폴더만 선택적으로 허용합니다. |

**Note:** 
에뮬레이터를 허용하는 경우, 별도 공지가 있기 전까지 DoveRunner는 BlueStacks, LDPlayer, Nox 환경에서만 보호를 보장합니다.


---

## 4단계 — 툴 & 패키지 탐지

기기에 설치된 악성 도구를 탐지하고, 해당 도구와 함께 앱을 실행할지 여부를 설정합니다. 모니터링과 콜백은 실링 버전 3.3.0.0 이상이 필요합니다. [위협 대응 동작](#위협-대응-동작)을 참고하세요.

| 옵션 | 값 | 기본값 | 설명 |
| :--- | :-- | :----- | :--- |
| **악성 툴 탐지** <br/>(3.3.0.0+) | 차단 / 허용 | 차단 | 툴/패키지 탐지를 총괄하는 마스터 스위치입니다. **차단** 상태에서는 아래 카테고리와 관계없이 미분류 툴도 항상 탐지합니다. **허용**으로 설정하면 모든 툴/패키지 탐지가 비활성화되고 아래 옵션이 숨겨집니다. |
| **매크로 도구** | 차단 / 모니터링 / 콜백 / 허용 | 차단 | 앱 기능을 어뷰징하는 데 사용될 수 있는 매크로 자동화 도구를 탐지합니다. 블랙리스트는 항상 최신으로 유지됩니다. |
| **패킷 공격** | 차단 / 모니터링 / 콜백 / 허용 | 차단 | 네트워크 통신 데이터를 수집하는 패킷 공격 도구를 탐지합니다. 블랙리스트는 항상 최신으로 유지됩니다. |
| **키로거** | 차단 / 모니터링 / 콜백 / 허용 | 허용 | 기기에 숨어 사용자의 터치 입력을 수집하는 키로거를 탐지합니다. |
| **패키지 화이트리스트** <br/>(3.3.0.0+) | 패키지 이름 | 없음 | 탐지에서 제외할 Android 패키지 이름입니다. 빌드 중 발견된 미분류 툴도 포함할 수 있습니다. 화이트리스트에 등록된 패키지는 탐지가 차단으로 설정되어 있어도 허용됩니다. 실링된 빌드의 [실링 이력](https://docs.doverunner.com/ko/mobile-app-security/android/android-history/)에 기록됩니다. |
| **행위 기반 악성코드 탐지** <br/>(3.3.0.0+) | 사용 / 미사용 | 미사용 | 접근성 관련 행위 신호, 설치 출처, 권한 정보, 큐레이션된 악성코드 패키지 인텔리전스를 활용하여 의심스러운 애플리케이션을 탐지하고, 탐지된 위협에 정책 기반 모니터링 및 차단을 적용합니다. |

**Caution:** 
악성 툴 탐지가 **차단**으로 설정된 동안에는 미분류 툴이 항상 탐지되어, 위 카테고리가 허용으로 설정되어 있어도 앱을 종료시킵니다. 종료 시 탐지된 패키지 이름이 포함된 토스트가 표시됩니다. 해당 패키지를 **패키지 화이트리스트**에 추가하면 예외 처리할 수 있습니다.


**Note:** 
**Use QUERY_ALL_PACKAGES**는 실링 버전 2.x에서만 사용할 수 있으며, 3.x에서는 표시되지 않습니다.


---

## 5단계 — 고급 탐지

| 옵션 | 값 | 기본값 | 설명 |
| :--- | :-- | :----- | :--- |
| **스크린 미러링 & 캡처** | 차단 / 허용 | 허용 | 스크린샷, 화면 녹화, 미러링, 원격 접속을 포함합니다. 차단하면 캡처 도구에는 앱 화면 대신 검은 화면만 보입니다. 앱은 **종료되지 않으며** 리포트도 전송되지 않습니다. |
| **오버레이 윈도우** | 차단 / 모니터링 / 콜백 / 허용 | 허용 | Android 12 이상에서 다른 앱이 앱 화면 위에 표시하는 오버레이를 가립니다. **차단**의 경우 앱은 **종료되지 않으며** 리포트도 전송되지 않습니다. 안드로이드 접근성(Accessibility) 오버레이는 차단되지 않습니다. |
| **Over-The-Air 업데이트** | 예 / 아니오 | 아니오 | 새 앱 배포 없이 커스텀 블랙리스트를 실행 중인 앱에 전달합니다. 커스텀 블랙리스트는 DoveRunner 기본 블랙리스트와 함께 동작합니다. 블랙리스트는 [앱 구성](https://docs.doverunner.com/ko/mobile-app-security/android/android-app-configurations/)에서 설정합니다. 엔터프라이즈 플랜 전용입니다. |
| **앱 종료 대신 콜백으로 위협 처리 사용** <br/>(3.2.x 전용) | 체크박스 | 해제 | 앱을 종료하는 대신 실시간 위협 이벤트를 앱 코드로 전달합니다. 실링 버전 3.2.0.0 ~ 3.2.x.x 에서만 표시됩니다. 3.3.0.0부터는 각 탐지 항목에서 **콜백**을 선택하세요. |
| **하드웨어 키 증명** <br/>(3.3.0.0+) | 사용 / 사용 안 함 | 사용 안 함 | 안드로이드의 하드웨어 기반 키 증명을 통해 기기의 부트로더 및 무결성 상태를 검증합니다. 사용하면 **대상 URL** — 증명으로 보호할 앱의 엔드포인트(정확한 URL 또는 정규식, 최대 50개, 각 500자 이내)를 추가합니다. 적용할 탐지 케이스는 [앱 구성](https://docs.doverunner.com/ko/mobile-app-security/android/android-app-configurations/#%ED%95%98%EB%93%9C%EC%9B%A8%EC%96%B4-%ED%82%A4-%EC%A6%9D%EB%AA%85)에서 앱별로 설정합니다. 자세한 내용은 [하드웨어 키 증명](https://docs.doverunner.com/ko/mobile-app-security/add-ons/hardware-key-attestation/)을 참고하세요. |
| **Customize Threat Response Messages** <br/>(3.2.0.0+) | 토글 | 해제 | 최종 사용자에게 표시되는 위협 대응 다이얼로그에 직접 만든 템플릿을 사용합니다. 켜면 **Select template** 드롭다운이 나타납니다. 끄면 솔루션 기본 메시지가 사용됩니다. 켜고 템플릿을 선택하지 않으면 실링이 시작되지 않습니다. |

**Note:** 
**Data Sealing**은 실링 버전 2.x에서만 사용할 수 있으며, 3.x에서는 표시되지 않습니다. [Android DataSealing](https://docs.doverunner.com/ko/mobile-app-security/add-ons/data-sealing/)을 참고하세요.


**Note:** 
**하드웨어 키 증명**과 **Customize Threat Response Messages**는 [애드온](https://docs.doverunner.com/ko/mobile-app-security/add-ons/)이며, 계정에 해당 애드온이 활성화된 경우에만 표시됩니다. 애드온은 별도의 플랜 또는 계약이 필요하므로 [헬프 센터](https://support.doverunner.com)로 문의해 주세요.


### 위협 탐지 콜백

콜백을 사용하면 실링된 앱은 위협을 탐지해도 종료되지 않습니다. 대신 Android 브로드캐스트를 통해 등록된 콜백을 호출하므로, 로깅·분석·자체 경고 화면·강제 로그아웃 등 원하는 처리 로직을 직접 구현할 수 있습니다.

사용 방법은 실링 버전에 따라 다릅니다.

| 실링 버전 | 콜백 사용 방법 |
| :-------- | :------------- |
| **3.3.0.0 이상** | 앱으로 전달할 탐지 항목마다 **콜백**을 선택합니다(2~5단계). 나머지 탐지 항목은 각자 지정한 동작을 따릅니다. CLI: `action_*=callback` |
| **3.2.0.0 ~ 3.2.x.x** | 5단계에서 **앱 종료 대신 콜백으로 위협 처리 사용**을 체크합니다. 3단계와 4단계에서 **차단**으로 설정된 모든 탐지에 적용됩니다. CLI: `use_callback_feature=true` |

**모니터링 모드:** 
콜백을 사용하면서 브로드캐스트 리시버를 구현하지 않으면 해당 탐지에 대해 앱은 **모니터링 전용 모드**로 동작합니다. 위협은 탐지·보고되지만 앱은 **종료되지 않습니다.** 단, **코드 후킹**은 예외로, 이 설정과 관계없이 항상 기본 보호 절차(경고, 앱 종료, 리포트)를 따릅니다.


**Note:** 
실링 버전 3.3.0.0 이상의 브로드캐스트 명세, 리시버 구현 방법, 위협 대응 코드는 [위협 탐지 콜백 연동](https://docs.doverunner.com/ko/mobile-app-security/android/android-threat-callback/)을 참고하세요. 3.2.x 버전의 연동 규격은 [헬프 센터](https://support.doverunner.com)로 문의하세요.


### 위협 대응 메시지

DoveRunner가 루팅 기기, 에뮬레이터, 디버거, 앱 변조, 후킹 프레임워크 등의 위협을 탐지하면 최종 사용자에게 대응 다이얼로그를 표시합니다. 기본적으로 솔루션이 제공하는 표준 메시지가 기기 언어로 표시됩니다.

이를 직접 만든 **템플릿**으로 대체할 수 있습니다. 위협 카테고리별 문구, 다이얼로그 제목과 버튼 라벨, 색상을 지정할 수 있습니다. 템플릿은 **Threat Response Messages**에서 만들며 실링 버전 3.2.0.0 이상에 적용할 수 있습니다. 적용하려면 5단계에서 **Customize Threat Response Messages**를 켜고 **Select template**에서 선택하거나, CLI로 실링하는 경우 프리셋에서 참조합니다.

**Note:** 
템플릿 생성, 지원 언어, 브랜딩 옵션은 [위협 대응 메시지](https://docs.doverunner.com/ko/mobile-app-security/add-ons/threat-response-messages/)를 참고하세요. 콘솔에 해당 메뉴가 보이지 않는다면 [헬프 센터](https://support.doverunner.com)로 문의해 주세요.


---

## 6단계 — Access Signals

Access Signals는 사용자의 위치, 위치 은닉 여부, 연결의 위험성을 기준으로 각 세션에 허용할 동작을 결정합니다. DoveRunner Mobile App Security와 함께 런타임에 적용됩니다.

| 옵션 | 값 | 기본값 | 설명 |
| :--- | :-- | :----- | :--- |
| **Access Signals 사용** | 켜기 / 끄기 | 끄기 | 실링 시점에 이 앱의 Access Signals 설정을 적용합니다. 국가 정책, VPN / Proxy / Tor 탐지, 악성 IP 탐지 등 개별 신호는 [앱 구성](https://docs.doverunner.com/ko/mobile-app-security/android/android-app-configurations/#access-signals)에서 앱별로 설정합니다. |

**Note:** 
Access Signals는 별도의 플랜 또는 계약이 필요한 [애드온](https://docs.doverunner.com/ko/mobile-app-security/add-ons/access-signals/)이며, 실링 버전 **3.2.0.4** 이상이 필요합니다. 이 단계가 표시되지 않거나 계정에서 Access Signals가 활성화되어 있지 않다고 표시되면 [헬프 센터](https://support.doverunner.com)로 문의해 주세요.