אישור גישה משירות לשירות

אם הארכיטקטורה שלכם משתמשת בכמה שירותים, סביר להניח שתצטרכו להשתמש באמצעי אימות כדי לאפשר תקשורת בין השירותים. ‫Cloud Build מספק תמיכה מובנית בתקן OpenID Connect‏ (OIDC) לאימות והרשאה מאובטחים בין שירותים.

אפשר להשתמש ב-Cloud Build כדי ליצור אסימונים מזהים. באמצעות האסימונים האלה, אפשר להתקשר לנקודות קצה מאובטחות מתוך Cloud Build.

לדוגמה, אם אתם מריצים אפליקציה בפלטפורמה בלי שרת כמו פונקציות Cloud Run,‏ Cloud Run או App Engine, אתם יכולים לקיים אינטראקציה מאובטחת עם האפליקציה מתוך עומסי עבודה של Cloud Build.

לפני שמתחילים

  • מפעילים את Cloud Build API ואת IAM API, אם הם עדיין לא מופעלים.

    תפקידים שנדרשים להפעלת ממשקי API

    כדי להפעיל ממשקי API, נדרשת ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד 'בעלים' (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד 'אדמין בממשק Service Usage' (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים

    הפעלת ממשקי ה-API

  • אם אתם מתכננים להשתמש בחשבון הזה כדי ליצור פרטי כניסה לטווח קצר, אתם צריכים גם להפעיל את IAM Service Account Credentials API.

    תפקידים שנדרשים להפעלת ממשקי API

    כדי להפעיל ממשקי API, נדרשת ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד 'בעלים' (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד 'אדמין בממשק Service Usage' (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים

    להפעלת ה-API

  • כדי להשתמש בדוגמאות של שורת הפקודה במדריך הזה, צריך להתקין ולהגדיר את Google Cloud CLI.

  • מוודאים שיצרתם את חשבון השירות שבו אתם רוצים להשתמש. חובה ליצור את החשבון באותו Cloud de Confiance פרויקט שבו מריצים את הבנייה.

הרשאות IAM נדרשות

לחשבון השירות שצוין על ידי המשתמש צריכה להיות ההרשאה iam.serviceAccounts.getOpenIdToken.

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

שיטות לקבלת טוקן של מזהה

יש שתי דרכים להגדיר את שלבי ה-build כדי לקבל אסימוני מזהה:

  • שימוש ב-CLI של gcloud
  • שליחת בקשה ישירה לשרת המטא-נתונים

קבלת טוקן של מזהה באמצעות gcloud

בקטע הזה, קטע הקוד הבא מדגים איך להשתמש ב-CLI של gcloud כדי לקבל טוקנים של מזהים:

YAML

steps:

- name: 'gcr.io/cloud-builders/gcloud'
  script: 'gcloud auth print-identity-token --audiences ${_TOKEN_AUDIENCE} > /workspace/identity_token.txt'
  env:
  - _TOKEN_AUDIENCE=${_TOKEN_AUDIENCE}
service_account: '$_SERVICE_ACCOUNT'
substitutions:
  _TOKEN_AUDIENCE: 'TOKEN_AUDIENCE'
  _SERVICE_ACCOUNT_ID: 'SERVICE_ACCOUNT_ID'
  _SERVICE_ACCOUNT: 'projects/${PROJECT_ID}/serviceAccounts/${_SERVICE_ACCOUNT_ID}'
logsBucket: 'LOGS_BUCKET_LOCATION'
options:
  logging: GCS_ONLY
  dynamic_substitutions: true

JSON

{
  "steps": [
      {
          "name": "gcr.io/cloud-builders/gcloud",
          "script": "gcloud auth print-identity-token --audiences ${_TOKEN_AUDIENCE} > /workspace/identity_token.txt"
          "env": [
              "_TOKEN_AUDIENCE=${_TOKEN_AUDIENCE}"
          ]
      }
  ],
  "service_account": "$_SERVICE_ACCOUNT",
  "substitutions": {
      "_TOKEN_AUDIENCE": "TOKEN_AUDIENCE",
      "_SERVICE_ACCOUNT_ID": "SERVICE_ACCOUNT_ID",
      "_SERVICE_ACCOUNT": "projects/${PROJECT_ID}/serviceAccounts/${_SERVICE_ACCOUNT_ID}"
  },
  "logsBucket": "LOGS_BUCKET_LOCATION",
  "options": {
      "logging": "GCS_ONLY",
      "dynamic_substitutions": true
  }
}

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

  • ‫TOKEN_AUDIENCE היא כתובת ה-URL או קהל היעד שאליו רוצים לקבל את האסימון המזהה, כמו http://www.example.com.
  • ‫SERVICE_ACCOUNT_ID היא כתובת האימייל או המזהה הייחודי של חשבון השירות שצוין על ידי המשתמש. לדוגמה, service-account-name@project-id.s3ns.iam.gserviceaccount.com.
  • ‫LOGS_BUCKET_LOCATION היא הקטגוריה של Cloud Storage שבה מאוחסנים יומני הבנייה. לדוגמה, gs://mylogsbucket.

שליחת בקשה ישירה לשרת המטא-נתונים

בקטע הזה, קטע הקוד הבא מדגים איך לשלוח בקשה ישירה לשרת המטא-נתונים כדי לקבל אסימוני מזהה:

YAML

steps:
- name: 'gcr.io/cloud-builders/curl'
  id: 'printTokenFromCurl'
  script: |
    curl -H 'Metadata-Flavor: Google' http://metadata/computeMetadata/v1/instance/service-accounts/default/identity?audience=${_TOKEN_AUDIENCE} -o /workspace/identity_token.txt
  env:
  - _TOKEN_AUDIENCE=${_TOKEN_AUDIENCE}
service_account: '$_SERVICE_ACCOUNT'
substitutions:
  _TOKEN_AUDIENCE: 'TOKEN_AUDIENCE'
  _SERVICE_ACCOUNT_ID: 'SERVICE_ACCOUNT_ID'
  _SERVICE_ACCOUNT: 'projects/${PROJECT_ID}/serviceAccounts/${_SERVICE_ACCOUNT_ID}'
logsBucket: 'LOGS_BUCKET_LOCATION'
options:
  logging: GCS_ONLY
  dynamic_substitutions: true

JSON

{
  "steps": [
      {
          "name": "gcr.io/cloud-builders/curl",
          "id": "printTokenFromCurl"
          "script": "curl -H 'Metadata-Flavor: Google' http://metadata/computeMetadata/v1/instance/service-accounts/default/identity?audience=${_TOKEN_AUDIENCE} -o /workspace/identity_token.txt"
          "env":
              "_TOKEN_AUDIENCE=${_TOKEN_AUDIENCE}"
      }
  ],
  "service_account": "$_SERVICE_ACCOUNT",
  "substitutions": {
      "_TOKEN_AUDIENCE": "TOKEN_AUDIENCE",
      "_SERVICE_ACCOUNT_ID": "SERVICE_ACCOUNT_ID",
      "_SERVICE_ACCOUNT": "projects/${PROJECT_ID}/serviceAccounts/${_SERVICE_ACCOUNT_ID}"
  },
  "logsBucket": "LOGS_BUCKET_LOCATION",
  "options": {
      "logging": "GCS_ONLY",
      "dynamic_substitutions": true
  }
}

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

  • ‫TOKEN_AUDIENCE היא כתובת ה-URL או קהל היעד שאליו רוצים לקבל את האסימון המזהה, כמו http://www.example.com.
  • ‫SERVICE_ACCOUNT_ID היא כתובת האימייל או המזהה הייחודי של חשבון השירות שצוין על ידי המשתמש. לדוגמה, service-account-name@project-id.s3ns.iam.gserviceaccount.com.
  • ‫LOGS_BUCKET_LOCATION היא הקטגוריה של Cloud Storage שבה יאוחסנו יומני הבנייה. לדוגמה, gs://mylogsbucket.

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

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