Security Insights API memungkinkan Anda mengaktifkan atau menonaktifkan fitur insight keamanan Chrome, memeriksa status pengaktifannya, dan membuat kueri data insight (seperti transfer konten dan kunjungan URL).
Ringkasan singkat metode API
URL relatif terhadap
https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| Deskripsi | URL relatif | Metode HTTP | Parameter permintaan yang diizinkan |
|---|---|---|---|
| Aktifkan insight untuk domain Anda dan konfigurasi konektor Chrome untuk OU root/sekumpulan OU tertentu di domain Anda | /enterprise/securityInsights:enable | POST | Opsional: targetOus |
| Menonaktifkan insight untuk domain Anda | /enterprise/securityInsights:disable | POST | |
| Memeriksa status pengaktifan insight untuk domain Anda | /enterprise/securityInsights:checkEnablementStatus | DAPATKAN | |
| Mengueri ringkasan transfer konten tingkat tinggi untuk domain Anda | /enterprise/securityInsights:queryContentTransfers | DAPATKAN | Opsional: filter |
| Mengueri ringkasan transfer konten dengan perincian menurut pengguna/domain/kategori konten | /enterprise/securityInsights:queryContentTransfersBreakdowns | DAPATKAN | Opsional: filter, metric, breakdown, fixedTimeRange, pageSize, pageToken |
| Mengirim kueri ringkasan kunjungan URL tingkat tinggi untuk domain Anda | /enterprise/securityInsights:queryUrlVisits | DAPATKAN | Opsional: filter |
| Mengueri ringkasan kunjungan URL dengan perincian menurut pengguna/domain | /enterprise/securityInsights:queryUrlVisitsBreakdowns | DAPATKAN | Opsional: filter, metric, breakdown, fixedTimeRange, pageSize, pageToken |
Lihat contoh kode untuk contoh permintaan dan respons.
Persyaratan langganan
Metode API berikut memerlukan langganan Chrome Enterprise Premium yang aktif. Jika pelanggan tidak memiliki langganan ini, permintaan tidak diblokir, tetapi hasil kueri akan kosong.
queryUrlVisitsqueryUrlVisitsBreakdowns
Hak Istimewa Admin
Bergantung pada metode yang dipanggil, hak istimewa administrator yang berbeda diperlukan.
| Metode | Memerlukan hak istimewa admin |
|---|---|
| aktifkan | "Unit Organisasi > Baca" "Layanan > Pengelolaan Chrome > Setelan > Kelola Setelan Pengguna" "Layanan > DLP Chrome > Mengelola setelan analisis aplikasi DLP Chrome" |
| nonaktifkan | "Unit Organisasi > Baca" "Layanan > Pengelolaan Chrome > Setelan > Kelola Setelan Pengguna" "Layanan > DLP Chrome > Mengelola setelan analisis aplikasi DLP Chrome" |
| checkEnablementStatus | "Unit Organisasi > Baca" "Layanan > DLP Chrome > Mengelola setelan analisis aplikasi DLP Chrome" ATAU "Layanan > DLP Chrome > Melihat setelan analisis aplikasi DLP Chrome" |
| queryContentTransfers | "Layanan > DLP Chrome > Melihat setelan analisis aplikasi DLP Chrome" |
| queryContentTransfersBreakdowns | "Layanan > DLP Chrome > Melihat setelan analisis aplikasi DLP Chrome" |
| queryUrlVisits | "Layanan > DLP Chrome > Melihat setelan analisis aplikasi DLP Chrome" |
| queryUrlVisitsBreakdowns | "Layanan > DLP Chrome > Melihat setelan analisis aplikasi DLP Chrome" |
Untuk mengelola peran dan hak istimewa administrator, buka "Konsol Admin -> Peran Admin".
Cakupan API
Mengaktifkan dan Menonaktifkan API memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/chrome.management.securityinsights
Untuk checkEnablementStatus dan semua metode kueri, salah satu dari dua cakupan berikut dapat digunakan:
https://www.googleapis.com/auth/chrome.management.securityinsights
https://www.googleapis.com/auth/chrome.management.securityinsights.readonly
Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.