长期支持版本

    AOps漏洞管理模块使用手册

    参照AOps部署指南部署AOps前后端服务后,即可使用AOps漏洞管理模块。

    下文会从页面的维度进行AOps漏洞管理模块功能的介绍。

    1. 工作台

    管理员登录后直接切入数据看板界面,在右侧页面主窗口右上角内看到CVE整体数量的分布统计。

    工作台图示

    2. 漏洞管理

    漏洞管理界面用于对目标主机存在的CVE进行监控与修复,现阶段漏洞管理只针对openEuler社区已修复的CVE,对于已发现但未修复的CVE管理作为预留扩展功能,后续逐步完善。

    当前漏洞管理模块分为以下三个界面:

    • CVEs界面
    • 主机列表界面
    • 任务列表界面

    2.1 主机列表界面

    主机列表界面

    支持如下操作:

    • 查看主机基本信息与其CVE个数(可根据主机组、Repo名称进行筛选,可根据CVE个数、上次扫描时间进行排序,根据主机名称进行主机检索)
    • 查看主机上次执行CVE扫描的时间
    • 当前已保存的Repo源
    • 添加Repo源
    • 删除Repo源
    • 对主机进行漏洞扫描
    • 点击主机名可跳转到主机详情界面
    • 当前数据进行导出

    (1) 主机详情信息界面

    主机详情信息界面

    支持如下操作:

    • 查看主机基本信息与CVE个数

    • 进行漏洞扫描

    • 生成CVE修复任务

    • 查看当前主机CVE列表信息(可根据严重性与状态进行筛选,可根据CVE发布时间与CVSS分数进行排序,可根据CVE ID进行检索)

    • 点击CVE ID 可跳转CVE详情界面

    • CVE标签修改

    • 主机CVE信息导出

    (2) 漏洞扫描

    扫描目标主机存在的CVE,主机列表不勾选的情况下,默认扫描全部主机。

    漏洞扫描

    (3) 添加REPO源

    点击CVE REPO下的“+”处,随后在弹出界面中,输入Repo源名称与Repo具体内容,点击右下角“确定”按钮便可完成添加Repo的操作。

    添加REPO源

    支持如下功能:

    • 编辑Repo内容
    • 下载Repo模板
    • 上传本地Repo文件

    (4) 上传repo文件

    在新建REPO源页面,点击“选择文件”后,选择本地已经编辑好的Repo文件便可将文件内容读入。

    上传repo文件

    (5) 查看repo源

    选中一个CVE REPO,点击CVE REPO名称后,在稍后弹出的窗口中可看到目标Repo的具体内容。

    查看repo源

    (6) 删除Repo源

    选中一个CVE REPO,点击“删除”后,会跳出一个确认窗口,点击“删除”按钮即可完成Repo删除动作。

    删除Repo源

    (7) 设置REPO任务

    当前CVE扫描与修复都是依赖于aops-update源实现,通过本功能可以为目标主机设置repo。设置的目标repo源中需包含aops-update源信息。

    设置REPO任务

    支持如下功能:

    • 编辑任务信息
    • 创建任务
    • 创建并执行任务

    2.2 CVEs界面

    此界面下可看到当前所有主机存在的CVE信息。

    CVEs界面

    支持如下操作:

    • 查看所有CVE信息(可根据CVE严重性进行筛选、CVE ID、发布时间、CVSS分数、主机数量进行排序,可根据CVE ID进行检索)
    • 上传安全公告(对版本有影响与对版本无影响的CVE数据)
      • 下载安全公告
    • 生成CVE修复任务

    (1) CVE详情信息

    CVE详情信息

    支持如下操作:

    • 查看CVE基本信息
    • 查看关联CVE数量
    • 查看用户对该CVE的状态标记
    • 查看受此CVE影响的主机列表以及基本信息
    • 可点击主机名称跳转至主机详情界面
    • 生成CVE修复任务

    (2) 生成CVE修复任务

    生成修复任务

    支持如下操作:

    • 编辑任务信息
    • 创建任务
    • 创建并执行任务

    (3) 上传安全公告

    • 下载安全公告

    ​ 受影响安全公告地址:https://repo.openeuler.org/security/data/cvrf/

    image-20230423162005888

    ​ 点击年份进入安全公告列表

    image-20230423162105519

    点击安全公告名称进入安全公告详情

    image-20230423162221215

    注:1.当前需要开发脚本主动下载或者手动复制安全公告内容保存;

    ​ 2.社区提供了一个订阅的方式:https://mailweb.openeuler.org/postorius/lists/sa-announce.openeuler.org/,目前还不支持推送的能力,预计6月30上线。

    CVE扫描结果的呈现依赖于数据库中已存储的CVE信息,对于目标主机存在但是未录入数据库的CVE数据,仅做日志记录。

    而CVE信息的录入依赖此接口实现。

    安全公告上传

    修改状态点击确认后,对应CVE的标签将会变更为对应字段。

    cve标记状态

    2.3 任务界面

    任务列表界面

    支持如下操作:

    • 查看任务列表(可根据任务类型筛选,可根据任务生成时间、任务需执行主机数量进行排序,可根据任务名称进行检索)
    • 执行任务
    • 删除任务
    • 点击任务名称跳转至任务详情界面

    (1) 任务详情界面

    任务详情界面

    支持如下操作:

    • 查看任务基本信息
    • 查看任务执行进度
    • 查看主机任务执行结果
    • 点击“查看报告”跳转至任务执行报告
    • 执行此任务

    (2) 执行任务

    任务的执行可通过下列三种方式触发。

    • 在任务创建时,点击创建并执行按钮。

      执行任务1

    • 在任务列表界面,点击某条任务信息后面的执行按钮。

      执行任务2

    • 在任务详情界面,点击执行按钮.

      执行任务3

    (3) 删除任务

    删除任务

    (4) 查看报告

    可在此处查看每个任务执行的具体情况,如执行结果、执行失败的原因等。

    查看报告

    FAQ:

    1. 当某个CVE修复完成需要再次扫描才会刷新CVE列表信息。
    2. 执行CVE扫描与CVE修复前需在目标主机设置repo id为aops-update的repo源。
    3. 当任务执行结果或者某个主机操作事件的返回结果为unknown时,请排查aops-zeus、aops-ceres服务是否正常运行以及相关配置文件是否正确配置。
    4. Linux系统Kernel类的漏洞修复完成后需要手动重启,否则CVE扫描仍可能会扫描到该漏洞。

    3.定时任务配置

    定时任务配置文件位于/etc/aops/apollo_crontab.ini,内容如下:

    [cve_scan]
    # timed task name
    id = cve scan
    # value between 0-6, for example, 0 means Monday, 0-6means everyday.
    day_of_week = 0-6
    # value between 0-23, for example, 2 means 2:00 in a day.
    hour = 2
    # value is true or false, for example, true means with service start.
    auto_start = true
    
    [download_sa]
    id = download sa
    day_of_week = 0-6
    hour = 3
    auto_start = true
    base_url = https://repo.openeuler.org/security/data/cvrf
    sa_years = 2021,2022,2023
    
    [correct_data]
    id = correct data
    day_of_week = 0-6
    hour = 4
    auto_start = true
    service_timeout_threshold_min = 15
    

    [cve_scan]

    定时扫描cve任务的参数。

    id

    表示定时任务的名称,不能与其他定时任务名称重复,不建议修改。

    day_of_week

    表示定时任务在一周中的第几天启动,取值范围0-6,0-6表示每天,0表示周一,1表示周二,以此类推。

    修改配置文件示例
    • 打开配置文件
    vim etc/aops/apollo_crontab.ini
    
    • 修改值

    image-20230420172756775

    hour

    表示定时任务启动的时间,取值范围0-23,1表示凌晨一点,2表示凌晨两点,以此类推。

    auto_start

    表示定时任务是否跟随服务启动,true表示同时启动,false表示不同时启动。

    其他

    如果要精确到分钟,秒,需要添加minute(取值范围0-59)和second(取值范围0-59)。

    示例
    minute = 13
    second = 34
    

    [download_sa]

    定时下载安全公告。

    相同字段含义和使用与[cve_scan]一样。

    base_url

    获取安全公告详细信息的基础url,不能修改。

    sa_years

    安全公告的年份,年份之间用“,”分开。

    [correct_data]

    定时校正异常数据。

    相同字段含义和使用与[cve_scan]一样。

    service_timeout_threshold_min

    判断异常数据的阈值,取值为正整数,建议最小值为15。

    修改配置文件示例
    • 打开配置文件
    vim etc/aops/apollo_crontab.ini
    
    • 修改值

    image-20230421090656768

    文档捉虫

    “有虫”文档片段

    问题描述

    提交类型 issue

    有点复杂...

    找人问问吧。

    PR

    小问题,全程线上修改...

    一键搞定!

    问题类型
    规范和低错类

    ● 错别字或拼写错误;标点符号使用错误;

    ● 链接错误、空单元格、格式错误;

    ● 英文中包含中文字符;

    ● 界面和描述不一致,但不影响操作;

    ● 表述不通顺,但不影响理解;

    ● 版本号不匹配:如软件包名称、界面版本号;

    易用性

    ● 关键步骤错误或缺失,无法指导用户完成任务;

    ● 缺少必要的前提条件、注意事项等;

    ● 图形、表格、文字等晦涩难懂;

    ● 逻辑不清晰,该分类、分项、分步骤的没有给出;

    正确性

    ● 技术原理、功能、规格等描述和软件不一致,存在错误;

    ● 原理图、架构图等存在错误;

    ● 命令、命令参数等错误;

    ● 代码片段错误;

    ● 命令无法完成对应功能;

    ● 界面错误,无法指导操作;

    风险提示

    ● 对重要数据或系统存在风险的操作,缺少安全提示;

    内容合规

    ● 违反法律法规,涉及政治、领土主权等敏感词;

    ● 内容侵权;

    您对文档的总体满意度

    非常不满意
    非常满意
    提交
    根据您的反馈,会自动生成issue模板。您只需点击按钮,创建issue即可。
    文档捉虫
    编组 3备份