הגדרת זהות בשירותים

לשירות או לגרסה של Cloud Run יש זהות שירות שמשמשת כחשבון המאומת כדי לגשת לממשקי ה-API של Google Cloud ממארז המכונה של Cloud Run. למידע נוסף על זהות השירות, קראו את המדריך מבוא לזהות השירות.

איך משתמשים בזהות בשירות

ב-Cloud Run, זהות השירות היא חשבון שירות שהוא גם משאב וגם חשבון משתמש.

  • זהות השירות כמשאב: כדי לצרף חשבון שירות כזהות השירות, לחשבון הפריסה צריכה להיות גישה למשאב של זהות השירות. בפעולות מסוימות, כמו יצירה או עדכון של שירות או גרסה, נדרשות הרשאות במשאב של זהות השירות בחשבון הפריסה.
  • זהות השירות כחשבון משתמש: כדי לגשת לממשקי ה-API של Google Cloud משירות או מגרסה של Cloud Run, צריך לתת לזהות השירות את התפקידים או ההרשאות שנדרשים לפעולות שרוצים שהשירות או הגרסה יבצעו.

בקטע הבא מוסבר אילו תפקידים נדרשים כדי לתת לחשבון הפריסה גישה למשאב של זהות השירות, ואילו תפקידים או הרשאות נדרשים לחשבון המשתמש של חשבון השירות.

התפקידים הנדרשים

אתם או האדמין שלכם צריכים להקצות תפקידים והרשאות ב-IAM לחשבון הפריסה ולזהות השירות.

לחצו כדי לראות את התפקידים הנדרשים לחשבון הפריסה

כדי לקבל את ההרשאות שנדרשות כדי לצרף חשבון שירות בתור זהות השירות בשירות או בגרסה, אתם או האדמין צריכים לתת לחשבון הפריסה את התפקיד משתמש בחשבון שירות (roles/iam.serviceAccountUser) בחשבון השירות שמשמש כזהות השירות.

התפקיד המוגדר מראש הזה כולל את ההרשאה iam.serviceAccounts.actAs, שנדרשת כדי לצרף חשבון שירות לשירות או לגרסה. יכול להיות שתוכלו לקבל את ההרשאה הזו גם באמצעות הגדרה של תפקידים בהתאמה אישית או באמצעות תפקידים מוגדרים מראש אחרים.

במאמר הרשאות פריסה מוסבר איך מקצים לחשבון הפריסה את התפקיד הזה בזהות השירות. אם חשבון השירות נמצא בפרויקט אחר מהשירות או מהגרסה של Cloud Run, אתם או האדמין שלכם צריכים גם להגדיר תפקיד IAM לסוכן השירות של Cloud Run ולהגדיר מדיניות ארגונית. למידע נוסף, קראו את המאמר שימוש בחשבונות שירות בפרויקטים אחרים.

לחיצה כדי לראות את התפקידים הנדרשים לזהות השירות

כדי לאפשר לזהות השירות לגשת לממשקי ה-API של Google Cloud מ-Cloud Run, אתם או האדמין שלכם צריכים לתת לזהות השירות את ההרשאות או התפקידים שנדרשים לפעולות שאתם רוצים לבצע. כדי לגשת לספריות לקוח ספציפיות של Cloud, עיינו ב Google Cloud מסמכי התיעוד של שירות Google Cloud .

אם שירות או גרסה של Cloud Run לא ניגשים לשירותי Google Cloud אחרים, לא צריך להקצות לזהות השירות תפקידים או הרשאות, ואפשר להשתמש בחשבון השירות שמוגדר כברירת מחדל שהוקצה לפרויקט.

קבלת המלצות ליצירת חשבונות שירות ייעודיים

כשיוצרים חשבון שירות חדש ממסוף Google Cloud , השלב האופציונלי "מתן גישה לחשבון השירות הזה לפרויקט" מיועד לכל גישה נוספת שנדרשת. לדוגמה, שירות Cloud Run אחד יכול להפעיל שירות Cloud Run פרטי אחר, או לגשת למסד נתונים של Cloud SQL. בשני המקרים נדרשים תפקידי IAM ספציפיים. מידע נוסף זמין במאמר ניהול הגישה.

שירות Recommender גם מספק באופן אוטומטי המלצות ליצירת חשבונות שירות ייעודיים עם קבוצת ההרשאות המינימלית הנדרשת.

הגדרת זהות השירות

אם עדיין לא יצרתם חשבון שירות, אתם יכולים ליצור חשבון שירות בניהול המשתמש ב-IAM או ב-Cloud Run.

כדי להגדיר את זהות השירות, אתם יכולים להשתמש במסוף Google Cloud , ב-CLI של gcloud, ב-API‏ (YAML) כשאתם יוצרים שירות חדש או פורסים גרסה חדשה, או ב-Terraform:

המסוף

  1. נכנסים לדף Cloud Run במסוף Google Cloud :

    כניסה ל-Cloud Run

  2. בתפריט הניווט של Cloud Run, לוחצים על Services:

    1. אם אתם מגדירים שירות חדש, לוחצים על Deploy container וממלאים את דף הגדרות השירות הראשוני. ואז לוחצים על Containers, Networking, Security כדי להרחיב את דף הגדרת השירות.

    2. אם אתם מגדירים שירות קיים, לוחצים על השירות.

  3. לוחצים על הכרטיסייה אבטחה.

  4. לוחצים על התפריט הנפתח Service account ובוחרים חשבון שירות קיים, או לוחצים על Create a new service account, אם רלוונטי.

  5. כדי ליצור שירות חדש, לוחצים על יצירה. לוחצים על View diff & redeploy ואז על Deploy changes בשירות קיים.

gcloud

כדי לעדכן שירות קיים כך שיהיה לו חשבון שירות חדש, משתמשים בפקודה הבאה:

gcloud run services update SERVICE --service-account SERVICE_ACCOUNT

מחליפים את מה שכתוב בשדות הבאים:

  • ‫SERVICE: שם השירות.
  • ‫SERVICE_ACCOUNT: חשבון השירות שמשויך לזהות החדשה. הערך הזה הוא כתובת האימייל של חשבון השירות, לדוגמה example@myproject..

אפשר גם להגדיר חשבון שירות במהלך הפריסה באמצעות הפקודה:

gcloud run deploy --image IMAGE_URL --service-account SERVICE_ACCOUNT

מחליפים את מה שכתוב בשדות הבאים:

  • ‫IMAGE_URL: הפניה לקובץ האימג' של הקונטיינר, לדוגמה us-docker.pkg.dev/cloudrun/container/hello:latest. אם אתם משתמשים ב-Artifact Registry, המאגר REPO_NAME כבר צריך להיות קיים. כתובת ה-URL צריכה להיות בפורמט LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
  • ‫SERVICE_ACCOUNT: חשבון השירות שמשויך לזהות החדשה. הערך הזה הוא כתובת האימייל של חשבון השירות, לדוגמה example@myservice..

YAML

  1. אם אתם יוצרים שירות חדש, דלגו על השלב הזה. אם אתם מעדכנים שירות קיים, הורידו את הגדרת ה-YAML שלו:

    gcloud run services describe SERVICE --format export > service.yaml
  2. מעדכנים את המאפיין serviceAccountName::

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: SERVICE
    spec:
      template:
        spec:
          serviceAccountName: SERVICE_ACCOUNT

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫SERVICE: השם של שירות Cloud Run.
    • ‫SERVICE_ACCOUNT: חשבון השירות שמשויך לזהות החדשה. הערך הזה הוא כתובת האימייל של חשבון השירות, לדוגמה SERVICE_ACCOUNT_NAME@PROJECT_ID..
  3. יוצרים או מעדכנים את השירות באמצעות הפקודה הבאה:

    gcloud run services replace service.yaml

    כברירת מחדל, הפקודה gcloud run services replace משתמשת בקובץ service.yaml אם הוא קיים.

Terraform

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

מוסיפים את הקוד הבא למשאב google_cloud_run_v2_service בתצורה של Terraform:

כדי ליצור חשבון שירות, מוסיפים את המשאב הבא לקובץ main.tf הקיים:

resource "google_service_account" "cloudrun_service_identity" {
  account_id = "my-service-account"
}

יוצרים או מעדכנים שירות Cloud Run וכוללים את חשבון השירות:

resource "google_cloud_run_v2_service" "default" {
  name     = "id-service"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"
    }
    service_account = google_service_account.cloudrun_service_identity.email
  }
}

שימוש בחשבונות שירות בפרויקטים אחרים

אם אתם מגדירים חשבון שירות מפרויקט ב- Google Cloud ששונה מהמשאב של Cloud Run, בצעו את הפעולות הבאות:

  1. אתם או האדמין צריכים להקצות את התפקיד "משתמש בחשבון שירות" (roles/iam.serviceAccountUser) בחשבון השירות שבו אתם משתמשים בתור זהות השירות.

    המסוף

    1. נכנסים לדף Service accounts במסוף Google Cloud :

      כניסה לדף Service accounts

    2. בוחרים את כתובת האימייל של חשבון השירות שמשמשת כזהות השירות.

    3. לוחצים על הכרטיסייה Principals with access.

    4. לוחצים על הכפתור Grant access.

    5. מזינים את כתובת האימייל של חשבון הפריסה שתואמת לחשבון המשתמש שאתם נותנים לו את התפקיד "אדמין" או "מפתח".

    6. בתפריט הנפתח Select a role, בוחרים את התפקיד Service Accounts > Service Account User.

    7. לוחצים על Save.

    gcloud

    משתמשים בפקודה gcloud iam service-accounts add-iam-policy-binding ומחליפים את המשתנים המודגשים בערכים המתאימים:

    gcloud iam service-accounts add-iam-policy-binding \
        SERVICE_ACCOUNT_NAME@SERVICE_ACCOUNT_PROJECT_ID. \
        --member="PRINCIPAL" \
        --role="roles/iam.serviceAccountUser"

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫SERVICE_ACCOUNT_NAME: השם של חשבון השירות שאליו מצרפים את המשאב של Cloud Run.
    • ‫SERVICE_ACCOUNT_PROJECT_ID: מזהה הפרויקט שבו נמצא חשבון השירות.
    • ‫PRINCIPAL: חשבון הפריסה שאליו מוסיפים את הקישור, בפורמט user|group|serviceAccount:email או domain:domain. לדוגמה:

      • user:test-user@gmail.com
      • group:admins@example.com
      • serviceAccount:test123@example.domain.com
      • domain:example.domain.com
  2. אתם או האדמין שלכם צריכים להקצות לסוכן השירות של המשאב ב-Cloud Run את התפקיד "יצירת אסימונים בחשבון שירות" (roles/iam.serviceAccountTokenCreator) בחשבון השירות שבו אתם משתמשים בתור זהות השירות. הפורמט של סוכן השירות הוא service-PROJECT_NUMBER@serverless-robot-prod..

    המסוף

    1. נכנסים לדף Service accounts במסוף Google Cloud :

      כניסה לדף Service accounts

    2. בוחרים את כתובת האימייל של חשבון השירות שמשמשת כזהות השירות.

    3. לוחצים על הכרטיסייה Permissions.

    4. לוחצים על הכפתור Grant access.

    5. מזינים את כתובת האימייל של סוכן השירות. לדוגמה: service-PROJECT_NUMBER@serverless-robot-prod..

    6. בתפריט הנפתח Select a role, בוחרים את התפקיד Service Accounts > Service Account Token Creator.

    7. לוחצים על Save.

    gcloud

    משתמשים בפקודה gcloud iam service-accounts add-iam-policy-binding:

    gcloud iam service-accounts add-iam-policy-binding \
        SERVICE_ACCOUNT_NAME@SERVICE_ACCOUNT_PROJECT_ID. \
        --member="serviceAccount:service-CLOUD_RUN_RESOURCE_PROJECT_NUMBER@serverless-robot-prod." \
        --role="roles/iam.serviceAccountTokenCreator"

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫SERVICE_ACCOUNT_NAME: השם של חשבון השירות שאליו מצרפים את המשאב של Cloud Run.
    • ‫SERVICE_ACCOUNT_PROJECT_ID: מזהה הפרויקט שבו נמצא חשבון השירות.
    • CLOUD_RUN_RESOURCE_PROJECT_NUMBER: מספר הפרויקט שבו נמצא Cloud Run.

    הפקודה מדפיסה את מדיניות ההרשאה המעודכנת לחשבון השירות המנוהל על ידי המשתמש.

  3. בפרויקט שמכיל את חשבון השירות הזה, צריך להגדיר את מדיניות הארגון iam.disableCrossProjectServiceAccountUsage לערך false או לא לאכוף אותה ברמת התיקייה, או שהיא צריכה לעבור בירושה מההגדרות ברמת הפרויקט. כברירת מחדל, ההגדרה היא true.

    המסוף

    1. נכנסים לדף Organization policies במסוף Google Cloud :

      כניסה לדף Organization policies

    2. בכלי לבחירת פרויקטים, בוחרים את הארגון ואת הפרויקט שבהם רוצים להשבית את השימוש בחשבונות שירות בפרויקטים שונים.

    3. בוחרים את המדיניות disable cross-project service account usage.

    4. לוחצים על ניהול המדיניות.

    5. בקטע מקור המדיניות, בוחרים באפשרות במקום המדיניות של המשאב הראשי.

    6. לוחצים על Add a rule.

    7. בקטע אכיפה, לוחצים על השבתה.

    8. כדי לאכוף את המדיניות, לוחצים על הגדרת מדיניות.

    gcloud

    בפרויקט שבו נמצא חשבון השירות, מוודאים שהאילוץ iam.disableCrossProjectServiceAccountUsage של מדיניות הארגון לא נאכף. האילוץ הזה נאכף כברירת מחדל.

    כדי להשבית את אילוץ מדיניות הארגון הזה, מריצים את הפקודה:

    gcloud resource-manager org-policies disable-enforce iam.disableCrossProjectServiceAccountUsage
        --project=SERVICE_ACCOUNT_PROJECT_ID

    מחליפים את SERVICE_ACCOUNT_PROJECT_ID במזהה הפרויקט שמכיל את חשבון השירות.

אפשר להחיל חברויות בתפקידים ישירות על המשאב של חשבון השירות, או לרשת אותן מרמות גבוהות יותר בהיררכיית המשאבים.

המאמרים הבאים