cccs/assemblyline-service-configextractor

ConfigExtractor服务

服务概述

ConfigExtractor服务是Assemblyline框架的一部分，用于运行解析器以提取***软件配置数据。该服务通过调用https://github.com/CybercentreCanada/configextractor-py%EF%BC%88%E5%B7%B2%E5%9C%A8PyPI%E5%8F%91%E5%B8%83%EF%BC%89%EF%BC%8C%E9%92%88%E5%AF%B9%E5%A4%9A%E7%A7%8D***%E8%BD%AF%E4%BB%B6%E5%AE%B6%E6%97%8F%E6%8F%90%E5%8F%96%E9%85%8D%E7%BD%AE%E4%BF%A1%E6%81%AF%EF%BC%88%E5%A6%82IP%E3%80%81URL%E5%92%8C%E5%9F%9F%E5%90%8D%EF%BC%89%E3%80%82

核心功能与特性

***软件配置提取

基于ConfigExtractor Python库，支持解析器目录与该库兼容的所有场景，能够有效提取***软件的关键配置参数。

支持的解析框架

官方支持以下框架：

• https://github.com/dod-cyber-crime-center/DC3-MWCP
• https://github.com/kevoreilly/CAPEv2
• https://github.com/CybercentreCanada/Maco

更新器配置

来源管理（Sources）

更新器需匹配包含解析器的目录，例如CAPE来源的匹配模式为`^/tmp/w+/CAPE/# ConfigExtractor服务

服务概述

ConfigExtractor服务是Assemblyline框架的一部分，用于运行解析器以提取***软件配置数据。该服务通过调用https://github.com/CybercentreCanada/configextractor-py%EF%BC%88%E5%B7%B2%E5%9C%A8PyPI%E5%8F%91%E5%B8%83%EF%BC%89%EF%BC%8C%E9%92%88%E5%AF%B9%E5%A4%9A%E7%A7%8D***%E8%BD%AF%E4%BB%B6%E5%AE%B6%E6%97%8F%E6%8F%90%E5%8F%96%E9%85%8D%E7%BD%AE%E4%BF%A1%E6%81%AF%EF%BC%88%E5%A6%82IP%E3%80%81URL%E5%92%8C%E5%9F%9F%E5%90%8D%EF%BC%89%E3%80%82

核心功能与特性

***软件配置提取

基于ConfigExtractor Python库，支持解析器目录与该库兼容的所有场景，能够有效提取***软件的关键配置参数。

支持的解析框架

官方支持以下框架：

• https://github.com/dod-cyber-crime-center/DC3-MWCP
• https://github.com/kevoreilly/CAPEv2
• https://github.com/CybercentreCanada/Maco

更新器配置

来源管理（Sources）

更新器需匹配包含解析器的目录，例如CAPE来源的匹配模式为，仅针对根目录中的解析器。

来源配置参数

可通过JSON配置设置提取器的部署状态：

json
{
    // 设置提取器的部署状态
    "deployment_status": {
        // 更新时将列表中的提取器类设为NOISY
        "NOISY": ["extractor_class", ...],
        // 更新时将列表中的提取器类设为DISABLED
        "DISABLED": ["broken_extractor_class", ...]
    }
}

持久化（Persistence）

更新器依赖存储卷维持持久化，需附加存储卷以存储源集合，而非依赖Assemblyline的数据存储。

Python包管理

更新器会扫描解析器根目录下的requirements.txt文件，并安装Python包至指定目录，供服务实例使用。若需代理安装包，可在容器配置中添加环境变量PIP_PROXY。

镜像变体与标签

基础镜像信息

基于https://hub.docker.com/r/cccs/assemblyline-v4-service-base%E6%9E%84%E5%BB%BA%EF%BC%8C%E8%AF%A5%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%E5%9F%BA%E4%BA%8EDebian 11，包含Python 3.11。

标签类型说明

使用方法

运行环境要求

该服务需作为Assemblyline框架的一部分运行，依赖框架提供的基础设施。

本地测试部署

若需本地测试，可直接运行Docker镜像：

bash
docker run \
    --name Configextractor \
    --env SERVICE_API_HOST=http://`ip addr show docker0 | grep "inet " | awk '{print $2}' | cut -f1 -d"/"`:5003 \
    --network=host \
    cccs/assemblyline-service-configextractor

添加到Assemblyline部署

如需将服务添加到现有Assemblyline部署，请参考https://cybercentrecanada.github.io/assemblyline4_docs/developer_manual/services/run_your_service/#add-the-container-to-your-deployment%E3%80%82

参考文档

Assemblyline通用文档：https://cybercentrecanada.github.io/assemblyline4_docs/