Exemples de code pour l'API Chrome Management Security Insights

Pour en savoir plus sur les fonctionnalités de l'API, consultez la page Chrome Management Security Insights API.

Toutes les requêtes présentées ci-dessous utilisent les variables suivantes :

  • $TOKEN : jeton OAuth 2
  • $CUSTOMER : ID du client ou littéral my_customer

Vérifier l'état d'activation des insights pour votre domaine

Pour vérifier l'état d'activation des insights pour votre domaine, utilisez la méthode checkEnablementStatus.

Requête

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/enterprise/securityInsights:checkEnablementStatus"

Réponse

{
  "insightsState": "INSIGHTS_ENABLED"
}

Activer les insights pour votre domaine

Pour activer les insights pour votre domaine, utilisez la méthode enable. Vous pouvez également configurer des connecteurs Chrome pour un ensemble spécifique d'unités organisationnelles en fournissant targetOus. Si targetOus n'est pas défini, les connecteurs Chrome sont configurés au niveau de l'UO racine.

Requête

  curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "targetOus": [
      "/corp/sales",
      "/eng"
    ]
  }' \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/enterprise/securityInsights:enable"

Réponse

{
  "insightsState": "INSIGHTS_ENABLED"
}

Désactiver les insights pour votre domaine

Pour désactiver les insights pour votre domaine, utilisez la méthode disable.

Requête

  curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}' \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/enterprise/securityInsights:disable"

Réponse

{
  "insightsState": "INSIGHTS_DISABLED"
}