בקרת גישה ל-Service Management API

ב-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

  1. פותחים את הדף Endpoints במסוף Google Cloud .

    כניסה לדף Endpoints

  2. לוחצים על השירות שעבורו רוצים לנהל את הגישה.
  3. לוחצים על הקישור "PERMISSIONS" בחלק העליון של הדף. כך אפשר להפעיל או להשבית את חלונית הנתונים.
  4. בחלונית הנתונים, לכל תפקיד ברמת השירות אפשר להציג את רשימת החברים הקיימים, להוסיף חברים חדשים ולהסיר חברים.

ניהול הגישה באמצעות ה-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