באמצעות Security Insights API אפשר להפעיל או להשבית את התכונה 'תובנות לגבי אבטחה ב-Chrome' וגם לבדוק את סטטוס ההפעלה שלה.
סקירה מהירה של שיטות API
כתובות ה-URL הן יחסיות ל-https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| תיאור | כתובת URL יחסית | שיטת HTTP | פרמטרים מותרים של בקשה |
|---|---|---|---|
| הפעלת תובנות בדומיין והגדרת מחברים ל-Chrome עבור היחידה הארגונית הבסיסית (root) או קבוצה ספציפית של יחידות ארגוניות בדומיין | /enterprise/securityInsights:enable | POST | אופציונלי: targetOus |
| השבתת התובנות בדומיין | /enterprise/securityInsights:disable | POST | |
| בדיקת סטטוס ההפעלה של התובנות בדומיין | /enterprise/securityInsights:checkEnablementStatus | הורדה |
דוגמאות קוד לבקשות ולתגובות
הרשאות אדמין
נדרשות הרשאות אדמין שונות, בהתאם לשיטה שבה משתמשים.
| שיטה | נדרשות הרשאות אדמין |
|---|---|
| enable | 'יחידות ארגוניות > קריאה' 'שירותים > ניהול Chrome > הגדרות > ניהול הגדרות משתמש' 'שירותים > Chrome DLP > ניהול של הגדרות התובנות לגבי אפליקציית Chrome DLP' |
| disable | 'יחידות ארגוניות > קריאה' 'שירותים > ניהול Chrome > הגדרות > ניהול הגדרות משתמש' 'שירותים > Chrome DLP > ניהול של הגדרות התובנות לגבי אפליקציית Chrome DLP' |
| checkEnablementStatus | 'יחידות ארגוניות > קריאה' 'שירותים > ניהול Chrome > הגדרות > ניהול הגדרות משתמש' 'שירותים > Chrome DLP > ניהול של הגדרות התובנות לגבי אפליקציית Chrome DLP' או 'שירותים > Chrome DLP > הצגת הגדרות התובנות לגבי אפליקציית Chrome DLP' |
כדי לנהל את תפקידי האדמין וההרשאות, עוברים אל 'מסוף Admin -> תפקידי אדמין'.
היקפי 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
מידע נוסף מופיע במאמר סקירה כללית על אימות.