cccs/assemblyline-service-emlparser

EmlParser Service

镜像概述和主要用途

EmlParser Service是一个基于Assemblyline框架的电子邮件解析服务，使用GOVCERT-LU eml_parser库解析电子邮件，提取头信息、附件和URI。该服务专为AssemblyLine 4平台设计，用于电子邮件安全分析和信息提取。

核心功能和特性

主要功能

• 提取电子邮件头信息
• 提取电子邮件正文中的URL
• 提取附件
• 标记各种电子邮件地址、URI、域名、IP等
• 可选提取电子邮件原始正文
• 可选返回eml_parser库的原始输出

支持工具

• https://github.com/GOVCERT-LU/eml_parser - 用于解析EML文件的Python库
• https://github.com/TeamMsgExtractor/msg-extractor - 用于解析Outlook文件的库

使用场景和适用范围

该服务主要用于电子邮件安全分析场景，适用于：

• 电子邮件威胁情报分析
• ***邮件检测与响应
• 电子邮件取证调查
• 电子邮件内容审计与合规检查

作为Assemblyline服务，它设计用于在Assemblyline框架内运行，是***分析和数字取证工作流的一部分。

镜像变体和标签

Assemblyline服务基于https://hub.docker.com/r/cccs/assemblyline-v4-service-base构建，该基础镜像基于Debian 11，内置Python 3.11。

Assemblyline服务使用以下标签定义：

详细使用方法和配置说明

本地测试

如果需要本地测试此服务，可以直接从命令行运行Docker镜像：

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

环境变量说明

• SERVICE_API_HOST: Assemblyline服务API主机地址，格式为http://<ip>:<port>

添加到Assemblyline部署

要将此服务添加到您的Assemblyline部署中，请遵循https://cybercentrecanada.github.io/assemblyline4_docs/developer_manual/services/run_your_service/#add-the-container-to-your-deployment。

配置选项

该服务提供以下可选配置：

• 提取电子邮件原始正文
• 返回eml_parser库的原始输出

这些选项可通过Assemblyline框架的服务配置界面进行设置。

相关文档

• https://cybercentrecanada.github.io/assemblyline4_docs/
• https://github.com/GOVCERT-LU/eml_parser
• https://github.com/TeamMsgExtractor/msg-extractor