---
title: "기존 버전 옵션 (3.2.x 이하)"
description: "DoveRunner Mobile App Security 3.2.x 이하 버전의 CLI 도구 옵션과 3.3.0.0 이상 위협 대응 정책과의 대응 관계를 설명합니다."
---
> For the complete documentation index, see [llms.txt](https://docs.doverunner.com/llms.txt).
DoveRunner Mobile App Security 3.3.0.0 미만 버전의 CLI 도구 옵션을 설명합니다. 3.3.0.0 이상의 공통 옵션, 리전별 API 엔드포인트, config.txt 파일은 [기본 구성](https://docs.doverunner.com/ko/mobile-app-security/android/cicd/basic-configuration/)을 참고하세요.
## 기존 위협 옵션 (3.0.0.0 ~ 3.2.x.x)
3.0.0.0 ~ 3.2.x.x 에서 사용하는 옵션입니다. 3.3.0.0 이상에서도 그대로 사용할 수 있으며, 서버에서 **3.3.0.0 이상 대응 옵션** 열과 같이 `action_*` 옵션으로 자동 변환됩니다. 같은 위협 항목에 기존 옵션과 `action_*` 옵션을 함께 지정하면 `action_*`가 우선합니다.
|옵션|설명|사용 가능한 값|기본값|3.3.0.0 이상 대응 옵션|
|------|-----------|----------------|-------------|-------------------|
|‑block_environment|이 옵션에서 루팅 또는 에뮬레이터 환경을 차단할 수 있습니다.
**쉼표로 여러 옵션을 사용할 수 있습니다.**|`rooting`, `emulator`||`rooting` → `action_rooting=block`
`emulator` → `action_emulator=block`|
|‑allow_emulator|위 옵션에서 에뮬레이터를 차단한 후 특정 에뮬레이터를 허용할 수 있습니다.
**쉼표로 여러 옵션을 사용할 수 있습니다.** |`LDPlayer`, `BlueStacks`, `Nox`||동일 옵션|
|‑block_work_profile|Secure Folder와 같은 직장프로필 환경에서 앱 실행을 차단할 수 있습니다|`yes`, `no`|`yes`|`action_work_profile=block`\|`allow`|
|‑allow_work_profiles|위 옵션을 `yes`로 설정했을 때 예외적인 직장프로필을 허용할 수 있습니다|`Samsung SecureFolder`||동일 옵션|
|‑block_keylogger|최종 사용자 스마트폰에 숨어서 키 로그 정보를 캡처하는 키로거 앱을 차단할 수 있습니다.|`yes`, `no`|`no`|`action_keylogger=block`\|`allow`|
|‑hide_overlay_windows|예기치 않은 조작을 방지하기 위해 애플리케이션에서 외부 앱의 UI 오버레이를 차단할 수 있습니다. 이 옵션은 Android 12 기기부터 작동합니다.|`yes`, `no`|`no`|`action_overlay=block`\|`allow`|
|‑allow_external_tool|매크로(자동 클릭) 및 패킷 공격 도구는 기본적으로 차단됩니다. 이 옵션을 사용하여 이러한 도구를 허용할 수 있습니다.
**쉼표로 여러 옵션을 사용할 수 있습니다.**|`macro`, `sniff`||`macro` → `action_macro=allow`
`sniff` → `action_sniff=allow`|
|‑block_developer_options|개발자 옵션이 활성화된 스마트폰에서 앱 실행을 차단할 수 있습니다.|`yes`, `no`|`no`|`action_developer_options=block`\|`allow`|
|‑block_usb_debugging|USB 디버깅이 활성화된 스마트폰에서 앱 실행을 차단할 수 있습니다|`yes`, `no`|`yes`|`action_usb_debugging=block`\|`allow`|
|‑use_callback_feature (3.2.x 전용)|`true`로 설정하면 훅킹을 제외한 취약점이 탐지되었을 때 앱을 즉시 종료하지 않습니다. 대신 앱보안 서버로 탐지 리포트를 전송하고 broadcast를 발생시키며, 앱 개발자는 receiver를 통해 콜백을 받아 앱 종료 여부 및 추가 정보를 직접 수집하는 등 의사결정을 할 수 있습니다. 콜백 연동 문서가 필요하시면 헬프센터로 문의하세요.|`true`, `false`|`false`|각 `action_*` 옵션에 `callback` 지정|
:::note
`use_query_all_packages`는 3.0.0.0부터 지원하지 않습니다. [2.x 버전](#cli-도구-옵션-앱보안-버전-2x-)에서만 사용할 수 있습니다.
:::
## 3.0.0.0 ~ 3.2.x.x 예제 사용법
3.0.0.0 ~ 3.2.x.x 에서 모든 옵션을 지정한 예제 명령행입니다. 이 명령의 다른 옵션은 [기본 구성](https://docs.doverunner.com/ko/mobile-app-security/android/cicd/basic-configuration/#%EA%B3%B5%ED%86%B5-%EC%98%B5%EC%85%98)을 참고하세요.
```bash
$ java -jar sealing.jar -url https://api.appsealing.com/covault/gw -authkey 123456789ABCDE -srcapk app-release.aab -sealedapk app-release-sealed.aab -service_type NATIVE_AOS -service_version 3.2.0.0 -deploymode release -dex_string_obfuscation balance -dex_call_hiding balance -dex_encrypt yes -select_dex_encrypt yes -so_encrypt yes -block_environment rooting,emulator -allow_emulator LDPlayer,BlueStacks,Nox -block_work_profile yes -allow_work_profiles 'Samsung SecureFolder' -block_developer_options yes -block_usb_debugging yes -block_keylogger yes -block_screen_capture yes -hide_overlay_windows yes -allow_external_tool macro,sniff -wifi_security_protocol collect -use_callback_feature false -disable_file_integrity_check false -enable_signing_certificate_identity_check false -app_signing registered_key
```
예) Config.txt 설정 (3.0.0.0 ~ 3.2.x.x). 전체 예제는 CLI 도구 패키지의 `examples/config-for-native-v3.txt`(Native), `examples/config-for-hybrid-v3.txt`(Hybrid 3.2.x.x)에 포함되어 있습니다.
```
url=https://api.appsealing.com/covault/gw
authkey=123456789ABCDE
service_version=3.2.0.0
deploymode=release
app_signing=none
dex_string_obfuscation=balance
dex_call_hiding=balance
block_environment=emulator, rooting
allow_emulator=BlueStacks, Nox, LDPlayer
block_work_profile=yes
allow_work_profiles=Samsung SecureFolder
block_developer_options=no
block_usb_debugging=yes
block_keylogger=no
hide_overlay_windows=no
allow_external_tool=macro, sniff
use_callback_feature=false
```
## CLI 도구 옵션 (앱보안 버전 2.x) (Deprecated)
|옵션|설명|사용 가능한 값|필수 여부|기본값|
|------|-----------|----------------|--------|-------------|
|‑url|실링 API URL — 계정 리전에 맞는 엔드포인트를 선택하세요 ([리전 표](https://docs.doverunner.com/ko/mobile-app-security/android/cicd/basic-configuration/#cli-%EB%8F%84%EA%B5%AC-%EC%98%B5%EC%85%98-%EC%95%B1%EB%B3%B4%EC%95%88-3000-%EC%9D%B4%EC%83%81-) 참고)|리전별 URL|필수||
|‑authkey|계정의 인증 키. CLI 도구 다운로드 페이지에서 이 키를 찾을 수 있습니다.| 별도 제공|필수||
|‑srcapk|보호해야 하는 소스 APK 또는 App Bundle 파일|생성된 APK 또는 AAB의 파일 경로|필수||
|‑sealedapk|다운로드해야 하는 실링된 파일의 이름을 포함한 대상 경로|실링된 APK 또는 AAB의 파일 경로|필수||
|‑app_type|최적화된 실링을 위한 앱 유형|`GAME`, `NON_GAME`|선택|`GAME`|
|‑service_type|DoveRunner Mobile App Security Hybrid은 버전 관리가 다르므로 ReactNative, Ionic, Cordova와 같은 Hybrid 앱을 업로드하는 경우 여기에 HYBRID_AOS를 입력해야 합니다.|`NATIVE_AOS`, `HYBRID_AOS`|선택|`NATIVE_AOS`|
|‑framework|HYBRID_AOS 앱을 업로드할 때 필요한 옵션입니다.|`REACT_NATIVE`, `IONIC`, `CORDOVA`|선택||
|‑service_version|DoveRunner Mobile App Security 서비스 버전|`latest` 또는 `2.31.0.0`과 같은 특정 버전|선택|`latest`|
|‑deploymode|테스트 모드는 DoveRunner Mobile App Security 워터마크를 표시하지만 제한 없이 테스트할 수 있습니다. 릴리스 모드는 워터마크를 제거하지만 MAD가 유료 사용량으로 계산됩니다.|`test`, `release`|선택|`test`|
|‑so_encrypt (신규)|앱의 lib 경로의 SO 파일들을 도브러너 정책에 따라 자동으로 암호화 합니다.
**- 암호화시 문제가 되는것으로 알려진 서드 파티 라이브러리의 SO 파일들은 암호화 하지 않습니다.**|`yes`, `no`|선택|`yes`|
|‑select_so_encrypt (신규)|앱의 lib 경로에 위치한 so 파일을 선택적으로 암호화 합니다.
- selective_so 목록을 반드시 함께 입력해야 합니다.
**- so_encrypt 옵션이 yes 일때만 작동합니다.**|`yes`, `no`|선택|`no`|
|‑selective_so (신규)|앱의 lib 경로에 위치한 so 파일들 중 보호하고 싶은 파일들을 지정할 수 있습니다. 각 SO 파일은 쉼표(,)로 구분합니다.
**- so_encrypt 및 select_so_encrypt가 yes 일때만 작동합니다.**|`"libAAA.so,libCC.so,...libZZZ.so"`|선택||
|‑dex_encrypt|classes.dex 파일을 암호화할 수 있습니다.|`yes`, `no`|선택|`no`|
|‑select_dex_encrypt|‑dex_encrypt 옵션을 `yes`로 설정한 후 이 옵션을 `yes`로 활성화할 수 있습니다. 이 옵션을 사용하기 전에 DoveRunner Mobile App Security 콘솔에서 Android 코드의 클래스 또는 패키지를 등록해야 합니다.|`yes`, `no`|선택|`no`|
|‑block_environment|이 옵션에서 루팅 또는 에뮬레이터 환경을 차단할 수 있습니다.
**쉼표로 여러 옵션을 사용할 수 있습니다.**|`rooting`, `emulator`|선택||
|‑allow_emulator|위 옵션에서 에뮬레이터를 차단한 후 특정 에뮬레이터를 허용할 수 있습니다.
**쉼표로 여러 옵션을 사용할 수 있습니다.** |`LDPlayer`, `BlueStacks`, `Nox`|선택||
|‑block_work_profile|Secure Folder와 같은 직장프로필 환경에서 앱 실행을 차단할 수 있습니다|`yes`, `no`|선택|`yes`|
|‑allow_work_profiles|위 옵션을 `yes`로 설정했을 때 예외적인 직장프로필을 허용할 수 있습니다|`Samsung SecureFolder`|선택||
|‑use_query_all_packages|이 권한을 사용하면 DoveRunner Mobile App Security가 package_name을 변경하는 치트 도구를 감지할 수 있지만, Google Play Console에 양식을 제출하고 승인을 받아야 Google Play Console에 앱을 업로드할 수 있습니다. 자세한 내용은 도움말 센터 페이지를 참조하세요. [도움말 센터 가이드 읽기](https://support.doverunner.com/hc/ko/articles/47891958774681)|`yes`, `no`|선택|`no`|
|‑block_keylogger|최종 사용자 스마트폰에 숨어서 키 로그 정보를 캡처하는 키로거 앱을 차단할 수 있습니다.|`yes`, `no`|선택|`no`|
|‑hide_overlay_windows|예기치 않은 조작을 방지하기 위해 애플리케이션에서 외부 앱의 UI 오버레이를 차단할 수 있습니다. 이 옵션은 Android 12 기기부터 작동합니다.|`yes`, `no`|선택|`no`|
|‑block_screen_capture|화면 미러링 또는 캡처 앱이 앱 화면을 가로채려고 할 때 검은 화면만 표시됩니다. 하지만 이것은 해킹 감지 보고서를 보내지 않으며 앱을 종료하지도 않습니다.|`yes`, `no`|선택|`no`|
|‑allow_external_tool|매크로(자동 클릭) 및 패킷 공격 도구는 기본적으로 차단됩니다. 이 옵션을 사용하여 이러한 도구를 허용할 수 있습니다.
**쉼표로 여러 옵션을 사용할 수 있습니다.**|`macro`, `sniff`|선택||
|‑block_developer_options|개발자 옵션이 활성화된 스마트폰에서 앱 실행을 차단할 수 있습니다.|`yes`, `no`|선택|`no`|
|‑block_usb_debugging|USB 디버깅이 활성화된 스마트폰에서 앱 실행을 차단할 수 있습니다|`yes`, `no`|선택|`yes`|
|‑wifi_security_protocol|`WEP`, `WPA`와 같은 스마트폰의 현재 Wi-Fi 보안 프로토콜 정보를 수집할 수 있습니다. 이 옵션을 활성화하면 애플리케이션에 `android.permission.ACCESS_WIFI_STATE`가 추가됩니다|`collect`, `disable`|선택|`disable`|
|‑app_signing|DoveRunner Mobile App Security 적용 후 앱의 서명이 비활성화됩니다. 실링된 앱을 스마트폰에 설치하려면 실링된 APK 또는 AAB에 수동으로 또는 이 옵션을 사용하여 서명해야 합니다. DoveRunner Mobile App Security 콘솔에서 키스토어를 등록한 후 registered_key 옵션을 사용할 수 있습니다|`none`, `appsealing_key`, `registered_key`|선택|`none`|