Skip to content

Commit 229324f

Browse files
Jami CogswellJami Cogswell
authored andcommitted
updated overview section of help file; also added 'App Manifest Overview' to references
1 parent 3714a98 commit 229324f

File tree

1 file changed

+12
-1
lines changed

1 file changed

+12
-1
lines changed

java/ql/src/Security/CWE/CWE-489/DebuggableAttributeEnabled.qhelp

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,14 @@
44
<qhelp>
55

66
<overview>
7-
<p>When a debugger is enabled it could allow for entry points in the application or reveal sensitive information.</p>
7+
<p>The Android manifest file defines configuration settings for Android applications.
8+
In this file, the <code>android:debuggable</code> attribute of the <code>application</code> element can be used to
9+
define whether or not the application can be debugged. When set to <code>true</code>, this attribute will allow the
10+
application to be debugged even when running on a device in user mode.</p>
11+
12+
<p>When a debugger is enabled it could allow for entry points in the application or reveal sensitive information.
13+
As a result, <code>android:debuggable</code> should only be enabled during development and should be disabled in
14+
production builds.</p>
815

916
</overview>
1017
<recommendation>
@@ -26,6 +33,10 @@ or do not include it in the manifest. The default value when not included is <co
2633
</example>
2734
<references>
2835

36+
<li>
37+
Android Developers:
38+
<a href="https://developer.android.com/guide/topics/manifest/manifest-intro">App Manifest Overview</a>.
39+
</li>
2940
<li>
3041
Android Developers:
3142
<a href="https://developer.android.com/guide/topics/manifest/application-element#debug">The android:debuggable attribute</a>.

0 commit comments

Comments
 (0)