La API de Security Insights te permite habilitar o inhabilitar la función de estadísticas de seguridad de Chrome, así como verificar su estado de habilitación.
Descripción general rápida 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 unidad organizacional raíz o un conjunto específico de unidades organizacionales de 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 las muestras de código para ver ejemplos de solicitudes y respuestas.
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 organizacionales > 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 organizacionales > 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 organizacionales > Leer" "Servicios > DLP de Chrome > Administrar la configuración de estadísticas de las aplicaciones de DLP de Chrome" O "Servicios > DLP de Chrome > Ver 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".
Alcances de la API
Para habilitar y inhabilitar las APIs, se requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/chrome.management.securityinsights
Para CheckEnablementStatus, se puede usar cualquiera de estos dos alcances:
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.