OpenHarmony-SELinux配置

前言：

OpenHarmony 上某个进程向samgr注册SA服务，其他进程在与该进程进行IPC通信之前，需要获取该SA服务，SA提供方需要为该SA配置SELinux标签，否则该SA会被SELinux配置为u:object_r:default_service:s0标签，配置访问default_service的策略会被neverallow禁止，本文将介绍如何为新增的SA配置SELinux策略。

一、SELinux简介

SELinux （安全增强式 Linux ， Security-Enhanced Linux ）是 Linux 的安全组件，包含一组内核修改和用户空间工具，并提供了基于安全策略的强制访问控制机制（ Mandatory Access Control ，MAC ）。SELinux 已经被添加到各种 Linux 发行版中，其软件架构力图将软件执行与安全策略设计分离。本部件负责对文件、属性、服务等系统资源提供强制访问控制保护。提供neverallow规则限制系统中的高危操作，减少系统安全风险。

访问控制基本流程如下图所示：

1.1 整体架构

1.2 策略目录结构

OpenHarmony SELinux策略文件存放在//base/security/selinux_adapter/sepolicy/ohos_policy路径下，在该目录下按以下规范存放：

复制代码

├── 子系统
│   └── 部件
│       ├── public
│       │   └── type1.te
│       ├── vendor
│       │   └── type2.te
│       └── system
│           └── type3.te

其中，系统相关策略存放在system目录下，芯片相关策略存放在vendor目录下，系统和芯片共用的策略存放在public目录下。

1.3 通用策略文件

通用策略文件，是指设备开发者进行SELinux策略配置时，涉及修改的文件。

1.4 基础策略文件

基础策略文件，是指SELinux基础框架的SELinux策略文件，一般不涉及修改。

1.5 SELinux模式开关

将镜像烧录到开发板上，开机，通过串口拿到 Shell ，在其中执行：

selinux模式开关配置文件：开发板 /etc/selinux/config

二、SELinux策略

2.1 avc日志信息

当系统行为被SELinux拦截时，会在内核日志和hilog中打印相关的avc denied日志，格式如下：

|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| //使用dmesg查看日志 audit: type=1400 audit(1502458430.566:4): avc: denied { open } for pid=1658 comm="setenforce" path="/sys/fs/selinux/enforce" dev="selinuxfs" ino=4 scontext=u:r:hdcd:s0 tcontext=u:object_r:selinuxfs:s0 tclass=file permissive=1 //关键字：avc： denied //日志解读 open #操作为open pid=1658 #访问主体进程号为1658 comm="setenforce" #访问主体进程名为setenforce path="/sys/fs/selinux/enforce" #被访问客体为/sys/fs/selinux/enforce dev="selinuxfs" #被访问文件属于selinuxfs这一文件系统 ino=4 #文件节点编号为4 scontext=u:r:hdcd:s0 #访问主体selinux标签为u:r:hdcd:s0 tcontext=u:object_r:selinuxfs:s0 #被访问客体selinux标签为u:object_r:selinuxfs:s0 tclass=file #当前告警属于file类型的操作 permissive=1 #当前selinux处于宽容模式，只告警不做访问拦截。强制模式时，做拦截， permissive=0 //分析：缺少啥权限：denied { open } 谁缺少权限：scontext=u:r:hdcd:s0 对哪个文件缺少：tcontext=u:object_r:selinuxfs:s0 什么类型：tclass=file 通用公式为：allow {scontext} {tcontext}:{tclass} {denied权限} |

开发者可以使用关键字avc denied来过滤日志，对于影响业务的avc告警，可以利用告警提供的信息来编写相应的SELinux策略，例如：

上述avc日志对应的TE规则为

|-----------------------------------------|
| allow hdcd selinuxfs:file open; |

2.2 策略格式

SELinux策略，又称SELinux规则，通常以allow或neverallow开头，表示允许或禁止某种行为。在设备上使能SELinux时，SELinux会拦截所有未经allow规则授权的行为，配置allow规则可以放行，neverallow规则主要是拦截危险规则的配置。通常allow规则如下:

|-------------------------------------------------|
| allow subject object:class permissions; |

表示允许subject对object进行class中的permissions操作，其中：

subject表示主体，通常为进程的SELinux类型，如init。
object表示客体，通常为系统资源的SELinux类型，如data_file。
class表示要执行的操作的类型，如文件操作file、目录操作dir、套接字操作socket。
permissions表示要执行的具体操作，如对文件file的open、read、write。

同理，

|------------------------------------------------------|
| neverallow subject object:class permissions; |

表示不允许subject对object进行class中的permissions操作。

2.3 策略宏隔离

在考虑设备开发者便利的同时，需要兼顾商用设备安全性，因此OpenHarmony SELinux提供了策略宏隔离，决定在不同版本上策略是否生效。OpenHarmony SELinux中支持对仅在root版本生效的策略做宏隔离，宏名称为debug_only。在用于设备开发者调试的root版本中，也就是在版本编译命令中指定--build-variant root时，宏开启。在用于商用发布的user版本中，也就是在版本编译命令中指定--build-variant user时，宏关闭。该宏的使用方法参考如下:

|----------------------------------------------------|
| debug_only(` allow ueventd init:fd use; ') |

另外，OpenHarmony SELinux中也支持对开发者模式的策略做宏隔离，宏名称为developer_only，该宏默认开启。开发者模式策略是指，为便于使用user版本进行调试开发的开发者，需要开放的一些用于调试的SELinux策略。开发者模式宏的使用方法参考如下:

|---------------------------------------------------|
| developer_only(` allow sh init:fd use; ') |

三、配置SELinux策略

此处以开发activation_sa激活服务为例，详细介绍如何为sa服务配置selinux策略。

3.1 配置service_contexts

在sepolicy/base/public/service_contexts文件内，新增SAID与SA标签的映射关系：（SAID在activation_sa服务中定义，如foundation/activation/activation/sa_profile/BUILD.gn）

在service.te中定义对应的sa_activation_sa，使对应的标签合法：

|------------------------------------------------|
| type sa_activation_sa, sa_service_attr |

3.2 配置type.te

由init通过cfg文件孵化的SA服务进程，需要在sa服务的本进程cfg文件中新增secon字段(本例子为 foundation/activation/activation/etc/activation_sa.cfg），建立进程与标签的映射关系。如果未配置secon字段，进程在SELinux使能状态会被拦截启动。

因此，需要在type.te中定义SELinux标签u:r:activation_sa:s0中的SELinux类型activation_sa，使u:r:activation_sa:s0是合法的：

|-----------------------------------------------|
| type activation_sa, sadomain, domain; |

此外，需要调用binder_call，在activation_sa.te中添加

|----------------------------------------------------------------------------------------------------------|
| binder_call(activation_sa, samgr); allow activation_sa sa_activation_sa:samgr_class { get add }; |

3.3 查看avc日志信息

|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| dmesg |grep activation_sa [ 11.766938] [pid=1][Init][INFO][init_service_manager.c:1088]Start service activation_sa [ 11.768130] [pid=1][Init][INFO][init_common_service.c:567]Service activation_sa(pid 606) started [ 34.494845] audit: type=1400 audit(1502631529.323:301): avc: denied { getattr } for pid=1395 comm="ps" path="/proc/606" dev="proc" ino=27789 scontext=u:r:sh:s0 tcontext=u:r:activation_sa:s0 tclass=dir permissive=1 [ 45.994459] audit: type=1400 audit(1502631540.823:317): avc: denied { read } for pid=1426 comm="ps" name="stat" dev="proc" ino=30816 scontext=u:r:sh:s0 tcontext=u:r:activation_sa:s0 tclass=file permissive=1 [ 45.994494] audit: type=1400 audit(1502631540.823:318): avc: denied { open } for pid=1426 comm="ps" path="/proc/606/stat" dev="proc" ino=30816 scontext=u:r:sh:s0 tcontext=u:r:activation_sa:s0 tclass=file permissive=1 [ 51.714670] audit: type=1400 audit(1502631546.543:334): avc: denied { getattr } for pid=1443 comm="ps" path="/proc/606" dev="proc" ino=27789 scontext=u:r:sh:s0 tcontext=u:r:activation_sa:s0 tclass=dir permissive=1 [ 51.714712] audit: type=1400 audit(1502631546.543:335): avc: denied { search } for pid=1443 comm="ps" name="606" dev="proc" ino=27789 scontext=u:r:sh:s0 tcontext=u:r:activation_sa:s0 tclass=dir permissive=1 |

根据日志配置te策略，新增sepolicy/ohos_policy/activation/test/system/sh.te

|-----------------------------------------------------------------------------------------------------------|
| allow sh activation_sa:dir { getattr search }; allow sh activation_sa:file { read open getattr }; |

注意：随着策略不断配置，还会出现很多新的avc日志，要全部配置完全。

3.4 其他

如果配置完上述策略后，应用程序还是无法调用activation_sa中的方法，那么还需在对应等级的应用te文件（如settings应用权限等级为system_basic，那么对应新增system_basic_hap.te）中添加：

|-----------------------------------------------------------------------------------------------------------------------------------------------|
| allow system_basic_hap_attr activation_sa:binder { call transfer }; allow system_basic_hap_attr sa_activation_sa:samgr_class { get }; |

通过上述一系列配置，新增的activation_sa服务能够在selinux开启强制模式下正常启动，且应用程序能够调用到activation_sa服务中定义的接口。