אם הארכיטקטורה שלכם משתמשת בכמה שירותים, סביר להניח שתצטרכו להשתמש באמצעי אימות כדי לאפשר תקשורת בין השירותים. 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). איך מקצים תפקידים אם אתם מתכננים להשתמש בחשבון הזה כדי ליצור פרטי כניסה לטווח קצר, אתם צריכים גם להפעיל את IAM Service Account Credentials API.
תפקידים שנדרשים להפעלת ממשקי API
כדי להפעיל ממשקי API, נדרשת ההרשאה
serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד 'בעלים' (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד 'אדמין בממשק Service Usage' (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידיםכדי להשתמש בדוגמאות של שורת הפקודה במדריך הזה, צריך להתקין ולהגדיר את Google Cloud CLI.
מוודאים שיצרתם את חשבון השירות שבו אתם רוצים להשתמש. חובה ליצור את החשבון באותו Cloud de Confiance פרויקט שבו מריצים את הבנייה.
הרשאות IAM נדרשות
לחשבון השירות שצוין על ידי המשתמש צריכה להיות ההרשאה iam.serviceAccounts.getOpenIdToken.
- מקצים את התפקיד 'יצירת אסימון זהות' ב-OpenID Connect של חשבון שירות (
roles/iam.serviceAccountOpenIdTokenCreator) לחשבון השירות שצוין על ידי המשתמש בפרויקט שבו נוצר חשבון השירות.
הוראות להקצאת תפקידי 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.
הוראות נוספות ליצירה ולשימוש בטוקנים של מזהים בעומסי העבודה זמינות במאמר שיטות לקבלת טוקן של מזהה.