L'API Security Insights vous permet d'activer ou de désactiver la fonctionnalité Insights sur la sécurité Chrome, ainsi que de vérifier son état d'activation.
Présentation rapide des méthodes d'API
Les URL sont relatives à
https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| Description | URL relative | Méthode HTTP | Paramètres de requête autorisés |
|---|---|---|---|
| Activer les insights pour votre domaine et configurer les connecteurs Chrome pour l'unité organisationnelle racine ou un ensemble spécifique d'unités organisationnelles de votre domaine | /enterprise/securityInsights:enable | POST | Facultatif : targetOus |
| Désactiver les insights pour votre domaine | /enterprise/securityInsights:disable | POST | |
| Vérifier l'état d'activation des insights pour votre domaine | /enterprise/securityInsights:checkEnablementStatus | GET |
Consultez des exemples de requêtes et de réponses dans les exemples de code.
Droits d'administrateur
Différents droits d'administrateur sont requis en fonction de la méthode appelée.
| Méthode | Droits d'administrateur requis |
|---|---|
| activer | "Unités organisationnelles > Lire" "Services > Gestion de Google Chrome > Paramètres > Gérer les paramètres utilisateur" "Services > Protection contre la perte de données Chrome > Gérer les paramètres d'insights sur les applications de protection contre la perte de données Chrome" |
| désactiver | "Unités organisationnelles > Lire" "Services > Gestion de Google Chrome > Paramètres > Gérer les paramètres utilisateur" "Services > Protection contre la perte de données Chrome > Gérer les paramètres d'insights sur les applications de protection contre la perte de données Chrome" |
| checkEnablementStatus | "Unités organisationnelles > Lire" "Services > Gestion de Google Chrome > Paramètres > Gérer les paramètres utilisateur" "Services > Protection contre la perte de données Chrome > Gérer les paramètres d'insights sur les applications de protection contre la perte de données Chrome" OU "Services > Protection contre la perte de données Chrome > Afficher les paramètres d'insights sur les applications de protection contre la perte de données Chrome" |
Pour gérer les rôles et les droits d'administrateur, accédez à "Console d'administration -> Rôles d'administrateur".
Champs d'application de l'API
Les API d'activation et de désactivation nécessitent le champ d'application OAuth suivant :
https://www.googleapis.com/auth/chrome.management.securityinsights
Pour CheckEnablementStatus, vous pouvez utiliser l'un de ces deux champs d'application :
https://www.googleapis.com/auth/chrome.management.securityinsights
https://www.googleapis.com/auth/chrome.management.securityinsights.readonly
Pour en savoir plus, consultez la page Présentation de l'authentification.