1 ##################################### 2 # domain_trans(olddomain, type, newdomain) 3 # Allow a transition from olddomain to newdomain 4 # upon executing a file labeled with type. 5 # This only allows the transition; it does not 6 # cause it to occur automatically - use domain_auto_trans 7 # if that is what you want. 8 # 9 define(`domain_trans', ` 10 # Old domain may exec the file and transition to the new domain. 11 allow $1 $2:file { getattr open read execute map }; 12 allow $1 $3:process transition; 13 # New domain is entered by executing the file. 14 allow $3 $2:file { entrypoint open read execute getattr map }; 15 # New domain can send SIGCHLD to its caller. 16 ifelse($1, `init', `', `allow $3 $1:process sigchld;') 17 # Enable AT_SECURE, i.e. libc secure mode. 18 dontaudit $1 $3:process noatsecure; 19 # XXX dontaudit candidate but requires further study. 20 allow $1 $3:process { siginh rlimitinh }; 21 ') 22 23 ##################################### 24 # domain_auto_trans(olddomain, type, newdomain) 25 # Automatically transition from olddomain to newdomain 26 # upon executing a file labeled with type. 27 # 28 define(`domain_auto_trans', ` 29 # Allow the necessary permissions. 30 domain_trans($1,$2,$3) 31 # Make the transition occur by default. 32 type_transition $1 $2:process $3; 33 ') 34 35 ##################################### 36 # file_type_trans(domain, dir_type, file_type) 37 # Allow domain to create a file labeled file_type in a 38 # directory labeled dir_type. 39 # This only allows the transition; it does not 40 # cause it to occur automatically - use file_type_auto_trans 41 # if that is what you want. 42 # 43 define(`file_type_trans', ` 44 # Allow the domain to add entries to the directory. 45 allow $1 $2:dir ra_dir_perms; 46 # Allow the domain to create the file. 47 allow $1 $3:notdevfile_class_set create_file_perms; 48 allow $1 $3:dir create_dir_perms; 49 ') 50 51 ##################################### 52 # file_type_auto_trans(domain, dir_type, file_type) 53 # Automatically label new files with file_type when 54 # they are created by domain in directories labeled dir_type. 55 # 56 define(`file_type_auto_trans', ` 57 # Allow the necessary permissions. 58 file_type_trans($1, $2, $3) 59 # Make the transition occur by default. 60 type_transition $1 $2:dir $3; 61 type_transition $1 $2:notdevfile_class_set $3; 62 ') 63 64 ##################################### 65 # r_dir_file(domain, type) 66 # Allow the specified domain to read directories, files 67 # and symbolic links of the specified type. 68 define(`r_dir_file', ` 69 allow $1 $2:dir r_dir_perms; 70 allow $1 $2:{ file lnk_file } r_file_perms; 71 ') 72 73 ##################################### 74 # tmpfs_domain(domain) 75 # Define and allow access to a unique type for 76 # this domain when creating tmpfs / shmem / ashmem files. 77 define(`tmpfs_domain', ` 78 type $1_tmpfs, file_type; 79 type_transition $1 tmpfs:file $1_tmpfs; 80 allow $1 $1_tmpfs:file { read write getattr }; 81 allow $1 tmpfs:dir { getattr search }; 82 ') 83 84 # pdx macros for IPC. pdx is a high-level name which contains transport-specific 85 # rules from underlying transport (e.g. UDS-based implementation). 86 87 ##################################### 88 # pdx_service_attributes(service) 89 # Defines type attribute used to identify various service-related types. 90 define(`pdx_service_attributes', ` 91 attribute pdx_$1_endpoint_dir_type; 92 attribute pdx_$1_endpoint_socket_type; 93 attribute pdx_$1_channel_socket_type; 94 attribute pdx_$1_server_type; 95 ') 96 97 ##################################### 98 # pdx_service_socket_types(service, endpoint_dir_t) 99 # Define types for endpoint and channel sockets. 100 define(`pdx_service_socket_types', ` 101 typeattribute $2 pdx_$1_endpoint_dir_type; 102 type pdx_$1_endpoint_socket, pdx_$1_endpoint_socket_type, pdx_endpoint_socket_type, file_type, coredomain_socket, mlstrustedobject, mlstrustedsubject; 103 type pdx_$1_channel_socket, pdx_$1_channel_socket_type, pdx_channel_socket_type, coredomain_socket; 104 userdebug_or_eng(` 105 dontaudit su pdx_$1_endpoint_socket:unix_stream_socket *; 106 dontaudit su pdx_$1_channel_socket:unix_stream_socket *; 107 ') 108 ') 109 110 ##################################### 111 # pdx_server(server_domain, service) 112 define(`pdx_server', ` 113 # Mark the server domain as a PDX server. 114 typeattribute $1 pdx_$2_server_type; 115 # Allow the init process to create the initial endpoint socket. 116 allow init pdx_$2_endpoint_socket_type:unix_stream_socket { create bind }; 117 # Allow the server domain to use the endpoint socket and accept connections on it. 118 # Not using macro like "rw_socket_perms_no_ioctl" because it provides more rights 119 # than we need (e.g. we don"t need "bind" or "connect"). 120 allow $1 pdx_$2_endpoint_socket_type:unix_stream_socket { read getattr write setattr lock append getopt setopt shutdown listen accept }; 121 # Allow the server domain to apply security context label to the channel socket pair (allow process to use setsockcreatecon_raw()). 122 allow $1 self:process setsockcreate; 123 # Allow the server domain to create a client channel socket. 124 allow $1 pdx_$2_channel_socket_type:unix_stream_socket create_stream_socket_perms; 125 # Prevent other processes from claiming to be a server for the same service. 126 neverallow {domain -$1} pdx_$2_endpoint_socket_type:unix_stream_socket { listen accept }; 127 ') 128 129 ##################################### 130 # pdx_connect(client, service) 131 define(`pdx_connect', ` 132 # Allow client to open the service endpoint file. 133 allow $1 pdx_$2_endpoint_dir_type:dir r_dir_perms; 134 allow $1 pdx_$2_endpoint_socket_type:sock_file rw_file_perms; 135 # Allow the client to connect to endpoint socket. 136 allow $1 pdx_$2_endpoint_socket_type:unix_stream_socket { connectto read write shutdown }; 137 ') 138 139 ##################################### 140 # pdx_use(client, service) 141 define(`pdx_use', ` 142 # Allow the client to use the PDX channel socket. 143 # Not using macro like "rw_socket_perms_no_ioctl" because it provides more rights 144 # than we need (e.g. we don"t need "bind" or "connect"). 145 allow $1 pdx_$2_channel_socket_type:unix_stream_socket { read getattr write setattr lock append getopt setopt shutdown }; 146 # Client needs to use an channel event fd from the server. 147 allow $1 pdx_$2_server_type:fd use; 148 # Servers may receive sync fences, gralloc buffers, etc, from clients. 149 # This could be tightened on a per-server basis, but keeping track of service 150 # clients is error prone. 151 allow pdx_$2_server_type $1:fd use; 152 ') 153 154 ##################################### 155 # pdx_client(client, service) 156 define(`pdx_client', ` 157 pdx_connect($1, $2) 158 pdx_use($1, $2) 159 ') 160 161 ##################################### 162 # init_daemon_domain(domain) 163 # Set up a transition from init to the daemon domain 164 # upon executing its binary. 165 define(`init_daemon_domain', ` 166 domain_auto_trans(init, $1_exec, $1) 167 tmpfs_domain($1) 168 ') 169 170 ##################################### 171 # app_domain(domain) 172 # Allow a base set of permissions required for all apps. 173 define(`app_domain', ` 174 typeattribute $1 appdomain; 175 # Label ashmem objects with our own unique type. 176 tmpfs_domain($1) 177 # Map with PROT_EXEC. 178 allow $1 $1_tmpfs:file execute; 179 ') 180 181 ##################################### 182 # untrusted_app_domain(domain) 183 # Allow a base set of permissions required for all untrusted apps. 184 define(`untrusted_app_domain', ` 185 typeattribute $1 untrusted_app_all; 186 ') 187 188 ##################################### 189 # net_domain(domain) 190 # Allow a base set of permissions required for network access. 191 define(`net_domain', ` 192 typeattribute $1 netdomain; 193 ') 194 195 ##################################### 196 # bluetooth_domain(domain) 197 # Allow a base set of permissions required for bluetooth access. 198 define(`bluetooth_domain', ` 199 typeattribute $1 bluetoothdomain; 200 ') 201 202 ##################################### 203 # hal_server_domain(domain, hal_type) 204 # Allow a base set of permissions required for a domain to offer a 205 # HAL implementation of the specified type over HwBinder. 206 # 207 # For example, default implementation of Foo HAL: 208 # type hal_foo_default, domain; 209 # hal_server_domain(hal_foo_default, hal_foo) 210 # 211 define(`hal_server_domain', ` 212 typeattribute $1 halserverdomain; 213 typeattribute $1 $2_server; 214 typeattribute $1 $2; 215 ') 216 217 ##################################### 218 # hal_client_domain(domain, hal_type) 219 # Allow a base set of permissions required for a domain to be a 220 # client of a HAL of the specified type. 221 # 222 # For example, make some_domain a client of Foo HAL: 223 # hal_client_domain(some_domain, hal_foo) 224 # 225 define(`hal_client_domain', ` 226 typeattribute $1 halclientdomain; 227 typeattribute $1 $2_client; 228 229 # TODO(b/34170079): Make the inclusion of the rules below conditional also on 230 # non-Treble devices. For now, on non-Treble device, always grant clients of a 231 # HAL sufficient access to run the HAL in passthrough mode (i.e., in-process). 232 not_full_treble(` 233 typeattribute $1 $2; 234 # Find passthrough HAL implementations 235 allow $2 system_file:dir r_dir_perms; 236 allow $2 vendor_file:dir r_dir_perms; 237 allow $2 vendor_file:file { read open getattr execute map }; 238 ') 239 ') 240 241 ##################################### 242 # passthrough_hal_client_domain(domain, hal_type) 243 # Allow a base set of permissions required for a domain to be a 244 # client of a passthrough HAL of the specified type. 245 # 246 # For example, make some_domain a client of passthrough Foo HAL: 247 # passthrough_hal_client_domain(some_domain, hal_foo) 248 # 249 define(`passthrough_hal_client_domain', ` 250 typeattribute $1 halclientdomain; 251 typeattribute $1 $2_client; 252 typeattribute $1 $2; 253 # Find passthrough HAL implementations 254 allow $2 system_file:dir r_dir_perms; 255 allow $2 vendor_file:dir r_dir_perms; 256 allow $2 vendor_file:file { read open getattr execute map }; 257 ') 258 259 ##################################### 260 # unix_socket_connect(clientdomain, socket, serverdomain) 261 # Allow a local socket connection from clientdomain via 262 # socket to serverdomain. 263 # 264 # Note: If you see denial records that distill to the 265 # following allow rules: 266 # allow clientdomain property_socket:sock_file write; 267 # allow clientdomain init:unix_stream_socket connectto; 268 # allow clientdomain something_prop:property_service set; 269 # 270 # This sequence is indicative of attempting to set a property. 271 # use set_prop(sourcedomain, targetproperty) 272 # 273 define(`unix_socket_connect', ` 274 ifelse($2, `property', ` 275 ifelse($3,`init', ` 276 print(`deprecated: unix_socket_connect($1, $2, $3) Please use set_prop($1, <property name>) instead.') 277 ') 278 ') 279 __unix_socket_connect__($1, $2, $3) 280 ') 281 282 define(`__unix_socket_connect__', ` 283 allow $1 $2_socket:sock_file write; 284 allow $1 $3:unix_stream_socket connectto; 285 ') 286 287 ##################################### 288 # set_prop(sourcedomain, targetproperty) 289 # Allows source domain to set the 290 # targetproperty. 291 # 292 define(`set_prop', ` 293 __unix_socket_connect__($1, property, init) 294 allow $1 $2:property_service set; 295 get_prop($1, $2) 296 ') 297 298 ##################################### 299 # get_prop(sourcedomain, targetproperty) 300 # Allows source domain to read the 301 # targetproperty. 302 # 303 define(`get_prop', ` 304 allow $1 $2:file r_file_perms; 305 ') 306 307 ##################################### 308 # unix_socket_send(clientdomain, socket, serverdomain) 309 # Allow a local socket send from clientdomain via 310 # socket to serverdomain. 311 define(`unix_socket_send', ` 312 allow $1 $2_socket:sock_file write; 313 allow $1 $3:unix_dgram_socket sendto; 314 ') 315 316 ##################################### 317 # binder_use(domain) 318 # Allow domain to use Binder IPC. 319 define(`binder_use', ` 320 # Call the servicemanager and transfer references to it. 321 allow $1 servicemanager:binder { call transfer }; 322 # servicemanager performs getpidcon on clients. 323 allow servicemanager $1:dir search; 324 allow servicemanager $1:file { read open }; 325 allow servicemanager $1:process getattr; 326 # rw access to /dev/binder and /dev/ashmem is presently granted to 327 # all domains in domain.te. 328 ') 329 330 ##################################### 331 # hwbinder_use(domain) 332 # Allow domain to use HwBinder IPC. 333 define(`hwbinder_use', ` 334 # Call the hwservicemanager and transfer references to it. 335 allow $1 hwservicemanager:binder { call transfer }; 336 # Allow hwservicemanager to send out callbacks 337 allow hwservicemanager $1:binder { call transfer }; 338 # hwservicemanager performs getpidcon on clients. 339 allow hwservicemanager $1:dir search; 340 allow hwservicemanager $1:file { read open }; 341 allow hwservicemanager $1:process getattr; 342 # rw access to /dev/hwbinder and /dev/ashmem is presently granted to 343 # all domains in domain.te. 344 ') 345 346 ##################################### 347 # vndbinder_use(domain) 348 # Allow domain to use Binder IPC. 349 define(`vndbinder_use', ` 350 # Talk to the vndbinder device node 351 allow $1 vndbinder_device:chr_file rw_file_perms; 352 # Call the vndservicemanager and transfer references to it. 353 allow $1 vndservicemanager:binder { call transfer }; 354 # vndservicemanager performs getpidcon on clients. 355 allow vndservicemanager $1:dir search; 356 allow vndservicemanager $1:file { read open }; 357 allow vndservicemanager $1:process getattr; 358 ') 359 360 ##################################### 361 # binder_call(clientdomain, serverdomain) 362 # Allow clientdomain to perform binder IPC to serverdomain. 363 define(`binder_call', ` 364 # Call the server domain and optionally transfer references to it. 365 allow $1 $2:binder { call transfer }; 366 # Allow the serverdomain to transfer references to the client on the reply. 367 allow $2 $1:binder transfer; 368 # Receive and use open files from the server. 369 allow $1 $2:fd use; 370 ') 371 372 ##################################### 373 # binder_service(domain) 374 # Mark a domain as being a Binder service domain. 375 # Used to allow binder IPC to the various system services. 376 define(`binder_service', ` 377 typeattribute $1 binderservicedomain; 378 ') 379 380 ##################################### 381 # wakelock_use(domain) 382 # Allow domain to manage wake locks 383 define(`wakelock_use', ` 384 # Access /sys/power/wake_lock and /sys/power/wake_unlock 385 allow $1 sysfs_wake_lock:file rw_file_perms; 386 # Accessing these files requires CAP_BLOCK_SUSPEND 387 allow $1 self:capability2 block_suspend; 388 ') 389 390 ##################################### 391 # selinux_check_access(domain) 392 # Allow domain to check SELinux permissions via selinuxfs. 393 define(`selinux_check_access', ` 394 r_dir_file($1, selinuxfs) 395 allow $1 selinuxfs:file w_file_perms; 396 allow $1 kernel:security compute_av; 397 allow $1 self:netlink_selinux_socket { read write create getattr setattr lock relabelfrom relabelto append bind connect listen accept getopt setopt shutdown recvfrom sendto name_bind }; 398 ') 399 400 ##################################### 401 # selinux_check_context(domain) 402 # Allow domain to check SELinux contexts via selinuxfs. 403 define(`selinux_check_context', ` 404 r_dir_file($1, selinuxfs) 405 allow $1 selinuxfs:file w_file_perms; 406 allow $1 kernel:security check_context; 407 ') 408 409 ##################################### 410 # create_pty(domain) 411 # Allow domain to create and use a pty, isolated from any other domain ptys. 412 define(`create_pty', ` 413 # Each domain gets a unique devpts type. 414 type $1_devpts, fs_type; 415 # Label the pty with the unique type when created. 416 type_transition $1 devpts:chr_file $1_devpts; 417 # Allow use of the pty after creation. 418 allow $1 $1_devpts:chr_file { open getattr read write ioctl }; 419 allowxperm $1 $1_devpts:chr_file ioctl unpriv_tty_ioctls; 420 # TIOCSTI is only ever used for exploits. Block it. 421 # b/33073072, b/7530569 422 # http://www.openwall.com/lists/oss-security/2016/09/26/14 423 neverallowxperm * $1_devpts:chr_file ioctl TIOCSTI; 424 # Note: devpts:dir search and ptmx_device:chr_file rw_file_perms 425 # allowed to everyone via domain.te. 426 ') 427 428 ##################################### 429 # Non system_app application set 430 # 431 define(`non_system_app_set', `{ appdomain -system_app }') 432 433 ##################################### 434 # Recovery only 435 # SELinux rules which apply only to recovery mode 436 # 437 define(`recovery_only', ifelse(target_recovery, `true', $1, )) 438 439 ##################################### 440 # Full TREBLE only 441 # SELinux rules which apply only to full TREBLE devices 442 # 443 define(`full_treble_only', ifelse(target_full_treble, `true', $1, 444 ifelse(target_full_treble, `cts', 445 # BEGIN_TREBLE_ONLY -- this marker is used by CTS -- do not modify 446 $1 447 # END_TREBLE_ONLY -- this marker is used by CTS -- do not modify 448 , ))) 449 450 ##################################### 451 # Not full TREBLE 452 # SELinux rules which apply only to devices which are not full TREBLE devices 453 # 454 define(`not_full_treble', ifelse(target_full_treble, `true', , $1)) 455 456 ##################################### 457 # Userdebug or eng builds 458 # SELinux rules which apply only to userdebug or eng builds 459 # 460 define(`userdebug_or_eng', ifelse(target_build_variant, `eng', $1, ifelse(target_build_variant, `userdebug', $1))) 461 462 ##################################### 463 # User builds 464 # SELinux rules which apply only to user builds 465 # 466 define(`userbuild', ifelse(target_build_variant, `user', $1, )) 467 468 ##################################### 469 # asan builds 470 # SELinux rules which apply only to asan builds 471 # 472 define(`with_asan', ifelse(target_with_asan, `true', userdebug_or_eng(`$1'), )) 473 474 #################################### 475 # Fallback crash handling for processes that can't exec crash_dump (e.g. because of seccomp). 476 # 477 define(`crash_dump_fallback', ` 478 userdebug_or_eng(` 479 allow $1 su:fifo_file append; 480 ') 481 allow $1 anr_data_file:file append; 482 allow $1 dumpstate:fd use; 483 # TODO: Figure out why write is needed. 484 allow $1 dumpstate:fifo_file { append write }; 485 allow $1 system_server:fifo_file { append write }; 486 allow $1 tombstoned:unix_stream_socket connectto; 487 allow $1 tombstoned:fd use; 488 allow $1 tombstoned_crash_socket:sock_file write; 489 allow $1 tombstone_data_file:file append; 490 ') 491 492 ##################################### 493 # WITH_DEXPREOPT builds 494 # SELinux rules which apply only when pre-opting. 495 # 496 define(`with_dexpreopt', ifelse(target_with_dexpreopt, `true', $1)) 497 498 ##################################### 499 # write_logd(domain) 500 # Ability to write to android log 501 # daemon via sockets 502 define(`write_logd', ` 503 unix_socket_send($1, logdw, logd) 504 allow $1 pmsg_device:chr_file w_file_perms; 505 ') 506 507 ##################################### 508 # read_logd(domain) 509 # Ability to run logcat and read from android 510 # log daemon via sockets 511 define(`read_logd', ` 512 allow $1 logcat_exec:file rx_file_perms; 513 unix_socket_connect($1, logdr, logd) 514 ') 515 516 ##################################### 517 # read_runtime_log_tags(domain) 518 # ability to directly map the runtime event log tags 519 define(`read_runtime_log_tags', ` 520 allow $1 runtime_event_log_tags_file:file r_file_perms; 521 ') 522 523 ##################################### 524 # control_logd(domain) 525 # Ability to control 526 # android log daemon via sockets 527 define(`control_logd', ` 528 # Group AID_LOG checked by filesystem & logd 529 # to permit control commands 530 unix_socket_connect($1, logd, logd) 531 ') 532 533 ##################################### 534 # use_keystore(domain) 535 # Ability to use keystore. 536 # Keystore is requires the following permissions 537 # to call getpidcon. 538 define(`use_keystore', ` 539 allow keystore $1:dir search; 540 allow keystore $1:file { read open }; 541 allow keystore $1:process getattr; 542 allow $1 keystore_service:service_manager find; 543 binder_call($1, keystore) 544 ') 545 546 ########################################### 547 # use_drmservice(domain) 548 # Ability to use DrmService which requires 549 # DrmService to call getpidcon. 550 define(`use_drmservice', ` 551 allow drmserver $1:dir search; 552 allow drmserver $1:file { read open }; 553 allow drmserver $1:process getattr; 554 ') 555 556 ########################################### 557 # add_service(domain, service) 558 # Ability for domain to add a service to service_manager 559 # and find it. It also creates a neverallow preventing 560 # others from adding it. 561 define(`add_service', ` 562 allow $1 $2:service_manager { add find }; 563 neverallow { domain -$1 } $2:service_manager add; 564 ') 565 566 ########################################### 567 # add_hwservice(domain, service) 568 # Ability for domain to add a service to hwservice_manager 569 # and find it. It also creates a neverallow preventing 570 # others from adding it. 571 define(`add_hwservice', ` 572 allow $1 $2:hwservice_manager { add find }; 573 allow $1 hidl_base_hwservice:hwservice_manager add; 574 neverallow { domain -$1 } $2:hwservice_manager add; 575 ') 576 577 ########################################## 578 # print a message with a trailing newline 579 # print(`args') 580 define(`print', `errprint(`m4: '__file__: __line__`: $* 581 ')') 582