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

رابط برنامه‌نویسی کاربردی بینش‌های امنیتی (Security Insights API) به شما امکان می‌دهد ویژگی بینش‌های امنیتی کروم را فعال یا غیرفعال کنید، وضعیت فعال‌سازی آن را بررسی کنید و داده‌های بینش (مانند انتقال محتوا و بازدیدهای URL) را جستجو کنید.

مرور سریع متدهای API

آدرس‌های اینترنتی (URL) نسبت به https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER هستند.

توضیحات آدرس اینترنتی نسبی روش اچ‌تی‌پی پارامترهای درخواست مجاز
فعال کردن بینش‌ها برای دامنه شما و پیکربندی کانکتورهای کروم برای OU ریشه/مجموعه‌ای خاص از OUها در دامنه شما /enterprise/securityInsights: فعال کنید پست اختیاری : targetOus
غیرفعال کردن بینش‌ها برای دامنه شما /enterprise/securityInsights: غیرفعال پست
وضعیت فعال‌سازی را برای مشاهده‌ی اطلاعات دامنه‌ی خود بررسی کنید /enterprise/securityInsights:checkEnablementStatus دریافت کنید
خلاصه‌های انتقال محتوای سطح بالا را برای دامنه خود جستجو کنید /enterprise/securityInsights:queryContentTransfers دریافت کنید اختیاری : فیلتر
خلاصه‌های انتقال محتوا را با تفکیک بر اساس دسته کاربر/دامنه/محتوا جستجو کنید /enterprise/securityInsights:queryContentTransfersBreakdowns دریافت کنید اختیاری : فیلتر، متریک، تجزیه، fixedTimeRange، pageSize، pageToken
خلاصه بازدیدهای سطح بالای URL را برای دامنه خود جستجو کنید /enterprise/securityInsights:queryUrlVisits دریافت کنید اختیاری : فیلتر
خلاصه بازدیدهای URL جستجو شده به همراه جزئیات بر اساس کاربر/دامنه /enterprise/securityInsights:queryUrlVisitsBreakdowns دریافت کنید اختیاری : فیلتر، متریک، تجزیه، fixedTimeRange، pageSize، pageToken

برای مثال، نمونه کدها را برای درخواست‌ها و پاسخ‌ها ببینید.

شرایط اشتراک

روش‌های API زیر نیاز به اشتراک فعال Chrome Enterprise Premium دارند. اگر مشتری این اشتراک را نداشته باشد، درخواست‌ها مسدود نمی‌شوند، اما نتایج پرس‌وجو خالی خواهد بود.

  • queryUrlVisits
  • queryUrlVisitsBreakdowns

امتیازات مدیر

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

روش امتیازات مدیریتی مورد نیاز است
فعال کردن «واحدهای سازمانی > مطالعه»
«سرویس‌ها > مدیریت کروم > تنظیمات > مدیریت تنظیمات کاربر»
«سرویس‌ها > Chrome DLP > مدیریت تنظیمات بینش برنامه Chrome DLP»
غیرفعال کردن «واحدهای سازمانی > مطالعه»
«سرویس‌ها > مدیریت کروم > تنظیمات > مدیریت تنظیمات کاربر»
«سرویس‌ها > Chrome DLP > مدیریت تنظیمات بینش برنامه Chrome DLP»
وضعیت فعال‌سازی را بررسی کنید «واحدهای سازمانی > مطالعه»
«خدمات > Chrome DLP > مدیریت تنظیمات بینش برنامه Chrome DLP» یا «خدمات > Chrome DLP > مشاهده تنظیمات بینش برنامه Chrome DLP»
queryContentTransfers «سرویس‌ها > Chrome DLP > مشاهده تنظیمات بینش برنامه Chrome DLP»
queryContentTransfersخرابی‌ها «سرویس‌ها > Chrome DLP > مشاهده تنظیمات بینش برنامه Chrome DLP»
queryUrlVisits «سرویس‌ها > Chrome DLP > مشاهده تنظیمات بینش برنامه Chrome DLP»
queryUrlVisitsBreakdowns «سرویس‌ها > Chrome DLP > مشاهده تنظیمات بینش برنامه Chrome DLP»

برای مدیریت نقش‌ها و امتیازات مدیر، به «کنسول مدیریت -> نقش‌های مدیریت» مراجعه کنید.

دامنه‌های API

فعال‌سازی و غیرفعال‌سازی APIها به محدوده‌ی OAuth زیر نیاز دارد:

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

برای checkEnablementStatus و تمام متدهای پرس‌وجو، می‌توان از هر یک از این دو حوزه استفاده کرد:

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

برای اطلاعات بیشتر، به مرور کلی احراز هویت مراجعه کنید.