API Security Insights

A API Security Insights permite ativar ou desativar o recurso de insights de segurança do Chrome, além de verificar o status de ativação.

Visão geral rápida dos métodos da API

Os URLs são relativos a https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER

Descrição URL relativo Método HTTP Parâmetros de solicitação permitidos
Ativar insights para seu domínio e configurar conectores do Chrome para a UO raiz ou um conjunto específico de UOs no seu domínio /enterprise/securityInsights:enable POST Opcional: targetOus
Desativar insights para seu domínio /enterprise/securityInsights:disable POST
Verificar o status de ativação dos insights para seu domínio /enterprise/securityInsights:checkEnablementStatus GET

Consulte exemplos de código para solicitações e respostas.

Privilégios de admin

Dependendo do método invocado, são necessários privilégios de administrador diferentes.

Método Privilégios de admin necessários
ativar "Unidades organizacionais > Ler"
"Serviços > Gerenciamento do Chrome > Configurações > Gerenciar configurações do usuário"
"Serviços > DLP do Chrome > Gerenciar configurações de insights do aplicativo de DLP do Chrome"
desativar "Unidades organizacionais > Ler"
"Serviços > Gerenciamento do Chrome > Configurações > Gerenciar configurações do usuário"
"Serviços > DLP do Chrome > Gerenciar configurações de insights do aplicativo de DLP do Chrome"
checkEnablementStatus "Unidades organizacionais > Ler"
"Serviços > DLP do Chrome > Gerenciar configurações de insights do aplicativo de DLP do Chrome" OU "Serviços > DLP do Chrome > Conferir configurações de insights do aplicativo de DLP do Chrome"

Para gerenciar papéis e privilégios de administrador, acesse "Admin Console -> Funções do administrador".

Escopos da API

Para ativar e desativar APIs, é necessário o seguinte escopo OAuth:

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

Para CheckEnablementStatus, qualquer um destes dois escopos pode ser usado:

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

Para mais informações, consulte a Visão geral da autenticação.