Mit der Security Insights API können Sie die Funktion „Statistiken zur Datensicherheit in Chrome“ aktivieren oder deaktivieren, den Aktivierungsstatus prüfen und Statistiken abfragen (z. B. zu Inhaltsübertragungen und URL-Besuchen).
Kurzübersicht der API-Methoden
URLs sind relativ zu
https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| Beschreibung | Relative URL | HTTP-Methode | Zulässige Anfrageparameter |
|---|---|---|---|
| Statistiken für Ihre Domain aktivieren und Chrome Enterprise Connectors für die Stammorganisationseinheit oder eine bestimmte Gruppe von Organisationseinheiten in Ihrer Domain konfigurieren | /enterprise/securityInsights:enable | Posten | Optional: targetOus |
| Statistiken für Ihre Domain deaktivieren | /enterprise/securityInsights:disable | Posten | |
| Aktivierungsstatus der Statistiken für Ihre Domain prüfen | /enterprise/securityInsights:checkEnablementStatus | NEUIGKEITEN | |
| Zusammenfassungen von Inhaltsübertragungen auf hoher Ebene für Ihre Domain abfragen | /enterprise/securityInsights:queryContentTransfers | NEUIGKEITEN | Optional: filter |
| Zusammenfassungen von Inhaltsübertragungen mit Aufschlüsselungen nach Nutzer, Domain und Inhaltskategorie abfragen | /enterprise/securityInsights:queryContentTransfersBreakdowns | NEUIGKEITEN | Optional: filter, metric, breakdown, fixedTimeRange, pageSize, pageToken |
| Zusammenfassungen von URL-Besuchen auf hoher Ebene für Ihre Domain abfragen | /enterprise/securityInsights:queryUrlVisits | NEUIGKEITEN | Optional: filter |
| Zusammenfassungen von URL-Besuchen mit Aufschlüsselungen nach Nutzer und Domain abfragen | /enterprise/securityInsights:queryUrlVisitsBreakdowns | NEUIGKEITEN | Optional: filter, metric, breakdown, fixedTimeRange, pageSize, pageToken |
Siehe Codebeispiele für Beispielanfragen und ‑antworten.
Aboanforderungen
Für die folgenden API-Methoden ist ein aktives Chrome Enterprise Premium-Abo erforderlich. Wenn der Kunde kein solches Abo hat, werden Anfragen nicht blockiert, aber die Abfrageergebnisse sind leer.
queryUrlVisitsqueryUrlVisitsBreakdowns
Admin-Berechtigungen
Je nachdem, welche Methode aufgerufen wird, sind unterschiedliche Administratorberechtigungen erforderlich.
| Methode | Erforderliche Administratorberechtigungen |
|---|---|
| aktivieren | "Organisationseinheiten > Lesen" "Dienste > Chrome Management > Einstellungen > Einstellungen für verwaltete Nutzer verwalten" "Dienste > Chrome DLP > Einstellungen für Chrome-DLP-Anwendungsstatistiken verwalten" |
| deaktivieren | "Organisationseinheiten > Lesen" "Dienste > Chrome Management > Einstellungen > Einstellungen für verwaltete Nutzer verwalten" "Dienste > Chrome DLP > Einstellungen für Chrome-DLP-Anwendungsstatistiken verwalten" |
| checkEnablementStatus | „Organisationseinheiten > Lesen“ „Dienste > Chrome DLP > Einstellungen für Chrome-DLP-Anwendungsstatistiken verwalten“ ODER „Dienste > Chrome DLP > Einstellungen für Chrome-DLP-Anwendungsstatistiken ansehen“ |
| queryContentTransfers | „Dienste > Chrome DLP > Einstellungen für Chrome-DLP-Anwendungsstatistiken ansehen“ |
| queryContentTransfersBreakdowns | „Dienste > Chrome DLP > Einstellungen für Chrome-DLP-Anwendungsstatistiken ansehen“ |
| queryUrlVisits | „Dienste > Chrome DLP > Einstellungen für Chrome-DLP-Anwendungsstatistiken ansehen“ |
| queryUrlVisitsBreakdowns | „Dienste > Chrome DLP > Einstellungen für Chrome-DLP-Anwendungsstatistiken ansehen“ |
Administratorrollen und ‑berechtigungen verwalten Sie in der Admin-Konsole unter „Admin-Rollen“.
API-Bereiche
Für das Aktivieren und Deaktivieren von APIs ist der folgende OAuth-Bereich erforderlich:
https://www.googleapis.com/auth/chrome.management.securityinsights
Für checkEnablementStatus und alle Abfragemethoden kann einer der beiden folgenden Bereiche verwendet werden:
https://www.googleapis.com/auth/chrome.management.securityinsights
https://www.googleapis.com/auth/chrome.management.securityinsights.readonly
Weitere Informationen finden Sie in der Authentifizierungs übersicht.