ב-Service Management API נעשה שימוש בניהול זהויות והרשאות גישה (Cloud IAM) כדי לבצע בקרה על הגישה לשירותים המנוהלים ולמשאבים הצאצאים שלהם. במאמר הזה נסביר על המשאבים, התפקידים וההרשאות ב-IAM שמתקבלים מ-Service Management API, ואיך אפשר להשתמש בהם כדי לבצע בקרה על הגישה.
משאבי IAM
IAM מחיל מדיניות על משאבים כדי לקבוע מי יכול לבצע פעולות כלשהן לגבי המשאבים. כדי לספק פונקציונליות, ב-Service Management API נעשה שימוש במשאבים הבאים:
כדי להשתמש במשאבים שונים ולנהל אותם נדרשות הרשאות שונות – פרטים מופיעים בהמשך המאמר.
הרשאות IAM
כדי לקרוא ל-Service Management API, למבצע הקריאה חייבות להיות הרשאות IAM הנדרשות במשאבי היעד.
ההרשאות שחלות על השירותים מפורטות בטבלה הבאה:
| הרשאה | תיאור |
|---|---|
servicemanagement.services.delete |
מחיקת שירותים |
servicemanagement.services.get |
קריאת שירותים |
servicemanagement.services.create |
יצירה וביטול מחיקה של שירותים בפרויקטים. |
servicemanagement.services.list |
רישום שירותים בפרויקטים |
servicemanagement.services.update |
עדכון שירותים |
servicemanagement.services.bind |
הצגה והפעלה של השירות בפרויקטים שבשליטת מבצע הקריאה |
servicemanagement.services.setIamPolicy |
הגדרת מדיניות הגישה ב-IAM לשירותים |
servicemanagement.services.getIamPolicy |
קריאת מדיניות הגישה ב-IAM לשירותים |
servicemanagement.services.check |
בדיקת הסטטוס של צרכן שירות למידע נוסף: services.check |
servicemanagement.services.quota |
הקצאת מכסה לצרכן שירות למידע נוסף: services.allocateQuota |
servicemanagement.services.report |
דיווח על שימוש בשירות למידע נוסף: services.report |
בטבלה הבאה מפורטות ההרשאות הנדרשות לכל method של Service Management API, במקרים הרלוונטיים. המידע מתועד גם במאמר מאמרי העזרה של ה-API:
| Method | ההרשאות הנדרשות |
|---|---|
services.create |
servicemanagement.services.create בפרויקט לשירות מנוהל. |
services.delete |
servicemanagement.services.delete ב-service_name שצוין. |
services.get |
servicemanagement.services.get ב-service_name שצוין. |
services.getConfig |
servicemanagement.services.get ב-service_name שצוין. |
services.undelete |
servicemanagement.services.create בפרויקט לשירות מנוהל. |
services.configs.create |
servicemanagement.services.update ב-service_name שצוין. |
services.configs.get |
servicemanagement.services.get ב-service_name שצוין. |
services.configs.list |
servicemanagement.services.get ב-service_name שצוין. |
services.configs.submit |
servicemanagement.services.update ב-service_name שצוין. |
services.rollouts.create |
servicemanagement.services.update ב-service_name שצוין. |
services.rollouts.get |
servicemanagement.services.get ב-service_name שצוין. |
services.rollouts.list |
servicemanagement.services.get ב-service_name שצוין. |
תפקידי IAM
בניהול הזהויות והרשאות הגישה, ההרשאות מוקצות באמצעות קישור בין משתמשים לתפקידים. למידע נוסף: הסבר על תפקידים
התפקידים שחלים על השירותים מפורטים בטבלה הבאה:
| תפקיד | הרשאות |
|---|---|
roles/viewer |
servicemanagement.services.get servicemanagement.services.list |
roles/editor |
כל ההרשאות של roles/viewer, ובנוסףservicemanagement.services.bind servicemanagement.services.check servicemanagement.services.create servicemanagement.services.delete servicemanagement.services.quota servicemanagement.services.report servicemanagement.services.update |
roles/owner |
כל ההרשאות של roles/editor, ובנוסףservicemanagement.services.getIamPolicy servicemanagement.services.setIamPolicy |
roles/servicemanagement.admin |
monitoring.timeSeries.list resourcemanager.folders.get resourcemanager.folders.list resourcemanager.organizations.get resourcemanager.projects.get resourcemanager.projects.list serviceconsumermanagement.consumers.get serviceconsumermanagement.quota.get serviceconsumermanagement.quota.update serviceconsumermanagement.tenancyu.addResource serviceconsumermanagement.tenancyu.create serviceconsumermanagement.tenancyu.delete serviceconsumermanagement.tenancyu.list serviceconsumermanagement.tenancyu.removeResource servicemanagement.services.bind servicemanagement.services.check servicemanagement.services.create servicemanagement.services.delete servicemanagement.services.get servicemanagement.services.getIamPolicy servicemanagement.services.list servicemanagement.services.quota servicemanagement.services.report servicemanagement.services.setIamPolicy servicemanagement.services.update serviceusage.quotas.get serviceusage.services.get |
roles/servicemanagement.configEditor |
servicemanagement.services.get servicemanagement.services.update |
roles/servicemanagement.reporter |
servicemanagement.services.report |
roles/servicemanagement.serviceConsumer |
servicemanagement.services.bind |
roles/servicemanagement.serviceController |
servicemanagement.services.check servicemanagement.services.get servicemanagement.services.quota servicemanagement.services.report |
ניהול המדיניות
בעזרת IAM אפשר לבצע הערכה של המדיניות באופן היררכי: משאב הצאצא יורש תמיד את המדיניות של ההורה שלו. ב-Service Management API, כל שירות מנוהל הוא משאב צאצא של הפרויקט לשירות המנוהל שלו. לכן, התפקידים שמוענקים בפרויקט לשירות המנוהל חלים על כל השירותים המנוהלים השייכים לפרויקט. הוראות להקצאת תפקידים ברמת הפרויקט זמינות במאמר ניהול מדיניות.
אפשר גם לנהל את מדיניות IAM לשירות ספציפי. בקטעים הבאים מוסבר איך לנהל תפקידים ברמת השירות באמצעות מסוף Google Cloud , Service Management API ו-Google Cloud CLI.
ניהול הגישה באמצעות מסוף Google Cloud
פותחים את הדף Endpoints במסוף Google Cloud .
- לוחצים על השירות שעבורו רוצים לנהל את הגישה.
- לוחצים על הקישור "PERMISSIONS" בחלק העליון של הדף. כך אפשר להפעיל או להשבית את חלונית הנתונים.
- בחלונית הנתונים, לכל תפקיד ברמת השירות אפשר להציג את רשימת החברים הקיימים, להוסיף חברים חדשים ולהסיר חברים.
ניהול הגישה באמצעות ה-CLI של gcloud
CLI של gcloud כולל פקודות gcloud endpoints services לניהול מדיניות IAM לשירותים מנוהלים:
endpoints services get-iam-policy- הצגת מדיניות IAM של השירות.
endpoints services check-iam-policy- בדיקת מדיניות IAM של השירות.
endpoints services add-iam-policy-binding- הוספת משתמש לתפקיד.
endpoints services remove-iam-policy-binding- הסרת משתמש מתפקיד.
לדוגמה:
# Show the IAM policy of service "endpointsapis.appspot.com".
gcloud endpoints services get-iam-policy endpointsapis.appspot.com
# The above command may produce an output similar to this:
bindings:
- members:
- user:email1@gmail.com
- group:group1@googlegroups.com
role: roles/servicemanagement.serviceConsumer
# Add a user to "roles/servicemanagement.serviceConsumer" role.
gcloud endpoints services add-iam-policy-binding endpointsapis.appspot.com --member "user:email1@gmail.com" --role "roles/servicemanagement.serviceConsumer"
# Add a group to "roles/servicemanagement.serviceConsumer" role.
gcloud endpoints services add-iam-policy-binding endpointsapis.appspot.com --member "group:group1@googlegroups.com" --role "roles/servicemanagement.serviceConsumer"
# Remove a user from "roles/servicemanagement.serviceConsumer" role.
gcloud endpoints services remove-iam-policy-binding endpointsapis.appspot.com --member "user:email1@gmail.com" --role "roles/servicemanagement.serviceConsumer"
# Remove a group from "roles/servicemanagement.serviceConsumer" role.
gcloud endpoints services remove-iam-policy-binding endpointsapis.appspot.com --member "group:group1@googlegroups.com" --role "roles/servicemanagement.serviceConsumer"
ניהול הגישה באמצעות Service Management API
ממשק Service Management API כולל את IAM Policy API לניהול המדיניות ברמת השירות וברמת הצרכן. אפשר להשתמש בפקודה gcurl כדי להתנסות ב-methods של ה-API.
מידע על השלבים להגדרה הראשונית זמין במאמר תחילת השימוש ב-Service Management API.
לדוגמה:
# View the current IAM policy on service "endpointsapis.appspot.com".
gcurl -d '{}' https://servicemanagement.googleapis.com/v1/services/endpointsapis.appspot.com:getIamPolicy
# View the current IAM policy on service "endpointsapis.appspot.com" and consumer "12345".
gcurl -d '{}' https://servicemanagement.googleapis.com/v1/services/endpointsapis.appspot.com/consumers/12345:getIamPolicy