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

איחוד שירותי אימות הזהות של כוח עבודה מאפשר לכם להשתמש ב-PingOne Advanced Identity Cloud ‏(AIC) כספק זהויות (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 שניות).

יצירת אפליקציית PingOne AIC

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

יצירת IdP מתארח

  1. בקטע Native Consoles > ניהול הרשאות גישה, עוברים אל Realms > REALM_NAME > Dashboard, ולוחצים על SAML Applications.
  2. לוחצים על Add Entity Provider > Hosted (הוספת ספק ישות > מתארח).
  3. מזינים מזהה ישות ב-SAML. שומרים את הערך הזה לשימוש בהמשך.

    1. מוודאים שהערך של Entity Provider כתובת URL בסיסית נכון. ב-Advanced Identity Cloud משתמשים בערך הזה לכל נקודות הקצה שקשורות ל-SAML 2.0.
    2. בקטע Meta Aliases, מזינים ערך שמתאים לכתובת URL במאפיין Identity Provider Meta Alias. השם הסודי הזה חייב להיות ייחודי במעגל האמון.
    3. לוחצים על יצירה.
    4. בכרטיסייה Assertion Processing, בקטע Attribute Mapper, ממפים את שמות המאפיינים של SAML לשמות המאפיינים המקומיים. שמות המאפיינים של SAML הם השמות שמשמשים בטענת נכוֹנוּת (assertion).
    5. לוחצים על הוספה או עדכון לכל מיפוי.
    6. לוחצים על שמירת השינויים.

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

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

בדוגמאות הבאות, מאפיינים בטענת הנכוֹנוּת (assertion) של SAML ממופים למאפיינים מקומיים:

מאפיין SAML מאפיין מקומי
IDPEmail mail
FirstName givenName
groups groups

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

ייצוא מטא-נתונים של ספק

אתם יכולים לגשת למטא-נתונים של SAML 2.0 של הספק המארח באחת מהדרכים הבאות:

  • Over REST

    מריצים את הפקודה הבאה:

    curl --output METADATA_XML \
        "https://TENANT_ENV_FQDN/am/ExportSamlMetadata?entityid=ENTITY_ID&realm=/REALM"
    
  • בדפדפן

    פותחים את כתובת ה-URL של המטא-נתונים של סביבת הדייר בדפדפן כדי להוריד את קובץ ה-XML: https://TENANT_ENV_FQDN/am/ExportSamlMetadata?entityid=ENTITY_ID&realm=/REALM

  1. שומרים את קובץ ה-XML במחשב המקומי.

ייבוא של Google כספק שירות מרוחק

  1. מכינים את Google Cloud קובץ ה-XML של המטא-נתונים של ספק השירות. משתמשים בתבנית הבאה ומחליפים את הערכים הזמניים לשמירת מקום:

    <?xml version="1.0" encoding="UTF-8"?>
    <md:EntityDescriptor xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" entityID="https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID">
       <md:SPSSODescriptor AuthnRequestsSigned="false" WantAssertionsSigned="true" protocolSupportEnumeration="urn:oasis:names:tc:SAML:2.0:protocol">
          <md:NameIDFormat>urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified</md:NameIDFormat>
          <md:NameIDFormat>urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress</md:NameIDFormat>
          <md:AssertionConsumerService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST" Location="https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID" index="0" isDefault="true"/>
       </md:SPSSODescriptor>
    </md:EntityDescriptor>
    
  2. מייבאים את המטא-נתונים באחת מהדרכים הבאות:

    • במסוף

      1. במסוף Admin ב-PingOne AIC, עוברים אל SAML Applications (אפליקציות SAML).
      2. לוחצים על Add Entity Provider > Remote.
      3. מעלים את Google Cloud קובץ ה-XML של המטא-נתונים של ספק הזהויות שיצרתם.
      4. לוחצים על יצירה.
    • Over REST

      1. ממירים את המטא-נתונים של ה-XML למחרוזת בקידוד base64url.
      2. מקבלים טוקן גישה.
      3. מריצים את הפקודה הבאה:

        curl --request POST \
            --header 'authorization: Bearer ACCESS_TOKEN' \
            --header 'Content-Type: application/json' \
            --header 'Accept-API-Version: resource=1.0' \
            --data-raw '{"standardMetadata": "BASE64URL_ENCODED_METADATA"}' \
            'https://TENANT_ENV_FQDN/am/json/realms/root/realms/alpha/realm-config/saml2/remote?_action=importEntity'
        

יצירת מעגל אמון (CoT)

  1. עוברים אל Realms > REALM_NAME > Applications > Federation > Circles of Trust.
  2. לוחצים על הוספת מעגל אנשים מהימנים.
  3. מזינים שם ולוחצים על יצירה.
  4. בדף Circle of Trust, במאפיין Entity Providers, בוחרים את ה-IdP המארח ואת ה-SP המרוחק של Google Cloud .
  5. לוחצים על שמירת השינויים.

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

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

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

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

    gcloud

    1. שומרים את המטא-נתונים של SAML מאפליקציית PingOne AIC.

    2. כדי ליצור את הספק של מאגר הזהויות לכוח העבודה ב-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 שייצאתם מ-PingOne AIC.
      • ‫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 של המטא-נתונים שייצאתם מ-PingOne AIC.
      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.attributes.ipaddr.startsWith('98.11.12.').
    3. כדי לאמת את המיפויים, לוחצים על שמירה ואחזור מחדש של הטוקן.

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

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

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

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

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

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

כדי להקצות את התפקיד Storage Admin (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. כשמופיעה ההנחיה, מזינים את פרטי הכניסה ל-PingOne AIC.

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

כדי להיכנס ל-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

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

  1. נכנסים עם חשבון משתמש לאפליקציית PingOne AIC ומקבלים את התגובה ב-SAML.
  2. שומרים את התגובה ב-SAML שמוחזרת על ידי PingOne AIC במיקום מאובטח במחשב המקומי. שומרים את הנתיב במשתנה סביבה, לדוגמה: SAML_ASSERTION_PATH=/tmp/saml_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 מעביר בשקיפות את פרטי הכניסה ב-PingOne AIC לטוקני גישה זמניים של 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.

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