La API de Security Insights te permite habilitar o inhabilitar la función de estadísticas de seguridad de Chrome, verificar su estado de habilitación y consultar datos de estadísticas (como transferencias de contenido y visitas a URLs).
Resumen rápido de los métodos de la API
Las URLs son relativas a
https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| Descripción | URL relativa | Método HTTP | Parámetros de solicitud permitidos |
|---|---|---|---|
| Habilita las estadísticas para tu dominio y configura los conectores de Chrome para la UO raíz o un conjunto específico de UOs en tu dominio. | /enterprise/securityInsights:enable | PUBLICAR | Opcional: targetOus |
| Inhabilita las estadísticas para tu dominio. | /enterprise/securityInsights:disable | PUBLICAR | |
| Verifica el estado de habilitación de las estadísticas para tu dominio. | /enterprise/securityInsights:checkEnablementStatus | GET | |
| Consulta resúmenes de transferencias de contenido de alto nivel para tu dominio. | /enterprise/securityInsights:queryContentTransfers | GET | Opcional: filter |
| Consulta resúmenes de transferencias de contenido con desgloses por usuario, dominio o categoría de contenido. | /enterprise/securityInsights:queryContentTransfersBreakdowns | GET | Opcional: filter, metric, breakdown, fixedTimeRange, pageSize, pageToken |
| Consulta resúmenes de visitas a URLs de alto nivel para tu dominio. | /enterprise/securityInsights:queryUrlVisits | GET | Opcional: filter |
| Consulta resúmenes de visitas a URLs con desgloses por usuario o dominio. | /enterprise/securityInsights:queryUrlVisitsBreakdowns | GET | Opcional: filter, metric, breakdown, fixedTimeRange, pageSize, pageToken |
Consulta las muestras de código para ver ejemplos de solicitudes y respuestas.
Requisitos para las suscripciones
Los siguientes métodos de la API requieren una suscripción activa a Chrome Enterprise Premium. Si el cliente no tiene esta suscripción, las solicitudes no se bloquean, pero los resultados de la consulta estarán vacíos.
queryUrlVisitsqueryUrlVisitsBreakdowns
Privilegios de administrador
Según el método que se invoque, se requieren diferentes privilegios de administrador.
| Método | Privilegios de administrador obligatorios |
|---|---|
| habilitar | "Unidades organizativas > Leer" "Servicios > Administración de Chrome > Configuración > Administrar la configuración del usuario" "Servicios > DLP de Chrome > Administrar la configuración de estadísticas de las aplicaciones de DLP de Chrome" |
| inhabilitar | "Unidades organizativas > Leer" "Servicios > Administración de Chrome > Configuración > Administrar la configuración del usuario" "Servicios > DLP de Chrome > Administrar la configuración de estadísticas de las aplicaciones de DLP de Chrome" |
| checkEnablementStatus | "Unidades organizativas > Leer" "Servicios > DLP de Chrome > Administrar la configuración de estadísticas de las aplicaciones de DLP de Chrome" O "Servicios > DLP de Chrome > Consultar la configuración de estadísticas de las aplicaciones de DLP de Chrome" |
| queryContentTransfers | "Servicios > DLP de Chrome > Consultar la configuración de estadísticas de las aplicaciones de DLP de Chrome" |
| queryContentTransfersBreakdowns | "Servicios > DLP de Chrome > Consultar la configuración de estadísticas de las aplicaciones de DLP de Chrome" |
| queryUrlVisits | "Servicios > DLP de Chrome > Consultar la configuración de estadísticas de las aplicaciones de DLP de Chrome" |
| queryUrlVisitsBreakdowns | "Servicios > DLP de Chrome > Consultar la configuración de estadísticas de las aplicaciones de DLP de Chrome" |
Para administrar los roles y privilegios de administrador, visita "Consola del administrador -> Roles de administrador".
Permisos de la API
Para habilitar y inhabilitar las APIs, se requiere el siguiente permiso de OAuth:
https://www.googleapis.com/auth/chrome.management.securityinsights
Para checkEnablementStatus y todos los métodos de consulta, se puede usar cualquiera de estos dos permisos:
https://www.googleapis.com/auth/chrome.management.securityinsights
https://www.googleapis.com/auth/chrome.management.securityinsights.readonly
Para obtener más información, consulta la Descripción general de la autenticación.