L'API Security Insights ti consente di attivare o disattivare la funzionalità di approfondimenti sulla sicurezza di Chrome, controllarne lo stato di attivazione ed eseguire query sui dati degli approfondimenti (ad esempio trasferimenti di contenuti e visite agli URL).
Panoramica rapida dei metodi API
Gli URL sono relativi a
https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| Descrizione | URL relativo | Metodo HTTP | Parametri di richiesta consentiti |
|---|---|---|---|
| Attiva gli approfondimenti per il tuo dominio e configura i connettori di Chrome per l'UO principale o un insieme specifico di UO nel tuo dominio | /enterprise/securityInsights:enable | PUBBLICA | (Facoltativo): targetOus |
| Disattivare le statistiche per il tuo dominio | /enterprise/securityInsights:disable | PUBBLICA | |
| Controllare lo stato di attivazione delle statistiche per il tuo dominio | /enterprise/securityInsights:checkEnablementStatus | GET | |
| Eseguire query sui riepiloghi di trasferimento dei contenuti di alto livello per il tuo dominio | /enterprise/securityInsights:queryContentTransfers | GET | (Facoltativo): filtro |
| Esegui query sui riepiloghi dei trasferimenti di contenuti con suddivisioni per utente/dominio/categoria di contenuti | /enterprise/securityInsights:queryContentTransfersBreakdowns | GET | (Facoltativo): filter, metric, breakdown, fixedTimeRange, pageSize, pageToken |
| Eseguire query sui riepiloghi di alto livello delle visite agli URL per il tuo dominio | /enterprise/securityInsights:queryUrlVisits | GET | (Facoltativo): filtro |
| Esegui query sui riepiloghi delle visite agli URL con suddivisioni per utente/dominio | /enterprise/securityInsights:queryUrlVisitsBreakdowns | GET | (Facoltativo): filter, metric, breakdown, fixedTimeRange, pageSize, pageToken |
Consulta gli esempi di codice per richieste e risposte di esempio.
Requisiti per l'abbonamento
I seguenti metodi API richiedono un abbonamento Chrome Enterprise Premium attivo. Se il cliente non ha questo abbonamento, le richieste non vengono bloccate, ma i risultati della query saranno vuoti.
queryUrlVisitsqueryUrlVisitsBreakdowns
Privilegi amministrativi
A seconda del metodo richiamato, sono necessari privilegi di amministratore diversi.
| Metodo | Sono necessari i privilegi amministrativi |
|---|---|
| attiva | "Unità organizzative > Lettura" "Servizi > Gestione di Chrome > Impostazioni > Gestione impostazioni utente" "Servizi > DLP di Chrome > Gestisci le impostazioni degli approfondimenti sulle applicazioni DLP di Chrome" |
| disattiva | "Unità organizzative > Lettura" "Servizi > Gestione di Chrome > Impostazioni > Gestione impostazioni utente" "Servizi > DLP di Chrome > Gestisci le impostazioni degli approfondimenti sulle applicazioni DLP di Chrome" |
| checkEnablementStatus | "Unità organizzative > Lettura" "Servizi > DLP di Chrome > Gestisci le impostazioni degli approfondimenti sull'applicazione DLP di Chrome" OPPURE "Servizi > DLP di Chrome > Visualizza le impostazioni degli approfondimenti sull'applicazione DLP di Chrome" |
| queryContentTransfers | "Servizi > DLP per Chrome > Visualizza le impostazioni degli insight sulle applicazioni DLP di Chrome" |
| queryContentTransfersBreakdowns | "Servizi > DLP per Chrome > Visualizza le impostazioni degli insight sulle applicazioni DLP di Chrome" |
| queryUrlVisits | "Servizi > DLP per Chrome > Visualizza le impostazioni degli insight sulle applicazioni DLP di Chrome" |
| queryUrlVisitsBreakdowns | "Servizi > DLP per Chrome > Visualizza le impostazioni degli insight sulle applicazioni DLP di Chrome" |
Per gestire i ruoli e i privilegi di amministratore, vai a "Console di amministrazione -> Ruoli amministratore".
Ambiti API
L'abilitazione e la disabilitazione delle API richiedono il seguente ambito OAuth:
https://www.googleapis.com/auth/chrome.management.securityinsights
Per checkEnablementStatus e tutti i metodi di query, è possibile utilizzare uno di questi due ambiti:
https://www.googleapis.com/auth/chrome.management.securityinsights
https://www.googleapis.com/auth/chrome.management.securityinsights.readonly
Per saperne di più, consulta la Panoramica dell'autenticazione.