API Security Insights позволяет включать или отключать функцию анализа безопасности Chrome, проверять ее статус включения и запрашивать данные анализа (например, о передаче контента и посещениях URL-адресов).
Краткий обзор методов API
URL-адреса являются относительными по отношению к https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| Описание | Относительный URL | HTTP-метод | Допустимые параметры запроса |
|---|---|---|---|
| Включите аналитику для вашего домена и настройте коннекторы Chrome для корневого подразделения/определенного набора подразделений в вашем домене. | /enterprise/securityInsights:enable | ПОЧТА | Необязательно : targetOus |
| Отключите аналитику для вашего домена | /enterprise/securityInsights:disable | ПОЧТА | |
| Проверьте статус активации, чтобы получить подробную информацию по вашей области. | /enterprise/securityInsights:checkEnablementStatus | ПОЛУЧАТЬ | |
| Запросите сводные данные о передаче контента высокого уровня для вашего домена. | /enterprise/securityInsights:queryContentTransfers | ПОЛУЧАТЬ | Необязательно : фильтр |
| Сводные данные о передаче контента по запросам с разбивкой по пользователям/доменам/категориям контента. | /enterprise/securityInsights:queryContentTransfersBreakdowns | ПОЛУЧАТЬ | Необязательные параметры : filter, metric, breakdown, fixedTimeRange, pageSize, pageToken |
| Получите сводные данные о посещениях URL-адресов вашего домена на высоком уровне. | /enterprise/securityInsights:queryUrlVisits | ПОЛУЧАТЬ | Необязательно : фильтр |
| Сводные данные о посещениях URL-адресов с разбивкой по пользователям/доменам. | /enterprise/securityInsights:queryUrlVisitsBreakdowns | ПОЛУЧАТЬ | Необязательные параметры : filter, metric, breakdown, fixedTimeRange, pageSize, pageToken |
Примеры запросов и ответов можно посмотреть в примерах кода .
Требования к подписке
Для использования следующих методов API требуется активная подписка Chrome Enterprise Premium. Если у клиента нет такой подписки, запросы не блокируются, но результаты запросов будут пустыми.
-
queryUrlVisits -
queryUrlVisitsBreakdowns
Административные права
В зависимости от используемого метода требуются различные права администратора.
| Метод | Требуются права администратора. |
|---|---|
| давать возможность | «Организационные подразделения > Читать» «Службы > Управление Chrome > Настройки > Управление пользовательскими настройками» «Сервисы > Chrome DLP > Управление настройками аналитики приложений Chrome DLP» |
| запрещать | «Организационные подразделения > Читать» «Службы > Управление Chrome > Настройки > Управление пользовательскими настройками» «Сервисы > Chrome DLP > Управление настройками аналитики приложений Chrome DLP» |
| checkEnablementStatus | «Организационные подразделения > Читать» «Сервисы > Chrome DLP > Управление настройками аналитики приложений Chrome DLP» ИЛИ «Сервисы > Chrome DLP > Просмотр настроек аналитики приложений Chrome DLP» |
| queryContentTransfers | «Сервисы > Chrome DLP > Просмотр настроек аналитики приложений Chrome DLP» |
| queryContentTransfersBreakdowns | «Сервисы > Chrome DLP > Просмотр настроек аналитики приложений Chrome DLP» |
| queryUrlVisits | «Сервисы > Chrome DLP > Просмотр настроек аналитики приложений Chrome DLP» |
| queryUrlVisitsBreakdowns | «Сервисы > Chrome DLP > Просмотр настроек аналитики приложений Chrome DLP» |
Для управления ролями и правами администратора перейдите в раздел «Консоль администратора -> Роли администратора».
Области действия API
Для включения и отключения API требуется следующая область действия OAuth:
https://www.googleapis.com/auth/chrome.management.securityinsights
Для метода checkEnablementStatus и всех методов запроса можно использовать любую из этих двух областей видимости:
https://www.googleapis.com/auth/chrome.management.securityinsights
https://www.googleapis.com/auth/chrome.management.securityinsights.readonly
Для получения более подробной информации см. раздел «Обзор аутентификации» .