ahuffman.aide

Ansible 角色

ahuffman.aide

描述

一个用于安装、配置和调度 AIDE 的 Ansible 角色。

请注意
默认设置将在安装工具后部署带有默认 aide.conf 的配置选项。
此角色仅在 Fedora 和 RHEL7 操作系统上经过全面测试。如在您的平台上遇到问题,请提出问题。

角色变量

变量名称 描述 是否必需 默认值 类型
aide_pkg 要安装的 aide 包的名称。如果需要,可以覆盖为特定版本。 "aide" 字符串
aide_conf_path aide 配置文件的路径 "/etc/aide.conf" 字符串
aide_update_db 是否在调用此角色时强制更新 aide 数据库 False 布尔值
aide_dbdir 创建 aide 数据库的目录 "/var/lib/aide" 字符串
aide_logdir 创建 aide 日志的目录 "/var/log/aide" 字符串
aide_database_filename 创建 aide 数据库时的文件名 "aide.db.gz" 字符串
aide_database_out_filename 创建更新后的 aide 数据库时的文件名 "aide.db.new.gz" 字符串
aide_gzip_dbout 是否压缩数据库输出文件 True 布尔值
aide_verbose AIDE 的详细级别。有效值为 0-255。 5 整数
aide_report_url 报告 URL 列表 ["file:@@{LOGDIR}/aide.log", "stdout"] 列表
aide_acl_no_symlink_follow 是否检查符号链接的 ACL。 True 布尔值
aide_warn_dead_symlinks 是否警告死符号链接。 False 布尔值
aide_summarize_changes 是否总结报告中添加、删除和更改文件的变化。 False 布尔值
aide_report_attributes 默认规则的报告列表 未定义 列表
aide_grouped 是否按添加、删除和更改的文件分组报告中的文件。 False 布尔值
aide_ignore_list (已弃用,将在未来版本中移除) 列出在最终报告中要忽略更改的属性的特殊组定义。 [] 列表
aide_config_version config_version 的值将在报告和数据库中打印。这仅用于信息目的,没有其他功能。 "1" 字符串
aide_cron_schedule_check 是否为运行 aide 检查设置定时任务 True 布尔值
aide_cron_email_notify_recipients 在定时任务后接收电子邮件通知的收件人列表。如果不需要此功能,请保留列表为空。 [] 列表
aide_cronjob_name 插入到定时任务之前的注释 "aide 定期数据库检查" 字符串
aide_cron_sched_min 调度定时任务开始的分钟 "0" 字符串
aide_cron_sched_hr 调度定时任务开始的小时 "1" 字符串
aide_cron_sched_day 调度定时任务开始的日期 "*" 字符串
aide_cron_sched_mon 调度定时任务开始的月份 "*" 字符串
aide_cron_sched_wkd 调度定时任务开始的星期几 "*" 字符串

定义和取消定义 aide.conf 变量

aide_macros:   
  define:   
     - name: "给它一个名字"
       variable: "变量名称"
       value: "变量的值"
     - name: "DBDIR 变量"
       variable: "DBDIR"
       value: "/var/lib/aide"
  undefine:   
     - name: "要取消定义的某个变量"
       variable: "变量名称"  #这将有效地取消定义我们上面定义的变量
     - name: "取消定义 DBDIR 变量"
       variable: "DBDIR"

定义规则/组、选择路径和忽略/负选择路径

构建了一个 YAML 规范来以相对组织的方式处理所有这些项目。

可用于规则的属性

aide_rules:   
  - name: "我的第一条规则"                                                #必需   
    rule: "FIPSR"                                                        #必需   
    comment: "放置在此规则声明上方的注释"                #可选   
    attributes: []  #由默认规则或定义的规则组成的列表      #必需,特殊负规则除外   
    paths:                                                               #可选   
       - "/my/include/path/1"  #不能以 '!' 开头,请参见忽略/负选择路径   
       - "/my/include/path/2"

一个特殊规则处理忽略/负选择路径

aide_rules 中添加一个规则,rule: negative
以下是示例,您也可以在此角色的 defaults/main.yml 中找到示例:

aide_rules:   
  - name: "我的负选择/忽略选择"                                #必需   
    rule: "negative"                                                     #必需   
    paths:                                                             #必需   
       - "/my/ignore/path/1"
       - "/my/ignore/path/2"

路径前不要包含 '!',模板逻辑会自动为您处理。

定时的 AIDE 检查

默认情况下在 crontab 中设置 'aide --check'。如果您希望在允许此角色创建定时任务后更改此设置,只需将变量 aide_cron_schedule_check 切换为 False。这样在下次运行剧本时,将从系统的 crontab 中移除该定时任务。需要注意的是,aide_cronjob_name 变量必须与当前 crontab 中的名称匹配,以才能正确移除。

示例剧本

- name: "安装和配置 aide"
  hosts: "servers"
  roles:
     - "ahuffman.aide"

许可证

MIT

作者信息

Andrew J. Huffman

关于项目

An Ansible role to install, configure, and schedule AIDE.

安装
ansible-galaxy install ahuffman.aide
许可证
mit
下载
33.7k