安裝 零信任 Assessment 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。 它還包含名稱、時間戳記、檢測金鑰,以及固定的匿名 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 | 所需版本 | Service | Platform |
|---|---|---|---|
PSFramework |
1.14.457 |
日誌、設定與執行空間。 | 全部。 |
Microsoft.Graph.Authentication |
2.40.0 |
Microsoft Graph。 | 全部。 |
Microsoft.Graph.Beta.Teams |
2.40.0 |
Teams 測試版 API。 | 全部。 |
Az.Accounts |
5.5.3 |
Azure。 | 全部。 |
ExchangeOnlineManagement |
3.10.1 |
Exchange Online 與 Security & Compliance。 | 所有項目,視服務支援情況而定。 |
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 前面。 不要以任意的相依性版本取代原有版本。
請使用乾淨的評估主機
一個專用的 Windows 虛擬機,搭載 PowerShell 7、Visual C++ Redistributable 以及評估的相依關係,可以盡量減少組件衝突。
已安裝的模組不一定會造成衝突。 設定檔、自動匯入或更早的指令可以將不相容的組件載入同一程序。 移除或重新匯入模組並不會可靠地卸載這些組件。 請在全新的 pwsh -NoProfile 處理程序中重試,而不是解除安裝共用模組。
連線到 Microsoft Graph 和 Microsoft Azure
連接器分別與 Microsoft Graph、Azure、Exchange Online、Security & Compliance、SharePoint Online 和 AIP 建立獨立的連線。
安排您打算評估的服務的 互動用戶存取 權限。 在連線前,請先透過 Microsoft Entra Privileged Identity Management 啟用符合資格的角色。
連線到目標租用戶。 將範例網域替換成你租戶已驗證的網域:
Connect-ZtAssessment -Tenant contoso.onmicrosoft.com完成服務提示並檢視每一項連線狀態。 快取的工作階段與單一簽入(SSO)可減少提示;提示次數不保證固定。 更改存取方式後請重新連線。
關於服務選擇、連線選項及憑證式無人值守存取,請參見 「連接評估服務」。
登入 Microsoft Graph
在授權管理員同意後,使用評估帳號的執行時角色,最好是 Global Reader。 同意不會指派執行時角色。 新的範圍可能會再次要求同意;請參見 權限與角色。
登入 Microsoft Azure
請使用在預期的訂閱/資源範圍層級具有 Reader 存取權或同等讀取權限的帳號。 如果有提示,選擇預期租戶和訂閱。 Azure 存取與 Microsoft Entra ID 目錄角色分開管理。 跳過 Azure 會限制基礎設施、網路與安全運營(SecOps)的覆蓋範圍,以及日誌匯出檢查。
執行評定
檢查服務連線後,在同一個 PowerShell 會話中執行評估。 評估不會套用租戶修復。
Warning
對非空輸出目錄進行全新且非恢復的執行會提示刪除其內容。 偵測到持續整合(CI)環境時,目前的實作會自動清理這些資料。 請使用專用的新目錄,絕不要用包含無關檔案的資料夾。
選擇預設
.\ZeroTrustReport輸出資料夾為全新的工作目錄。 若要使用自訂路徑或選取的構面,請參見 執行與繼續評估。進行評估:
Invoke-ZtAssessment請參考進度儀表板,檢視警告或錯誤。 執行時間會依租戶大小、服務回應時間、限速及選擇的測試而異。 利用 診斷檔案 區分正在進行的工作與故障。
審查評估結果
重新設計的報表預設會在 .\ZeroTrustReport\ZeroTrustAssessmentReport.html 開啟。 在得出結論前,務必檢視所有七大支柱,包括跳過的檢查與錯誤。 請參閱 檢視結果並匯入 Workshop。
將評估結果轉化為行動
利用每個結果的風險、狀態及建議的補救措施,建立優先排序的改進待辦清單。 將每一項分配給擁有受影響技術的團隊,並追蹤安全結果,而非將評估完成視為工作結束。
身份、端點、網路與資料擁有者
使用評估索引標籤,繼續查看對應的實作指引:
- 身分:針對身分實施 零信任。
- 裝置:在端點實施 零信任。
- 網路:針對網路實施 零信任。
- 資料:對資料實施 零信任。
資安領導者與架構師
利用這些途徑協調跨團隊的修復作業,並將發現結果連結到更廣泛的安全性計畫:
移除零信任評量模組
當你不再需要該模組或其資料時,請依照 移除評估。 只移除你打算刪除的輸出和診斷套件;擴充的 PSFramework 日誌則是另外儲存的。
FAQs
這些連結保留對現已設有專屬文章之程序的存取權限。
匯出故障排除日誌
在同一個 PowerShell 會話中擷取診斷資料並檢視後再分享。 請參見「擷取支援套件」。
測試執行時查看日誌
關於每次執行進度日誌、收集器與測試細節,以及擴展的 PSFramework 日誌,請參見 日誌與診斷檔案。
解除安裝舊版
關於目前及舊有的套件清理,請參見 移除評估套件。 例行穩定更新時,請使用 安裝指引。
無法載入檔案或元件 Microsoft.Graph.Authentication
從乾淨的處理程序和評估所釘選的相依性開始,而不是一刀切移除共用模組。 參見 Resolve Graph 組件衝突。
我怎麼知道腳本是做什麼的?
檢視來源、進度儀表板及 評估診斷。
為什麼我收到異常錯誤“'DuckDB.NET.Data.DuckDBConnectionStringBuilder' 的類型初始化器拋出異常”?
在選擇解決方法前,先檢視內部例外。 請參見 解決 DuckDB 初始化錯誤。
我該如何取得支援?
這項評估有社群協助,而非官方的 Microsoft 產品支援。 請參閱 「舉報問題」或「提供回饋」。