thechip911.hardening

加固 - Ansible 角色

一个 Ansible 角色,用于提高 AlmaLinux、Debian 或 Ubuntu 服务器的安全性。
systemd 版

要求 Ansible 版本 >= 2.12。

可在 Ansible Galaxy 中获取。

支持以下版本: AlmaLinux 8Debian 11, Ubuntu 20.04 LTS (Focal Fossa)22.04 LTS (Jammy Jellyfish)

注意

使用此角色前,请务必在非生产环境中进行测试。

注意

此角色在 slsa action workflow 下具有 SLSA 认证,可供验证。

依赖

无。

示例

Playbook

---
- hosts: localhost
  any_errors_fatal: true
  tasks:
    - name: 包含加固角色
      ansible.builtin.include_role:
        name: thechip911.hardening
      vars:
        block_blacklisted: true
        sshd_admin_net:
          - 10.0.0.0/16
        suid_sgid_permissions: false
...

使用 git checkout 的 ansible-pull

---
- hosts: localhost
  any_errors_fatal: true
  tasks:
    - name: 安装 git
      become: true
      ansible.builtin.package:
        name: git
        state: present

    - name: 检出 thechip911.hardening
      become: true
      ansible.builtin.git:
        repo: 'https://github.com/thechip911/ansible-role-hardening'
        dest: /etc/ansible/roles/thechip911.hardening
        version: master

    - name: 包含加固角色
      ansible.builtin.include_role:
        name: thechip911.hardening
      vars:
        block_blacklisted: true
        sshd_admin_net:
          - 10.0.2.0/16
        suid_sgid_permissions: false
...

关于 UFW 防火墙规则的注意事项

该角色不会在每次运行时重置 ufw,以避免导致网络流量中断,而是删除没有 comment: ansible managed 任务参数和值的所有 ufw 规则。

该角色还设置了默认的拒绝策略,这意味着需要为除 sshd_portufw_outgoing_traffic 变量中指定的额外端口创建防火墙规则。

任务执行和结构

请参见 STRUCTURE.md 了解角色结构树。

角色测试

请参见 TESTING.md

默认角色变量

./defaults/main/auditd.yml

auditd_apply_audit_rules: true
auditd_action_mail_acct: root
auditd_admin_space_left_action: suspend
auditd_disk_error_action: suspend
auditd_disk_full_action: suspend
auditd_max_log_file: 8
auditd_max_log_file_action: keep_logs
auditd_mode: 1
auditd_num_logs: 5
auditd_space_left: 75
auditd_space_left_action: email
grub_audit_backlog_cmdline: audit_backlog_limit=8192
grub_audit_cmdline: audit=1

在启动时通过 Grub 启用 auditd

auditd_apply_audit_rules 为 'yes' 时,角色将应用模板文件中的 auditd 规则。

auditd_action_mail_acct 应为有效的电子邮件地址或别名。

auditd_admin_space_left_action 定义当系统检测到磁盘空间不足时采取的动作。suspend 将导致审计守护进程停止记录到磁盘。

auditd_max_log_file_action 设置当系统检测到达到最大文件大小限制时采取的动作。例如,rotate 选项将使审计守护进程轮换日志。keep_logs 选项类似于 rotate,但不使用 num_logs 设置。这可以防止审计日志被覆盖。

auditd_space_left_action 告诉系统当检测到磁盘空间不足时采取的动作。email 意味着会向 action_mail_acct 指定的电子邮件账户发送警告,同时也会发送消息到 syslog。

auditd_mode 设置 auditd 的失败模式,0=静默 1=输出 2=恐慌。

auditd.conf(5)

./defaults/main/compilers.yml

compilers:
  - as
  - cargo
  - cc
  - cc-[0-9]*
  - clang-[0-9]*
  - gcc
  - gcc-[0-9]*
  - go
  - make
  - rustc

将限制使用的编译器列表,仅限于 root 用户。

./defaults/main/disablewireless.yml

disable_wireless: false

如果为 true,则关闭所有无线接口。

./defaults/main/dns.yml

dns: 127.0.0.1 1.1.1.1
fallback_dns: 9.9.9.9 1.0.0.1
dnssec: allow-downgrade
dns_over_tls: opportunistic

用于系统和备用 DNS 服务器的 IPv4 和 IPv6 地址。
如果 dnssec 设置为 "allow-downgrade",则尝试进行 DNSSEC 验证,但如果服务器不正确支持 DNSSEC,自动禁用 DNSSEC 模式。

如果 dns_over_tls 为 true,所有与服务器的连接将在 DNS 服务器支持 DNS-over-TLS 并拥有有效证书的情况下进行加密。

systemd 选项。

./defaults/main/ipv6.yml

disable_ipv6: false
ipv6_disable_sysctl_settings:
  net.ipv6.conf.all.disable_ipv6: 1
  net.ipv6.conf.default.disable_ipv6: 1

如果 disable_ipv6: true,则禁用 IPv6。

./defaults/main/limits.yml

limit_nofile_hard: 1024
limit_nofile_soft: 512
limit_nproc_hard: 1024
limit_nproc_soft: 512

最大进程数和打开文件数。

./defaults/main/misc.yml

install_aide: true
reboot_ubuntu: false
redhat_signing_keys:
  - 567E347AD0044ADE55BA8A5F199E2F91FD431D51
  - 47DB287789B21722B6D95DDE5326810137017186
epel7_signing_keys:
  - 91E97D7C4A5E96F17F3E888F6A2FAEA2352C64E5
epel8_signing_keys:
  - 94E279EB8D8F25B21810ADF121EA45AB2F86D6A1
epel9_signing_keys:
  - FF8AD1344597106ECE813B918A3872BF3228467C

如果 install_aide: true,则会安装并配置 AIDE

如果 reboot_ubuntu: true,则在需要时会重启 Ubuntu 节点。

redhat_signing_keysRedHat 产品签名密钥

epel7_signing_keysepel8_signing_keysepel9_signing_keys 是特定版本的 Fedora EPEL 签名密钥

./defaults/main/module_blocklists.yml

block_blacklisted: false
fs_modules_blocklist:
  - cramfs
  - freevxfs
  - hfs
  - hfsplus
  - jffs2
  - squashfs
  - udf
misc_modules_blocklist:
  - bluetooth
  - bnep
  - btusb
  - can
  - cpia2
  - firewire-core
  - floppy
  - n_hdlc
  - net-pf-31
  - pcspkr
  - soundcore
  - thunderbolt
  - usb-midi
  - usb-storage
  - uvcvideo
  - v4l2_common
net_modules_blocklist:
  - atm
  - dccp
  - sctp
  - rds
  - tipc

被阻止的内核模块。

设置 block_blacklisted: true 将阻止或禁用任何黑名单内核模块的自动加载。由于黑名单模块仍可以通过 modprobe module_name 手动加载,因此使用 install module_name /bin/true 可以防止这种情况。

./defaults/main/mount.yml

hide_pid: 2
process_group: root

hide_pid 设置 /proc/<pid>/ 的访问模式。

process_group 设置授权学习进程信息的组,否则受 hidepid= 限制。

/proc 挂载选项

./defaults/main/ntp.yml

fallback_ntp: 2.ubuntu.pool.ntp.org 3.ubuntu.pool.ntp.org
ntp: 0.ubuntu.pool.ntp.org 1.ubuntu.pool.ntp.org

NTP 服务器主机名或 IP 地址。 systemd 选项。

./defaults/main/packages.yml

system_upgrade: true
packages_blocklist:
  - apport*
  - autofs
  - avahi*
  - avahi-*
  - beep
  - git
  - pastebinit
  - popularity-contest
  - prelink
  - rpcbind
  - rsh*
  - rsync
  - talk*
  - telnet*
  - tftp*
  - whoopsie
  - xinetd
  - yp-tools
  - ypbind
packages_debian:
  - acct
  - apparmor-profiles
  - apparmor-utils
  - apt-show-versions
  - audispd-plugins
  - auditd
  - cracklib-runtime
  - debsums
  - gnupg2
  - haveged
  - libpam-apparmor
  - libpam-cap
  - libpam-modules
  - libpam-pwquality
  - libpam-tmpdir
  - lsb-release
  - needrestart
  - openssh-server
  - postfix
  - rkhunter
  - rsyslog
  - sysstat
  - tcpd
  - vlock
  - wamerican
packages_redhat:
  - audispd-plugins
  - audit
  - cracklib
  - gnupg2
  - haveged
  - libpwquality
  - openssh-server
  - needrestart
  - postfix
  - psacct
  - rkhunter
  - rsyslog
  - rsyslog-gnutls
  - vlock
  - words
packages_ubuntu:
  - fwupd
  - secureboot-db

system_upgrade: 'yes' 运行 apt upgradednf update(如果需要)。

根据发行版要安装的包和要删除的包(packages_blocklist)。

./defaults/main/password.yml

crypto_policy: FIPS
pwquality_config:
  dcredit: -1
  dictcheck: 1
  difok: 8
  enforcing: 1
  lcredit: -1
  maxclassrepeat: 4
  maxrepeat: 3
  minclass: 4
  minlen: 15
  ocredit: -1
  ucredit: -1

设置 加密政策,如果 /etc/crypto-policies/config 存在。

配置 libpwquality 库。

./defaults/main/sshd.yml

sshd_accept_env: LANG LC_*
sshd_admin_net:
  - 192.168.0.0/24
  - 192.168.1.0/24
sshd_allow_agent_forwarding: 'no'
sshd_allow_groups: sudo
sshd_allow_tcp_forwarding: 'no'
sshd_authentication_methods: any
sshd_banner: /etc/issue.net
sshd_challenge_response_authentication: 'no'
sshd_ciphers: [email protected],[email protected],aes256-ctr
sshd_client_alive_count_max: 1
sshd_client_alive_interval: 200
sshd_compression: 'no'
sshd_gssapi_authentication: 'no'
sshd_hostbased_authentication: 'no'
sshd_host_key_algorithms: [email protected],[email protected],ssh-ed25519,ssh-rsa,[email protected],[email protected],[email protected],ecdsa-sha2-nistp521,ecdsa-sha2-nistp384,ecdsa-sha2-nistp256
sshd_ignore_user_known_hosts: 'yes'
sshd_kerberos_authentication: 'no'
sshd_kex_algorithms: [email protected],ecdh-sha2-nistp521,ecdh-sha2-nistp384,ecdh-sha2-nistp256,diffie-hellman-group-exchange-sha256
sshd_login_grace_time: 20
sshd_log_level: VERBOSE
sshd_macs: [email protected],[email protected],hmac-sha2-512,hmac-sha2-256
sshd_max_auth_tries: 3
sshd_max_sessions: 3
sshd_max_startups: 10:30:60
sshd_password_authentication: 'no'
sshd_permit_empty_passwords: 'no'
sshd_permit_root_login: 'no'
sshd_permit_user_environment: 'no'
sshd_port: 22
sshd_print_last_log: 'yes'
sshd_print_motd: 'no'
sshd_rekey_limit: 512M 1h
sshd_required_rsa_size: 2048
sshd_strict_modes: 'yes'
sshd_subsystem: sftp internal-sftp
sshd_tcp_keep_alive: 'no'
sshd_use_dns: 'no'
sshd_use_pam: 'yes'
sshd_x11_forwarding: 'no'

有关未在此处描述的选项的说明,请阅读 https://man.openbsd.org/sshd_config

只有在 sshd_admin_net 中定义的网络可以连接到 sshd_port。请注意,需要设置其他规则以允许访问其他服务。

仅允许 SSH 登录用于其主组或补充组列表匹配 sshd_allow_groups 中模式的用户。

sshd_allow_agent_forwarding 指定是否允许 ssh-agent(1) 转发。

sshd_allow_tcp_forwarding 指定是否允许 TCP 转发。可用选项为 yes(或 all)以允许 TCP 转发,no 禁止所有 TCP 转发,local 仅允许本地(相对于 ssh(1))转发,或 remote 仅允许远程转发。

sshd_authentication_methods 指定必须成功完成的身份验证方法才能授予用户访问权限。

sshd_log_level 提供用于记录消息的详细程度。

sshd_max_auth_triessshd_max_sessions 分别指定每次连接允许的 SSH 身份验证尝试次数和每个网络连接允许的最大打开 shell、登录或子系统(例如 sftp)会话数。

sshd_password_authentication 指定是否允许密码身份验证。

sshd_port 指定 sshd(8) 监听的端口号。

sshd_required_rsa_size,所需 RSA 大小,仅在 SSH 版本高于 9.1 时设置。

./defaults/main/suid_sgid_blocklist.yml

suid_sgid_permissions: true
suid_sgid_blocklist:
  - ansible-playbook
  - ar
  - as
  - at
  - awk
  - base32
  - base64
  - bash
  - busctl
  - busybox
  [...]

如果 suid_sgid_permissions: true,则遍历 suid_sgid_blocklist 并删除任何 SUID/SGID 权限。

完整文件列表可在 defaults/main/suid_sgid_blocklist.yml 中找到。

./defaults/main/sysctl.yml

sysctl_dev_tty_ldisc_autoload: 0
sysctl_net_ipv6_conf_accept_ra_rtr_pref: 0

ipv4_sysctl_settings:
  net.ipv4.conf.all.accept_redirects: 0
  net.ipv4.conf.all.accept_source_route: 0
  net.ipv4.conf.all.log_martians: 1
  net.ipv4.conf.all.rp_filter: 1
  net.ipv4.conf.all.secure_redirects: 0
  net.ipv4.conf.all.send_redirects: 0
  net.ipv4.conf.all.shared_media: 0
  net.ipv4.conf.default.accept_redirects: 0
  net.ipv4.conf.default.accept_source_route: 0
  net.ipv4.conf.default.log_martians: 1
  net.ipv4.conf.default.rp_filter: 1
  net.ipv4.conf.default.secure_redirects: 0
  net.ipv4.conf.default.send_redirects: 0
  net.ipv4.icmp_echo_ignore_broadcasts: 1
  net.ipv4.icmp_ignore_bogus_error_responses: 1
  net.ipv4.ip_forward: 0
  net.ipv4.tcp_challenge_ack_limit: 2147483647
  net.ipv4.tcp_invalid_ratelimit: 500
  net.ipv4.tcp_max_syn_backlog: 20480
  net.ipv4.tcp_rfc1337: 1
  net.ipv4.tcp_syn_retries: 5
  net.ipv4.tcp_synack_retries: 2
  net.ipv4.tcp_syncookies: 1

ipv6_sysctl_settings:
  net.ipv6.conf.all.accept_ra: 0
  net.ipv6.conf.all.accept_redirects: 0
  net.ipv6.conf.all.accept_source_route: 0
  net.ipv6.conf.all.forwarding: 0
  net.ipv6.conf.all.use_tempaddr: 2
  net.ipv6.conf.default.accept_ra: 0
  net.ipv6.conf.default.accept_ra_defrtr: 0
  net.ipv6.conf.default.accept_ra_pinfo: 0
  net.ipv6.conf.default.accept_ra_rtr_pref: 0
  net.ipv6.conf.default.accept_redirects: 0
  net.ipv6.conf.default.accept_source_route: 0
  net.ipv6.conf.default.autoconf: 0
  net.ipv6.conf.default.dad_transmits: 0
  net.ipv6.conf.default.max_addresses: 1
  net.ipv6.conf.default.router_solicitations: 0
  net.ipv6.conf.default.use_tempaddr: 2

generic_sysctl_settings:
  fs.protected_fifos: 2
  fs.protected_hardlinks: 1
  fs.protected_symlinks: 1
  fs.suid_dumpable: 0
  kernel.core_uses_pid: 1
  kernel.dmesg_restrict: 1
  kernel.kptr_restrict: 2
  kernel.panic: 60
  kernel.panic_on_oops: 60
  kernel.perf_event_paranoid: 3
  kernel.randomize_va_space: 2
  kernel.sysrq: 0
  kernel.unprivileged_bpf_disabled: 1
  kernel.yama.ptrace_scope: 2
  net.core.bpf_jit_harden: 2

conntrack_sysctl_settings:
  net.netfilter.nf_conntrack_max: 2000000
  net.netfilter.nf_conntrack_tcp_loose: 0

sysctl 配置。

sysctl.conf

./defaults/main/ufw.yml

ufw_enable: true
ufw_outgoing_traffic:
  - 22
  - 53
  - 80
  - 123
  - 443
  - 853

ufw_enable: true 安装并配置 ufw 及相关规则。将其设置为 false 可手动安装和配置防火墙。
ufw_outgoing_traffic 打开特定的 ufw 端口,允许出站流量。

./defaults/main/users.yml

delete_users:
  - games
  - gnats
  - irc
  - list
  - news
  - sync
  - uucp

要删除的用户。

推荐阅读

对比 DISA STIG 和 CIS 基准值

互联网安全中心 Linux 基准

常见配置枚举

DISA 安全技术实施指南

SCAP 安全指南

以安全为中心的 systemd 配置

贡献

想要贡献吗?太好了!欢迎任何规模的贡献。如果您发现了任何问题,请随时提交问题,创建一个 Pull Request 改进代码,或者通过 赞助该项目

许可

Apache 许可证 版本 2.0

作者信息

https://github.com/thechip911

安装
ansible-galaxy install thechip911.hardening
许可证
apache-2.0
下载
109
拥有者