Skip to content
This documentation is also available as markdown. For a complete index of all pages, see llms.txt at /llms.txt

Threat Response Messages

When DoveRunner detects a threat — a rooted device, an emulator, a debugger, app tampering, or a hooking framework — the sealed app shows the end user a response dialog and then closes. By default this dialog uses standard, solution-provided messages in the device language.

Threat Response Messages lets you replace those defaults with your own reusable templates: your wording, your dialog title, your button label, and your colors. Templates are created once and then selected per sealing, so the same template can be reused across builds and apps.

The feature is opt-in. If you do not select a template when sealing, the solution’s default messages are used and existing builds are unaffected.

A template is not applied by saving it. You apply it when you seal:

  • In the sealing wizard, on Step 5 · Advanced Detection.
  • Or by referencing it from a sealing preset. This is the only way to apply a template when you seal through the CLI — see -sealing_preset_name.

Open Android Mobile App Security → ThreatResponseMessages. The list shows every template in your account:

ColumnDescription
Template NameThe name you gave the template.
DescriptionOptional free-text note.
TypeCUSTOM for templates you created.
LanguagesThe language codes the template defines, for example EN KO.
Last UpdatedWhen the template was last saved.
ActionsPreview, edit, duplicate, or delete the template.

You can search by name or description, and filter the list by type or by language. Use + NEW TEMPLATE to create one, or the duplicate action to branch an existing template rather than starting over.

  1. Click + NEW TEMPLATE.

  2. Replace the default Untitled Template name and, optionally, add a description.

  3. Add the languages the template should cover (see Languages).

  4. Edit the wording on the MESSAGES tab and the dialog styling on the BRANDING tab.

  5. Check the LIVE PREVIEW panel, then click SAVE TEMPLATE.

English (en) is included by default. You can add more from the Add language… picker:

de Germanes Spanishfr Frenchid Indonesian
it Italianja Japaneseko Koreanpt Portuguese
pt_PT Portuguese (Portugal)ru Russianth Thaitr Turkish
vi Vietnamesezh Chinese (Simplified)zh_TW Chinese (Traditional)

The MESSAGES tab is pre-populated with the default wording, so you only need to edit the categories you care about. Expand a category to edit its Title and Message.

There are 11 threat categories, each with one message:

CategoryShown when
Rooted DeviceThe device is rooted, or a rooting tool is detected.
Android EmulatorThe app is running in an emulator.
App Cloning EnvironmentThe app is running in a virtual space, dual-app, or cloned environment.
Developer OptionsAndroid Developer Options are enabled.
USB DebuggingADB/USB debugging is enabled.
Customized ROMThe device runs a modified system image.
Code HookingA hooking framework is manipulating the app at runtime.
DebuggingA debugger is attached to the app’s process.
Tampering System & Disabling SecuritySystem security settings have been tampered with or disabled.
Cheat ToolA cheat or memory-manipulation tool is detected.
Repackaged ApplicationThe app has been repackaged or resigned.

The message body accepts a small set of HTML tags for basic formatting:

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

The BRANDING tab controls how the dialog looks. These settings apply to every category in the template.

FieldDescription
Dialog TitleHeading of the threat dialog.
Button TextLabel on the dismiss button.
Button ColorBackground color of the button.
Button Text ColorText color of the button label.
Background ColorBackground color of the dialog.
Text ColorColor of the dialog body text.

The LIVE PREVIEW panel on the right renders the dialog over a mock app screen, exactly as an end user would see it. Page through all 11 categories with the arrows next to the 1/11 counter to check every message before saving.

For reference, the default English dialog for Rooted Device reads:

Security Alert

Rooted Environment Detected

Not allowed to launch the App on rooted device, app will get closed.

OK

After the template is saved, seal your app as usual and select the template on Step 5 · Advanced Detection. See Apply DoveRunner Mobile App Security for the rest of the sealing flow.