Security Insights API

Interfejs Security Insights API umożliwia włączanie i wyłączanie funkcji statystyk związanych z bezpieczeństwem Chrome, sprawdzanie jej stanu włączenia oraz wysyłanie zapytań o dane statystyczne (takie jak przenoszenie treści i odwiedzanie adresów URL).

Szybki przegląd metod interfejsu API

Adresy URL są względne względem https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER

Opis Względny URL Metoda HTTP Dozwolone parametry żądania
Włącz statystyki w domenie i skonfiguruj oprogramowanie sprzęgające Chrome w głównej jednostce organizacyjnej lub w określonym zestawie jednostek organizacyjnych w domenie. /enterprise/securityInsights:enable POST Opcjonalny: targetOus
Wyłączanie statystyk dotyczących domeny /enterprise/securityInsights:disable POST
Sprawdzanie stanu włączenia statystyk dotyczących domeny /enterprise/securityInsights:checkEnablementStatus SPRAWDŹ
Wysyłanie zapytań o podsumowania przenoszenia treści w domenie /enterprise/securityInsights:queryContentTransfers SPRAWDŹ Opcjonalny: filtr
Wyświetlanie podsumowań przenoszenia treści z podziałem na użytkowników, domeny i kategorie treści /enterprise/securityInsights:queryContentTransfersBreakdowns SPRAWDŹ Opcjonalnie: filter, metric, breakdown, fixedTimeRange, pageSize, pageToken
Wysyłanie zapytań o podsumowania wizyt w adresach URL najwyższego poziomu w Twojej domenie /enterprise/securityInsights:queryUrlVisits SPRAWDŹ Opcjonalny: filtr
Wyświetlanie podsumowań wizyt w adresach URL z podziałem na użytkowników i domeny /enterprise/securityInsights:queryUrlVisitsBreakdowns SPRAWDŹ Opcjonalnie: filter, metric, breakdown, fixedTimeRange, pageSize, pageToken

Przykładowe żądania i odpowiedzi znajdziesz w przykładowych fragmentach kodu.

Wymagania dotyczące subskrypcji

Poniższe metody API wymagają aktywnej subskrypcji Chrome Enterprise Premium. Jeśli klient nie ma tej subskrypcji, żądania nie są blokowane, ale wyniki zapytań będą puste.

  • queryUrlVisits
  • queryUrlVisitsBreakdowns

Uprawnienia administratora

W zależności od wywoływanej metody wymagane są różne uprawnienia administratora.

Metoda Wymagane uprawnienia administratora
włącz „Jednostki organizacyjne > Odczyt”
„Usługi > Zarządzanie urządzeniami z Chrome > Ustawienia > Zarządzanie ustawieniami użytkowników”
„Usługi > DLP w Chrome > Zarządzanie ustawieniami statystyk dotyczących aplikacji DLP w Chrome”
wyłącz „Jednostki organizacyjne > Odczyt”
„Usługi > Zarządzanie urządzeniami z Chrome > Ustawienia > Zarządzanie ustawieniami użytkowników”
„Usługi > DLP w Chrome > Zarządzanie ustawieniami statystyk dotyczących aplikacji DLP w Chrome”
checkEnablementStatus „Jednostki organizacyjne > Odczyt”
„Usługi > DLP w Chrome > Zarządzanie ustawieniami statystyk dotyczących aplikacji DLP dla Chrome” LUB „Usługi > DLP w Chrome > Wyświetlanie ustawień statystyk dotyczących aplikacji DLP dla Chrome”
queryContentTransfers „Usługi > Chrome DLP > Wyświetlanie ustawień statystyk dotyczących aplikacji DLP dla Chrome”
queryContentTransfersBreakdowns „Usługi > Chrome DLP > Wyświetlanie ustawień statystyk dotyczących aplikacji DLP dla Chrome”
queryUrlVisits „Usługi > Chrome DLP > Wyświetlanie ustawień statystyk dotyczących aplikacji DLP dla Chrome”
queryUrlVisitsBreakdowns „Usługi > Chrome DLP > Wyświetlanie ustawień statystyk dotyczących aplikacji DLP dla Chrome”

Aby zarządzać rolami i uprawnieniami administratora, otwórz „Konsola administracyjna –> Role administratora”.

Zakresy interfejsu API

Włączanie i wyłączanie interfejsów API wymaga tego zakresu OAuth:

https://www.googleapis.com/auth/chrome.management.securityinsights

W przypadku metody checkEnablementStatus i wszystkich metod zapytań można użyć jednego z tych 2 zakresów:

https://www.googleapis.com/auth/chrome.management.securityinsights
https://www.googleapis.com/auth/chrome.management.securityinsights.readonly

Więcej informacji znajdziesz w Przeglądzie uwierzytelniania.