نمونه کد برای API بینش‌های امنیتی مدیریت کروم

برای اطلاعات بیشتر در مورد ویژگی‌های API، به Chrome Management Security Insights API مراجعه کنید.

تمام درخواست‌های نشان داده شده در زیر از متغیرهای زیر استفاده می‌کنند:

  • توکن $TOKEN - توکن OAuth 2
  • $CUSTOMER - شناسه مشتری یا به عبارت دیگر my_customer

وضعیت فعال‌سازی را برای مشاهده‌ی اطلاعات دامنه‌ی خود بررسی کنید

برای بررسی وضعیت فعال‌سازی Insights برای دامنه خود، از متد checkEnablementStatus استفاده کنید.

درخواست

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

پاسخ

{
  "insightsState": "INSIGHTS_ENABLED"
}

فعال کردن بینش برای دامنه شما

برای فعال کردن بینش‌ها برای دامنه خود، از متد enable استفاده کنید. می‌توانید به صورت اختیاری با ارائه targetOus کانکتورهای کروم را برای مجموعه‌ای خاص از OUها پیکربندی کنید. اگر targetOus تنظیم نشده باشد، کانکتورهای کروم در OU ریشه پیکربندی می‌شوند.

درخواست

  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"

پاسخ

{
  "insightsState": "INSIGHTS_ENABLED"
}

غیرفعال کردن بینش‌ها برای دامنه شما

برای غیرفعال کردن بینش‌ها برای دامنه خود، از متد disable استفاده کنید.

درخواست

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

پاسخ

{
  "insightsState": "INSIGHTS_DISABLED"
}