Security Insights API cho phép bạn bật hoặc tắt tính năng thông tin chi tiết về bảo mật của Chrome, kiểm tra trạng thái bật và truy vấn dữ liệu thông tin chi tiết (chẳng hạn như lượt chuyển nội dung và lượt truy cập URL).
Tổng quan nhanh về các phương thức API
URL liên quan đến https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| Mô tả | URL tương đối | Phương thức HTTP | Tham số yêu cầu được phép |
|---|---|---|---|
| Bật thông tin chi tiết cho miền của bạn và định cấu hình Chrome Enterprise Connectors cho đơn vị tổ chức gốc/một nhóm đơn vị tổ chức cụ thể trong miền của bạn | /enterprise/securityInsights:enable | POST | Không bắt buộc: targetOus |
| Tắt thông tin chi tiết cho miền của bạn | /enterprise/securityInsights:disable | POST | |
| Kiểm tra trạng thái bật thông tin chi tiết cho miền của bạn | /enterprise/securityInsights:checkEnablementStatus | NHẬN | |
| Truy vấn thông tin tóm tắt cấp cao về việc chuyển nội dung cho miền của bạn | /enterprise/securityInsights:queryContentTransfers | NHẬN | Không bắt buộc: bộ lọc |
| Truy vấn thông tin tóm tắt về hoạt động chuyển nội dung theo thông tin chi tiết về người dùng/miền/danh mục nội dung | /enterprise/securityInsights:queryContentTransfersBreakdowns | NHẬN | Không bắt buộc: filter, metric, breakdown, fixedTimeRange, pageSize, pageToken |
| Truy vấn thông tin tóm tắt về lượt truy cập URL cấp cao cho miền của bạn | /enterprise/securityInsights:queryUrlVisits | NHẬN | Không bắt buộc: bộ lọc |
| Truy vấn thông tin tóm tắt về lượt truy cập URL theo thông tin chi tiết về người dùng/miền | /enterprise/securityInsights:queryUrlVisitsBreakdowns | NHẬN | Không bắt buộc: filter, metric, breakdown, fixedTimeRange, pageSize, pageToken |
Hãy xem mã mẫu để biết các yêu cầu và phản hồi mẫu.
Yêu cầu đối với gói thuê bao
Các phương thức API sau đây yêu cầu bạn phải có gói thuê bao Chrome Enterprise Premium đang hoạt động. Nếu khách hàng không có gói thuê bao này, các yêu cầu sẽ không bị chặn, nhưng kết quả truy vấn sẽ trống.
queryUrlVisitsqueryUrlVisitsBreakdowns
Đặc quyền của quản trị viên
Tuỳ thuộc vào phương thức đang được gọi, bạn cần có các đặc quyền quản trị khác nhau.
| Phương thức | Cần có đặc quyền của quản trị viên |
|---|---|
| bật | "Đơn vị tổ chức > Đọc" "Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý chế độ cài đặt người dùng" "Dịch vụ > Chrome DLP > Quản lý chế độ cài đặt thông tin chi tiết về ứng dụng Chrome DLP" |
| tắt | "Đơn vị tổ chức > Đọc" "Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý chế độ cài đặt người dùng" "Dịch vụ > Chrome DLP > Quản lý chế độ cài đặt thông tin chi tiết về ứng dụng Chrome DLP" |
| checkEnablementStatus | "Đơn vị tổ chức > Đọc" "Dịch vụ > DLP của Chrome > Quản lý chế độ cài đặt thông tin chi tiết về ứng dụng DLP của Chrome" HOẶC "Dịch vụ > DLP của Chrome > Xem chế độ cài đặt thông tin chi tiết về ứng dụng DLP của Chrome" |
| queryContentTransfers | "Dịch vụ > DLP của Chrome > Xem chế độ cài đặt thông tin chi tiết về ứng dụng DLP của Chrome" |
| queryContentTransfersBreakdowns | "Dịch vụ > DLP của Chrome > Xem chế độ cài đặt thông tin chi tiết về ứng dụng DLP của Chrome" |
| queryUrlVisits | "Dịch vụ > DLP của Chrome > Xem chế độ cài đặt thông tin chi tiết về ứng dụng DLP của Chrome" |
| queryUrlVisitsBreakdowns | "Dịch vụ > DLP của Chrome > Xem chế độ cài đặt thông tin chi tiết về ứng dụng DLP của Chrome" |
Để quản lý vai trò và đặc quyền của quản trị viên, hãy truy cập vào "Bảng điều khiển dành cho quản trị viên -> Vai trò quản trị".
Phạm vi API
Để bật và tắt API, bạn cần có phạm vi OAuth sau:
https://www.googleapis.com/auth/chrome.management.securityinsights
Đối với checkEnablementStatus và tất cả các phương thức truy vấn, bạn có thể sử dụng một trong hai phạm vi sau:
https://www.googleapis.com/auth/chrome.management.securityinsights
https://www.googleapis.com/auth/chrome.management.securityinsights.readonly
Để biết thêm thông tin, hãy xem bài viết Tổng quan về quy trình xác thực.