Microsoft-Analyzer-Suite 使用教程
1. 项目目录结构及介绍
Microsoft-Analyzer-Suite 是一个专为分析微软生态数据,特别是Microsoft 365和Microsoft Entra ID日志而设计的PowerShell脚本集合。以下是该仓库的基本目录结构及其简介:
.
├── ADSignInLogsGraph-Analyzer-v0.2.ps1 # 分析AD登录日志图的脚本
├── MFA-Analyzer.ps1 # 多因素认证(MFA)日志分析脚本
├── MTL-Analyzer.ps1 # 消息跟踪日志分析器
├── OAuthPermissions-Analyzer.ps1 # OAuth权限分析脚本
├── RiskyDetections-Analyzer.ps1 # 高风险检测分析器
├── RiskyUsers-Analyzer.ps1 # 高风险用户分析脚本
├── UAL-Analyzer.ps1 # 用户授权活动分析
├── Users-Analyzer.ps1 # 用户分析脚本
├── TransportRules-Analyzer.ps1 # 邮件传输规则分析
├── README.md # 主要的阅读文件,提供了快速概览和使用说明
├── LICENSE # 许可证文件,遵循GPL-3.0协议
├── Helper-Scripts # 辅助脚本目录,可能包含日志处理等工具脚本
├── Config # 配置文件目录,存放分析所需的配置设定
├── Blacklists & Whitelists # 黑名单与白名单文件,用于过滤数据分析
├── Screenshots # 屏幕截图,展示脚本运行结果示例
├── Tools # 工具集合,辅助进行数据预处理或额外分析
└── ...
每个分析脚本通常对应一种特定的数据来源或安全分析需求,位于根目录下便于执行。
2. 项目启动文件介绍
主要的启动过程涉及直接调用这些.ps1
脚本。例如,如果你想要分析高风险用户,你会通过PowerShell终端执行命令 .\RiskyUsers-Analyzer.ps1
。每个脚本设计为独立工作,针对不同的数据集提供分析报告,因此没有单一的“启动文件”,而是根据具体分析需求选择对应的脚本执行。
3. 项目的配置文件介绍
配置文件通常位于Config
目录中。虽然具体的配置文件名和结构未直接在引用内容中列出,这类脚本集可能会要求配置数据源路径、过滤条件、输出格式等参数。配置可能是基于文本的(如.ini
、.json
或简单的文本文件),允许用户自定义分析的范围和细节。为了定制分析行为,你需要根据提供的配置模板或者脚本中的说明来编辑相应的配置文件。这一步骤确保了分析能够适应不同的环境和需求。
实际操作步骤概述:
- 克隆或下载仓库:首先从GitHub克隆该项目到本地。
- 了解配置:查看
Config
目录下的文件,理解其结构,并按需调整设置。 - 准备数据:确保你有权限访问并导出所需的Microsoft 365或Entra ID日志。
- 运行脚本:打开PowerShell(记得以管理员身份运行,尤其是当脚本需要较高权限时),定位到脚本所在的目录,然后逐个执行你需要的分析脚本。
请注意,使用任何脚本前应详细阅读README.md
文件,它会提供关于如何配置和执行脚本的具体指导以及必要的先决条件和注意事项。