במאמר הזה מוסבר איך להקצות תפקידים והרשאות של ניהול זהויות והרשאות גישה (IAM) כדי לתמוך בניתוב אירועים מ- Google Cloud וממקורות אחרים לפונקציות Cloud Run באמצעות Eventarc.
הקצאת הרשאות ברמת הפרויקט והפריסה לחשבון המשתמש שיוצר טריגרים ופורס פונקציות:
התפקיד אדמין ב-Eventarc נותן לכם שליטה מלאה בכל המשאבים של Eventarc, כולל ציון חשבון שירות לטריגר כשאתם יוצרים אותו.
התפקיד משתמש בחשבון שירות מאפשר לחשבון המשתמש להתחזות לחשבון שירות ולהשתמש בו, כולל חשבון השירות של הטריגר וחשבונות השירות של זמן הריצה או ה-build של הפונקציה.
בהתאם לאופן שבו אתם פורסים את הפונקציה, התפקידים מפתח מקור ב-Cloud Run וצרכן של שימוש בשירות (כשפורסים באמצעות ה-CLI של
gcloud runאו Cloud Run Admin API) או התפקיד מפתח ב-Cloud Functions או אדמין ב-Cloud Functions (כשפורסים באמצעות ה-CLI שלgcloud functionsאו Cloud Functions v2 API) מאפשרים לכם ליצור ולעדכן פונקציות.
הענקת הרשאות לטריגר של Eventarc לחשבון השירות של הטריגר: התפקיד מקבל אירועים של Eventarc מאפשר לטריגר של Eventarc לקבל אירועים מספקי אירועים. אם אתם מנתבים אירועים ישירים מ-Cloud Pub/Sub, אתם לא צריכים להקצות את התפקיד.
מתן הרשאות הפעלה של פונקציות Cloud Run לחשבון השירות של הטריגר: התפקיד Cloud Run Invoker מאפשר לטריגר של Eventarc להפעיל פונקציית Cloud Run מאומתת.
מתן הרשאות לסוכני שירות של Google:
התפקיד סוכן שירות של Eventarc מאפשר לסוכן השירות של Eventarc לנהל את משאבי התעבורה הבסיסיים ולאמת את מקורות האירועים. התפקיד הזה מוקצה כברירת מחדל כשיוצרים משאב Eventarc בפעם הראשונה, אבל צריך לשחזר אותו אם הוא הוסר.
אם אתם פורסים פונקציות באמצעות ה-CLI של
gcloud functionsאו Cloud Functions v2 API, התפקיד סוכן שירות של Cloud Functions מאפשר לסוכן השירות של Cloud Functions ליצור ולנהל טריגרים של Eventarc ושירותים בסיסיים של Cloud Run. התפקיד הזה מוקצה כברירת מחדל כשמפעילים את Cloud Functions API, אבל צריך לשחזר אותו אם הוא הוסר.אם אתם יוצרים טריגר לאירועים ישירים מ-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. הוא נדרש גם כדי לפעול בתור חשבון השירות של סביבת זמן הריצה כשפורסים פונקציית Cloud Run, ובתור חשבון השירות של ה-build כשפורסים מקוד המקור. מידע נוסף זמין במאמר תפקידים לאימות חשבון שירות.
אתם יכולים להקצות את התפקיד בפרויקט כדי לאפשר לחשבון המשתמש להתחזות לכמה חשבונות שירות, או להקצות את התפקיד בחשבון השירות כדי לאפשר לחשבון המשתמש להתחזות רק לחשבון שירות ספציפי.
מקצים את התפקיד בפרויקט:
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.iam.gserviceaccount.com \ --member=PRINCIPAL \ --role=roles/iam.serviceAccountUser
מחליפים את מה שכתוב בשדות הבאים:
SERVICE_ACCOUNT_PROJECT_ID: מזהה הפרויקט ב- Google Cloudשמכיל את חשבון השירות.
SERVICE_ACCOUNT_NAME: השם של חשבון השירות.
מקצים את התפקידים שנדרשים כדי לפרוס את פונקציית Cloud Run, בהתאם לאופן הפריסה:
פריסה באמצעות
gcloud run deployאו Cloud Run Admin API: מקצים את התפקיד "מפתח מקורות ב-Cloud Run" (roles/run.sourceDeveloper) ואת התפקיד "צרכן של שימוש בשירות" (roles/serviceusage.serviceUsageConsumer) בפרויקט. למידע נוסף, כולל התפקידים הנדרשים בחשבון השירות של Cloud Build כדי ליצור מקוד מקור, קראו את המאמרים התפקידים הנדרשים לפריסת פונקציות Cloud Run ויצירת טריגר לפונקציות.פריסה באמצעות
gcloud functions deployאו Cloud Functions v2 API: מקצים את התפקיד "מפתח ב-Cloud Functions" (roles/cloudfunctions.developer) או את התפקיד "אדמין ב-Cloud Functions" (roles/cloudfunctions.admin) בפרויקט. למידע נוסף, כולל התפקידים הנדרשים בחשבון השירות של Cloud Build כדי לבנות מקוד מקור, קראו את המאמרים הגדרות נוספות לפריסה ובקרת גישה באמצעות IAM.
מתן הרשאות לטריגר של 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.iam.gserviceaccount.com \ --role=roles/eventarc.eventReceiver
מחליפים את
SERVICE_ACCOUNT_NAMEבשם של חשבון השירות שציינתם בשלב הקודם.
מתן הרשאות להפעלת פונקציות Cloud Run
כברירת מחדל, פונקציות Cloud Run דורשות אימות, כלומר אי אפשר להפעיל אותן בלי לספק פרטי כניסה לאימות בבקשה. בפרויקטים עם מדיניות ארגונית של הגבלה לפי דומיין, צריך להשתמש בפונקציית יעד מאומתת במקום בפונקציה שמאפשרת גישה ציבורית (לא מאומתת).
אם אתם מנתבים אירועים לפונקציית Cloud Run מאומתת, אתם צריכים להקצות את התפקיד "מפעיל של Cloud Run" (
roles/run.invoker) בשירות Cloud Run הבסיסי לחשבון השירות שמשויך לטריגר של Eventarc:gcloud run services add-iam-policy-binding FUNCTION_NAME \ --region=REGION \ --member=serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \ --role=roles/run.invoker
מחליפים את מה שכתוב בשדות הבאים:
FUNCTION_NAME: השם של פונקציית Cloud Run.
REGION: האזור שבו הפונקציה פרוסה.
אפשר גם להקצות את התפקיד בכל השירותים, הפונקציות והמשימות של Cloud Run בפרויקט ב- Google Cloud . למידע נוסף, קראו את המאמר שליטה בגישה לכל השירותים והמשימות בפרויקט.
שימו לב שאם יוצרים טריגר לפונקציית Cloud Run מאומתת בלי להקצות את התפקיד "הפעלת פונקציות של Cloud Run", הטריגר נוצר בהצלחה והוא פעיל. עם זאת, הטריגר לא יפעל כמו שצריך, ותופיע הודעה דומה לזו ביומנים:
The request was not authenticated. Either allow unauthenticated
invocations or set the proper Authorization header.
מתן הרשאות לסוכני שירות של 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.iam.gserviceaccount.com \ --role=roles/eventarc.serviceAgent
מחליפים את
PROJECT_NUMBERבמספר הפרויקט ב- Google Cloud. אפשר לראות את מספר הפרויקט בדף Welcome במסוף Google Cloud , או להריץ את הפקודה הבאה:gcloud projects describe PROJECT_ID --format='value(projectNumber)'
אם אתם פורסים פונקציות באמצעות
gcloud functions deployאו Cloud Functions v2 API, והתפקיד "סוכן שירות של Cloud Functions" (roles/cloudfunctions.serviceAgent) הוסר מסוכן השירות של Cloud Functions, צריך להקצות את התפקיד בפרויקט כדי שסוכן השירות יוכל ליצור ולנהל טריגרים של Eventarc ושירותי Cloud Run בסיסיים. אחרת, התפקיד הזה מוקצה כברירת מחדל כשמפעילים את Cloud Functions API:gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:service-PROJECT_NUMBER@gcf-admin-robot.iam.gserviceaccount.com \ --role=roles/cloudfunctions.serviceAgent
שימו לב שהתפקיד הזה הוצא משימוש והוא חל רק על פונקציות שנוצרו באמצעות Cloud Functions API. לפונקציות שנוצרו באמצעות Cloud Run, ראו את הדף תפקידים והרשאות ב-Cloud Run.
אם אתם יוצרים טריגר לאירועים ישירים מ-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.iam.gserviceaccount.com \ --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.iam.gserviceaccount.com \ --role=roles/iam.serviceAccountTokenCreator
המאמרים הבאים
מידע ולמידה על אפשרויות בקרת הגישה ב-Eventarc
מידע ולמידה על בקרת גישה באמצעות IAM לפונקציות Cloud Run
מידע ולמידה על שיטות מומלצות לשימוש בחשבונות שירות