Akamai Unified Log Streamer (ULS)

概述

Unified Log Streamer (ULS) 旨在简化Akamai安全企业访问产品与SIEM系统的集成，支持的产品包括：

• 企业应用访问 (EAA)
• 安全互联网访问企业版 (SIA)
• Akamai MFA (MFA)
• Guardicore微分段
• Akamai云 (Linode)
• Akamai控制中心日志 (ACC)

得益于模块化设计，ULS支持多种开箱即用的SIEM解决方案，可将数据发送至任何支持文件、TCP、UDP、HTTP或FILE摄入的SIEM系统。

ULS可直接作为Python代码运行，也可作为Docker容器、通过docker compose脚本或在Kubernetes中通过Helm运行。Windows系统（Python环境）也支持运行ULS（但尚未经过广泛测试）。

!ULS docker compose使用

核心功能

支持的产品和日志源

支持的数据输出方式

• TCP 套接字 (tcp://host:port) --output tcp
• UDP 套接字 (udp://host:port) --output udp
• HTTP 和 HTTPS URL (http(s)://host:port/path)（支持认证）--output http
• RAW (>STDOUT) --output raw
• FILE（将日志写入本地文件系统并轮换）--output file
  完整输出文档请参见此处。

操作类型

• Python命令行
• Docker
• Docker Compose
• Kubernetes / k8s

附加功能

• 监控输出
• 调试信息（日志级别调整）
• HTTP CA证书验证跳过
• 可适配的HTTP - POST格式
• 输出过滤（减少发送至SIEM的日志行数）
• 输出转换（生成其他日志格式，如用于第三方集成）
• 自动恢复
• 文件后处理（仅文件输出）

文档

ULS可通过多种方式运行。在设置ULS之前，请了解您的SIEM摄入能力并在SIEM上配置摄入方法。ULS设计为抽象层，可轻松将日志数据发送至市场上大多数SIEM，不创建仪表板/数据提取。有关特定SIEM解决方案的详细信息，请参见此目录和您的SIEM文档。

通用要求

• Python 3.9+ 或 Docker / Docker Compose 或 Kubernetes / Helm
• AKAMAI .edgerc文件（详见文档）
• 出站互联网访问（Akamai API、Dockerhub或Python仓库）
• 计算资源占用极小：1 vCPU、1 GB RAM、500 MB可用磁盘。另见高可用性文档。
• ULS运行的操作系统需同步NTP时间。

命令行使用

!ULS命令行使用
示例命令：

bash
# ETP - THREAT日志输出到控制台
python3.9 bin/uls.py --input etp --feed threat --output raw

# EAA - ACCESS日志输出到TCP
python3.9 bin/uls.py --input eaa --feed access --output tcp --host 10.99.10.99 --port 8081

更多信息，请参见此文档。

Docker

!ULS Docker使用
更多信息，请参见此文档。

Docker Compose

!ULS Docker Compose使用
更多信息，请参见此文档。

Kubernetes

!img.png
更多信息，请参见此文档。

开发

有关此软件的最新稳定版本，请查看仓库的发布部分。main分支将保留稳定版本。为确保工具的持续开发，所有新更新将首先进入此仓库的development分支。development分支可能会有变化，也可能是软件的损坏版本。同时，"main"分支中的所有新版本也将在ULS Docker Hub空间上可用。

可通过Pull Requests提供对此软件的贡献，审核通过后将合并。

更新日志

所有新增功能和修复漏洞的完整更新日志请参见：
ULS - 更新日志

支持

Akamai ULS按"现状"提供。它不受Akamai Support支持。Akamai不对该工具的功能或使用该工具引起的任何问题负责。有关更多信息，请参阅许可证文档。

要报告问题、功能请求或漏洞，请在GitHub Issues页面创建新issue。本软件根据"Apache许可证"发布。在创建ticket前，请阅读常见问题并查看故障排除和调试说明。

欢迎通过Pull Requests改进代码或增强功能。

链接/参考

ULS项目GitHub
ULS项目Docker Hub

历史星标数

以下小图显示了该项目随时间收集的星标数量。欢迎添加您的星标。
![历史星标数]([***]