Com a API Security Insights, é possível ativar ou desativar o recurso de insights de segurança do Chrome e verificar o status de ativação dele.
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 |
Privilégios de admin
Dependendo do método invocado, são necessários privilégios de administrador diferentes.
| Método | Privilégios de administrador necessários |
|---|---|
| ativar | "Unidades organizacionais > Leitura" "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 DLP do Chrome" |
| desativar | "Unidades organizacionais > Leitura" "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 DLP do Chrome" |
| checkEnablementStatus | "Unidades organizacionais > Ler" "Serviços > Gerenciamento do Chrome > Configurações > Gerenciar configurações do usuário" "Serviços > DLP do Chrome > Gerenciar configurações dos insights do aplicativo de DLP do Chrome" OU "Serviços > DLP do Chrome > Ver configurações dos insights do aplicativo de DLP do Chrome" |
Para gerenciar funções e privilégios de administrador, acesse "Admin Console -> Funções de 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, é possível usar um destes dois escopos:
https://www.googleapis.com/auth/chrome.management.securityinsights
https://www.googleapis.com/auth/chrome.management.securityinsights.readonly
Para saber mais, consulte a Visão geral da autenticação.