Security Insights API

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.

  • queryUrlVisits
  • queryUrlVisitsBreakdowns

Đặ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.