הגדרה של איחוד שירותי אימות הזהות של עומסי עבודה עם Kubernetes

איחוד שירותי אימות הזהות של עומסי עבודה מאפשר לעומסי עבודה ב-Azure Kubernetes Service ‏(AKS), ב-Amazon Elastic Kubernetes Service ‏(Amazon EKS) או באשכולות Kubernetes באירוח עצמי לבצע אימות ב- Google Cloud. ב-Kubernetes אפשר להגדיר אשכול כך שעומסי עבודה יוכלו לקבל אסימוני ServiceAccount של Kubernetes מנפח מוקרן. עומסי העבודה יכולים להחליף את האסימונים האלה בפרטי כניסה לטווח קצר כדי לגשת לממשקי ה-API שלGoogle Cloud בלי להשתמש במפתחות של חשבונות שירות.

לעומסי עבודה שפועלים ב-Google Kubernetes Engine ‏(GKE), השתמשו באיחוד זהויות של עומסי עבודה ל-GKE.

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

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

GKE

למשתמשי Google Kubernetes Engine ‏(GKE), קראו את המאמר אימות ל- Google Cloud APIs מעומסי עבודה ב-GKE.

AKS

מוודאים שהאשכול עומד בקריטריונים הבאים:

  • הפעלתם את התכונה מנפיק OIDC.

    אתם צריכים להפעיל את התכונה הזו כדי שאיחוד שירותי אימות הזהות של עומסי עבודה יוכל לגשת למטא-נתונים של OpenID Connect ול-JSON Web Key Set‏ (JWKS) של האשכול.

EKS

אתם לא צריכים לשנות את ההגדרות האישיות ב-EKS.

‏Kubernetes

מוודאים שהאשכול עומד בקריטריונים הבאים:

  • אתם משתמשים ב-Kubernetes מגרסה 1.20 ואילך.

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

  • הגדרתם את kube-apiserver כך שיתמוך בServiceAccount תחזיות של נפח טוקנים.

לא חייבת להיות גישה לאשכול דרך האינטרנט.

הגדרה של איחוד שירותי אימות הזהות של עומסי עבודה

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

כדי להתחיל בהגדרה של איחוד שירותי אימות הזהות של עומסי עבודה, מבצעים את הפעולות הבאות:

  1. בדף לבחירת הפרויקט במסוף Google Cloud , בוחרים פרויקט ב- Google Cloud או יוצרים אותו.

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

    • בחירת פרויקט: כדי לבחור פרויקט לא נדרש תפקיד IAM ספציפי – אתם יכולים לבחור כל פרויקט שקיבלתם בו תפקיד.
    • יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד "יצירת פרויקטים" (roles/resourcemanager.projectCreator), שכולל את ההרשאה resourcemanager.projects.create. איך מקצים תפקידים?

    כניסה לדף לבחירת הפרויקט

  2. מומלץ להשתמש בפרויקט ייעודי לניהול ספקים ומאגרי זהויות של עומסי עבודה.
  3. מוודאים שהחיוב מופעל בפרויקט ב- Google Cloud .

  4. מפעילים את ממשקי ה-API של IAM,‏ מנהל המשאבים,‏ פרטי כניסה לחשבון שירות ו-Security Token Service, אם הם עדיין לא מופעלים.

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

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

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

הגדרת מיפוי של מאפיין ותנאי

אסימוני ServiceAccount של Kubernetes מכילים כמה הצהרות, כולל:

  • ‫sub: מכיל את מרחב השמות ואת השם של ServiceAccount, לדוגמה system:serviceaccount:NAMESPACE:KSA_NAME, כאשר NAMESPACE הוא מרחב השמות של ServiceAccount ו-KSA_NAME הוא השם של ServiceAccount.
  • ‫"kubernetes.io".namespace: מכיל את מרחב השמות של ServiceAccount.
  • ‫"kubernetes.io".serviceaccount.name: מכיל את השם של חשבון השירות.
  • ‫"kubernetes.io".pod.name: מכיל את שם ה-Pod.

כדי להשתמש ב-sub בתור מזהה נושא (google.subject) ב- Google Cloud, משתמשים במיפוי הבא:

google.subject=assertion.sub

אפשר גם למפות מאפיינים נוספים (אופציונלי). לאחר מכן אפשר לקרוא למאפיינים האלה כשמקצים גישה למשאבים. לדוגמה:

google.subject=assertion.sub,
attribute.namespace=assertion['kubernetes.io']['namespace'],
attribute.service_account_name=assertion['kubernetes.io']['serviceaccount']['name'],
attribute.pod=assertion['kubernetes.io']['pod']['name']

אפשר גם להגדיר תנאי למאפיין. תנאים למאפיינים הם ביטויים ב-CEL שאפשר לבדוק בהם טענת נכוֹנוּת (assertion) ומאפייני יעד. אם התנאי למאפיין מקבל ערך של true לגבי פרטי כניסה מסוימים, הפרטים האלה מאושרים. אחרת, פרטי הכניסה נדחים.

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

assertion['kubernetes.io']['namespace'] in ['backend', 'monitoring']

יצירה של ספק ומאגר זהויות של עומסי עבודה

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

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

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

יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.

לחלופין, התפקיד הבסיסי ב-IAM 'בעלים' (roles/owner) כולל גם הרשאות להגדרה של איחוד זהויות. בסביבת ייצור לא מומלץ להקצות תפקידים בסיסיים, אבל אפשר להעניק אותם בסביבת פיתוח או בסביבת בדיקה.

כדי ליצור מאגר זהויות של עומסי עבודה וספק, בצעו את הפעולות הבאות:

AKS

  1. מאתרים את כתובת ה-URL של המנפיק של אשכול ה-AKS:

    az aks show -n NAME -g RESOURCE_GROUP --query "oidcIssuerProfile.issuerUrl" -otsv
    

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

    • ‫NAME: שם האשכול
    • ‫RESOURCE_GROUP: קבוצת המשאבים של האשכול

    פלט הפקודה מציג את כתובת ה-URL של המנפיק. תצטרכו את כתובת ה-URL של המנפיק באחד מהשלבים הבאים.

    אם הפקודה לא מחזירה כתובת URL של מנפיק, ודאו שהפעלתם את התכונה מנפיק OIDC.

  2. יצירת מאגר זהויות חדש של עומסי עבודה:

    gcloud iam workload-identity-pools create POOL_ID \
        --location="global" \
        --description="DESCRIPTION" \
        --display-name="DISPLAY_NAME"
    

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

    • ‫POOL_ID: המזהה הייחודי של המאגר.
    • ‫DISPLAY_NAME: שם המאגר.
    • DESCRIPTION: תיאור של המאגר שנבחר. התיאור הזה מופיע כשנותנים גישה לזהויות במאגר.
  3. מוסיפים את אשכול ה-AKS כספק של מאגר זהויות של עומסי עבודה:

    gcloud iam workload-identity-pools providers create-oidc WORKLOAD_PROVIDER_ID \
        --location="global" \
        --workload-identity-pool="POOL_ID" \
        --issuer-uri="ISSUER" \
        --attribute-mapping="MAPPINGS" \
        --attribute-condition="CONDITIONS"
    

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

    • WORKLOAD_PROVIDER_ID: מזהה ייחודי לפי בחירתך של מאגר זהויות של כוח עבודה.
    • ‫POOL_ID: מזהה מאגר הזהויות של עומסי העבודה שיצרתם קודם.
    • ‫ISSUER: ה-URI של המנפיק שקבעתם קודם.
    • MAPPINGS: רשימה מופרדת בפסיקים של מיפויי המאפיינים שיצרת קודם לכן במדריך הזה.
    • CONDITIONS: תנאי למאפיין אפשרי שיצרת מוקדם יותר במדריך הזה. אפשר להסיר את הפרמטר אם אין לך תנאי למאפיין.

EKS

  1. מאתרים את כתובת ה-URL של המנפיק של אשכול ה-EKS:

    aws eks describe-cluster --name NAME --query "cluster.identity.oidc.issuer" --output text
    

    מחליפים את NAME בשם האשכול.

    פלט הפקודה מציג את כתובת ה-URL של המנפיק. תצטרכו את כתובת ה-URL של המנפיק באחד מהשלבים הבאים.

  2. יצירת מאגר זהויות חדש של עומסי עבודה:

    gcloud iam workload-identity-pools create POOL_ID \
        --location="global" \
        --description="DESCRIPTION" \
        --display-name="DISPLAY_NAME"
    

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

    • ‫POOL_ID: המזהה הייחודי של המאגר.
    • ‫DISPLAY_NAME: שם המאגר.
    • DESCRIPTION: תיאור של המאגר שנבחר. התיאור הזה מופיע כשנותנים גישה לזהויות במאגר.
  3. מוסיפים את אשכול ה-EKS כספק של מאגר זהויות של עומסי עבודה:

    gcloud iam workload-identity-pools providers create-oidc WORKLOAD_PROVIDER_ID \
        --location="global" \
        --workload-identity-pool="POOL_ID" \
        --issuer-uri="ISSUER" \
        --attribute-mapping="MAPPINGS" \
        --attribute-condition="CONDITIONS"
    

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

    • WORKLOAD_PROVIDER_ID: מזהה ייחודי לפי בחירתך של מאגר זהויות של כוח עבודה.
    • ‫POOL_ID: מזהה מאגר הזהויות של עומסי העבודה שיצרתם קודם.
    • ‫ISSUER: ה-URI של המנפיק שקבעתם קודם.
    • MAPPINGS: רשימה מופרדת בפסיקים של מיפויי המאפיינים שיצרת קודם לכן במדריך הזה.
    • CONDITIONS: תנאי למאפיין אפשרי שיצרת מוקדם יותר במדריך הזה. אפשר להסיר את הפרמטר אם אין לך תנאי למאפיין.

‏Kubernetes

  1. מתחברים לאשכול Kubernetes ומשתמשים ב-kubectl כדי לקבוע את כתובת ה-URL של מנפיק האשכול:

    kubectl get --raw /.well-known/openid-configuration | jq -r .issuer
    

    תצטרכו את כתובת ה-URL של המנפיק באחד מהשלבים הבאים.

  2. מורידים את ה-JSON Web Key Set‏ (JWKS) של האשכול:

    kubectl get --raw /openid/v1/jwks > cluster-jwks.json
    

    באחד מהשלבים הבאים, תעלו את ה-JWKS כדי שאיחוד שירותי אימות הזהות של עומסי עבודה יוכל לאמת את האותנטיות של אסימוני Kubernetes ServiceAccount שהונפקו על ידי האשכול שלכם.

  3. יצירת מאגר זהויות חדש של עומסי עבודה:

    gcloud iam workload-identity-pools create POOL_ID \
        --location="global" \
        --description="DESCRIPTION" \
        --display-name="DISPLAY_NAME"
    

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

    • ‫POOL_ID: המזהה הייחודי של המאגר.
    • ‫DISPLAY_NAME: שם המאגר.
    • DESCRIPTION: תיאור של המאגר שנבחר. התיאור הזה מופיע כשנותנים גישה לזהויות במאגר.
  4. מוסיפים את אשכול Kubernetes כספק של מאגר זהויות של עומסי עבודה ומעלים את ה-JWKS של האשכול:

    gcloud iam workload-identity-pools providers create-oidc WORKLOAD_PROVIDER_ID \
        --location="global" \
        --workload-identity-pool="POOL_ID" \
        --issuer-uri="ISSUER" \
        --attribute-mapping="MAPPINGS" \
        --attribute-condition="CONDITIONS" \
        --jwk-json-path="cluster-jwks.json"
    

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

    • ‫WORKLOAD_PROVIDER_ID: מזינים מזהה ייחודי לספק מאגר הזהויות של עומסי העבודה.
    • ‫POOL_ID: מזהה מאגר הזהויות של עומסי העבודה שיצרתם קודם.
    • ‫ISSUER: ה-URI של המנפיק שקבעתם קודם.
    • MAPPINGS: רשימה מופרדת בפסיקים של מיפויי המאפיינים שיצרת קודם לכן במדריך הזה.
    • CONDITIONS: תנאי למאפיין אפשרי שיצרת מוקדם יותר במדריך הזה. אפשר להסיר את הפרמטר אם אין לך תנאי למאפיין.

מתן גישה לעומס עבודה ב-Kubernetes

בקטע הזה מוסבר איך להגדיר עומס עבודה ב-Kubernetes כדי לגשת לממשקי API שלGoogle Cloud באמצעות גישה ישירה למשאבים של איחוד שירותי אימות הזהות של עומסי עבודה או התחזות לחשבון שירות.

צריך לבצע את השלבים האלה פעם אחת לכל עומס עבודה ב-Kubernetes שצריך גישה אל Google Cloud.

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

אם לשיטות שבהן אתם משתמשים בעומס העבודה יש מגבלות כאלה, אתם יכולים להשתמש בהתחזות ב-IAM.

שימוש באיחוד שירותי אימות הזהות של עומסי עבודה כדי לתת גישה ישירה למשאבים

בקטע הזה תשתמשו באיחוד שירותי אימות הזהות של עומסי עבודה כדי להקצות תפקיד IAM ל-ServiceAccount של Kubernetes, כדי שתהיה לו גישה ישירה למשאבי Google Cloud .

כדי ליצור חשבון שירות של Kubernetes ולהקצות לו תפקיד:

  1. יוצרים Kubernetes ServiceAccount:

    kubectl create serviceaccount KSA_NAME --namespace NAMESPACE
    

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

    • ‫KSA_NAME: שם לחשבון השירות.
    • ‫NAMESPACE: מרחב השמות שבו יוצרים את ServiceAccount.
  2. נותנים גישה ב-IAM ל-Kubernetes ServiceAccount למשאבGoogle Cloud .

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

    בדוגמה הבאה, הפקודה מקצה את התפקיד צפייה באשכולות של Kubernetes Engine (roles/container.clusterViewer) לחשבון השירות שיצרתם. הפקודה משתמשת בנושא שמיפיתם קודם לכן במסמך הזה.

    gcloud projects add-iam-policy-binding projects/PROJECT_ID \
        --role=roles/container.clusterViewer \
        --member=principal://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/subject/MAPPED_SUBJECT \
        --condition=None
    

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

    • ‫PROJECT_ID: המזהה של הפרויקט ב- Google Cloudשרוצים לתת לו גישה.
    • ‫PROJECT_NUMBER: מספר הפרויקט שמכיל את מאגר הזהויות של עומסי העבודה.
    • ‫POOL_ID: המזהה של מאגר הזהויות של עומסי העבודה.
    • ‫MAPPED_SUBJECT: חשבון השירות של Kubernetes מההצהרה בטוקן של מזהה שמיפיתם ל-google.subject. לדוגמה, אם מיפיתם את google.subject=assertion.sub והטוקן של המזהה מכיל את "sub": "system:serviceaccount:default:my-kubernetes-serviceaccount", אז MAPPED_SUBJECT הוא system:serviceaccount:default:my-kubernetes-serviceaccount.

    אפשר להקצות תפקידים בכל משאב של Google Cloud שתומך במדיניות הרשאות של IAM. התחביר של מזהה חשבון המשתמש תלוי במשאב ב-Kubernetes. רשימת המזהים הנתמכים מופיעה במאמר מזהים של חשבונות משתמשים לאיחוד זהויות של עומסי עבודה ל-GKE.

עכשיו אפשר לפרוס עומס עבודה שמשתמש ב-ServiceAccount של Kubernetes כדי לגשת למשאבי Google Cloud שנתתם להם גישה.

חלופה: שימוש בהתחזות לחשבון שירות ב-IAM כדי לתת גישה

כדי להגדיר את Kubernetes ServiceAccount כך שיבצע התחזות לחשבון שירות של IAM, בצעו את הפעולות הבאות:

  1. אם עדיין לא עשיתם זאת, צרו חשבון שירות של Kubernetes:

    kubectl create serviceaccount KSA_NAME --namespace NAMESPACE
    

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

    • ‫KSA_NAME: שם לחשבון השירות.
    • ‫NAMESPACE: מרחב השמות שבו רוצים ליצור את ServiceAccount.
  2. יוצרים חשבון שירות ב-IAM שמייצג את עומס העבודה.

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

    gcloud iam service-accounts create IAM_SA_NAME \
        --project=IAM_SA_PROJECT_ID
    

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

    • ‫IAM_SA_NAME: השם של חשבון השירות.
    • ‫IAM_SA_PROJECT_ID: מזהה הפרויקט של חשבון השירות.
  3. נותנים לחשבון השירות ב-IAM גישה למשאבי Google Cloud הספציפיים שרוצים שעומס העבודה ב-Kubernetes יוכל לגשת אליהם.

    gcloud projects add-iam-policy-binding IAM_SA_PROJECT_ID \
        --member="serviceAccount:IAM_SA_NAME@IAM_SA_PROJECT_ID.iam.gserviceaccount.com" \
        --role="ROLE"
    

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

    • ‫IAM_SA_PROJECT_ID: מזהה הפרויקט שבו יצרתם את חשבון השירות.
    • ‫IAM_SA_NAME: השם של חשבון השירות.
    • ‫ROLE: שם התפקיד שרוצים לתת, למשל roles/container.clusterViewer.
  4. נותנים ל-Kubernetes ServiceAccount הרשאה להתחזות לחשבון השירות של IAM:

    gcloud iam service-accounts add-iam-policy-binding \
      IAM_SA_NAME@IAM_SA_PROJECT_ID.iam.gserviceaccount.com \
        --member="principal://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/subject/MAPPED_SUBJECT" \
        --role=roles/iam.workloadIdentityUser
    
    

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

    • ‫IAM_SA_NAME: השם של חשבון השירות.
    • ‫IAM_SA_PROJECT_ID: מזהה הפרויקט שבו יצרתם את חשבון השירות.
    • ‫PROJECT_NUMBER: מספר הפרויקט שמכיל את מאגר הזהויות של עומסי העבודה.
    • ‫POOL_ID: המזהה של מאגר הזהויות של עומסי העבודה.
    • ‫MAPPED_SUBJECT: חשבון השירות של Kubernetes מההצהרה בטוקן של מזהה שמיפיתם ל-google.subject. לדוגמה, אם מיפיתם את google.subject=assertion.sub והטוקן של המזהה מכיל את "sub": "system:serviceaccount:default:my-kubernetes-serviceaccount", אז MAPPED_SUBJECT הוא system:serviceaccount:default:my-kubernetes-serviceaccount.

    במאמר הסבר על חשבונות שירות מוסבר איך נותנים לחשבונות שירות ב-IAM הרשאת גישה לממשקי API שלGoogle Cloud .

עכשיו אפשר לפרוס עומס עבודה שמשתמש בחשבון השירות של Kubernetes ובחשבון השירות של IAM כדי לגשת למשאבי Google Cloudשנתתם להם גישה.

פריסת עומס העבודה ב-Kubernetes

כדי לפרוס עומס עבודה ב-Kubernetes שיכול לגשת למשאבי Google Cloud , מבצעים את הפעולות הבאות:

  1. יוצרים קובץ תצורה של פרטי הכניסה:

    gcloud iam workload-identity-pools create-cred-config \
        projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/WORKLOAD_PROVIDER_ID \
        --service-account=SERVICE_ACCOUNT_EMAIL \
        --credential-source-file=/var/run/service-account/token \
        --credential-source-type=text \
        --sts-location=REGION \
        --output-file=credential-configuration.json

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

    • ‫PROJECT_NUMBER: מספר הפרויקט שמכיל את מאגר הזהויות של עומסי העבודה
    • ‫POOL_ID: המזהה של מאגר הזהויות של עומסי העבודה
    • ‫WORKLOAD_PROVIDER_ID: מזהה הספק של מאגר הזהויות של עומסי העבודה
    • ‫SERVICE_ACCOUNT_EMAIL: כתובת האימייל של חשבון השירות, אם הגדרתם את Kubernetes ServiceAccount כך שישתמש בהתחזות לחשבון שירות של IAM. אם הגדרתם את Kubernetes ServiceAccount לשימוש בגישה ישירה למשאבים, אל תשתמשו בדגל הזה.
    • ‫REGION: אופציונלי. מציינים את האזור של נקודות הקצה האזוריות של Security Token Service, אם הן זמינות.

    קובץ הגדרת פרטי הכניסה מאפשר לספריות הלקוח ב-Cloud, ל-CLI של gcloud ול-Terraform לקבוע את הפרטים הבאים:

    • המקור שממנו משיגים פרטי כניסה חיצוניים
    • מאגר זהויות של עומסי עבודה וספק שבהם צריך להשתמש
    • חשבון השירות שצריך להתחזות אליו
  2. מייבאים את קובץ התצורה של פרטי הכניסה בתור ConfigMap

    kubectl create configmap CONFIGMAP_NAME \
      --from-file credential-configuration.json \
      --namespace NAMESPACE
    

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

    • ‫CONFIGMAP_NAME: השם של ConfigMap.
    • ‫NAMESPACE: מרחב השמות שבו יוצרים את ה-ConfigMap.
  3. פורסים עומס עבודה ומאפשרים לו להשתמש ב-ServiceAccount וב-ConfigMap של Kubernetes.

    יוצרים מניפסט ומגדירים אותו באופן הבא:

    • טוענים נפח אסימונים חזוי כדי שעומס העבודה יוכל לקבל אסימון Kubernetes ServiceAccount מקובץ מקומי. מגדירים את אמצעי האחסון כך שאסימון ServiceAccount של Kubernetes ישתמש בקהל שצפוי על ידי הספק של מאגר הזהויות של עומסי העבודה.
    • טוענים את ה-ConfigMap שמכיל את קובץ התצורה של פרטי הכניסה, כדי שעומס העבודה יוכל לגשת לתצורה שנדרשת לשימוש באיחוד שירותי אימות הזהות של עומסי עבודה.
    • מוסיפים משתנה סביבה GOOGLE_APPLICATION_CREDENTIALS שמכיל את הנתיב של קובץ התצורה של פרטי הכניסה, כדי שעומסי העבודה יוכלו למצוא את הקובץ.

    הדוגמה הבאה היא מניפסט שמשתמש ב-ServiceAccount וב-ConfigMap של Kubernetes כדי לאפשר ל-Google Cloud CLI לבצע אימות ב- Google Cloud:

    apiVersion: v1
    kind: Pod
    metadata:
      name: example
      namespace: NAMESPACE
    spec:
      containers:
      - name: example
        image: google/cloud-sdk:alpine
        command: ["/bin/sh", "-c", "gcloud auth login --cred-file $GOOGLE_APPLICATION_CREDENTIALS && gcloud auth list && sleep 600"]
        volumeMounts:
        - name: token
          mountPath: "/var/run/service-account"
          readOnly: true
        - name: workload-identity-credential-configuration
          mountPath: "/etc/workload-identity"
          readOnly: true
        env:
        - name: GOOGLE_APPLICATION_CREDENTIALS
          value: "/etc/workload-identity/credential-configuration.json"
    
      serviceAccountName: KSA_NAME
      volumes:
      - name: token
        projected:
          sources:
          - serviceAccountToken:
              audience: https://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/WORKLOAD_PROVIDER_ID
              expirationSeconds: 3600
              path: token
      - name: workload-identity-credential-configuration
        configMap:
          name: CONFIGMAP_NAME

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

    C++‎

    ספריות הלקוח שלGoogle Cloud ל-C++‎ תומכות באיחוד שירותי אימות הזהות של עומסי עבודה החל מגרסה v2.6.0. כדי להשתמש באיחוד שירותי אימות הזהות של עומסי עבודה, צריך ליצור את ספריות הלקוח בגרסה 1.36.0 ואילך של gRPC.

    המשך

    ספריות לקוח ל-Go תומכות באיחוד שירותי אימות הזהות של עומסי עבודה אם נעשה בהן שימוש במודול golang.org/x/oauth2 בגרסה 00.0.0-20210218202405-ba52d332ba99 ואילך.

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

    cd $GOPATH/src/cloud.google.com/go
    go list -m golang.org/x/oauth2
    

    Java

    בספריות לקוח ל-Java יש תמיכה באיחוד שירותי אימות הזהות של עומסי עבודה, אם נעשה בהן שימוש בארטיפקט com.google.auth:google-auth-library-oauth2-http בגרסה 0.24.0 ואילך.

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

    mvn dependency:list -DincludeArtifactIds=google-auth-library-oauth2-http
    

    Node.js

    בספריות לקוח ל-Node.js יש תמיכה באיחוד שירותי אימות הזהות של עומסי עבודה אם נעשה בהן שימוש בחבילת google-auth-library בגרסת 7.0.2 ואילך.

    כדי לבדוק באיזו גרסה של החבילה הזאת נעשה שימוש בספריית הלקוח, בספרייה של האפליקציה מפעילים את פקודת Maven הזאת:

    npm list google-auth-library
    

    כשיוצרים אובייקט GoogleAuth, אפשר לציין מזהה פרויקט או לאפשר ל-GoogleAuth לאתר את מזהה הפרויקט באופן אוטומטי. כדי לאתר את מזהה הפרויקט באופן אוטומטי, צריך להקצות לחשבון השירות בקובץ התצורה את התפקיד דפדפן (roles/browser) או תפקיד עם הרשאות דומות בפרויקט. לפרטים נוספים, ראו README לחבילת google-auth-library.

    Python

    בספריות לקוח ל-Python יש תמיכה באיחוד שירותי אימות הזהות של עומסי עבודה אם נעשה בהן שימוש בחבילת google-auth בגרסת 1.27.0 ואילך.

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

    pip show google-auth
    

    כדי לציין מזהה פרויקט ללקוח האימות, תוכלו להגדיר את משתנה הסביבה GOOGLE_CLOUD_PROJECT או לאפשר ללקוח למצוא את מזהה הפרויקט באופן אוטומטי. כדי לאתר את מזהה הפרויקט באופן אוטומטי, צריך להקצות לחשבון השירות בקובץ התצורה את התפקיד דפדפן (roles/browser) או תפקיד עם הרשאות דומות בפרויקט. לפרטים נוספים, ראו מדריך למשתמש לחבילת google-auth.

    gcloud

    כדי לבצע אימות באמצעות איחוד שירותי אימות הזהות של עומסי עבודה, משתמשים בפקודה gcloud auth login:

    gcloud auth login --cred-file=FILEPATH.json
    

    מחליפים את הערך FILEPATH בנתיב לקובץ התצורה של פרטי הכניסה.

    ב-CLI של gcloud יש תמיכה באיחוד שירותי אימות הזהות של עומסי עבודה ב-CLI של gcloud בגרסה 363.0.0 ואילך.

    Terraform

    יש תמיכה באיחוד שירותי אימות הזהות של עומסי עבודה אם משתמשים בספקGoogle Cloud בגרסה 3.61.0 ואילך:

    terraform {
      required_providers {
        google = {
          source  = "hashicorp/google"
          version = "~> 3.61.0"
        }
      }
    }
    

    BQ

    כדי לבצע אימות באמצעות איחוד שירותי אימות הזהות של עומסי עבודה, משתמשים בפקודה gcloud auth login:

    gcloud auth login --cred-file=FILEPATH.json
    

    מחליפים את הערך FILEPATH בנתיב לקובץ התצורה של פרטי הכניסה.

    ב-bq, יש תמיכה באיחוד שירותי אימות הזהות של עומסי עבודה ב-CLI של gcloud בגרסה 390.0.0 ואילך.

  4. כדי לוודא שהאימות פועל כמו שצריך, מריצים את הפקודה הבאה:

    kubectl exec example --namespace NAMESPACE -- gcloud auth print-access-token

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