Security Insights API

您可以使用 Security Insights API 啟用或停用 Chrome 安全性深入分析功能,以及檢查啟用狀態。

API 方法快速總覽

網址與 https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER 相關

說明 相對網址 HTTP 方法 允許的要求參數
為網域啟用深入分析功能,並為網域中的根機構單位/特定機構單位組合設定 Chrome 連接器 /enterprise/securityInsights:enable POST 選用:targetOus
停用網域的深入分析資訊 /enterprise/securityInsights:disable POST
查看網域深入分析資訊的啟用狀態 /enterprise/securityInsights:checkEnablementStatus GET

管理員權限

視呼叫的方法而定,需要不同的管理員權限。

方法 需要管理員權限
啟用 「機構單位」>「讀取」
「服務」>「Chrome 管理服務」>「設定」>「管理使用者設定」
「服務」>「Chrome 資料遺失防護」>「管理 Chrome 資料遺失防護應用程式深入分析設定」
停用 「機構單位」>「讀取」
「服務」>「Chrome 管理服務」>「設定」>「管理使用者設定」
「服務」>「Chrome 資料遺失防護」>「管理 Chrome 資料遺失防護應用程式深入分析設定」
checkEnablementStatus 「機構單位」>「讀取」
「服務」>「Chrome 管理服務」>「設定」>「管理使用者設定」
「服務」>「Chrome 資料遺失防護」>「管理 Chrome 資料遺失防護應用程式深入分析設定」「服務」>「Chrome 資料遺失防護」>「查看 Chrome 資料遺失防護應用程式深入分析設定」

如要管理管理員角色和權限,請前往「管理控制台 -> 管理員角色」。

API 範圍

啟用和停用 API 需要下列 OAuth 範圍:

https://www.googleapis.com/auth/chrome.management.securityinsights

對於 CheckEnablementStatus,可以使用下列任一範圍:

https://www.googleapis.com/auth/chrome.management.securityinsights
https://www.googleapis.com/auth/chrome.management.securityinsights.readonly

詳情請參閱驗證總覽一文。