blob: 365138934043eee0d32f3520cea4206ba73b61c0 [file] [log] [blame]
Alan Stokes6b576bd2019-01-31 15:16:01 +00001# The entries in this file define how security contexts for apps are determined.
2# Each entry lists input selectors, used to match the app, and outputs which are
3# used to determine the security contexts for matching apps.
4#
Nick Kralevich4be31902014-07-01 13:59:50 -07005# Input selectors:
Michael Peckf54b3622017-02-14 09:48:57 -08006# isSystemServer (boolean)
7# isEphemeralApp (boolean)
8# isOwner (boolean)
9# user (string)
10# seinfo (string)
11# name (string)
12# path (string)
13# isPrivApp (boolean)
14# minTargetSdkVersion (unsigned integer)
Yabin Cuiffa2b612018-11-02 14:34:06 -070015# fromRunAs (boolean)
Alan Stokes6b576bd2019-01-31 15:16:01 +000016#
17# All specified input selectors in an entry must match (i.e. logical AND).
18# An unspecified string or boolean selector with no default will match any
19# value.
20# A user, name, or path string selector that ends in * will perform a prefix
21# match.
22# String matching is case-insensitive.
23# See external/selinux/libselinux/src/android/android_platform.c,
24# seapp_context_lookup().
25#
26# isSystemServer=true only matches the system server.
Stephen Smalleydd31ddf2012-07-27 17:08:21 -040027# An unspecified isSystemServer defaults to false.
Chad Brubaker06cf31e2016-10-06 13:15:44 -070028# isEphemeralApp=true will match apps marked by PackageManager as Ephemeral
Stephen Smalleyff4db912014-09-15 15:16:06 -040029# isOwner=true will only match for the owner/primary user.
Alan Stokes6b576bd2019-01-31 15:16:01 +000030# user=_app will match any regular app process.
31# user=_isolated will match any isolated service process.
32# Other values of user are matched against the name associated with the process
33# UID.
34# seinfo= matches aginst the seinfo tag for the app, determined from
35# mac_permissions.xml files.
36# The ':' character is reserved and may not be used in seinfo.
37# name= matches against the package name of the app.
38# path= matches against the directory path when labeling app directories.
Jeff Vander Stoepee9c0b52015-10-05 09:15:04 -070039# isPrivApp=true will only match for applications preinstalled in
40# /system/priv-app.
Michael Peckf54b3622017-02-14 09:48:57 -080041# minTargetSdkVersion will match applications with a targetSdkVersion
42# greater than or equal to the specified value. If unspecified,
43# it has a default value of 0.
Alan Stokes6b576bd2019-01-31 15:16:01 +000044# fromRunAs=true means the process being labeled is started by run-as. Default
45# is false.
Nick Kralevich4be31902014-07-01 13:59:50 -070046#
Alan Stokes6b576bd2019-01-31 15:16:01 +000047# Precedence: entries are compared using the following rules, in the order shown
48# (see external/selinux/libselinux/src/android/android_platform.c,
49# seapp_context_cmp()).
Michael Peckf54b3622017-02-14 09:48:57 -080050# (1) isSystemServer=true before isSystemServer=false.
Alan Stokes6b576bd2019-01-31 15:16:01 +000051# (2) Specified isEphemeralApp= before unspecified isEphemeralApp=
52# boolean.
Nick Kralevich795add52019-04-16 15:56:33 -070053# (3) Specified isOwner= before unspecified isOwner= boolean.
54# (4) Specified user= string before unspecified user= string;
Alan Stokes6b576bd2019-01-31 15:16:01 +000055# more specific user= string before less specific user= string.
Nick Kralevich795add52019-04-16 15:56:33 -070056# (5) Specified seinfo= string before unspecified seinfo= string.
57# (6) Specified name= string before unspecified name= string;
Alan Stokes6b576bd2019-01-31 15:16:01 +000058# more specific name= string before less specific name= string.
Nick Kralevich795add52019-04-16 15:56:33 -070059# (7) Specified path= string before unspecified path= string.
Alan Stokes6b576bd2019-01-31 15:16:01 +000060# more specific name= string before less specific name= string.
Nick Kralevich795add52019-04-16 15:56:33 -070061# (8) Specified isPrivApp= before unspecified isPrivApp= boolean.
62# (9) Higher value of minTargetSdkVersion= before lower value of
Alan Stokes6b576bd2019-01-31 15:16:01 +000063# minTargetSdkVersion= integer. Note that minTargetSdkVersion=
64# defaults to 0 if unspecified.
Nick Kralevich795add52019-04-16 15:56:33 -070065# (10) fromRunAs=true before fromRunAs=false.
Alan Stokes6b576bd2019-01-31 15:16:01 +000066# (A fixed selector is more specific than a prefix, i.e. ending in *, and a
67# longer prefix is more specific than a shorter prefix.)
68# Apps are checked against entries in precedence order until the first match,
69# regardless of their order in this file.
70#
71# Duplicate entries, i.e. with identical input selectors, are not allowed.
Stephen Smalley2dd4e512012-01-04 12:33:27 -050072#
73# Outputs:
Michael Peckf54b3622017-02-14 09:48:57 -080074# domain (string)
75# type (string)
76# levelFrom (string; one of none, all, app, or user)
77# level (string)
Alan Stokes6b576bd2019-01-31 15:16:01 +000078#
79# domain= determines the label to be used for the app process; entries
80# without domain= are ignored for this purpose.
81# type= specifies the label to be used for the app data directory; entries
82# without type= are ignored for this purpose.
83# levelFrom and level are used to determine the level (sensitivity + categories)
84# for MLS/MCS.
85# levelFrom=none omits the level.
86# levelFrom=app determines the level from the process UID.
87# levelFrom=user determines the level from the user ID.
88# levelFrom=all determines the level from both UID and user ID.
Nick Kralevich795add52019-04-16 15:56:33 -070089#
Stephen Smalley38084142012-11-28 10:46:18 -050090# levelFrom=user is only supported for _app or _isolated UIDs.
91# levelFrom=app or levelFrom=all is only supported for _app UIDs.
Nick Kralevich4be31902014-07-01 13:59:50 -070092# level may be used to specify a fixed level for any UID.
Stephen Smalley2dd4e512012-01-04 12:33:27 -050093#
Alan Stokes6b576bd2019-01-31 15:16:01 +000094# For backwards compatibility levelFromUid=true is equivalent to levelFrom=app
95# and levelFromUid=false is equivalent to levelFrom=none.
96#
William Roberts81e1f902015-06-03 21:57:47 -070097#
98# Neverallow Assertions
Alan Stokes6b576bd2019-01-31 15:16:01 +000099# Additional compile time assertion checks for the rules in this file can be
100# added as well. The assertion
William Roberts81e1f902015-06-03 21:57:47 -0700101# rules are lines beginning with the keyword neverallow. Full support for PCRE
102# regular expressions exists on all input and output selectors. Neverallow
103# rules are never output to the built seapp_contexts file. Like all keywords,
104# neverallows are case-insensitive. A neverallow is asserted when all key value
105# inputs are matched on a key value rule line.
106#
107
108# only the system server can be in system_server domain
109neverallow isSystemServer=false domain=system_server
110neverallow isSystemServer="" domain=system_server
111
112# system domains should never be assigned outside of system uid
113neverallow user=((?!system).)* domain=system_app
114neverallow user=((?!system).)* type=system_app_data_file
115
116# anything with a non-known uid with a specified name should have a specified seinfo
117neverallow user=_app name=.* seinfo=""
118neverallow user=_app name=.* seinfo=default
119
120# neverallow shared relro to any other domain
121# and neverallow any other uid into shared_relro
122neverallow user=shared_relro domain=((?!shared_relro).)*
123neverallow user=((?!shared_relro).)* domain=shared_relro
124
125# neverallow non-isolated uids into isolated_app domain
126# and vice versa
127neverallow user=_isolated domain=((?!isolated_app).)*
128neverallow user=((?!_isolated).)* domain=isolated_app
129
130# uid shell should always be in shell domain, however non-shell
131# uid's can be in shell domain
132neverallow user=shell domain=((?!shell).)*
133
Max Bires77d41f72018-01-24 21:17:18 +0000134# only the package named com.android.shell can run in the shell domain
135neverallow domain=shell name=((?!com\.android\.shell).)*
136neverallow user=shell name=((?!com\.android\.shell).)*
137
Chad Brubaker06cf31e2016-10-06 13:15:44 -0700138# Ephemeral Apps must run in the ephemeral_app domain
139neverallow isEphemeralApp=true domain=((?!ephemeral_app).)*
Jeff Vander Stoep400d3ac2015-10-30 12:43:19 -0700140
Nick Kralevichcaf42d62018-10-04 10:57:29 -0700141isSystemServer=true domain=system_server_startup
142
Max Bires4ea55692017-12-11 16:19:23 -0800143user=_app seinfo=platform name=com.android.traceur domain=traceur_app type=app_data_file levelFrom=all
William Roberts92dfa312014-09-29 10:29:48 -0700144user=system seinfo=platform domain=system_app type=system_app_data_file
145user=bluetooth seinfo=platform domain=bluetooth type=bluetooth_data_file
Roshan Pius1086c7d2019-10-01 13:49:21 -0700146user=network_stack seinfo=network_stack domain=network_stack type=radio_data_file
William Roberts92dfa312014-09-29 10:29:48 -0700147user=nfc seinfo=platform domain=nfc type=nfc_data_file
Ruchi Kandoi8a2b4a72018-01-04 10:33:20 -0800148user=secure_element seinfo=platform domain=secure_element levelFrom=all
William Roberts92dfa312014-09-29 10:29:48 -0700149user=radio seinfo=platform domain=radio type=radio_data_file
Nick Kralevichb5ffbb72015-01-07 13:52:43 -0800150user=shared_relro domain=shared_relro
Max Bires77d41f72018-01-24 21:17:18 +0000151user=shell seinfo=platform domain=shell name=com.android.shell type=shell_data_file
Robert Sesekbacb19b2018-01-30 10:54:33 -0500152user=webview_zygote seinfo=webview_zygote domain=webview_zygote
Jeff Vander Stoep6231b4d2017-12-17 20:55:12 -0800153user=_isolated domain=isolated_app levelFrom=all
Martijn Coenen1bbda7e2018-11-05 11:39:15 +0100154user=_app seinfo=app_zygote domain=app_zygote levelFrom=all
Jerry Zhang9f152d92017-04-10 16:57:48 -0700155user=_app seinfo=media domain=mediaprovider name=android.process.media type=app_data_file levelFrom=user
Stephen Smalleya8337632014-09-11 14:07:28 -0400156user=_app seinfo=platform domain=platform_app type=app_data_file levelFrom=user
Nick Kralevich795add52019-04-16 15:56:33 -0700157user=_app isEphemeralApp=true domain=ephemeral_app type=app_data_file levelFrom=all
Nick Kralevich5d175512018-09-12 12:30:32 -0700158user=_app isPrivApp=true domain=priv_app type=privapp_data_file levelFrom=user
Ashwini Oruganti9bc81122019-10-21 15:28:00 -0700159user=_app seinfo=permission_controller isPrivApp=true name=com.google.android.permissioncontroller domain=permissioncontroller_app type=privapp_data_file levelFrom=all
Yabin Cui5dc2c8c2018-11-02 11:12:43 -0700160user=_app minTargetSdkVersion=29 domain=untrusted_app type=app_data_file levelFrom=all
161user=_app minTargetSdkVersion=28 domain=untrusted_app_27 type=app_data_file levelFrom=all
Jeff Vander Stoep6231b4d2017-12-17 20:55:12 -0800162user=_app minTargetSdkVersion=26 domain=untrusted_app_27 type=app_data_file levelFrom=user
Jeff Vander Stoepbacb6d72017-02-13 13:33:27 -0800163user=_app domain=untrusted_app_25 type=app_data_file levelFrom=user
Yabin Cui770a4f62019-01-07 16:37:24 -0800164user=_app minTargetSdkVersion=28 fromRunAs=true domain=runas_app levelFrom=all
165user=_app fromRunAs=true domain=runas_app levelFrom=user