---
title: "위협 대응 메시지"
description: "DoveRunner 기본 위협 다이얼로그를 직접 만든 브랜드·다국어 메시지 템플릿으로 대체합니다."
---
> For the complete documentation index, see [llms.txt](/llms.txt).

import { Aside, Steps } from '@astrojs/starlight/components';

<Aside type="note">
엔터프라이즈 플랜 전용 기능입니다. Developer Console의 Android 메뉴에 **ThreatResponseMessages**가 보이지 않는다면 [헬프 센터](https://support.doverunner.com)로 문의해 주세요.
</Aside>

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

**위협 대응 메시지(Threat Response Messages)** 기능을 사용하면 이를 직접 만든 **템플릿**으로 대체할 수 있습니다. 문구, 다이얼로그 제목, 버튼 라벨, 색상을 지정할 수 있으며, 한 번 만든 템플릿은 실링할 때마다 선택해 재사용할 수 있습니다.

이 기능은 선택 사항입니다. 실링 시 템플릿을 선택하지 않으면 솔루션 기본 메시지가 사용되며, 이미 실링된 빌드에도 영향을 주지 않습니다.

## 템플릿이 적용되는 지점

템플릿은 저장한다고 해서 적용되지 않습니다. 실링할 때 적용합니다.

- 실링 위저드의 **5단계 · 고급 탐지**에서 선택합니다.
- 또는 실링 프리셋에서 참조합니다. CLI로 실링하는 경우 템플릿을 적용할 수 있는 유일한 방법입니다 — [`-sealing_preset_name`](../cicd/basic-configuration/)을 참고하세요.

## 템플릿 관리

**안드로이드 모바일 앱 보안 → ThreatResponseMessages**를 엽니다. 계정에 등록된 모든 템플릿이 표시됩니다.

| 열 | 설명 |
| :-- | :--- |
| **Template Name** | 템플릿에 지정한 이름입니다. |
| **Description** | 선택 입력하는 설명입니다. |
| **Type** | 직접 만든 템플릿은 `CUSTOM`으로 표시됩니다. |
| **Languages** | 템플릿이 정의한 언어 코드입니다. 예: `EN` `KO` |
| **Last Updated** | 마지막으로 저장한 시각입니다. |
| **Actions** | 미리보기, 편집, 복제, 삭제 |

이름·설명으로 검색하거나 타입·언어로 목록을 필터링할 수 있습니다. **+ NEW TEMPLATE**으로 새로 만들거나, 복제 기능으로 기존 템플릿을 분기할 수 있습니다.

## 템플릿 만들기

<Steps>

1. **+ NEW TEMPLATE**을 클릭합니다.

2. 기본값인 **Untitled Template** 이름을 변경하고, 필요하면 설명을 입력합니다.

3. 템플릿이 다룰 언어를 추가합니다([언어](#언어) 참고).

4. **MESSAGES** 탭에서 문구를, **BRANDING** 탭에서 다이얼로그 스타일을 편집합니다.

5. **LIVE PREVIEW**로 확인한 뒤 **SAVE TEMPLATE**을 클릭합니다.

</Steps>

### 언어

영어(`en`)는 기본으로 포함됩니다. **Add language…** 선택기에서 다음 언어를 추가할 수 있습니다.

| | | | |
| :--- | :--- | :--- | :--- |
| `de` 독일어 | `es` 스페인어 | `fr` 프랑스어 | `id` 인도네시아어 |
| `it` 이탈리아어 | `ja` 일본어 | `ko` 한국어 | `pt` 포르투갈어 |
| `pt_PT` 포르투갈어(포르투갈) | `ru` 러시아어 | `th` 태국어 | `tr` 튀르키예어 |
| `vi` 베트남어 | `zh` 중국어(간체) | `zh_TW` 중국어(번체) | |

<Aside type="caution">
템플릿 하나에는 영어를 포함해 **최대 3개 언어**만 담을 수 있습니다. 더 많은 언어가 필요하면 템플릿을 나누어 만들고 언어 조합별로 실링해야 합니다.
</Aside>

### 메시지

**MESSAGES** 탭은 기본 문구가 미리 채워져 있으므로 필요한 카테고리만 수정하면 됩니다. 카테고리를 펼쳐 **Title**과 **Message**를 편집합니다.

위협 카테고리는 11개이며, 각각 메시지 1개를 가집니다.

| 카테고리 | 표시되는 상황 |
| :------- | :------------ |
| **Rooted Device** | 기기가 루팅되었거나 루팅 툴이 탐지된 경우 |
| **Android Emulator** | 에뮬레이터에서 앱이 실행된 경우 |
| **App Cloning Environment** | Virtual Space, 듀얼앱 등 복제 환경에서 실행된 경우 |
| **Developer Options** | 개발자 옵션이 활성화된 경우 |
| **USB Debugging** | ADB/USB 디버깅이 활성화된 경우 |
| **Customized ROM** | 변조된 시스템 이미지를 사용하는 기기인 경우 |
| **Code Hooking** | 후킹 프레임워크가 런타임에 앱을 조작하는 경우 |
| **Debugging** | 앱 프로세스에 디버거가 연결된 경우 |
| **Tampering System & Disabling Security** | 시스템 보안 설정이 변조되거나 비활성화된 경우 |
| **Cheat Tool** | 치트툴 또는 메모리 변조 도구가 탐지된 경우 |
| **Repackaged Application** | 앱이 리패키징되거나 재서명된 경우 |

메시지 본문에는 다음 HTML 태그를 사용할 수 있습니다.

```
<b>  <i>  <u>  <br>  <span>
```

### 브랜딩

**BRANDING** 탭에서 다이얼로그의 외형을 설정합니다. 이 설정은 템플릿 내 모든 카테고리에 공통 적용됩니다.

| 항목 | 설명 |
| :--- | :--- |
| **Dialog Title** | 위협 다이얼로그의 제목입니다. |
| **Button Text** | 닫기 버튼의 라벨입니다. |
| **Button Color** | 버튼 배경색입니다. |
| **Button Text Color** | 버튼 라벨의 글자색입니다. |
| **Background Color** | 다이얼로그 배경색입니다. |
| **Text Color** | 다이얼로그 본문 글자색입니다. |

<Aside type="note">
로고 업로드 기능은 없습니다. 브랜딩은 제목, 버튼 라벨, 위 4가지 색상으로 한정됩니다.
</Aside>

### 라이브 미리보기

오른쪽 **LIVE PREVIEW** 패널은 최종 사용자가 보게 될 화면 그대로 다이얼로그를 렌더링합니다. `1/11` 카운터 옆 화살표로 11개 카테고리를 모두 넘겨보며 저장 전에 확인하세요.

참고로 **Rooted Device**의 기본 영어 다이얼로그는 다음과 같습니다.

> **Security Alert**
>
> **Rooted Environment Detected**
>
> Not allowed to launch the App on rooted device, app will get closed.
>
> `OK`

## 템플릿 적용하기

템플릿을 저장한 뒤 평소처럼 실링을 진행하고, **5단계 · 고급 탐지**에서 템플릿을 선택합니다. 나머지 실링 절차는 [DoveRunner Mobile App Security 적용](../android-sealing/)을 참고하세요.

<Aside type="note">
템플릿을 수정해도 이미 실링된 앱에는 반영되지 않습니다. 변경된 문구나 브랜딩을 적용하려면 앱을 다시 실링해야 합니다.
</Aside>