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

איחוד שירותי אימות הזהות של כוח עבודה מאפשר לכם להשתמש ב-PingFederate כספק זהויות (IdP) כדי לאמת את כוח העבודה שלכם ב- Google Cloud. אחרי שמגדירים את השילוב של Security Assertion Markup Language (SAML) 2.0, משתמשים מאוחדים יכולים להיכנס לשירותי Google Cloud שתומכים באיחוד שירותי אימות הזהות של כוח העבודה.

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

  1. מוודאים שהגדרתם ארגון ב- Google Cloud .
  2. התקינו את ה-CLI של Google Cloud. אחר כך, אתחלו את ה-CLI של Google Cloud באמצעות הפקודה הבאה:

    gcloud init

    אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

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

עלויות

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

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

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

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

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

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

gcloud

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

gcloud iam workforce-pools create WORKFORCE_POOL_ID \
    --organization=ORGANIZATION_ID \
    --display-name="DISPLAY_NAME" \
    --description="DESCRIPTION" \
    --session-duration=SESSION_DURATION \
    --location=global

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

  • ‫WORKFORCE_POOL_ID: המזהה שבחרתם כדי לייצג את מאגר כוח העבודה ב- Google Cloud . מזהה המאגר חייב להיות ייחודי באופן גלובלי בכל מאגרי הזהויות של כוח העבודה ב- Google Cloud. מידע על הפורמט של המזהה מופיע בקטע פרמטרים של שאילתה במאמרי העזרה של ה-API.
  • ‫ORGANIZATION_ID: מזהה הארגון (מספרי) של הארגון ב- Google Cloud למאגר הזהויות של כוח העבודה. מאגרי הזהויות של כוח העבודה זמינים בכל הפרויקטים והתיקיות בארגון.
  • ‫DISPLAY_NAME: אופציונלי. שם לתצוגה של מאגר הזהויות של כוח העבודה.
  • ‫DESCRIPTION: אופציונלי. תיאור של מאגר זהויות של כוח עבודה.
  • ‫SESSION_DURATION: אופציונלי. משך הסשן, מיוצג כמספר שאחריו מופיע s – לדוגמה, 3600s. משך הסשן קובע לכמה זמן יהיו פעילים Google Cloud אסימוני הגישה, המסוף (איחוד), החיבור לסשן והחיבור ל-CLI של gcloud מהמאגר של כוח העבודה. משך הסשן שמוגדר כברירת מחדל הוא שעה (3,600 שניות). משך הסשן צריך להיות בין 15 דקות (900 שניות) ל-12 שעות (43,200 שניות).

המסוף

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

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

    כניסה לדף Workforce Identity Pools

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

  3. לוחצים על Create pool ומבצעים את הפעולות הבאות:

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

    2. אופציונלי: בשדה Description, מזינים תיאור של המאגר.

    3. כדי ליצור את מאגר הזהויות של כוח העבודה, לוחצים על Next.

משך הסשן של מאגר הזהויות של כוח העבודה מוגדר כברירת מחדל לשעה אחת (3,600 שניות). משך הסשן קובע לכמה זמן יהיו פעילים אסימוני הגישה ל- Google Cloud , המסוף (איחוד), החיבור לסשן והחיבור ל-CLI של gcloud מהמאגר של כוח העבודה. אחרי שיוצרים את המאגר, אפשר לעדכן את המאגר כדי להגדיר משך סשן בהתאמה אישית. משך הסשן צריך להיות בין 15 דקות (900 שניות) ל-12 שעות (43,200 שניות).

יצירת אפליקציית PingFederate

בקטע הזה מוסבר איך ליצור Application Integration של PingFederate.

כדי להגדיר אפליקציית PingFederate שמשתמשת בפרוטוקול SAML 2.0, מבצעים את הפעולות הבאות ב-PingFederate:

  1. מגדירים את מזהה הישות ב-SAML 2.0 של ה-IdP ב-PingFederate. פרטים נוספים זמינים במאמר ציון פרטי איחוד.
  2. יוצרים חיבור SAML 2.0 SP, מעיינים בקטע בחירת סוג חיבור SP ומבצעים את הפעולות הבאות:

    1. בקטע Connection Type, בוחרים את Browser SSO Profiles ואת SAML 2.0 protocol.
    2. בקטע ייבוא מטא-נתונים, בוחרים באפשרות ללא.
  3. בקטע General Info, מגדירים את מזהה ישות ב-SAML של השותף (מזהה חיבור) לערך הבא:

    https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
    
  4. בקטע פרופילי SAML, מפעילים את האפשרות SSO ביוזמת ספק השירות. אם אתם מתכננים להשתמש גם בכניסה יחידה (SSO) בהפעלת IdP, אתם יכולים להפעיל גם אותה.

  5. ב-Attribute Contract (חוזה מאפיינים), מגדירים מאפיינים מותאמים אישית (לדוגמה, אימייל וקבוצות) שיועברו בטענת הנכוֹנוּת (assertion). אפשר להשתמש במאפיינים האלה ב- Google Cloud כדי ליצור כללי מדיניות לניהול הרשאות גישה בהמשך.

  6. בקטע Attribute Contract Fulfillment, מוודאים שהמאפיין SAML_SUBJECT ממופה לשדה עם ערך ייחודי לכל משתמש. לדוגמה, כתובת אימייל היא בדרך כלל ייחודית לכל משתמש, לא משתנה, ולעיתים קרובות משמשת כדי להתייחס למשתמש ספציפי במדיניות ניהול הרשאות גישה של Google Cloud .

  7. כדי להגדיר כניסה למסוף (מאוחד), מוסיפים את כתובת ה-URL הבאה של נקודת הקצה בשדה Assertion Consumer Service URL:

    https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
    

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

    • ‫WORKFORCE_POOL_ID: המזהה של מאגר כוח העבודה שיצרתם קודם.
    • ‫WORKFORCE_PROVIDER_ID: המזהה של ספק כוח העבודה שתיצרו בהמשך.
  8. מגדירים את Binding של נקודת הקצה הזו ל-POST.

  9. כדי לאפשר כניסה לחשבון במסוף (איחוד), בקטע Allowable SAML Bindings בוחרים באפשרות Redirect.

  10. בקטע Signature Policy, בוחרים באפשרות Sign Response As Required.

  11. שומרים ומפעילים את החיבור.

שימוש במאפיינים

בקטע הזה מוסבר איך להשתמש במאפיינים מטענת הנכונוּת (assertion) של SAML.

משתמשים בחוזי מאפיינים כדי לציין את המאפיינים המותאמים אישית בטענות הנכונות (assertions) של SAML שנוצרו. אחרי שמגדירים מאפיינים, אפשר להשתמש בהם ב- Google Cloud כדי ליצור כללי מדיניות לניהול הרשאות גישה. למידע נוסף על חוזי מאפיינים, קראו את המאמר חוזי מאפיינים במסמכי התיעוד של שרת PingFederate.

לדוגמה, במדריך הזה אנחנו משתמשים ב-PingOne כמאגר הנתונים של PingFederate וממפים את חוזי המאפיינים email,‏ firstName ו-groups באמצעות מאפייני המשתמש ממאגר הנתונים של PingOne, באופן הבא:

חוזה מאפיינים ערך
email email
firstName name.given
groups memberOfGroupIDs

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

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

יצירת ספק של מאגר זהויות של כוח עבודה ב-SAML 2.0

  1. כדי להגדיר את אפליקציית ה-SAML:

    gcloud

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

    gcloud iam workforce-pools providers create-saml WORKFORCE_PROVIDER_ID \
        --workforce-pool="WORKFORCE_POOL_ID" \
        --display-name="DISPLAY_NAME" \
        --description="DESCRIPTION" \
        --idp-metadata-path="XML_METADATA_PATH" \
        --attribute-mapping="ATTRIBUTE_MAPPING" \
        --attribute-condition="ATTRIBUTE_CONDITION" \
        --location=global
    

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

    • ‫WORKFORCE_PROVIDER_ID: מזהה הספק.
    • WORKFORCE_POOL_ID: המזהה של מאגר הזהויות של כוח העבודה.
    • ‫DISPLAY_NAME: שם לתצוגה.
    • ‫DESCRIPTION: תיאור.
    • ‫XML_METADATA_PATH: הנתיב לקובץ המטא-נתונים בפורמט XML מ-PingFederate.
    • ‫ATTRIBUTE_MAPPING: מיפוי המאפיינים, לדוגמה google.subject=assertion.subject,google.groups=assertion.attributes.groups,attribute.department=assertion.attributes.department[0].
    • ‫ATTRIBUTE_CONDITION: תנאי למאפיין (לא חובה). לדוגמה, כדי להגביל את המאפיין ipaddr לטווח מסוים של כתובות IP, אפשר ליצור את התנאי assertion.ipaddr.startsWith('98.11.12.').

    הפקודה תשייך את subject, ‏groups ו-department בהצהרת SAML למאפיינים google.subject, ‏google.groups ו-attribute.department בהתאמה. התנאי למאפיין גם מבטיח שרק משתמשים בטווח מסוים של כתובות IP יוכלו להיכנס באמצעות ספק הזהויות הזה לכוח העבודה.

    המסוף

    כדי להגדיר ספק שתומך ב-SAML באמצעות מסוף Google Cloud :

    1. במסוף Google Cloud , נכנסים לדף Workforce Identity Pools: כניסה לדף Workforce Identity Pools
    2. בטבלה Workforce Identity Pools, בוחרים את המאגר שרוצים ליצור בשבילו את הספק.
    3. בקטע Providers, לוחצים על Add Provider.
    4. ברשימה Select a Provider vendor, בוחרים באפשרות Generic Identity Provider.
    5. בקטע Select an authentication protocol, בוחרים באפשרות SAML.
    6. בקטע Create a provider, מבצעים את הפעולות הבאות:
      1. בקטע שם, מזינים שם לספק.
      2. אופציונלי: בשדה תיאור, מזינים תיאור של הספק.
      3. ב-IDP metadata file (XML), בוחרים את קובץ ה-XML של המטא-נתונים מ-PingFederate.
      4. כדי ליצור ספק שמופעל, מוודאים שהאפשרות הפעלת הספק מופעלת.
      5. לוחצים על Continue.
    7. בקטע שיתוף פרטי הספק, לוחצים על המשך.
    8. אופציונלי: כדי להפעיל רישום מפורט ביומן הביקורת, בקטע הגדרת ספק, בקטע רישום מפורט ביומן, לוחצים על המתג הפעלת רישום ביומן הביקורת של ערכי מאפיינים.

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

      כדי להשבית את יומן הביקורת המפורט של ספק מאגר הזהויות של כוח העבודה, משאירים את המתג Enable attribute value audit logging במצב כבוי כשיוצרים את הספק. כדי להשבית את הרישום המפורט ביומן הביקורת, אתם יכולים גם לעדכן את הספק.

    9. כדי ליצור את הספק, לוחצים על Submit.

    אחרי שיוצרים את הספק, המערכת מפנה אתכם לדף המאפיינים של הספק.

    כדי להגדיר מיפויים ותנאים של מאפיינים:

    1. כשמוצגת בקשה, נכנסים ל-IdP החיצוני כדי לאמת את מיפויי המאפיינים שמוגדרים כברירת מחדל.
    2. בדף המאפיינים של הספק, אפשר לראות ולערוך את התנאים והמיפויים של המאפיינים:

      1. כדי להוסיף או לערוך מיפויים של מאפיינים, מבצעים את הפעולות הבאות:

        1. לוחצים על הוספת מיפוי כדי להוסיף מיפוי חדש, או עורכים את המיפויים הקיימים.
        2. בשדה Google n, שבו n הוא מספר, בוחרים מפתח שנתמך ב- Google Cloud.
        3. בשדה SAML n התואם, מזינים את שם המאפיין של ה-IdP או ביטוי CEL, לדוגמה:

          google.subject=assertion.subject,
          google.groups=assertion.attributes['https://example.com/aliases'],
          attribute.costcenter=assertion.attributes.costcenter[0]
          
      2. כדי להוסיף תנאי מאפיין, מבצעים את הפעולות הבאות:

        1. לוחצים על הוספת תנאי.
        2. בשדה Attribute Conditions, מזינים תנאי בפורמט CEL, לדוגמה, assertion.ipaddr.startsWith('98.11.12.').
    3. כדי לאמת את המיפויים, לוחצים על שמירה ואחזור מחדש של הטוקן.

    4. כדי לסיים את ההגדרה, לוחצים על שמירה ויציאה.

ניהול הגישה למשאבים של Google Cloud

בקטע הזה מוסבר איך לנהל את הגישה של משתמשי PingFederate למשאבים ב- Google Cloud .

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

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

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

כדי להקצות את התפקיד "אדמין של נפח אחסון" (roles/storage.admin) לכל הזהויות במחלקה ספציפית בפרויקט TEST_PROJECT_ID, מריצים את הפקודה הבאה:

gcloud projects add-iam-policy-binding TEST_PROJECT_ID \
    --role="roles/storage.admin" \
    --member="principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/attribute.department/DEPARTMENT_VALUE"

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

  • ‫TEST_PROJECT_ID: מזהה הפרויקט.
  • WORKFORCE_POOL_ID: המזהה של מאגר הזהויות של כוח העבודה.
  • ‫DEPARTMENT_VALUE: הערך הממופה של attribute.department.

שימוש בקבוצות ממופות

כדי להקצות את התפקיד "אדמין של נפח אחסון" (roles/storage.admin) לכל הזהויות בקבוצה GROUP_ID בפרויקט TEST_PROJECT_ID, מריצים את הפקודה הבאה:

gcloud projects add-iam-policy-binding TEST_PROJECT_ID \
    --role="roles/storage.admin" \
    --member="principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/group/GROUP_ID"

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

  • ‫TEST_PROJECT_ID: מזהה הפרויקט.
  • WORKFORCE_POOL_ID: המזהה של מאגר הזהויות של כוח העבודה.
  • ‫GROUP_ID: קבוצה בהצהרה הממופה google.groups.

כניסה לחשבון ובדיקת גישה

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

כניסה

כניסה לחשבון במסוף (איחוד)

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

  1. עוברים לדף הכניסה של המסוף (איחוד).

    כניסה למסוף (איחוד)

  2. מזינים את שם הספק בפורמט הבא:
    locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
  3. כשמופיעה ההנחיה, מזינים את פרטי הכניסה ל-PingFederate.

כניסה באמצעות הדפדפן ל-CLI של gcloud

כדי להיכנס ל-CLI של gcloud באמצעות הדפדפן:

מריצים את הפקודה הבאה כדי ליצור קובץ תצורה של ההתחברות:

‫Linux ו-macOS

gcloud iam workforce-pools create-login-config \
    locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID \
    --output-file=LOGIN_CONFIG_PATH

‏Windows (PowerShell)

gcloud iam workforce-pools create-login-config `
    locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID `
    --output-file=LOGIN_CONFIG_PATH

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

  • ‫WORKFORCE_POOL_ID: המזהה של מאגר הזהויות של כוח העבודה.
  • ‫WORKFORCE_PROVIDER_ID: המזהה של ספק איחוד שירותי אימות הזהות של כוח העבודה.
  • ‫LOGIN_CONFIG_PATH: הנתיב שבו ייכתב קובץ התצורה להתחברות. לדוגמה, login-config.json.

קובץ הגדרות ההתחברות מכיל את נקודות הקצה (endpoints) שבהן ה-CLI של gcloud משתמש כדי להפעיל את תהליך האימות בדפדפן ולהגדיר את הקהל ל-IdP שהוגדר בספק של מאגר הזהויות של כוח העבודה. הקובץ לא מכיל מידע סודי.

התוכן של קובץ התצורה לכניסה נראה כך:

{
  "universe_domain": "googleapis.com",
  "universe_cloud_web_domain": "cloud.google",
  "type": "external_account_authorized_user_login_config",
  "audience": "//iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID",
  "auth_url": "https://auth.cloud.google/authorize",
  "token_url": "https://sts.googleapis.com/v1/oauthtoken",
  "token_info_url": "https://sts.googleapis.com/v1/introspect"
}

מפנים לקובץ התצורה של ההתחברות באמצעות משתנה סביבה, מאפיין בהגדרות האישיות הפעילות של ה-CLI של gcloud, או משתמשים בו ישירות באמצעות הפקודה gcloud auth login:

משתנה הסביבה

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

  1. מגדירים את משתנה הסביבה CLOUDSDK_AUTH_LOGIN_CONFIG_FILE לנתיב של קובץ התצורה להתחברות.
  2. מריצים את הפקודה הבאה:

    gcloud auth login
  3. ה-CLI של gcloud מפנה למשתנה הסביבה כדי למצוא את קובץ התצורה של ההתחברות, ואז מתחיל את תהליך האימות. פועלים לפי התהליך בדפדפן כדי לאמת את ה-CLI של gcloud ולתת לו הרשאה לגשת למשאבים בשמכם בפקודות עתידיות.

כדי להפסיק להשתמש בקובץ התצורה שמשמש לכניסה לפקודות gcloud auth login, צריך לנקות את משתנה הסביבה CLOUDSDK_AUTH_LOGIN_CONFIG_FILE.

ההגדרות האישיות של ה-CLI של gcloud

כדי להשתמש בקובץ התצורה של ההתחברות עם מאפיין הגדרה של ה-CLI של gcloud, פועלים לפי ההוראות הבאות:

  1. מגדירים את המאפיין auth/login_config_file של מערך ההגדרות האישיות הפעיל של ה-CLI של gcloud לנתיב של קובץ התצורה של ההתחברות, באמצעות הפקודה הבאה:

    gcloud config set auth/login_config_file LOGIN_CONFIG_PATH
  2. מריצים את הפקודה הבאה:

    gcloud auth login
  3. ה-CLI של gcloud מפנה למאפיין של מערך ההגדרות האישיות כדי למצוא את קובץ התצורה של ההתחברות, ואז מתחיל את תהליך האימות. פועלים לפי התהליך בדפדפן כדי לאמת את ה-CLI של gcloud ולתת לו הרשאה לגשת למשאבים בשמכם בפקודות עתידיות.

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

gcloud config unset auth/login_config_file

gcloud auth login

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

  • אם השתמשתם בדגל --activate כשיצרתם את קובץ התצורה שמשמש לכניסה, צריך להריץ את הפקודה הבאה:

    gcloud auth login
  • אם לא השתמשתם בדגל --activate כשיצרתם את קובץ התצורה של ההתחברות, צריך להריץ את הפקודה הבאה:

    ‫Linux ו-macOS

    gcloud auth login \
        --login-config=LOGIN_CONFIG_PATH

    ‏Windows (PowerShell)

    gcloud auth login `
        --login-config=LOGIN_CONFIG_PATH

    מחליפים את LOGIN_CONFIG_PATH בנתיב של קובץ התצורה להתחברות.

הפקודה gcloud auth login שומרת את פרטי הכניסה בספריית הבית. חשבון המשתמש המאומת הופך לחשבון המשתמש הפעיל בהגדרות האישיות הפעילות של ה-CLI של gcloud. אם לא מבטלים את ההגדרה, ה-CLI של gcloud משתמש בפרטי הכניסה האלה כדי לגשת אל Google Cloud.

כניסה באמצעות דפדפן ללא GUI ל-CLI של gcloud

כדי להיכנס ל-PingFederate באמצעות ה-CLI של gcloud ופרוטוקול SAML:

  1. נכנסים עם חשבון משתמש לאפליקציית PingFederate ומקבלים את התגובה ב-SAML.
  2. שומרים את התגובה ב-SAML שמוחזרת על ידי PingFederate במיקום מאובטח במחשב המקומי. שומרים את הנתיב במשתנה סביבה, לדוגמה: SAML_ASSERTION_PATH=/path/to/assertion.xml.
  3. יוצרים קובץ תצורה:

    gcloud iam workforce-pools create-cred-config \
        locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID \
        --subject-token-type=urn:ietf:params:oauth:token-type:saml2 \
        --credential-source-file=SAML_ASSERTION_PATH \
        --workforce-pool-user-project=PROJECT_ID \
        --output-file=config.json
    

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

    • ‫SAML_ASSERTION_PATH: הנתיב לקובץ של טענת הנכוֹנוּת ב-SAML.
    • ‫PROJECT_ID: מזהה הפרויקט.
  4. קובץ התצורה שנוצר נראה כך:

    {
      "type": "external_account",
      "audience": "//iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID",
      "subject_token_type": "urn:ietf:params:oauth:token-type:saml2",
      "token_url": "https://sts.googleapis.com/v1/token",
      "credential_source": {
        "file": "SAML_ASSERTION_PATH"
      },
      "workforce_pool_user_project": "PROJECT_ID"
    }
    
  5. כדי להיכנס ל-CLI של gcloud באמצעות החלפת אסימונים, מריצים את הפקודה הבאה:

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

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

    Authenticated with external account user credentials for: [principal://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/subject/USER_ID].

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

    gcloud auth list
    

בדיקת גישה

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

כניסה לחשבון במסוף (איחוד)

כדי לאמת את הגישה במסוף (המאוחד):

  1. נכנסים לדף Cloud Storage.
  2. מוודאים שאפשר לראות את רשימת הקטגוריות הקיימות של הפרויקט TEST_PROJECT_ID.

‫CLI של gcloud

כדי לראות את הקטגוריות של Cloud Storage ואת האובייקטים בפרויקט שיש אליו גישה, מריצים את הפקודה הבאה:

gcloud alpha storage ls --project="TEST_PROJECT_ID"

לחשבון המשתמש צריכה להיות את ההרשאה serviceusage.services.use בפרויקט שהוגדר בסשן של ה-CLI של gcloud: ‏PROJECT_ID.

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