安装 零信任 评估 PowerShell 模块,连接到租户中的各项服务,并运行评估以检查安全配置。
在开始之前,请准备受支持的 PowerShell 主机,并安排对要评估的服务的访问权限。 有关完整要求,请参阅 先决条件。
这些说明描述了开发源码。 已发布的包可能具有不同的要求和功能。
先决条件
- 访问要评估的租户和服务,包括 权限和角色。 初始同意和运行时访问是单独的要求。
- 当前开发依赖项集需要 PowerShell 7.6 或更高版本。 固定的 ExchangeOnlineManagement 3.10.1 使用 .NET 10,需要 PowerShell 7.6+。 旧包可能有所不同。 请参阅Exchange模块先决条件并在 Windows 上安装 PowerShell。 Windows PowerShell 5.1 不是评估主机。
- Windows 可提供完整的服务覆盖。 SharePoint Online 和 Azure 信息保护 (AIP) 使用 Windows PowerShell 兼容性会话。 在其他平台上,这些服务不可用,并且其相关测试将被跳过。
- 用于 Windows 上 DuckDB 本机依赖项的 Microsoft Visual C++ Redistributable(x64)。
- 在导入其他模块之前,使用干净的 PowerShell 进程,最好在专用的 Windows 虚拟机 (VM) 上运行。
- 适用的服务订阅和许可证。 缺少服务、许可证或数据访问可能会生成跳过的检查,而不是租户满足建议的证据。
- 具有足够磁盘空间的受保护输出目录。 为每个新的评估使用新目录。
保护评估数据
决定如何在运行模块之前保护本地评估数据以及是否发送评估遥测数据。
- 限制对输出目录的访问。 报表、导出和诊断可以包含租户配置和个人信息。 不再需要时将其删除。 导入 Workshop JSON 或共享诊断是你控制的单独操作。
- 查看遥测行为。 默认情况下已启用遥测;使用
Invoke-ZtAssessment -DisableTelemetry禁用评估遥测事件。
遥测事件的唯一特定于租户的自定义属性是租户 ID。 它还包括名称、时间戳、检测密钥/Instrumentation Key,以及固定的匿名 IP 地址和操作系统(OS)标记。 不包括评估结果。 网络服务可以处理标准连接元数据,例如源 IP 地址。 请参阅 遥测实现。
安装 PowerShell 模块
在干净进程中安装已发布的包,以便不相关的模块不会首先加载冲突的程序集。
打开新的 PowerShell 7 进程,最好使用
pwsh -NoProfile。为当前用户安装稳定的评估包:
Install-PSResource -Name ZeroTrustAssessment -Scope CurrentUser在接受存储库发出的信任提示之前,请先查看这些提示。 让评估在导入或首次使用时初始化其依赖项。
若要改用预发行版包,请使用:
Install-PSResource -Name ZeroTrustAssessment -Prerelease -Scope CurrentUser
安装预发行版会选择包版本。 评估的 -Preview 开关在存在时会启用仅预览功能;当前这七个支柱不需要此开关。 这两个选项都不意味着每个存储库更改都已发布。
若要更新现有的稳定安装,请运行 Update-PSResource -Name ZeroTrustAssessment,然后启动新的 PowerShell 过程。 无需删除不相关的模块来更新评估。
捆绑的 PowerShell 模块
开发模块清单将这些版本锁定为指定版本。 它们描述源快照,不一定是最新的稳定 Gallery 包。
| Module | 所需版本 | 服务 | Platform |
|---|---|---|---|
PSFramework |
1.14.457 |
日志记录、配置和运行空间。 | 全部。 |
Microsoft.Graph.Authentication |
2.40.0 |
Microsoft Graph。 | 全部。 |
Microsoft.Graph.Beta.Teams |
2.40.0 |
Teams Beta API。 | 全部。 |
Az.Accounts |
5.5.3 |
Azure. | 全部。 |
ExchangeOnlineManagement |
3.10.1 |
Exchange Online 和安全与合规。 | 全部(在服务支持的情况下)。 |
Microsoft.Online.SharePoint.PowerShell |
16.0.27612.12000 |
SharePoint Online。 | Windows。 |
AipService |
3.1.0.0 |
Azure 信息保护。 | Windows。 |
依赖项初始化程序会在 Windows 上将这些版本解析为 %APPDATA%\ZeroTrustAssessment\Modules,在 macOS/Linux 上解析为 ~/.cache/ZeroTrustAssessment/Modules。 它会将该缓存添加到 $env:PSModulePath 前面。 不要替换任意依赖项版本。
使用干净的评估主机
具有 PowerShell 7、Visual C++ 可再发行组件和评估依赖项的专用Windows VM 可最大程度地减少程序集冲突。
已安装的模块不会自动发生冲突。 配置文件、自动导入或早期命令可以将不兼容的程序集加载到同一进程中。 删除或重新导入模块不会可靠地卸载这些程序集。 在全新 pwsh -NoProfile 进程中重试,而不是卸载共享模块。
连接到 Microsoft Graph 和 Microsoft Azure
该连接器会分别建立到 Microsoft Graph、Azure、Exchange Online、安全与合规、SharePoint Online 和 AIP 的连接。
为要评估的服务安排 交互式用户访问 。 在连接之前,通过Microsoft Entra Privileged Identity Management激活符合条件的角色。
连接到预期租户。 将示例域替换为租户的已验证域:
Connect-ZtAssessment -Tenant contoso.onmicrosoft.com完成服务提示并查看每个连接状态。 缓存的会话和单一登录可以减少提示;无法保证提示次数。 更改访问方式后重新连接。
有关服务选择、连接选项和基于证书的无人参与访问,请参阅“连接到评估服务”。
登录到 Microsoft Graph
在授权管理员安排同意后,使用评估帐户的运行时角色,最好是全局读取者。 同意不会分配运行时角色。 新的范围可能需要再次获得同意;请参阅 权限和角色。
登录 Microsoft Azure
在预期的订阅/资源范围内使用具有读取者访问权限或等效读取权限的帐户。 如果出现提示,请选择预期的租户和订阅。 Azure访问与Microsoft Entra ID目录角色分开。 跳过 Azure 会限制基础结构、网络和安全运营(SecOps)覆盖范围以及日志导出检查。
执行评估
检查服务连接后,在同一 PowerShell 会话中运行评估。 评估不应用租户修复操作。
Warning
在非空输出目录上执行全新的、非恢复运行会提示删除其内容。 在检测到的持续集成 (CI) 环境中,当前实现会自动清理它。 使用专用的新目录,从不使用包含不相关的文件的文件夹。
选择一个工作目录,确保默认
.\ZeroTrustReport输出文件夹是新建的。 有关自定义路径或选定的支柱,请参阅“运行和恢复评估”。运行评估:
Invoke-ZtAssessment关注进度仪表板并查看警告或错误。 运行时因租户大小、服务响应时间、限制和所选测试而异。 使用 诊断文件 将活动工作与故障区分开来。
查看评估结果
默认情况下 .\ZeroTrustReport\ZeroTrustAssessmentReport.html,重新设计的报表将打开。 在得出结论之前,请查看所有七大支柱,包括跳过的检查和错误。 请参阅“查看结果并导入到 Workshop”。
将评估结果转化为行动
使用每个结果的风险、状态和建议的修正措施来生成按优先级排序的改进待办事项列表。 将每个项目分配给拥有受影响技术的团队,并跟踪安全结果,而不是将评估完成视为工作结束。
身份、终端、网络和数据所有者
使用评估选项卡继续查看相应的实施指导:
安全领导者和架构师
使用这些路径协调各团队的修复工作,并将发现的问题关联到更广泛的安全计划:
删除零信任评估模块
如果不再需要模块或其数据,请按照 “删除评估”操作操作。 仅删除要删除的输出和诊断包;扩展的 PSFramework 日志单独存储。
FAQs
这些链接仍可访问现已拥有专门文章的相关操作步骤。
导出故障排除日志
在同一 PowerShell 会话中捕获诊断,并在分享这些诊断信息之前查看诊断。 请参阅 “捕获支持包”。
在测试执行期间查看日志
有关每运行进度日志、收集器和测试详细信息以及扩展的 PSFramework 日志,请参阅 日志和诊断文件。
卸载以前的版本
有关当前和旧版程序包清理,请参阅删除评估程序包。 对于常规稳定更新,请使用 安装指南。
无法加载文件或程序集Microsoft.Graph.Authentication
从干净的进程和评估的固定依赖项开始,而不是全面删除共享模块。 请参阅 “解决图程序集冲突”。
如何知道脚本的作用?
查看源、进度仪表板和 评估诊断。
为什么我会收到异常错误:“‘DuckDB.NET.Data.DuckDBConnectionStringBuilder’的类型初始化器引发了一个异常。”
在选择补救措施之前检查内部异常。 请参阅 解决 DuckDB 初始化错误。
我如何获取支持?
该评估提供社区帮助,而非 Microsoft 官方产品支持。 请参阅 报告问题或提供反馈。