借助 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
如需了解详情,请参阅身份验证概览。