איחוד שירותי אימות הזהות של כוח העבודה מאפשר לכם להשתמש בספק הזהויות (IdP) של Microsoft Entra ID כדי לנהל את הגישה אל Google Cloud. אחרי שמאחדים את הזהויות באמצעות הפרוטוקול OpenID Connect (OIDC) או SAML 2.0, משתמשים מאוחדים יכולים לגשת לשירותי Google Cloud שתומכים באיחוד שירותי אימות הזהות של כוח העבודה.
לפני שמתחילים
- מוודאים שיש לכם ארגון מוגדר ב- Google Cloud .
-
התקינו את ה-CLI של Google Cloud. אחר כך, אתחלו את ה-CLI של Google Cloud באמצעות הפקודה הבאה:
gcloud initאם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם.
- צריך לוודא שאסימוני הזיהוי ב-Microsoft Entra ID מאפשרים זרם הענקת גישה משתמע. מידע נוסף זמין במאמר הפעלת הענקת גישה משתמעת של טוקן של מזהה.
- כדי להיכנס, ספק הזהויות שלכם צריך לספק פרטי אימות חתומים: ספקי זהויות שתומכים ב-OIDC צריכים לספק אסימון JWT, ותשובות שמגיעות מספקי זהויות שתומכים ב-SAML חייבות להיות חתומות.
- כדי לקבל מידע חשוב על שינויים בארגון או במוצריGoogle Cloud , צריך לספק אנשי קשר חיוניים. מידע נוסף זמין במאמר סקירה כללית על איחוד שירותי אימות הזהות של כוח עבודה.
עלויות
איחוד שירותי אימות הזהות של כוח עבודה זמין כתכונה ללא עלות. עם זאת, רישום מפורט של יומני ביקורת של איחוד שירותי אימות הזהות של כוח עבודה מתבצע באמצעות Cloud Logging. למידע על התמחור של Logging
התפקידים הנדרשים
כדי לקבל את ההרשאות שנדרשות להגדרה של איחוד שירותי אימות הזהות של כוח עבודה, צריך לבקש מהאדמין להקצות לכם ב-IAM את התפקיד אדמין של מאגר זהויות של כוח עבודה (roles/iam.workforcePoolAdmin) בארגון.
כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.
אם אתם מגדירים הרשאות בסביבת פיתוח או בדיקה, ולא בסביבת ייצור, אתם יכולים להקצות את התפקיד הבסיסי "בעלים" ב-IAM (roles/owner), שכולל גם הרשאות לאיחוד שירותי אימות הזהות של כוח העבודה.
יצירת אפליקציה ב-Microsoft Entra ID
בקטע הזה מוסבר איך יוצרים אפליקציה של Microsoft Entra ID באמצעות מרכז הניהול של Microsoft Entra. אפשר גם לעדכן את האפליקציה הקיימת. פרטים נוספים מופיעים במאמר הגדרת אפליקציות בסביבה העסקית של Microsoft Entra ID.מאגרי הזהויות של כוח העבודה תומכים באיחוד בעזרת הפרוטוקולים OIDC ו-SAML.
OIDC
כדי לרשום אפליקציה של Microsoft Entra ID שמשתמשת בפרוטוקול OIDC:
נכנסים למרכז הניהול של Microsoft Entra.
עוברים אל Entra ID > App registrations.
כדי להתחיל את הרישום של האפליקציה:
לוחצים על New registration.
נותנים שם לאפליקציה.
בוחרים אפשרות ב-Supported account types.
ב-Redirect URI, פותחים את הרשימה הנפתחת Select a Platform ובוחרים ב-Web.
בשדה הטקסט מזינים כתובת URL להפניה אוטומטית. המשתמשים שייכנסו לחשבון יופנו לכתובת ה-URL הזו. אם מגדירים את הגישה למסוף (איחוד), צריך להשתמש בכתובת URL בפורמט הבא:
https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_IDמחליפים את מה שכתוב בשדות הבאים:
-
WORKFORCE_POOL_ID: המזהה של מאגר הזהויות של כוח העבודה, שבו משתמשים כשיוצרים את מאגר הזהויות של כוח העבודה בהמשך המסמך הזה. לדוגמה:entra-id-oidc-pool.
WORKFORCE_PROVIDER_ID: המזהה של ספק מאגר הזהויות של כוח העבודה, שבו משתמשים כשיוצרים את ספק מאגר הזהויות של כוח העבודה בהמשך המסמך הזה. לדוגמה,entra-id-oidc-pool-provider.למידע נוסף על הפורמט של המזהה, תוכלו להיעזר בחלק פרמטרים של שאילתה במשאבי העזרה של ה-API
-
לוחצים על Register כדי לרשום את האפליקציה.
כדי להשתמש בדוגמה של מיפוי המאפיינים שמוצגת בהמשך המאמר הזה, צריך ליצור מאפיין
departmentבהתאמה אישית.
מומלץ: כשיטה מומלצת לאבטחה, אנחנו ממליצים להגדיר בקשה לקבוצות משתמשים באופן הבא:
עוברים לרישום של האפליקציה ב-Microsoft Entra ID.
לוחצים על Token configuration.
לוחצים על Add groups claim.
בוחרים את סוגי הקבוצות שיוחזרו. לפרטים נוספים, קראו את המאמר הגדרת בקשות אופציונליות לקבוצת משתמשים.
SAML
כדי לרשום אפליקציה של Microsoft Entra ID שמשתמשת בפרוטוקול SAML:
נכנסים למרכז הניהול של Microsoft Entra.
עוברים אל Entra ID > Enterprise applications.
כדי להגדיר את האפליקציה הארגונית:
לוחצים על New application > Create your own application.
בחלונית Create your own application שמופיעה, נותנים שם לאפליקציה.
לוחצים על יצירה.
עוברים אל Single sign-on (כניסה יחידה) > SAML.
מעדכנים את Basic SAML Configuration:
בשדה Identifier (Entity ID), מזינים את הערך הבא:
https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_IDמחליפים את מה שכתוב בשדות הבאים:
-
WORKFORCE_POOL_ID: המזהה של מאגר הזהויות של כוח העבודה, שבו משתמשים כשיוצרים את מאגר הזהויות של כוח העבודה בהמשך המאמר (לדוגמה,entra-id-saml-pool).
WORKFORCE_PROVIDER_ID: המזהה של ספק מאגר הזהויות של כוח העבודה, שבו משתמשים כשיוצרים את ספק מאגר הזהויות של כוח העבודה בהמשך המסמך הזה. לדוגמה,entra-id-saml-pool-provider.למידע נוסף על הפורמט של המזהה, תוכלו להיעזר בחלק פרמטרים של שאילתה במשאבי העזרה של ה-API
-
בשדה Reply URL (Assertion Consumer Service URL), מזינים כתובת URL להפניה אוטומטית. המשתמשים שייכנסו לחשבון יופנו לכתובת ה-URL הזו. אם מגדירים את הגישה למסוף (איחוד), צריך להשתמש בכתובת URL בפורמט הבא:
https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_IDמחליפים את מה שכתוב בשדות הבאים:
-
WORKFORCE_POOL_ID: המזהה של מאגר הזהויות של כוח העבודה. -
WORKFORCE_PROVIDER_ID: מזהה הספק של מאגר הזהויות של כוח העבודה.
-
כדי להפעיל כניסה ביוזמת ספק הזהויות, הגדירו את השדה Relay State לערך הבא:
https://console.cloud.google/כדי לשמור את ההגדרות של אפליקציית SAML, לוחצים על Save.
כדי להשתמש בדוגמה של מיפוי המאפיינים שמוצגת בהמשך המאמר הזה, צריך ליצור מאפיין
departmentבהתאמה אישית.
מומלץ: כשיטה מומלצת לאבטחה, אנחנו ממליצים להגדיר בקשה לקבוצות משתמשים באופן הבא:
נכנסים לאפליקציית Microsoft Entra ID.
לוחצים על Single sign-on.
בקטע Attributes & Claims לוחצים על Edit.
לוחצים על Add a group claim.
בוחרים את סוג הקבוצה שיוחזר. לפרטים נוספים קראו את המאמר הוספת בקשות של קבוצות משתמשים לאסימונים לאפליקציות SAML באמצעות הגדרה של SSO.
יצירת מאגר זהויות של כוח העבודה
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 שניות).
המסוף
כדי ליצור את מאגר הזהויות של כוח העבודה:
נכנסים לדף Workforce Identity Pools במסוף Google Cloud :
בוחרים את הארגון של מאגר הזהויות של כוח העבודה. מאגרי הזהויות של כוח העבודה זמינים בכל הפרויקטים והתיקיות שבארגון.
לוחצים על Create pool ומבצעים את הפעולות הבאות:
בשדה Name, מזינים את השם המוצג של המאגר. מזהה המאגר נגזר באופן אוטומטי מהשם בזמן ההקלדה, ומוצג מתחת לשדה Name. כדי לעדכן את מזהה המאגר, לוחצים על Edit ליד מזהה המאגר.
אופציונלי: בשדה Description, מזינים תיאור של המאגר.
כדי ליצור את מאגר הזהויות של כוח העבודה, לוחצים על Next.
משך הסשן של מאגר הזהויות של כוח העבודה מוגדר כברירת מחדל לשעה אחת (3,600 שניות). משך הסשן קובע לכמה זמן יהיו פעילים אסימוני הגישה ל- Google Cloud , המסוף (איחוד), החיבור לסשן והחיבור ל-CLI של gcloud מהמאגר של כוח העבודה. אחרי שיוצרים את המאגר, אפשר לעדכן את המאגר כדי להגדיר משך סשן בהתאמה אישית. משך הסשן צריך להיות בין 15 דקות (900 שניות) ל-12 שעות (43,200 שניות).
יצירת ספק זהויות של מאגר כוח העבודה ב-Microsoft Entra ID
כאן מוסבר איך ליצור ספק מאגר זהויות של כוח עבודה כדי לאפשר למשתמשים של ספק הזהויות לגשת אל Google Cloud. אתם יכולים להגדיר את הספק כך שישתמש בפרוטוקול OIDC או SAML.
יצירת ספק של מאגר זהויות של כוח עבודה ב-OIDC
כדי ליצור ספק של מאגר זהויות של כוח עבודה בשביל שילוב אפליקציית Microsoft Entra ID באמצעות פרוטוקול OIDC, מבצעים את הפעולות הבאות:
כדי לקבל את ה-URI של המנפיק לאפליקציית Microsoft Entra ID:
- עוברים לדף Overview של רישום האפליקציה ב-Microsoft Entra ID.
- לוחצים על נקודות קצה.
מוצאים את נקודת הקצה (endpoint) של מסמך המטא-נתונים של OpenID Connect. ה-URI של המנפיק הוא ה-URI של מסמך המטא-נתונים של OpenID Connect, בלי הסיומת
/.well-known/openid-configuration.לדוגמה, אם ה-URI של מסמך המטא-נתונים של OpenID Connect הוא
https://login.microsoftonline.com/d41ad248-019e-49e5-b3de-4bdfe1fapple/v2.0/.well-known/openid-configuration, ה-URI של המנפיק הואhttps://login.microsoftonline.com/d41ad248-019e-49e5-b3de-4bdfe1fapple/v2.0/. לחלופין, אתם יכולים להעתיק את כתובת ה-URL של מסמך המטא-נתונים של OpenID Connect, לפתוח אותה בכרטיסייה בדפדפן ולהעתיק את הערך שלissuerמתגובת ה-JSON.
כדי לקבל את מזהה הלקוח לאפליקציית Microsoft Entra ID:
- עוברים לדף Overview של רישום האפליקציה ב-Microsoft Entra ID.
- מעתיקים את הערך שמופיע בשדה Application (client) ID.
כדי ליצור ספק של מאגר זהויות של כוח העבודה ב-OIDC בשביל כניסה לחשבון באינטרנט, מבצעים את הפעולות הבאות:
gcloud
כדי ליצור ספק שתומך בפרוטוקול OIDC:
זרימת קוד
כדי ליצור ספק OIDC שמשתמש בהרשאה באמצעות קוד לכניסה מבוססת-אינטרנט, בצעו את הפעולות הבאות:
כדי לקבל את סוד הלקוח באפליקציית Microsoft Entra ID:
עוברים לרישום של האפליקציה ב-Microsoft Entra ID.
ב-Certificates & secrets, לוחצים על הכרטיסייה Client secrets.
כדי להוסיף סוד לקוח לוחצים על + New client secret.
ממלאים את הפרטים בתיבת הדו-שיח Add a client secret לפי הצורך.
כדי ליצור את סוד הלקוח לוחצים על Add.
מוצאים את סוד הלקוח החדש בכרטיסייה Client secrets.
בעמודה Value של סוד הלקוח החדש שיצרתם, לוחצים על content_copy Copy.
כדי ליצור את הספק, מריצים את הפקודה הבאה:
gcloud iam workforce-pools providers create-oidc WORKFORCE_PROVIDER_ID \ --workforce-pool=WORKFORCE_POOL_ID \ --display-name="DISPLAY_NAME" \ --description="DESCRIPTION" \ --issuer-uri="ISSUER_URI" \ --client-id="OIDC_CLIENT_ID" \
--client-secret-value="OIDC_CLIENT_SECRET" \
--vendor-type="entra-id" \ --web-sso-response-type="code" \ --web-sso-assertion-claims-behavior="merge-user-info-over-id-token-claims" \ --web-sso-additional-scopes="WEB_SSO_ADDITIONAL_SCOPES" \ --attribute-mapping="ATTRIBUTE_MAPPING" \ --attribute-condition="ATTRIBUTE_CONDITION" \ --jwk-json-path="JWK_JSON_PATH" \ --detailed-audit-logging \ --location=globalמחליפים את מה שכתוב בשדות הבאים:
-
WORKFORCE_PROVIDER_ID: מזהה ייחודי של ספק מאגר הזהויות של כוח העבודה. התחיליתgcp-שמורה ואי אפשר להשתמש בה במזהה של מאגר זהויות של כוח עבודה או במזהה של ספק מאגר זהויות של כוח עבודה. -
WORKFORCE_POOL_ID: מזהה מאגר הזהויות של כוח העבודה שאליו רוצים לחבר את ה-IdP. -
DISPLAY_NAME: שם תצוגה ידידותי למשתמש בשביל הספק (לא חובה). לדוגמה,idp-eu-employees. -
DESCRIPTION: תיאור של ספק כוח העבודה (לא חובה), לדוגמה,IdP for Partner Example Organization employees. -
ISSUER_URI: ה-URI של מנפיק OIDC, בפורמט URI תקין שמתחיל ב-https. לדוגמה:https://example.com/oidc. הערה: מטעמי אבטחה,ISSUER_URIצריך להשתמש בסכמת HTTPS. -
OIDC_CLIENT_ID: מזהה הלקוח ב-OIDC שרשום ב-IdP של OIDC. המזהה צריך להיות תואם להצהרתaudשל ה-JWT שמונפקת על ידי ה-IdP. -
OIDC_CLIENT_SECRET: סוד הלקוח ב-OIDC. -
WEB_SSO_ADDITIONAL_SCOPES: היקפי הרשאות אופציונליים לשליחה ל-IdP של OIDC בשביל המסוף (איחוד) או בשביל כניסה באמצעות הדפדפן ל-CLI של gcloud. -
ATTRIBUTE_MAPPING: מיפוי מאפיינים. ב-Microsoft Entra ID עם אימות OIDC, אנחנו ממליצים על מיפוי המאפיינים הבא:google.subject=assertion.oid, google.groups=assertion.groups, google.display_name=assertion.preferred_usernameבדוגמה הזו, המאפיינים
assertion.oid,assertion.groupsו-assertion.preferred_usernameשל ה-IdP ממופים למאפייניםgoogle.subject,google.groupsו-google.display_nameשל Google Cloud, בהתאמה. -
ATTRIBUTE_CONDITION: תנאי למאפיין. לדוגמה, כדי להגביל את המאפייןipaddrלטווח מסוים של כתובות IP, אפשר ליצור את התנאיassertion.ipaddr.startsWith('98.11.12.'). -
JWK_JSON_PATH: נתיב אופציונלי למפתחות JWK ב-OIDC שהועלו באופן מקומי. אם לא מוסיפים את הפרמטר הזה, המערכת של Google Cloud תשתמש בנתיב/.well-known/openid-configurationשל ה-IdP כדי למצוא את מפתחות ה-JWK שמכילים את המפתחות הציבוריים. מידע נוסף על מפתחות JWK של OIDC שהועלו באופן מקומי זמין במאמר ניהול מפתחות JWK של OIDC. -
רישום מפורט ביומן הביקורת של איחוד שירותי אימות הזהות של כוח עבודה מתעד ב-Logging את המידע שהתקבל מה-IdP. יומני ביקורת מפורטים יכולים לעזור לכם לפתור בעיות בהגדרות של הספק של מאגר הזהויות של כוח העבודה. כדי ללמוד איך לפתור שגיאות במיפוי מאפיינים באמצעות רישום מפורט ביומן הביקורת, קראו את המאמר שגיאות כלליות במיפוי מאפיינים. למידע על התמחור של Logging
כדי להשבית את יומן הביקורת המפורט של ספק מאגר זהויות של כוח עבודה, משמיטים את הדגל
--detailed-audit-loggingכשמריצים אתgcloud iam workforce-pools providers create. כדי להשבית את הרישום המפורט ביומן הביקורת, אתם יכולים גם לעדכן את הספק.
הדגל
--web-sso-assertion-claims-behaviorקובע איך הצהרות OIDC נכללות באובייקטassertionשמשמש למיפוי מאפיינים ולתנאי מאפיינים. בתהליך של הרשאה באמצעות קוד (--web-sso-response-type="code"), אפשר להגדיר את הדגל הזה לאחד מהערכים הבאים:-
merge-user-info-over-id-token-claims: מיזוג של ההצהרות מנקודת הקצהUserInfoשל OIDC עם ההצהרות מהטוקן של המזהה. אם שניהם מכילים את אותו שם תביעה, הערך של התביעהUserInfoמקבל קדימות. משתמשים בערך הזה כשספק הזהויות מחזיר מאפייני משתמש נוספים או הצהרות קבוצה מנקודת הקצהUserInfo. -
only-id-token-claims: כולל רק הצהרות מהטוקן של המזהה. משתמשים בערך הזה כשכל ההצהרות שנדרשות למיפויים ולתנאים של המאפיינים כבר קיימות בטוקן של מזהה.
locations/global/workforcePools/enterprise-example-organization-employees.-
זרם הענקת גישה משתמע
כדי ליצור ספק של OIDC שמשתמש בזרם הענקת גישה משתמע לכניסה בדפדפן:
כדי להפעיל את טוקן של מזהה באפליקציית Microsoft Entra ID, בצע את הפעולות הבאות:
- עוברים לרישום של האפליקציה ב-Microsoft Entra ID.
- בקטע Authentication, מסמנים את התיבה טוקן של מזהה.
- לוחצים על Save.
כדי ליצור את הספק, מריצים את הפקודה הבאה:
gcloud iam workforce-pools providers create-oidc WORKFORCE_PROVIDER_ID \ --workforce-pool=WORKFORCE_POOL_ID \ --display-name="DISPLAY_NAME" \ --description="DESCRIPTION" \ --issuer-uri="ISSUER_URI" \ --client-id="OIDC_CLIENT_ID" \
--vendor-type="entra-id" \ --web-sso-response-type="id-token" \ --web-sso-assertion-claims-behavior="only-id-token-claims" \ --web-sso-additional-scopes="WEB_SSO_ADDITIONAL_SCOPES" \ --attribute-mapping="ATTRIBUTE_MAPPING" \ --attribute-condition="ATTRIBUTE_CONDITION" \ --jwk-json-path="JWK_JSON_PATH" \ --detailed-audit-logging \ --location=globalמחליפים את מה שכתוב בשדות הבאים:
-
WORKFORCE_PROVIDER_ID: מזהה ייחודי של ספק מאגר הזהויות של כוח העבודה. התחיליתgcp-שמורה ואי אפשר להשתמש בה במזהה של מאגר זהויות של כוח עבודה או במזהה של ספק מאגר זהויות של כוח עבודה. -
WORKFORCE_POOL_ID: מזהה מאגר הזהויות של כוח העבודה שאליו רוצים לחבר את ה-IdP. -
DISPLAY_NAME: שם תצוגה ידידותי למשתמש בשביל הספק (לא חובה). לדוגמה,idp-eu-employees. -
DESCRIPTION: תיאור של ספק כוח העבודה (לא חובה), לדוגמה,IdP for Partner Example Organization employees. -
ISSUER_URI: ה-URI של מנפיק OIDC, בפורמט URI תקין שמתחיל ב-https. לדוגמה:https://example.com/oidc. הערה: מטעמי אבטחה,ISSUER_URIצריך להשתמש בסכמת HTTPS. -
OIDC_CLIENT_ID: מזהה הלקוח ב-OIDC שרשום ב-IdP של OIDC. המזהה צריך להיות תואם להצהרתaudשל ה-JWT שמונפקת על ידי ה-IdP. -
WEB_SSO_ADDITIONAL_SCOPES: היקפי הרשאות אופציונליים לשליחה ל-IdP של OIDC בשביל המסוף (איחוד) או בשביל כניסה באמצעות הדפדפן ל-CLI של gcloud. -
ATTRIBUTE_MAPPING: מיפוי מאפיינים. ב-Microsoft Entra ID עם אימות OIDC, אנחנו ממליצים על מיפוי המאפיינים הבא:google.subject=assertion.oid, google.groups=assertion.groups, google.display_name=assertion.preferred_usernameבדוגמה הזו, המאפיינים
assertion.oid,assertion.groupsו-assertion.preferred_usernameשל ה-IdP ממופים למאפייניםgoogle.subject,google.groupsו-google.display_nameשל Google Cloud, בהתאמה. -
ATTRIBUTE_CONDITION: תנאי למאפיין. לדוגמה, כדי להגביל את המאפייןipaddrלטווח מסוים של כתובות IP, אפשר ליצור את התנאיassertion.ipaddr.startsWith('98.11.12.'). -
JWK_JSON_PATH: נתיב אופציונלי למפתחות JWK ב-OIDC שהועלו באופן מקומי. אם לא מוסיפים את הפרמטר הזה, המערכת של Google Cloud תשתמש בנתיב/.well-known/openid-configurationשל ה-IdP כדי למצוא את מפתחות ה-JWK שמכילים את המפתחות הציבוריים. מידע נוסף על מפתחות JWK של OIDC שהועלו באופן מקומי זמין במאמר ניהול מפתחות JWK של OIDC. -
רישום מפורט ביומן הביקורת של איחוד שירותי אימות הזהות של כוח עבודה מתעד ב-Logging את המידע שהתקבל מה-IdP. יומני ביקורת מפורטים יכולים לעזור לכם לפתור בעיות בהגדרות של הספק של מאגר הזהויות של כוח העבודה. כדי ללמוד איך לפתור שגיאות במיפוי מאפיינים באמצעות רישום מפורט ביומן הביקורת, קראו את המאמר שגיאות כלליות במיפוי מאפיינים. למידע על התמחור של Logging
כדי להשבית את יומן הביקורת המפורט של ספק מאגר זהויות של כוח עבודה, משמיטים את הדגל
--detailed-audit-loggingכשמריצים אתgcloud iam workforce-pools providers create. כדי להשבית את הרישום המפורט ביומן הביקורת, אתם יכולים גם לעדכן את הספק.
במקרה של זרם הענקת גישה משתמע (
בתשובה לפקודה, POOL_RESOURCE_NAME הוא שם המאגר. לדוגמה:--web-sso-response-type="id-token"), צריך להגדיר את הדגל--web-sso-assertion-claims-behaviorלערךonly-id-token-claims, שכולל רק הצהרות מהאסימון המזהה באובייקטassertion. זרם הענקת הגישה המשתמע לא תומך בערךmerge-user-info-over-id-token-claims.locations/global/workforcePools/enterprise-example-organization-employees.-
המסוף
זרימת קוד
כדי ליצור ספק OIDC שמשתמש בהרשאה באמצעות קוד לכניסה מבוססת-אינטרנט, בצע את הפעולות הבאות:
כדי לקבל את סוד הלקוח של Microsoft Entra ID:
עוברים לרישום של האפליקציה ב-Microsoft Entra ID.
ב-Certificates & secrets, לוחצים על הכרטיסייה Client secrets.
כדי להוסיף סוד לקוח לוחצים על + New client secret.
ממלאים את הפרטים בתיבת הדו-שיח Add a client secret לפי הצורך.
כדי ליצור את סוד הלקוח לוחצים על Add.
מוצאים את סוד הלקוח החדש בכרטיסייה Client secrets.
בעמודה Value של סוד הלקוח החדש שיצרתם, לוחצים על content_copy Copy.
- במסוף Google Cloud , נכנסים לדף Workforce Identity Pools:
- בטבלה Workforce Identity Pools, בוחרים את המאגר שרוצים ליצור לו ספק.
- בקטע Providers, לוחצים על Add Provider.
- ברשימה Select a Provider vendor, בוחרים את ה-IdP.
אם ספק הזהויות שלכם לא מופיע ברשימה, בוחרים באפשרות ספק זהויות כללי.
- בקטע Select an authentication protocol, בוחרים באפשרות OpenID Connect (OIDC).
- בקטע Create a provider, מבצעים את הפעולות הבאות:
- בקטע שם, מזינים את שם הספק.
- בקטע Description, מזינים את תיאור הספק.
- בשדה Issuer (URL), מזינים את ה-URI של המנפיק. ה-URI של מנפיק OIDC צריך להיות בפורמט URI תקין ולהתחיל ב-
https. לדוגמה:https://example.com/oidc. - בשדה Client ID, מזינים את מזהה הלקוח ב-OIDC שרשום ב-IdP של OIDC. המזהה צריך להיות תואם להצהרת
audשל ה-JWT שמונפקת על ידי ה-IdP. - כדי ליצור ספק שמופעל, מוודאים שהאפשרות הפעלת הספק מופעלת.
- לוחצים על Continue.
- בקטע שיתוף פרטי הספק עם IdP, מעתיקים את כתובת ה-URL. ב-IdP, מגדירים את כתובת ה-URL הזו בתור ה-URI להפניה אוטומטית, שמציין ל-IdP לאן לשלוח את אסימון טענת הנכוֹנוּת (assertion) אחרי ההתחברות.
- לוחצים על Continue.
- בקטע Configure OIDC Web Sign-in, מבצעים את הפעולות הבאות:
- ברשימה Flow type, בוחרים באפשרות Code.
- ברשימה Assertion claims behavior, בוחרים אחת מהאפשרויות הבאות:
- פרטי המשתמש וטוקן של מזהה: מיזוג ההצהרות מנקודת הקצה (endpoint) של
UserInfoעם ההצהרות מטוקן של מזהה, תוך העדפת ערכי ההצהרות שלUserInfoלאותו שם הצהרה. בחרו באפשרות הזו אם ספק הזהויות מחזיר מאפייני משתמשים נוספים או הצהרות קבוצה מנקודת הקצהUserInfo. - רק טוקן של מזהה: כולל רק הצהרות מהטוקן של המזהה. בחרו באפשרות הזו אם כל ההצהרות שנדרשות למיפויים ולתנאים של המאפיינים כבר קיימות בטוקן של המזהה.
- פרטי המשתמש וטוקן של מזהה: מיזוג ההצהרות מנקודת הקצה (endpoint) של
- בשדה סוד לקוח, מזינים את סוד הלקוח מספק הזהויות.
- לוחצים על Continue.
- בקטע Configure provider, לוחצים על המתג Enable attribute value audit logging בשביל Detailed logging.
רישום מפורט ביומן הביקורת של איחוד שירותי אימות הזהות של כוח עבודה מתעד ב-Logging את המידע שהתקבל מה-IdP. יומני ביקורת מפורטים יכולים לעזור לכם לפתור בעיות בהגדרות של הספק של מאגר הזהויות של כוח העבודה. כדי ללמוד איך לפתור שגיאות במיפוי מאפיינים באמצעות רישום מפורט ביומן הביקורת, קראו את המאמר שגיאות כלליות במיפוי מאפיינים. למידע על התמחור של Logging
כדי להשבית את יומן הביקורת המפורט של ספק מאגר הזהויות של כוח העבודה, משאירים את המתג Enable attribute value audit logging במצב כבוי כשיוצרים את הספק. כדי להשבית את רישום יומן הביקורת המפורט, אתם יכולים גם לעדכן את הספק.
- כדי ליצור את הספק, לוחצים על Submit.
אחרי שיוצרים את הספק, המערכת מפנה לדף המאפיינים של הספק.
כדי להגדיר מיפויים ותנאים של מאפיינים:
- כשמוצגת בקשה, נכנסים ל-IdP החיצוני כדי לאמת את מיפויי המאפיינים שמוגדרים כברירת מחדל.
- בדף המאפיינים של הספק, אפשר לראות ולערוך את מיפויי המאפיינים והתנאים:
- כדי להוסיף או לערוך מיפוי מאפיינים:
- לוחצים על הוספת מיפוי כדי להוסיף מיפוי חדש, או עורכים את המיפויים הקיימים.
- בשדה Google n, כאשר n הוא מספר, בוחרים מפתח שנתמך ב- Google Cloud.
- בשדה OIDC n התואם, מזינים את שם המאפיין של ספק הזהויות או ביטוי CEL.
ב-Microsoft Entra ID עם אימות OIDC, אנחנו ממליצים על מיפוי המאפיינים הבא:
google.subject=assertion.oid, google.groups=assertion.groups, google.display_name=assertion.preferred_usernameבדוגמה הזו, המאפיינים
assertion.oid,assertion.groupsו-assertion.preferred_usernameשל ה-IdP ממופים למאפייניםgoogle.subject,google.groupsו-google.display_nameשל Google Cloud, בהתאמה.
- כדי להגדיל את מספר הקבוצות:
- לוחצים על הפעלה כדי להוסיף מאפיינים נוספים.
- בתת-המשימה שנפתחת, ממלאים את הפרטים הבאים:
- בשדה Extra Attributes Issuer URI, מזינים את כתובת ה-URL של המנפיק.
- בשדה Extra Attributes Client ID, מזינים את מזהה הלקוח.
- בשדה Extra Attributes Client Secret, מזינים את סוד הלקוח.
- ברשימה Extra Attributes Type, בוחרים סוג מאפיין למאפיינים הנוספים.
- בשדה Extra Attributes Filter, מזינים ביטוי סינון שישמש לשאילתות ב-Microsoft Graph API לקבוצות.
- לוחצים על Enable.
אחרי שמפעילים מאפיינים נוספים, אפשר ללחוץ על עריכה כדי לפתוח מחדש את תת-המשימה ולערוך את הפרטים, או ללחוץ על השבתה כדי להשבית את המאפיינים הנוספים.
- כדי להוסיף תנאי למאפיין:
- לוחצים על הוספת תנאי.
- בשדה Attribute Conditions, מזינים תנאי בפורמט CEL. לדוגמה, כדי להגביל את המאפיין
ipaddrלטווח מסוים של כתובות IP, אפשר ליצור את התנאיassertion.ipaddr.startsWith('98.11.12.').
- כדי להוסיף או לערוך מיפוי מאפיינים:
- כדי לאמת את המיפויים, לוחצים על שמירה ואחזור מחדש של הטוקן.
- כדי לסיים את ההגדרה, לוחצים על שמירה ויציאה.
זרם הענקת גישה משתמע
כדי ליצור ספק OIDC שמשתמש בזרם הענקת גישה משתמע לכניסה מבוססת-אינטרנט:
כדי להפעיל את טוקן של מזהה באפליקציית Microsoft Entra ID, בצע את הפעולות הבאות:
- עוברים לרישום של האפליקציה ב-Microsoft Entra ID.
- בקטע Authentication, מסמנים את התיבה טוקן של מזהה.
- לוחצים על Save.
- במסוף Google Cloud , נכנסים לדף Workforce Identity Pools:
- בטבלה Workforce Identity Pools, בוחרים את המאגר שרוצים ליצור לו ספק.
- בקטע ספקים, לוחצים על הוספת ספק.
- ברשימה Select a Provider vendor, בוחרים את ה-IdP.
אם ספק הזהויות שלכם לא מופיע ברשימה, בוחרים באפשרות ספק זהויות כללי.
- בקטע Select an authentication protocol, בוחרים באפשרות OpenID Connect (OIDC).
- בקטע Create a provider, מבצעים את הפעולות הבאות:
- בקטע שם, מזינים את שם הספק.
- בקטע Description, מזינים את תיאור הספק.
- בשדה Issuer (URL), מזינים את ה-URI של המנפיק. ה-URI של מנפיק OIDC צריך להיות בפורמט URI תקין ולהתחיל ב-
https. לדוגמה:https://example.com/oidc. - בשדה Client ID, מזינים את מזהה הלקוח ב-OIDC שרשום ב-IdP של OIDC. המזהה צריך להיות תואם להצהרת
audשל ה-JWT שמונפקת על ידי ה-IdP. - כדי ליצור ספק שמופעל, מוודאים שהאפשרות הפעלת הספק מופעלת.
- לוחצים על Continue.
- בקטע שיתוף פרטי הספק עם IdP, מעתיקים את כתובת ה-URL. ב-IdP, מגדירים את כתובת ה-URL הזו כ-URI להפניה אוטומטית, שמציין ל-IdP לאן לשלוח את אסימון טענת הנכוֹנוּת (assertion) אחרי ההתחברות.
- לוחצים על Continue.
- בקטע Configure OIDC Web Sign-in, מבצעים את הפעולות הבאות:
- ברשימה Flow type, בוחרים באפשרות טוקן של מזהה.
- ברשימה Assertion claims behavior, טוקן של מזהה נבחר.
- לוחצים על Continue.
- בקטע Configure provider, בקטע Detailed logging, לוחצים על המתג Enable attribute value audit logging.
רישום מפורט ביומן הביקורת של איחוד שירותי אימות הזהות של כוח עבודה מתעד ב-Logging את המידע שהתקבל מה-IdP. יומני ביקורת מפורטים יכולים לעזור לכם לפתור בעיות בהגדרות של הספק של מאגר הזהויות של כוח העבודה. כדי ללמוד איך לפתור שגיאות במיפוי מאפיינים באמצעות רישום מפורט ביומן הביקורת, קראו את המאמר שגיאות כלליות במיפוי מאפיינים. למידע על התמחור של Logging
כדי להשבית את יומן הביקורת המפורט של ספק מאגר הזהויות של כוח העבודה, משאירים את המתג Enable attribute value audit logging במצב כבוי כשיוצרים את הספק. כדי להשבית את רישום יומן הביקורת המפורט, אתם יכולים גם לעדכן את הספק.
- כדי ליצור את הספק, לוחצים על Submit.
אחרי שיוצרים את הספק, המערכת מפנה לדף המאפיינים של הספק.
כדי להגדיר מיפויים ותנאים של מאפיינים:
- כשמוצגת בקשה, נכנסים ל-IdP החיצוני כדי לאמת את מיפויי המאפיינים שמוגדרים כברירת מחדל.
- בדף המאפיינים של הספק, אפשר לראות ולערוך את מיפויי המאפיינים והתנאים:
- כדי להוסיף או לערוך מיפוי מאפיינים:
- לוחצים על הוספת מיפוי כדי להוסיף מיפוי חדש, או עורכים את המיפויים הקיימים.
- בשדה Google n, כאשר n הוא מספר, בוחרים מפתח שנתמך ב- Google Cloud.
- בשדה OIDC n התואם, מזינים את שם המאפיין של ספק הזהויות או ביטוי CEL.
ב-Microsoft Entra ID עם אימות OIDC, אנחנו ממליצים על מיפוי המאפיינים הבא:
google.subject=assertion.oid, google.groups=assertion.groups, google.display_name=assertion.preferred_usernameבדוגמה הזו, מאפייני ה-IdP
assertion.oid,assertion.groupsו-assertion.preferred_usernameממופים למאפייני Google Cloudgoogle.subject,google.groupsו-google.display_name, בהתאמה.
- כדי להגדיל את מספר הקבוצות:
- לוחצים על הפעלה כדי להוסיף מאפיינים נוספים.
- במשימת המשנה שנפתחת, מזינים את הפרטים:
- בשדה Extra Attributes Issuer URI, מזינים את כתובת ה-URL של המנפיק.
- בשדה Extra Attributes Client ID, מזינים את מזהה הלקוח.
- בשדה Extra Attributes Client Secret, מזינים את סוד הלקוח.
- ברשימה Extra Attributes Type, בוחרים סוג מאפיין למאפיינים הנוספים.
- בשדה Extra Attributes Filter, מזינים ביטוי סינון שישמש לשאילתות ב-Microsoft Graph API לקבוצות.
- לוחצים על Enable.
אחרי שמפעילים מאפיינים נוספים, אפשר ללחוץ על עריכה כדי לפתוח מחדש את תת-המשימה ולערוך את הפרטים, או ללחוץ על השבתה כדי להשבית את המאפיינים הנוספים.
- כדי להוסיף תנאי למאפיין:
- לוחצים על הוספת תנאי.
- בשדה Attribute Conditions, מזינים תנאי בפורמט CEL. לדוגמה, כדי להגביל את המאפיין
ipaddrלטווח מסוים של כתובות IP, אפשר ליצור את התנאיassertion.ipaddr.startsWith('98.11.12.').
- כדי להוסיף או לערוך מיפוי מאפיינים:
- כדי לאמת את המיפויים, לוחצים על שמירה ואחזור מחדש של הטוקן.
- כדי לסיים את ההגדרה, לוחצים על שמירה ויציאה.
יצירת ספק של מאגר זהויות של כוח עבודה ב-SAML 2.0
ב-IdP שתומך ב-SAML, רושמים אפליקציה חדשה לאיחוד שירותי אימות הזהות של כוח עבודה ב- Google Cloud.
מגדירים את הקהל לטענת הנכוֹנוּת (assertion) של SAML. בדרך כלל משתמשים בשדה
SP Entity IDבהגדרות שלכם ב-IdP. צריך להגדיר אותו כך שיכיל את כתובת ה-URL הבאה:https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_IDמגדירים את כתובת ה-URL להפניה אוטומטית, שנקראת גם כתובת ה-URL של Assertion Consumer Service (ACS). כדי להגדיר את כתובת ה-URL להפניה אוטומטית, מאתרים את השדה של כתובת ה-URL להפניה אוטומטית ב-IdP של SAML, ומבצעים אחת מהפעולות הבאות:
כדי להגדיר כניסה באמצעות דפדפן דרך מסוף Google Cloud או שיטת התחברות אחרת באמצעות דפדפן, מזינים את כתובת ה-URL הבאה:
https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_IDמחליפים את מה שכתוב בשדות הבאים:
WORKFORCE_POOL_ID: המזהה של מאגר הזהויות של כוח העבודה
WORKFORCE_PROVIDER_ID: המזהה של ספק הזהויות של כוח העבודה בארגון שתיצרו בהמשך המאמר.
כדי להגדיר כניסה פרוגרמטית דרך ה-IdP, מזינים את כתובת ה-URL הבאה:
localhost
פרטים נוספים זמינים במאמר הגדרת הגישה של משתמשים למסוף.
ב- Google Cloud, יוצרים ספק של מאגר זהויות של כוח עבודה ב-SAML, באמצעות מסמך המטא-נתונים של SAML ב-IdP שלכם. אתם יכולים להוריד את מסמך ה-XML של המטא-נתונים של SAML מה-IdP. המסמך צריך לכלול לפחות את הפרטים הבאים:
- מזהה ישות ב-SAML ל-IdP שלכם.
- כתובת ה-URL לכניסה יחידה (SSO) ל-IdP שלכם.
- לפחות מפתח ציבורי אחד לחתימה אפשר לקרוא פרטים נוספים על חתימת מפתחות בקטע דרישות עיקריות בהמשך המדריך הזה.
gcloud
כדי לשמור את המטא-נתונים של SAML לאפליקציית Microsoft Entra ID וליצור את הספק:
- נכנסים לאפליקציית Microsoft Entra ID.
- לוחצים על Single sign-on.
- מורידים את הקובץ Federation Metadata XML מהקטע SSL certificates.
- שומרים את המטא-נתונים כקובץ XML מקומי.
כדי ליצור את הספק של מאגר הזהויות לכוח העבודה ב-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" \
--vendor-type="entra-id" \
--detailed-audit-logging \
--location=global
מחליפים את מה שכתוב בשדות הבאים:
-
WORKFORCE_PROVIDER_ID: מזהה הספק. -
WORKFORCE_POOL_ID: המזהה של מאגר הזהויות של כוח העבודה. -
DISPLAY_NAME: שם לתצוגה. -
DESCRIPTION: תיאור. -
XML_METADATA_PATH: הנתיב לקובץ מטא-נתונים בפורמט XML עם המטא-נתונים של ההגדרות לספק הזהויות ב-SAML.
ATTRIBUTE_MAPPING: מיפוי המאפיינים, לדוגמה:google.subject=assertion.attributes['http://schemas.microsoft.com/identity/claims/objectidentifier'], attribute.costcenter=assertion.attributes.costcenter[0]בדוגמה הזו, המאפיין
assertion.attributes['http://schemas.microsoft.com/identity/claims/objectidentifier']ב-IdP ממופה ל-google.subject, והמאפייןassertion.attributes.costcenter[0]ב-IdP ממופה ל-attribute.costcenter.מידע נוסף זמין במאמר מיפוי מאפיינים.
ATTRIBUTE_CONDITION: תנאי למאפיין (לא חובה). לדוגמה, כדי להגביל את המאפייןipaddrלטווח מסוים של כתובות IP, אפשר ליצור את התנאיassertion.attributes.ipaddr.startsWith('98.11.12.'). התנאי לדוגמה הזה מבטיח שרק משתמשים עם כתובת IP שמתחילה ב-98.11.12.יוכלו להיכנס באמצעות ספק הזהויות הזה לכוח העבודה.
-
רישום מפורט ביומן הביקורת של איחוד שירותי אימות הזהות של כוח עבודה מתעד ב-Logging את המידע שהתקבל מה-IdP. יומני ביקורת מפורטים יכולים לעזור לכם לפתור בעיות בהגדרות של הספק של מאגר הזהויות של כוח העבודה. כדי ללמוד איך לפתור שגיאות במיפוי מאפיינים באמצעות רישום מפורט ביומן הביקורת, קראו את המאמר שגיאות כלליות במיפוי מאפיינים. למידע על התמחור של Logging
כדי להשבית את יומן הביקורת המפורט של ספק מאגר זהויות של כוח עבודה, משמיטים את הדגל
--detailed-audit-loggingכשמריצים אתgcloud iam workforce-pools providers create. כדי להשבית את הרישום המפורט ביומן הביקורת, אתם יכולים גם לעדכן את הספק.
אופציונלי: אישור טענות נכונות (assertions) של SAML מוצפן מ-IdP
כדי לאפשר לספק הזהויות ב-SAML 2.0 לייצר טענות נכונות מוצפנות שיתקבלו על ידי איחוד שירותי אימות הזהות של כוח העבודה:
- באיחוד שירותי אימות הזהות של כוח העבודה מבצעים את הפעולות הבאות:
- יוצרים זוג מפתחות אסימטריים בשביל הספק של מאגר הזהויות של כוח העבודה.
- מורידים קובץ אישור שמכיל את המפתח הציבורי.
- מגדירים את ספק הזהויות ב-SAML כך שישתמש במפתח הציבורי להצפנה של טענות הנכוֹנוּת שהוא מנפיק ב-SAML.
- מבצעים את הפעולות הבאות בספק הזהויות:
- מפעילים את ההצפנה של טענות הנכוֹנוּת, שנקראת גם הצפנה באמצעות אסימון.
- מעלים את המפתח הציבורי שיצרתם באיחוד שירותי אימות הזהות של כוח העבודה.
- מוודאים שה-IdP מייצר טענות נכונות (assertions) מוצפנות ב-SAML.
יצירת מפתחות הצפנה לטענות נכוֹנוּת ב-SAML של איחוד שירותי אימות הזהות של כוח העבודה
בחלק הזה מוסבר איך יוצרים זוג מפתחות אסימטריים שמאפשר לאיחוד שירותי אימות הזהות של כוח העבודה לקבל טענות נכוֹנוּת מוצפנות ב-SAML.
ב- Google Cloud , המערכת תשתמש במפתח פרטי כדי לפענח את טענות הנכונות של ה-SAML שה-IdP מנפיק. כדי ליצור זוג מפתחות אסימטריים להצפנה ב-SAML, מריצים את הפקודה הבאה. למידע נוסף, ראו אלגוריתמים נתמכים להצפנה ב-SAML.
gcloud iam workforce-pools providers keys create KEY_ID \ --workforce-pool WORKFORCE_POOL_ID \ --provider WORKFORCE_PROVIDER_ID \ --location global \ --use encryption \ --spec KEY_SPECIFICATION
מחליפים את מה שכתוב בשדות הבאים:
-
KEY_ID: שם המפתח שבחרתם -
WORKFORCE_POOL_ID: מזהה המאגר -
WORKFORCE_PROVIDER_ID: המזהה של ספק מאגר הזהויות של כוח העבודה -
KEY_SPECIFICATION: מפרט המפתחות, שיכול להיות אחד מאלה:rsa-2048, rsa-3072אוrsa-4096.
אחרי שיוצרים את זוג המפתחות, מריצים את הפקודה הבאה כדי להוריד את המפתח הציבורי לקובץ האישור. רק לאיחוד שירותי אימות הזהות של כוח העבודה יש גישה למפתח הפרטי.
gcloud iam workforce-pools providers keys describe KEY_ID \ --workforce-pool WORKFORCE_POOL_ID \ --provider WORKFORCE_PROVIDER_ID \ --location global \ --format "value(keyData.key)" \ > CERTIFICATE_PATH
מחליפים את מה שכתוב בשדות הבאים:
-
KEY_ID: שם המפתח -
WORKFORCE_POOL_ID: מזהה המאגר -
WORKFORCE_PROVIDER_ID: המזהה של ספק מאגר הזהויות של כוח העבודה CERTIFICATE_PATH: הנתיב שבו האישור ייכתב. לדוגמה:saml-certificate.cerאוsaml-certificate.pem
הגדרת ה-IdP שתואם ל-SAML 2.0 כדי להנפיק טענות נכונות (assertions) של SAML מוצפן
כדי להגדיר את Microsoft Entra ID להצפנת אסימוני SAML, ראו <a href="https://learn.microsoft.com/en-us/azure/active-directory/manage-apps/howto-saml-token-encryption?tabs=azure-portal"
הגדרת הצפנה באמצעות אסימונים ב-SAML ב-Azure Active Directory.
אחרי שמגדירים את ה-IdP כך שיצפין את טענות הנכונות (assertions) ב-SAML, מומלץ לוודא שטענות הנכונות שהוא מפיק באמת מוצפנות. גם אם מוגדר להצפין את טענות הנכוֹנוּת ב-SAML, איחוד שירותי אימות הזהות של כוח העבודה עדיין יכול לעבד טענות נכוֹנוּת עם טקסט ללא הצפנה.
איך מוחקים את מפתחות ההצפנה של איחוד שירותי אימות הזהות של כוח העבודה
כדי למחוק את מפתחות ההצפנה ב-SAML, מריצים את הפקודה הבאה: gcloud iam workforce-pools providers keys delete KEY_ID \ --workforce-pool WORKFORCE_POOL_ID \ --provider WORKFORCE_PROVIDER_ID \ --location globalמחליפים את מה שכתוב בשדות הבאים:
-
KEY_ID: שם המפתח-
WORKFORCE_POOL_ID: מזהה המאגר-
WORKFORCE_PROVIDER_ID: המזהה של ספק מאגר הזהויות של כוח העבודה
אלגוריתמי הצפנה נתמכים של SAML
באיחוד שירותי אימות הזהות של כוח העבודה אפשר להשתמש באלגוריתמים הבאים להעברת מפתחות:
- http://www.w3.org/2001/04/xmlenc#rsa-oaep-mgf1p
- http://www.w3.org/2009/xmlenc11#rsa-oaep"
- http://www.w3.org/2001/04/xmlenc#rsa-1_5"
באיחוד שירותי אימות הזהות של כוח העבודה אפשר להשתמש באלגוריתמים הבאים להצפנת בלוקים:
המסוף
כדי להגדיר את הספק שתומך ב-SAML באמצעות מסוף Google Cloud :
- במסוף Google Cloud , נכנסים לדף Workforce Identity Pools:
- בטבלה Workforce Identity Pools, בוחרים את המאגר שרוצים ליצור לו ספק.
- בקטע Providers, לוחצים על Add Provider.
- ברשימה Select a Provider vendor, בוחרים את ה-IdP.
אם ספק הזהויות שלכם לא מופיע ברשימה, בוחרים באפשרות ספק זהויות כללי.
- בקטע Select an authentication protocol, בוחרים באפשרות SAML.
- בקטע Create a provider, מבצעים את הפעולות הבאות:
- בקטע שם, מזינים שם לספק.
- אופציונלי: בשדה תיאור, מזינים תיאור של הספק.
- בשדה IDP metadata file (XML), בוחרים את קובץ ה-XML של המטא-נתונים שיצרתם קודם במדריך הזה.
- כדי ליצור ספק שמופעל, מוודאים שהאפשרות הפעלת הספק מופעלת.
- לוחצים על Continue.
- בקטע Share your provider information, מעתיקים את כתובות ה-URL. ב-IdP, מגדירים את כתובת ה-URL הראשונה כמזהה ישות ב-SAML, שמזהה את האפליקציה ב-IdP. מגדירים את כתובת ה-URL השנייה בתור ה-URI להפניה אוטומטית, שמציין ל-IdP לאן לשלוח את אסימון ההצהרה אחרי הכניסה.
- לוחצים על Continue.
- בקטע Configure provider, בקטע Detailed logging, לוחצים על המתג Enable attribute value audit logging.
רישום מפורט ביומן הביקורת של איחוד שירותי אימות הזהות של כוח עבודה מתעד ב-Logging את המידע שהתקבל מה-IdP. יומני ביקורת מפורטים יכולים לעזור לכם לפתור בעיות בהגדרות של הספק של מאגר הזהויות של כוח העבודה. כדי ללמוד איך לפתור שגיאות במיפוי מאפיינים באמצעות רישום מפורט ביומן הביקורת, קראו את המאמר שגיאות כלליות במיפוי מאפיינים. למידע על התמחור של Logging
כדי להשבית את יומן הביקורת המפורט של ספק מאגר הזהויות של כוח העבודה, משאירים את המתג Enable attribute value audit logging במצב כבוי כשיוצרים את הספק. כדי להשבית את רישום יומן הביקורת המפורט, אתם יכולים גם לעדכן את הספק.
- כדי ליצור את הספק, לוחצים על Submit.
אחרי שיוצרים את הספק, המערכת מפנה לדף המאפיינים של הספק.
כדי להגדיר מיפויים ותנאים של מאפיינים:
- כשמוצגת בקשה, נכנסים ל-IdP החיצוני כדי לאמת את מיפויי המאפיינים שמוגדרים כברירת מחדל.
- בדף המאפיינים של הספק, אפשר לראות ולערוך את מיפויי המאפיינים והתנאים:
- כדי להוסיף או לערוך מיפוי מאפיינים:
- לוחצים על הוספת מיפוי כדי להוסיף מיפוי חדש, או עורכים את המיפויים הקיימים.
- בשדה Google n, כאשר n הוא מספר, בוחרים מפתח Google Cloud נתמך.
- בשדה SAML n התואם, מזינים את שם המאפיין של ה-IdP או ביטוי CEL, לדוגמה:
google.subject=assertion.attributes['http://schemas.microsoft.com/identity/claims/objectidentifier'], attribute.costcenter=assertion.attributes.costcenter[0]בדוגמה הזו, המאפיין
assertion.attributes['http://schemas.microsoft.com/identity/claims/objectidentifier']ב-IdP ממופה ל-google.subject, והמאפייןassertion.attributes.costcenter[0]ב-IdP ממופה ל-attribute.costcenter.
- כדי להגדיל את מספר הקבוצות:
- לוחצים על הפעלה כדי להוסיף מאפיינים נוספים.
- במשימת המשנה שנפתחת, מזינים את הפרטים:
- בשדה Extra Attributes Issuer URI, מזינים את כתובת ה-URL של המנפיק.
- בשדה Extra Attributes Client ID, מזינים את מזהה הלקוח.
- בשדה Extra Attributes Client Secret, מזינים את סוד הלקוח.
- ברשימה Extra Attributes Type, בוחרים סוג מאפיין למאפיינים הנוספים.
- בשדה Extra Attributes Filter, מזינים ביטוי סינון שישמש לשאילתות ב-Microsoft Graph API לקבוצות.
- לוחצים על Enable.
אחרי שמפעילים מאפיינים נוספים, אפשר ללחוץ על עריכה כדי לפתוח מחדש את תת-המשימה ולערוך את הפרטים, או ללחוץ על השבתה כדי להשבית את המאפיינים הנוספים.
- כדי להוסיף תנאי מאפיין:
- לוחצים על הוספת תנאי.
- בשדה Attribute Conditions, מזינים תנאי בפורמט CEL. לדוגמה, כדי להגביל את המאפיין
ipaddrלטווח מסוים של כתובות IP, אפשר ליצור את התנאיassertion.attributes.ipaddr.startsWith('98.11.12.'). התנאי לדוגמה הזה מבטיח שרק משתמשים עם כתובת IP שמתחילה ב-98.11.12.יוכלו להיכנס באמצעות ספק הזהויות הזה לכוח העבודה.
- כדי להוסיף או לערוך מיפוי מאפיינים:
- כדי לאמת את המיפויים, לוחצים על שמירה ואחזור מחדש של הטוקן.
- כדי לסיים את ההגדרה, לוחצים על שמירה ויציאה.
אימות ההגדרות של הספק
לפני שבודקים את תהליך הכניסה של משתמשי הקצה, אפשר לוודא שהגדרת הספק נכונה ושאפשר להחליף אסימונים בין Google Cloud לבין ה-IdP.
הדף Validate your provider attributes במסוף Google Cloud כולל כלי להצגת מאפיינים, שמאפשר לבדוק באופן אינטראקטיבי את ההגדרות ולנפות באגים בביטויים של Common Expression Language (CEL). אתם יכולים להשתמש בכלי להצגת מאפיינים כדי:
- לראות את המאפיינים הגולמיים שנשלחו בטענת הנכוֹנוּת (assertion) של ה-IdP.
- מוודאים שמיפויי המאפיינים והתנאים משנים את המאפיינים האלה בצורה נכונה.
- ניפוי באגים של ביטויי CEL מורכבים בזמן אמת.
כדי לאמת את הגדרת הספק:
- כדי להפעיל את תהליך הכניסה מבוסס-הדפדפן לאיחוד שירותי אימות הזהות של כוח עבודה, צריך להוסיף את
https://auth.cloud.google/signin-callback/locations/global/workforcePools/POOL_ID/providers/PROVIDER_IDלרשימת ה-URIs המותרים להפניה אוטומטית של ה-IdP. -
במסוף Google Cloud , נכנסים לדף Workforce Identity Pools.
כניסה לדף Workforce Identity Pools - ברשימת המאגרים, לוחצים על שם המאגר שרוצים לאמת.
- בדף Workforce pool details, לוחצים על השם של ה-IdP שרוצים לאמת.
- בדף פרטי הספק, לוחצים על ניפוי באגים של אסימון IdP.
- בתיבת הדו-שיח Sign in, נכנסים ל-IdP כמשתמש לבדיקה.
בדף Validate your provider attributes מוצגים המאפיינים הממופים והתוצאה של תנאי המאפיין.
בקטע Mapped attributes from your IdP token מוצג איך מאפיינים של Google, כמו google.subject, מאוכלסים מהאסימון של ה-IdP על סמך הגדרת המיפוי. אם המיפוי שגוי, מופיע סמל שגיאה.
בקטע Attribute condition מוצגת התוצאה הבוליאנית של התנאי. אם התנאי מקבל את הערך false, הכניסה נחסמת.
כדי לראות את אסימון ההצהרה המלא, לוחצים על הצגת האסימון המלא. כאן מוצג אובייקט ה-JSON הגולמי מספק הזהויות. כדי להפנות למאפיין ברמה העליונה במיפויים, משתמשים בפורמט assertion.PROPERTY_NAME.
עריכת הגדרות הספק
כדי לתקן שגיאות, אפשר לערוך את ההגדרות:
- בדף Validate your provider attributes, לוחצים על Edit.
- מבצעים את השינויים הנדרשים.
- כדי להתחיל בדיקה חדשה ולראות את התוצאות המעודכנות, לוחצים על שמירה ואחזור מחדש של הטוקן.
ניהול הגישה למשאבים של Google Cloud
הקטע הזה מדגים ניהול גישה למשאבים שלGoogle Cloud באמצעות המשתמשים באיחוד שירותי אימות הזהות של כוח העבודה.
בדוגמה הזו, מקצים תפקיד בממשק לניהול הזהויות והרשאות הגישה (IAM) בפרויקט לדוגמה. לאחר מכן המשתמשים יוכלו להיכנס לחשבון ולהשתמש בפרויקט כדי לקבל גישה למוצרי Google Cloud .
אפשר לנהל תפקידים ב-IAM לזהויות בודדות, לקבוצת זהויות או למאגר שלם. מידע נוסף מופיע במאמר מזהים של חשבונות משתמשים של כוח עבודה במדיניות הרשאות.
באמצעות קבוצות ממופות
כדי לתת את התפקיד Storage Admin (roles/storage.admin) בפרויקט TEST_PROJECT_ID לכל הזהויות בקבוצה GROUP_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
לזהויות בודדות
כדי להקצות את התפקיד Storage Admin (roles/storage.admin) לזהות יחידה של הפרויקט TEST_PROJECT_ID, מריצים את הפקודה הבאה:
gcloud projects add-iam-policy-binding TEST_PROJECT_ID \
--role="roles/storage.admin" \
--member="principal://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/subject/SUBJECT_VALUE"
מחליפים את מה שכתוב בשדות הבאים:
-
TEST_PROJECT_ID: מזהה פרויקט הבדיקה -
WORKFORCE_POOL_ID: המזהה של מאגר הזהויות של כוח העבודה -
SUBJECT_VALUE: זהות המשתמש
באמצעות מאפיין של מחלקה ממופה
כדי להקצות את התפקיד 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
כניסה לחשבון ובדיקת גישה
בקטע הזה נכנסים כמשתמש של מאגר הזהויות של כוח העבודה ובודקים שיש גישה למשאבים של Google Cloud .
כניסה
בקטע הזה מוסבר איך נכנסים כמשתמש מאיחוד שירותי האימות ומקבלים גישה למשאביGoogle Cloud .
כניסה לחשבון במסוף (איחוד)
כדי להיכנס למסוף של Google Cloud איחוד זהויות של כוח עבודה, שנקרא גם המסוף (המאוחד), מבצעים את הפעולות הבאות:
-
עוברים לדף הכניסה של המסוף (איחוד).
-
מזינים את שם הספק בפורמט הבא:
locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
אם מופיעה בקשה, מזינים את פרטי הכניסה של המשתמש ב-Microsoft Entra ID.
אם התחלתם תהליך כניסה באמצעות ספק הזהויות, השתמשו בכתובת ה-URL הבאה בשביל שרת הממסר: https://console.cloud.google/.
כניסה באמצעות הדפדפן ל-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:
משתנה הסביבה
כדי להשתמש בקובץ התצורה של ההתחברות עם משתנה סביבה, מבצעים את ההוראות הבאות:
-
מגדירים את משתנה הסביבה
CLOUDSDK_AUTH_LOGIN_CONFIG_FILEלנתיב של קובץ התצורה להתחברות. -
מריצים את הפקודה הבאה:
gcloud auth login
- ה-CLI של gcloud מפנה למשתנה הסביבה כדי למצוא את קובץ התצורה של ההתחברות, ואז מתחיל את תהליך האימות. פועלים לפי התהליך בדפדפן כדי לאמת את ה-CLI של gcloud ולתת לו הרשאה לגשת למשאבים בשמכם בפקודות עתידיות.
כדי להפסיק להשתמש בקובץ התצורה של הכניסה לפקודות gcloud auth login, צריך לנקות את משתנה הסביבה CLOUDSDK_AUTH_LOGIN_CONFIG_FILE.
ההגדרות האישיות של ה-CLI של gcloud
כדי להשתמש בקובץ התצורה של ההתחברות עם מאפיין תצורה של ה-CLI של gcloud, פועלים לפי ההוראות הבאות:
-
מגדירים את המאפיין
auth/login_config_fileשל מערך ההגדרות האישיות הפעיל של ה-CLI של gcloud לנתיב של קובץ התצורה של ההתחברות, באמצעות הפקודה הבאה:gcloud config set auth/login_config_file LOGIN_CONFIG_PATH
-
מריצים את הפקודה הבאה:
gcloud auth login
- ה-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
כדי להיכנס ל-Microsoft Entra ID באמצעות ה-CLI של gcloud:
OIDC
מבצעים את הפעולות לשליחת בקשת הכניסה. נכנסים עם חשבון המשתמש לאפליקציית Microsoft Entra ID באמצעות OIDC.
מעתיקים את הטוקן של המזהה מהפרמטר
id_tokenשל כתובת ה-URL להפניה אוטומטית, ושומרים אותו בקובץ במיקום מאובטח במחשב המקומי. בהמשך יהיה צורך להגדיר את PATH_TO_OIDC_ID_TOKEN לנתיב של הקובץ הזה.מריצים את הפקודה הבאה כדי ליצור קובץ תצורה שדומה לדוגמה שבהמשך:
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:id_token \ --credential-source-file=PATH_TO_OIDC_ID_TOKEN \ --workforce-pool-user-project=WORKFORCE_POOL_USER_PROJECT \ --output-file=config.jsonמחליפים את מה שכתוב בשדות הבאים:
-
WORKFORCE_POOL_ID: המזהה של מאגר הזהויות של כוח העבודה. -
WORKFORCE_PROVIDER_ID: המזהה של ספק מאגר הזהויות של כוח העבודה. -
PATH_TO_OIDC_ID_TOKEN: הנתיב למיקום של הקובץ שבו שמור האסימון של ספק הזהויות -
WORKFORCE_POOL_USER_PROJECT: מספר או מזהה הפרויקט שמשמש למכסות ולחיוב לחשבון המשתמש צריכה להיות הרשאתserviceusage.services.useבפרויקט הזה.
בסיום הפקודה, Microsoft Entra ID יוצר את קובץ התצורה הבא:
{ "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:id_token", "token_url": "https://sts.googleapis.com/v1/token", "workforce_pool_user_project": "WORKFORCE_POOL_USER_PROJECT", "credential_source": { "file": "PATH_TO_OIDC_CREDENTIALS" } }-
פותחים את ה-CLI של gcloud ומריצים את הפקודה הבאה:
gcloud auth login --cred-file=PATH_TO_OIDC_CREDENTIALSמחליפים את PATH_TO_OIDC_CREDENTIALS בנתיב של קובץ הפלט מהשלב הקודם.
ה-CLI של gcloud יפרסם בצורה שקופה את פרטי הכניסה לנקודת הקצה של Security Token Service. בנקודת הקצה, הפרטים מוחלפים בטוקני גישה זמניים ל- Google Cloud .
עכשיו תוכלו להריץ ב-Google Cloudפקודות באמצעות ה-CLI של gcloud.
SAML
נכנסים עם חשבון משתמש לאפליקציית Microsoft Entra ID ומקבלים את התגובה ב-SAML.
שומרים את התגובה ב-SAML שמוחזרת על ידי Microsoft Entra ID במיקום מאובטח במחשב המקומי ואז שומרים את הנתיב בצורה הבאה:
SAML_ASSERTION_PATH=SAML_ASSERTION_PATHכדי ליצור קובץ תצורה של פרטי הכניסה, מריצים את הפקודה הבאה:
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מחליפים את מה שכתוב בשדות הבאים:
-
WORKFORCE_PROVIDER_ID: המזהה של ספק הזהויות של כוח העבודה שיצרתם קודם במדריך הזה. -
WORKFORCE_POOL_ID: המזהה של מאגר הזהויות של כוח העבודה שיצרתם קודם במדריך -
SAML_ASSERTION_PATH: הנתיב לקובץ של טענת הנכונות ב-SAML -
PROJECT_ID: מזהה הפרויקט
קובץ התצורה שנוצר נראה כך:
{ "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" }-
כדי להתחבר ל-CLI של gcloud באמצעות החלפת אסימונים של איחוד שירותי אימות הזהות של כוח עבודה, מריצים את הפקודה הבאה:
gcloud auth login --cred-file=config.jsonלאחר מכן, ה-CLI של gcloud ממיר באופן שקוף את פרטי הכניסה של Microsoft Entra ID לטוקני גישה זמניים של Google Cloud . טוקני הגישה מאפשרים לכם לגשת אל Google Cloud.
הפלט אמור להיראות כך:
Authenticated with external account user credentials for: [principal://iam.googleapis.com/locations/global/workforcePools/
WORKFORCE_POOL_ID/subject/USER_ID].כדי להציג את החשבונות עם פרטי הכניסה ואת החשבון הפעיל, מריצים את הפקודה הבאה:
gcloud auth list
בדיקת הגישה
עכשיו יש לכם גישה למוצרי Google Cloud שתומכים באיחוד שירותי אימות הזהות של כוח העבודה, ושאליהם ניתנה לכם גישה. מוקדם יותר במסמך הזה, נתתם את התפקיד "אדמין של נפח אחסון" (roles/storage.admin) לכל הזהויות במזהה הקבוצה שציינתם ב-gcloud projects add-iam-policy-binding לפרויקט TEST_PROJECT_ID.
עכשיו תוכלו לבדוק אם יש לכם גישה על ידי הצגת הרשימה של הקטגוריות של Cloud Storage.
המסוף (איחוד)
כדי לבדוק אם יש לכם גישה באמצעות המסוף (המאוחד):
מעבר לדף Cloud Storage.
מוודאים שאפשר לראות את רשימת הקטגוריות הקיימות של
TEST_PROJECT_ID.
CLI של gcloud
כדי לבדוק אם יש לכם גישה באמצעות ה-CLI של gcloud, אתם יכולים להציג את הקטגוריות והאובייקטים של Cloud Storage בפרויקט שיש לכם גישה אליו. כדי לעשות את זה, מריצים את הפקודה הבאה: לחשבון המשתמש צריכה להיות ההרשאה serviceusage.services.use בפרויקט שצוין.
gcloud storage ls --project="TEST_PROJECT_ID"
מחק משתמשים
איחוד שירותי אימות הזהות של כוח העבודה יוצר מטא-נתונים ומשאבים של משתמשים לזהויות משתמשים מאוחדות. אם אתם בוחרים למחוק משתמשים ב-IdP, אתם צריכים למחוק את המשאבים האלה באופן מפורש גם ב- Google Cloud. כדי לעשות את זה, קראו את המאמר מחיקת המשתמשים באיחוד שירותי אימות הזהות של כוח עבודה והנתונים שלהם.
כדי לסיים באופן מיידי את הסשנים הפעילים של משתמש, אתם יכולים לבטל את הסשנים שלו. מידע נוסף מופיע במאמר ביטול סשנים של משתמשים באיחוד שירותי אימות הזהות של כוח עבודה.יכול להיות שמשאבים ימשיכו להיות משויכים למשתמש שנמחק. הסיבה לכך היא שמחיקת מטא-נתונים ומשאבים של משתמשים דורשת פעולה ארוכה. אחרי שמתחילים למחוק זהות של משתמש, תהליכים שהמשתמש התחיל לפני המחיקה יכולים להמשיך לפעול עד שהם מסתיימים או מבוטלים.
המאמרים הבאים
- הגדרת SCIM ב-Microsoft Entra ID
- מחיקת המשתמשים באיחוד שירותי אימות הזהות של כוח עבודה והנתונים שלהם
- ביטול סשנים של משתמשים באיחוד שירותי אימות הזהות של כוח עבודה
- מוצרי שתומכים באיחוד שירותי אימות הזהות של כוח העבודה Google Cloud
- הגדרת גישה של משתמשים למסוף (מאוחד)