Office365审计日志收集器使用教程
1. 项目的目录结构及介绍
office365-audit-log-collector/
├── ConfigExamples/
│ ├── fullConfig.yaml
│ └── ...
├── README.md
├── main.py
├── config.yaml
└── ...
- ConfigExamples/: 包含配置文件的示例,特别是
fullConfig.yaml
,其中包含了所有可能的配置选项和一些解释性注释。 - README.md: 项目的主文档,包含项目的基本信息和使用说明。
- main.py: 项目的启动文件,负责执行审计日志的收集和输出。
- config.yaml: 项目的配置文件,用于设置收集和输出的参数。
2. 项目的启动文件介绍
main.py
是项目的启动文件,负责执行审计日志的收集和输出。以下是该文件的主要功能:
- 初始化配置: 从
config.yaml
文件中读取配置参数。 - 收集日志: 根据配置参数从 Office365 和 AzureAD 收集审计日志。
- 输出日志: 将收集到的日志输出到指定的目标,如 PRTG、Azure Log Analytics Workspace、SQL、Graylog、Fluentd 和文件。
3. 项目的配置文件介绍
config.yaml
是项目的配置文件,用于设置收集和输出的参数。以下是该文件的主要内容:
output:
prtg: true
azure_log_analytics: true
sql: true
graylog: true
fluentd: true
file: true
filters:
event_types:
- UserLoggedIn
- UserLoggedOut
schedule:
interval: 3600 # 每隔3600秒(1小时)执行一次
resume: true # 从上次运行时间恢复
- output: 指定日志输出的目标,可以同时启用多个输出目标。
- filters: 设置日志过滤条件,如事件类型。
- schedule: 设置收集任务的执行间隔。
- resume: 设置是否从上次运行时间恢复,以避免遗漏任何日志。
通过配置文件,用户可以根据自己的需求灵活地设置日志收集和输出的参数。