Chrome Management Enrollment Tokens API מאפשר לאדמינים לנהל טוקנים של רישום שמשמשים לרישום דפדפני Chrome ב-Chrome Enterprise Core. אפשר להשתמש בממשקי ה-API האלה כדי ליצור, לאחזר, להציג ולבטל טוקנים של הרשמה למכשירים.
סקירה מהירה של שיטות API
כתובות ה-URL הן יחסיות ל-https://chromemanagement.googleapis.com/v1/customers/{customer_id}
| תיאור | כתובת URL יחסית | שיטת HTTP |
|---|---|---|
| יצירת טוקן רישום | /enrollmentTokens | POST |
| אחזור טוקן רישום | /enrollmentTokens/{token_permanent_id} | הורדה |
| הצגת רשימה של טוקנים של הרשמה | /enrollmentTokens | הורדה |
| ביטול טוקן רישום | /enrollmentTokens/{token_permanent_id}:revoke | POST |
דוגמאות קוד לבקשות ותשובות.
המערכת מסננת את התוצאות
כשמציגים רשימה של טוקנים להרשמה באמצעות ה-method /enrollmentTokens, אפשר לצמצם את התוצאות באמצעות פרמטר השאילתה filter. כששולחים פרמטרים של מסננים בבקשות HTTP, צריך להשתמש בתווי escape של כתובות URL. אפשר לשלב כמה תנאים באמצעות האופרטור AND.
- שדות מסוג String ו-Enum: תמיכה באופרטורים להשוואה
=ו-:. - סינון לפי יחידה ארגונית: אפשר לסנן אסימונים שנוצרו עבור יחידה ארגונית ספציפית על ידי ציון
org_unit_pathאוorg_unit_id.
שדות שניתן לסנן
| שדה | תיאור |
|---|---|
device_type
|
סוג המכשיר שאסימוני הרישום משמשים לרישום שלו
(כרגע CHROME_BROWSER). |
token_state
|
המצב של טוקן ההרשמה (ACTIVE, EXPIRED, REVOKED). |
org_unit_path
|
הנתיב של היחידה הארגונית לטוקן ההרשמה
(למשל, /Marketing). |
org_unit_id
|
המזהה המוסתר של היחידה הארגונית עבור אסימון ההרשמה. |
הרשאות אדמין
ממשק Chrome Management Enrollment Tokens API מכבד את ההרשאות שהוקצו לתפקידי אדמין.
| שיטה | נדרשות הרשאות אדמין |
|---|---|
| CreateEnrollmentToken | Services -> Chrome Management -> Settings -> Managed Browsers |
| GetEnrollmentToken | 'Services -> Chrome Management -> Settings -> Managed Browsers' או 'Services -> Chrome Management -> Settings -> Managed Browsers -> Read' |
| ListEnrollmentTokens | 'Services -> Chrome Management -> Settings -> Managed Browsers' או 'Services -> Chrome Management -> Settings -> Managed Browsers -> Read' |
| RevokeEnrollmentToken | Services -> Chrome Management -> Settings -> Managed Browsers |
כדי לנהל את תפקידי האדמין וההרשאות, עוברים אל 'מסוף Admin -> תפקידי אדמין'.
היקפי API
ממשק ה-API של טוקנים לרישום ב-Chrome Management דורש את היקפי ההרשאות הבאים של OAuth:
| שיטה | היקפי ההרשאות הנדרשים של OAuth |
|---|---|
| CreateEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens |
| GetEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens או https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly |
| ListEnrollmentTokens | https://www.googleapis.com/auth/chrome.management.enrollmenttokens או https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly |
| RevokeEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens |
למידע נוסף, ראו את המאמר סקירה כללית על אימות.