במאמר הזה מוסבר איך להקצות תפקידים והרשאות של ניהול זהויות והרשאות גישה (IAM) כדי לתמוך בניתוב אירועים מ- Google Cloud וממקורות אחרים לנקודת קצה פנימית של HTTP ברשת של ענן וירטואלי פרטי (VPC) באמצעות Eventarc.
לתת הרשאות ברמת הפרויקט לחשבון המשתמש שמפעיל את ממשקי ה-API של Eventarc (לדוגמה, יוצר הטריגר של Eventarc):
- התפקיד אדמין ב-Eventarc מאפשר לכם שליטה מלאה בכל המשאבים של Eventarc, כולל ציון חשבון שירות לטריגר כשאתם יוצרים אותו.
- התפקיד משתמש בחשבון שירות מאפשר לחשבון הראשי להתחזות לחשבון שירות ולהשתמש בו. חשבון השירות משויך לטריגר של Eventarc ומייצג את הזהות של הטריגר.
הקצאת הרשאות לטריגר של Eventarc לחשבון השירות של הטריגר: התפקיד מקבל אירועים של Eventarc מאפשר לטריגר של Eventarc לקבל אירועים מספקי אירועים. אם אתם מנתבים אירועים ישירים מ-Cloud Pub/Sub, אתם לא צריכים להקצות את התפקיד.
מתן הרשאות לסוכני שירות של Google:
התפקיד סוכן שירות של Eventarc מאפשר לסוכן השירות של Eventarc לנהל את משאבי התעבורה הבסיסיים ולאמת את מקורות האירועים. התפקיד הזה מוקצה כברירת מחדל כשיוצרים משאב Eventarc בפעם הראשונה, אבל צריך לשחזר אותו אם הוא הוסר.
אם ה-URI של נקודת הקצה הפנימית של ה-HTTP משתמש בשם ה-DNS הפנימי של שירות שניתן לפתור באמצעות Cloud DNS, צריך להקצות את התפקיד DNS Peer בפרויקט המארח של ה-VPC לסוכן השירות של Eventarc.
אם אתם יוצרים טריגר לאירועים ישירים מ-Cloud Storage, הקצו את התפקיד מפרסם Pub/Sub לסוכן השירות של Cloud Storage.
אם הפעלתם את סוכן השירות של Cloud Pub/Sub ב-8 באפריל 2021 או לפני כן, אתם צריכים להקצות לסוכן השירות של Pub/Sub את התפקיד יצירת אסימונים בחשבון שירות.
למידע נוסף על הקצאת תפקידי IAM, קראו את המאמר ניהול הגישה. יכול להיות שתוכלו לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
מתן הרשאות ברמת הפרויקט
אם אתם יוצרי הפרויקט, מוקצה לכם התפקיד הבסיסי "בעלים" (roles/owner). כברירת מחדל, התפקיד הזה כולל את ההרשאות שנדרשות כדי לקבל גישה מלאה לרוב המשאבים שלGoogle Cloud . אחרת, אדמין צריך להקצות את התפקידים הנדרשים במשאב המתאים לחשבון המשתמש המתאים (שנקרא גם חבר).
לדוגמה, חשבון משתמש יכול להיות חשבון Google (למשתמשי קצה) או חשבון שירות (לאפליקציות ולעומסי עבודה ממוחשבים). לכל חשבון משתמש יש מזהה משלו, שהוא בדרך כלל כתובת אימייל.
התפקיד "אדמין ב-Eventarc" (
roles/eventarc.admin) מאפשר לכם שליטה מלאה בכל המשאבים של Eventarc.מקצים את התפקיד בפרויקט:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=PRINCIPAL \ --role=roles/eventarc.admin
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud . -
PRINCIPAL: מזהה של יוצר הטריגר, שבדרך כלל נראה כך:PRINCIPAL_TYPE:ID. לדוגמה:user:my-user@example.com. בדף העזר בנושא קישורי מדיניות תוכלו למצוא רשימה מלאה של הערכים שיכולים להיות ל-PRINCIPAL_TYPE.
-
התפקיד "משתמש בחשבון שירות" (
roles/iam.serviceAccountUser) מאפשר לחשבון משתמש להריץ פעולות בתור חשבון שירות.כשיוצרים טריגר של Eventarc, צריך את התפקיד הזה כדי לשייך לטריגר חשבון שירות בניהול המשתמשים שייצג את הזהות שלו. מידע נוסף זמין במאמר תפקידים לאימות חשבון שירות.
כדי לאפשר לחשבון הראשי להתחזות לכמה חשבונות שירות, אפשר להקצות את התפקיד בפרויקט. כדי לאפשר לחשבון הראשי להתחזות רק לחשבון שירות ספציפי, אפשר להקצות את התפקיד בחשבון השירות.
מקצים את התפקיד בפרויקט:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=PRINCIPAL \ --role=roles/iam.serviceAccountUser
או להקצות את התפקיד בחשבון השירות:
gcloud iam service-accounts add-iam-policy-binding \ projects/SERVICE_ACCOUNT_PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT_NAME@SERVICE_ACCOUNT_PROJECT_ID. \ --member=PRINCIPAL \ --role=roles/iam.serviceAccountUser
מחליפים את מה שכתוב בשדות הבאים:
-
SERVICE_ACCOUNT_PROJECT_ID:Google Cloud מזהה הפרויקט שמכיל את חשבון השירות. -
SERVICE_ACCOUNT_NAME: השם של חשבון השירות.
-
מתן הרשאות לטריגר של Eventarc
כל טריגר של Eventarc משויך לחשבון שירות של IAM בזמן יצירת הטריגר. אתם יכולים לציין חשבון שירות שמנוהל על ידי משתמש, שישמש את הטריגר כזהות ברירת המחדל שלו. אם לא תציינו חשבון שירות במהלך יצירת הטריגר, הטריגר ישתמש בחשבון השירות שמוגדר כברירת מחדל ב-Compute Engine בתור הזהות שלו.
מומלץ ליצור חשבון שירות משלכם בניהול המשתמשים כדי שתהיה לכם יותר שליטה וגמישות בניהול הטריגר.
יוצרים חשבון שירות ורושמים את השם שלו:
gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \ --description="DESCRIPTION" \ --display-name="DISPLAY_NAME"
מחליפים את מה שכתוב בשדות הבאים:
-
SERVICE_ACCOUNT_NAME: השם של חשבון השירות. השם הזה מופיע כחלק מכתובת האימייל שמזהה את חשבון השירות. -
DESCRIPTION: תיאור אופציונלי של חשבון השירות. DISPLAY_NAME: השם של חשבון השירות שיופיע במסוף Google Cloud .
-
מקצים את התפקיד "מקבל אירועים ב-Eventarc" (
roles/eventarc.eventReceiver) בפרויקט לחשבון השירות שמשויך לטריגר של Eventarc, כדי שהטריגר יוכל לקבל אירועים מספקי אירועים.שימו לב: אם אתם מנתבים אירועים ישירים מ-Cloud Pub/Sub, אתם לא צריכים להקצות את התפקיד "מקבל אירועים ב-Eventarc".
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID. \ --role=roles/eventarc.eventReceiver
מחליפים את
SERVICE_ACCOUNT_NAMEבשם של חשבון השירות שציינתם בשלב הקודם.
מתן הרשאות לסוכני שירות של Google
לחלק משירותי Google Cloud יש סוכני שירות שמאפשרים לשירותים לגשת למשאבים שלכם. אם ממשק API דורש סוכן שירות, Google יוצרת את סוכן השירות אחרי שמפעילים את ה-API ומשתמשים בו.
אם התפקיד "סוכן שירות של Eventarc" (
roles/eventarc.serviceAgent) הוסר מסוכן השירות של Eventarc, צריך להקצות את התפקיד בפרויקט כדי ש-Eventarc יוכל לנהל את משאבי התעבורה הבסיסיים ולאמת את מקורות האירועים. אחרת, התפקיד הזה מוקצה כברירת מחדל כשיוצרים משאב Eventarc בפעם הראשונה:gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-eventarc. \ --role=roles/eventarc.serviceAgent
מחליפים את
PROJECT_NUMBERבמספר הפרויקט ב- Google Cloud. אפשר לראות את מספר הפרויקט בדף Welcome במסוף Google Cloud , או להריץ את הפקודה הבאה:gcloud projects describe PROJECT_ID --format='value(projectNumber)'
אם ה-URI של נקודת הקצה הפנימית של HTTP ברשת ה-VPC משתמש בשם ה-DNS הפנימי של שירות שניתן לפתור באמצעות Cloud DNS, כדי לגשת לרשתות היעד באמצעות תחום קישור בין רשתות שכנות ב-DNS, צריך להקצות את התפקיד "ישות שכנה ב-DNS" (
roles/dns.peer) בפרויקט המארח של ה-VPC לסוכן השירות של Eventarc:gcloud projects add-iam-policy-binding VPC_HOST_PROJECT_ID \ --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-eventarc. \ --role=roles/dns.peer
מחליפים את מה שכתוב בשדות הבאים:
VPC_HOST_PROJECT_ID: מזהה הפרויקט ב- Google Cloud של הפרויקט המארח של VPC. כשמשתמשים ב-VPC משותף, מצרפים לפרויקט המארח פרויקט שירות אחד או יותר, וכך מאפשרים למשאבים מכמה פרויקטים להתחבר לרשת VPC משותפת.שימו לב: בהתאם להגדרות של רשת ה-VPC, יכול להיות שהפרויקט המארח של ה-VPC יהיה גם הפרויקט של הטריגר של Eventarc.
PROJECT_NUMBER: מספר הפרויקט ב- Google Cloud של הפרויקט עם הטריגר של Eventarc.
אם אתם יוצרים טריגר לאירועים ישירים מ-Cloud Storage, כדי לתמוך בפרסום הודעות בנושא, אתם צריכים להקצות לסוכן השירות של Cloud Storage את התפקיד "פרסום הודעות ב-Pub/Sub" (
roles/pubsub.publisher) בפרויקט:gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:service-PROJECT_NUMBER@gs-project-accounts. \ --role=roles/pubsub.publisher
אם הפעלתם את סוכן השירות של Cloud Pub/Sub ב-8 באפריל 2021 או לפני כן, כדי לתמוך בבקשות דחיפה מאומתות של Pub/Sub, צריך להקצות לסוכן השירות של Pub/Sub את התפקיד "יצירת אסימונים בחשבון שירות" (
roles/iam.serviceAccountTokenCreator) בפרויקט. אחרת, התפקיד הזה מוקצה כברירת מחדל:gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-pubsub. \ --role=roles/iam.serviceAccountTokenCreator
המאמרים הבאים
מידע ולמידה על אפשרויות בקרת הגישה ב-Eventarc
מידע ולמידה על שיטות מומלצות לשימוש בחשבונות שירות