Security Insights API

借助 Security Insights API,您可以启用或停用 Chrome 安全性分析功能,以及检查其启用状态。

API 方法快速概览

网址相对于 https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER

说明 相对网址 HTTP 方法 允许的请求参数
为您的网域启用数据洞察,并为网域中的根 OU/一组特定的 OU 配置 Chrome 接口 /enterprise/securityInsights:enable POST 可选:targetOus
为网域停用数据洞见 /enterprise/securityInsights:disable POST
查看网域的“数据洞见”功能的启用状态 /enterprise/securityInsights:checkEnablementStatus GET

管理员权限

根据调用的方法,需要不同的管理员权限。

方法 需要管理员权限
启用 “组织部门 > 读取”
“服务 > Chrome 管理 > 设置 > 管理用户设置”
“服务 > Chrome DLP > 管理 Chrome DLP 应用数据分析设置”
停用 “组织部门 > 读取”
“服务 > Chrome 管理 > 设置 > 管理用户设置”
“服务 > Chrome DLP > 管理 Chrome DLP 应用数据分析设置”
checkEnablementStatus “组织部门 > 读取”
“服务 > Chrome 管理 > 设置 > 管理用户设置”
“服务 > Chrome DLP > 管理 Chrome DLP 应用数据分析设置”“服务 > Chrome DLP > 查看 Chrome DLP 应用数据分析设置”

如需管理管理员角色和权限,请前往“管理控制台 -> 管理员角色”。

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

如需了解详情,请参阅身份验证概览