跳转到内容
搜索 AlmaLinux 文档

    浏览当前文档目录

    AlmaLinux 10 fapolicyd 应用白名单入门 — AppStream 1.4.5、rules.d 编译规则与 trust.d 信任片段(容器实测)

    在 almalinux:10 容器(aarch64;10.2「Lavender Lion」,镜像 almalinux:10@sha256:5a4b41a4…cfe8,2026-10-31)中实际执行:dnf install fapolicyd 与包清点、fapolicyd-cli -l / --help / -t / -D / -u / --file add 的离线行为、/etc/fapolicyd/ 目录与 fapolicyd.conf 原文、rules.d/ 11 个规则文件与 compiled.rules 编译产物对照、trust.d/ 片段追加、fapolicyd-selinux 子包与 getenforce、unit 文件内容与 systemctl enable 建链。原始日志:plans/content-expansion/evidence/logs/alma-fapolicyd.log(主会话取证 + 三次同镜像重开容器补采,合并进对应 step)。

    本页没有执行:systemd 运行时(容器无 systemd)、实际拦截(denial 事件)、trust.db 首次生成——这些标注「未实测」,见文末「未验证事项」。

    fapolicyd 是什么:EL10 的应用白名单与包来源

    Section titled “fapolicyd 是什么:EL10 的应用白名单与包来源”

    fapolicyd(File Access Policy Daemon,包 Summary 为 Application Whitelisting Daemon)用「信任库 + 规则」两条依据决定对文件访问的 allow/deny:信任回答「这个文件是不是系统认可的」,规则回答「谁在什么条件下能对它做什么」。这套模型在 EL10 是开箱自带的——不依赖 EPEL。

    仓库归属(实测,dnf -q list --available "fapolicyd*"):

    fapolicyd.aarch64 1.4.5-1.2.el10_2 appstream
    fapolicyd-selinux.noarch 1.4.5-1.2.el10_2 appstream

    两个包都在 AppStream,版本同步发布(同为 1.4.5-1.2.el10_2)。最小容器镜像默认未安装 fapolicyd(初装容器先 dnf list --available 可见、再安装才有),所以「装了就开白名单」不是默认状态——最小时刻的第一步就是安装。

    上游代码与文档入口(包内 URL 字段指向):https://github.com/linux-application-whitelisting/fapolicyd。

    Terminal window
    sudo dnf install -y fapolicyd
    rpm -q fapolicyd fapolicyd-cli fapolicyd-selinux fapolicyd-server

    实测结果:

    包是否装上说明
    fapolicyd✅ 1.4.5-1.2.el10_2(aarch64)主包:守护进程 + fapolicyd-cli + unit 文件
    fapolicyd-selinux✅ 1.4.5-1.2.el10_2(noarch)SELinux 策略子包,随安装自动带入
    rpm-plugin-fapolicyd✅ 4.19.1.1-23.el10.alma.1RPM 插件,装 /usr/lib64/rpm-plugins/fapolicyd.so
    fapolicyd-cli❌ 无独立包rpm -q 报 package fapolicyd-cli is not installed
    fapolicyd-server❌ 无独立包同上——CLI 与服务都在主包里

    安装事务连带拉入 selinux-policy/selinux-policy-targeted、policycoreutils(+python-utils)、python3-audit、pam、libpwquality、lmdb-libs 等 20 余个依赖(日志为节选,原事务含 23 个包行)。rpm -q --info fapolicyd 关键字段:License GPL-3.0-or-later、Vendor AlmaLinux、Size 449,132 字节、Build Host arm64-builder01.almalinux.org。安装后系统新增用户/组 fapolicyd(uid/gid 998,shell /sbin/nologin,home /var/lib/fapolicyd,实测 getent passwd)。

    初装容器内没有 fapolicyd 进程(ps 不可用,改扫 /proc/*/comm 确认)——装包不等于启用。

    信任规则体系:rules.d 编译与默认策略(实测)

    Section titled “信任规则体系:rules.d 编译与默认策略(实测)”

    /etc/fapolicyd/ 目录初态(实测 ls -la):

    文件/目录实测大小角色
    fapolicyd.conf573 B守护进程主配置
    compiled.rules1,077 B编译产物(勿手改)
    fapolicyd.trust229 B信任清单(AUTOGENERATED FILE VERSION 2)
    fapolicyd-filter.conf2,195 B事件过滤配置
    rules.d/11 个文件规则源文件(可编辑)
    trust.d/空信任片段目录(可编辑)

    fapolicyd.conf 关键行(实测原文):

    permissive = 0 # 非 permissive:违规即实际拦截(而非只审计)
    trust = rpmdb,file # 信任来源:RPM 数据库 + 文件清单
    integrity = none # 不做哈希完整性校验(代价选项,见下)
    watch_fs = ext2,ext3,ext4,tmpfs,xfs,vfat,iso9660,btrfs

    trust = rpmdb,file 就是两个信任通道:rpmdb 通道由 rpm-plugin-fapolicyd 插件在 RPM 事务后维护(插件实测随装,其同步行为按包内 man 页转述、未实测);file 通道就是 fapolicyd.trust 与 trust.d/ 片段,用于非 RPM 产物(见下一节)。integrity = none 是默认档:信任只看「在不在清单里」,不比对文件哈希是否被篡改;代价更高的 sha256 档的性能影响未实测。

    规则侧是「源文件 → 编译产物」两段式。rules.d/ 实测装了 11 个编号规则文件:

    rules.d 文件关键规则(原文)作用
    10-languages.rules%languages=application/x-bytecode.python,…声明脚本/字节码 ftype 集合
    20-dracut.rulesallow perm=any uid=0 : dir=/var/tmp/ 等为 dracut 构建 initramfs 开例外
    21-updaters.rulesallow perm=open exe=/usr/bin/rpm、comm=dnf系统更新器例外(防死锁)
    30-patterns.rulesdeny_audit perm=any pattern=ld_so : all拦 ld.so 注入模式(ld_preload/static 被注释)
    40-bad-elf.rulesdeny_audit … ftype=application/x-bad-elf畸形 ELF 拒绝(即便可信)
    41-shared-obj.rulesallow … ftype=application/x-sharedlib trust=1共享库只放可信的
    42-trusted-elf.rulesallow perm=execute all : trust=1可信 ELF 才可执行
    70-trusted-lang.rulesallow … ftype=%languages trust=1语言文件只放可信的
    72-shell.rulesallow perm=any all : ftype=text/x-shellscriptshell 脚本放行
    90-deny-execute.rulesdeny_audit perm=execute all : all其余一切执行拒绝
    95-allow-open.rulesallow perm=open all : all其余打开放行

    compiled.rules 头注写明 automatically generated from /etc/fapolicyd/rules.d,内容与 11 个源文件按编号顺序展开一致(实测逐行对照);unit 文件里的 ExecStartPre=/usr/sbin/fagenrules 就是每次启动时重编译这一步(编译动作的运行时验证未实测)。规则顺序就是命中顺序——靠后的 90-deny-execute 兜住前面没被 allow 的执行,95-allow-open 兜住打开,这就是默认「可信才可执行、打开默认放行」的面。

    一个容易踩的版本差异:rpm -ql fapolicyd 里仍有 /etc/fapolicyd/fapolicyd.rules,但磁盘上该文件并不存在(实测 ls 报 No such file or directory)——1.4.x 的传统单文件规则路径已被 rules.d/ 取代,别按旧文档去改它。

    非 RPM 产物入信任库:trust.d 片段与 fapolicyd-cli(实测)

    Section titled “非 RPM 产物入信任库:trust.d 片段与 fapolicyd-cli(实测)”

    fapolicyd-cli --help 实测命令面(节选):--check-config、--check-trustdb、--check-path、-D --dump-db、-d --delete-db、-f --file、-t --ftype、-l --list、-r --reload-rules、-u --update、--trust-file。日常三条线:

    改规则 → 编辑 rules.d/ 后 fapolicyd-cli -r 通知重载(依赖运行中服务,未实测); 加信任 → fapolicyd-cli --file add; 查/校验 → -l 列规则、-D dump 信任库、-t 看 ftype。

    非 RPM 产物入信任库的实测演示(自建一个 4 字节脚本 /usr/local/bin/demo-tool):

    Terminal window
    # 先建空片段,再追加
    : > /etc/fapolicyd/trust.d/local-tools
    fapolicyd-cli --file add /usr/local/bin/demo-tool --trust-file local-tools

    两个实测细节:

    --trust-file /etc/fapolicyd/trust.d/local-tools
    → 10/31/26 12:26:27 [ ERROR ]: Invalid trust file name rc=2
    (--trust-file 传的是 trust.d/ 里的【片段名】,不是全路径)
    --trust-file local-tools
    → rc=0;片段内容变为:
    # AUTOGENERATED FILE VERSION 3
    /usr/local/bin/demo-tool 4 2a97516c354b68848cdbd8f54a226a0a55b21ed138e207ad6c5cbb9c00aa5aea

    即:--file add 会把「路径 大小 SHA256」写进片段,且片段头从包初装的 VERSION 2 变为 VERSION 3。改动后让守护进程生效需要 -u(更新信任库)或 -r(重载规则),两者都走 /run/fapolicyd/fapolicyd.fifo——容器里服务没跑,实测 -u 报 Open: /run/fapolicyd/fapolicyd.fifo -> No such file or directory,-D 报 mdb_env_open failed(trust.db 在 /var/lib/fapolicyd/,实测目录为空,首次运行服务才生成)。

    两个离线可用的排错口(实测 rc=0):fapolicyd-cli -l 列出编译后规则(不依赖服务),fapolicyd-cli --check-config 校验主配置(Daemon config is OK)。

    -t 的 ftype 判定演示(实测):fapolicyd-cli -t /usr/bin/rpm 与 /usr/sbin/fapolicyd 返回 application/x-executable;而 /usr/bin/ls 返回 text/plain——EL10 的 ls 不是 ELF,是 49 字节的 coreutils multi-call 脚本(头四字节 23 21 2f 75,即 #!/u)。这类「脚本化系统命令」在默认规则下的放行/拦截结果未实测(无运行中服务),实机部署前建议先跑 --check-path 核对。

    包内 unit 文件(实测 cat /usr/lib/systemd/system/fapolicyd.service):

    [Service]
    Type=forking
    OOMScoreAdjust=-1000
    RuntimeDirectory=fapolicyd
    PIDFile=/run/fapolicyd.pid
    ExecStartPre=/usr/sbin/fagenrules
    ExecStart=/usr/sbin/fapolicyd
    Restart=on-abnormal
    [Install]
    WantedBy=multi-user.target

    头注要求「You should manage this file with systemctl edit utility and not manually」——需要 NSS 用户/组查询的部署,按注释用 drop-in 加 After=nss-user-lookup.target。标准启用命令(转述,未实测):

    Terminal window
    sudo systemctl enable --now fapolicyd
    systemctl status fapolicyd
    journalctl -u fapolicyd # denial 事件与启动日志在这里看

    容器里这条命令的实际行为被记录到一半:enable 建链成功(Created symlink '/etc/systemd/system/multi-user.target.wants/fapolicyd.service' → '/usr/lib/systemd/system/fapolicyd.service'),--now 因 systemd 未运行被拒。即:开机自启的接线成立,运行时验证(守护进程常驻、fagenrules 重编译、denial 事件)需要实机 VM。

    安装 fapolicyd 会自动带入 fapolicyd-selinux(同版本 1.4.5-1.2.el10_2,noarch,实测 rpm -q);装好后 dnf -q list --available fapolicyd-selinux 返回 No matching Packages——available 列表只列未安装的包。fapolicyd-selinux 的角色是为守护进程本身提供 SELinux 策略模块(落盘在 selinux-policy 体系内);实测容器 getenforce 为 Disabled,即策略模块仅随包落盘、不生效——fapolicyd 的规则判定不依赖 SELinux 处于 enforcing,两者是独立的机制层,容器正是「装了 fapolicyd 矩阵、SELinux 关闭」的状态。两者在生产上的协同语义(如 enforcing 主机上的 denial 分流)未实测,见下节。

    • 服务运行时:容器无 systemd——systemctl enable --now/start 的真实启动、守护进程常驻、fagenrules 运行时重编译、fapolicyd-cli -u/-r(依赖 /run/fapolicyd/fapolicyd.fifo)均不可验证,启用方式按包内 unit 文件口径转述。
    • 实际拦截行为:无运行中服务即无 denial 事件——journalctl -u fapolicyd 排错路径、permissive 0/1 切换、被拦进程收到 EPERM 的语义均未验证。
    • trust.db 生命周期:首次生成的真实输出、--check-trustdb/--check-path 的实际校验结果未实测(容器内 trust.db 不存在,-D 仅能证明缺库报错 mdb_env_open failed)。
    • 生产信任规则编写:sample-rules/(/usr/share/fapolicyd/sample-rules/,实测列有 10-languages…95-allow-open 等 20+ 个样例与 README-rules)的组合取舍、integrity = sha256 的性能开销、自编译二进制/Python venv/rsync 产物的放行方案,需实机环境验证。
    • ftype 边界:脚本化系统命令(/usr/bin/ls 判 text/plain)在默认规则下的放行/拦截未实测。
    • 文档口径:RH 安全加固文档 fapolicyd 章本机不可达,本页仅以容器包内文件与 CLI 实测为准,文档口径待实抓复核。