כל נושא – משתמש או קבוצה – עובר תהליך דו-שלבי כדי לקבל גישה לשרת ה-API הגלובלי. מתן הרשאות לנושא בשרת ה-API הגלובלי באמצעות IAMRoleBinding ל-IAMRole מוגדר מראש. כל התפקידים וקישורי התפקידים הם גלובליים.
הדף הזה מיועד לאדמינים של הפלטפורמה שמנהלים את ההרשאות בארגון. מידע נוסף זמין במאמר קהלי היעד של GDC עם air gap.
לפני שמתחילים
לפני שמנהלים את קישורי התפקידים או מבטלים את הגישה, צריך לבקש את ההרשאות הנדרשות ולהכין את הסביבה. התפקידים הספציפיים שנדרשים תלויים בפעולה שאתם מבצעים: ניהול של קישורי תפקידים או ביטול של גישת משתמשים.
בקשת תפקידים ב-IAM
כדי לבקש את התפקידים שמתאימים למשימות שאתם צריכים לבצע, פנו למנהל חשבון ארגוני ב-IAM:
- מנהל חשבון ארגוני ב-IAM (
organization-iam-admin): יצירה, עדכון ומחיקה של קישורי תפקידים ברמת הארגון וברמת הפרויקט. - מנהל חשבון ארגוני של סשנים (
org-session-admin): ביטול הסשנים הפעילים והגישה של משתמש באזור ספציפי.
הכנת הסביבה
כדי להשתמש בכלים של שורת הפקודה לניהול קישורי תפקידים או לביטול גישה, צריך לבצע את ההגדרה הבאה.
- מורידים ומתקינים את ה-gdcloud CLI, אם עדיין לא עשיתם את זה.
- כדי להשתמש ב-API עם
kubectl, צריך לבצע הגדרה נוספת:
הגדרת קישורי תפקידים
אתם יכולים להגדיר קישורי תפקידים שנותנים לחברי הצוות גישה למשאבים ברמת הארגון או ברמת הפרויקט.
הקצאת תפקיד למשתמש מורשה:
המסוף
- נכנסים למסוף GDC.
- בוחרים ארגון או פרויקט בכלי לבחירת היקף.
- כדי להגדיר קישורי תפקידים לארגון, בוחרים ארגון.
- כדי להגדיר קישורי תפקידים לפרויקט, בוחרים פרויקט.
- בתפריט הניווט, לוחצים על Identity and Access > Access.
- לוחצים על הוספת חבר.
- בוחרים אם להוסיף משתמשים ספציפיים או קבוצות.
- ברשימה Identity provider, בוחרים ספק זהויות.
- בשדה שם משתמש או כתובת אימייל חלופית של קבוצה, מזינים את שם המשתמש, כתובת האימייל או כתובת האימייל החלופית.
- ברשימה Role, בוחרים את התפקיד שרוצים להקצות למשתמש או לקבוצה, למשל Organization Viewer ברמת הארגון או Project Creator ברמת הפרויקט.
- לוחצים על הוספה.
המשתמש מופיע ברשימה משתמשים מורשים.
gdcloud
מוודאים שהתקנתם את ה-CLI של gdcloud.
נכנסים באמצעות הפקודה
gdcloud auth loginכדי לאמת את ספק הזהויות. מידע נוסף זמין במאמר אימות ב-gdcloud CLI.מגדירים קישורי תפקידים.
הגדרת קישורי תפקידים לארגון:
gdcloud organizations add-iam-policy-binding ORGANIZATION \ --member=USER_ACCOUNT \ --role=ROLEמחליפים את המשתנים הבאים:
-
ORGANIZATION: שם הארגון שבו מגדירים את קישור התפקידים. -
USER_ACCOUNT: חשבון המשתמש שרוצים לתת לו את התפקיד. הדגל הזה מקבל כתובת אימייל של משתמש עם הקידומת של ספק הזהויות (user:idpprefix-user@example.com) או שם של חשבון שירות עם הפרויקט של חשבון השירות (serviceAccount:projectName:serviceAccountName). -
ROLE: השם של התפקיד המוגדר מראש או התפקיד בהתאמה אישית שרוצים להקצות למשתמש.
-
הגדרת קישורי תפקידים לפרויקט:
gdcloud projects add-iam-policy-binding PROJECT \ --member=USER_ACCOUNT \ --role=ROLEמחליפים את המשתנים הבאים:
-
PROJECT: שם הפרויקט שבו מגדירים את קישור התפקידים. -
USER_ACCOUNT: חשבון המשתמש שרוצים לתת לו את התפקיד. הדגל הזה מקבל כתובת אימייל של משתמש עם הקידומת של ספק הזהויות (user:idpprefix-user@example.com) או שם של חשבון שירות עם הפרויקט של חשבון השירות (serviceAccount:projectName:serviceAccountName). -
ROLE: השם של התפקיד המוגדר מראש או התפקיד בהתאמה אישית שרוצים להקצות למשתמש.
-
API
מייצאים את משתני הסביבה של קישור התפקיד:
export GLOBAL_API_SERVER_KUBECONFIG=GLOBAL_API_SERVER_KUBECONFIG export USERNAME=IDP_PREFIX-USERNAME export ROLE_NAME=ROLE_NAME export BINDING_NAMESPACE=BINDING_NAMESPACE export USER_EMAIL=IDP_PREFIX-USER_EMAILמחליפים את מה שכתוב בשדות הבאים:
-
GLOBAL_API_SERVER_KUBECONFIG: הנתיב לקובץ kubeconfig של שרת ה-API הגלובלי. -
IDP_PREFIX: הקידומת של ספק הזהויות. -
USERNAME: החלק של שם המשתמש בכתובת האימייל של המשתמש לפני הסמל@(למשלpaulמתוךpaul@example.com). -
ROLE_NAME: שם התפקיד שהמשתמש צריך (למשלproject-creator). רשימה של התפקידים וההיקף שלהם מופיעה בקטע הגדרות תפקידים. -
BINDING_NAMESPACE:platformלתפקידים ברמת הארגון, או השם של מרחב השמות של פרויקט היעד לתפקידים ברמת הפרויקט. -
USER_EMAIL: כתובת האימייל של חשבון המשתמש שרוצים להקצות לו את התפקיד (למשלpaul@example.com).
-
יוצרים ומחילים משאב מותאם אישית של
IAMRoleBinding:cat <<EOF | kubectl --kubeconfig ${GLOBAL_API_SERVER_KUBECONFIG} apply -f - apiVersion: iam.global.gdc.goog/v1 kind: IAMRoleBinding metadata: name: ${USERNAME}-${ROLE_NAME}-binding namespace: ${BINDING_NAMESPACE} spec: roleRef: apiGroup: iam.global.gdc.goog kind: IAMRole name: ${ROLE_NAME} subjects: - apiGroup: rbac.authorization.k8s.io kind: User name: ${USER_EMAIL} EOF
הסרה של קישורי תפקידים
כשכבר לא צריך את הגישה, מסירים את החבר ואת התפקידים, ההרשאות והגישה שמשויכים אליו.
כדי להסיר חברים, פועלים לפי השלבים הבאים:
המסוף
- נכנסים למסוף GDC.
- בתפריט הניווט, לוחצים על Identity and Access > Access.
- ברשימה Authorized members, בוחרים חבר.
- לוחצים על הסרה מהקבוצה המשפחתית.
- כשמופיעה בקשה, לוחצים על הסרה מהקבוצה המשפחתית כדי לאשר.
gdcloud
מוודאים שהתקנתם את ה-CLI של gdcloud.
נכנסים באמצעות הפקודה
gdcloud auth loginכדי לאמת את ספק הזהויות. מידע נוסף זמין במאמר אימות ב-gdcloud CLI.הסרת קישורי תפקידים.
הסרת קישורי תפקידים לארגון:
gdcloud organizations remove-iam-policy-binding ORGANIZATION \ --member=USER_ACCOUNT \ --role=ROLEמחליפים את המשתנים הבאים:
-
ORGANIZATION: שם הארגון שממנו מסירים את קישור התפקידים. -
USER_ACCOUNT: חשבון המשתמש שממנו רוצים להסיר את התפקיד. הדגל הזה מקבל כתובת אימייל של משתמש עם הקידומת של ספק הזהויות (user:idpprefix-user@example.com) או שם של חשבון שירות עם הפרויקט של חשבון השירות (serviceAccount:projectName:serviceAccountName). -
ROLE: השם של התפקיד המוגדר מראש או בהתאמה אישית שרוצים להסיר מחשבון המשתמש.
-
הסרת קישורי תפקידים בפרויקט:
gdcloud projects remove-iam-policy-binding PROJECT \ --member=USER_ACCOUNT \ --role=ROLEמחליפים את המשתנים הבאים:
-
PROJECT: שם הפרויקט שממנו מסירים את קישור התפקידים. -
USER_ACCOUNT: חשבון המשתמש שממנו רוצים להסיר את התפקיד. הדגל הזה מקבל כתובת אימייל של משתמש עם הקידומת של ספק הזהויות (user:idpprefix-user@example.com) או שם של חשבון שירות עם הפרויקט של חשבון השירות (serviceAccount:projectName:serviceAccountName). -
ROLE: השם של התפקיד המוגדר מראש או בהתאמה אישית שרוצים להסיר מחשבון המשתמש.
-
kubectl
מוחקים את IAMRoleBinding כדי לבטל את ההרשאה שניתנה לחשבון ה-PA:
kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG \
delete iamrolebinding IDP_PREFIX-USERNAME-ROLE_NAME-binding -n BINDING_NAMESPACE
מחליפים את מה שכתוב בשדות הבאים:
- GLOBAL_API_SERVER_KUBECONFIG: הנתיב לקובץ kubeconfig של שרת ה-API הגלובלי.
- IDP_PREFIX: הקידומת של ספק הזהויות.
- USERNAME: החלק של שם המשתמש בכתובת האימייל של המשתמש לפני הסמל
@(למשלpaulמתוךpaul@example.com). - ROLE_NAME: שם התפקיד שרוצים להסיר, למשל
project-creator. - BINDING_NAMESPACE: מחליפים ב-
platformלתפקידים ברמת הארגון, או בשם של מרחב השמות של פרויקט היעד לתפקידים ברמת הפרויקט.
ביטול גישת משתמשים
אם חבר צוות עוזב את הארגון או את הצוות, אתם יכולים לבטל את הגישה שלו ל-Google Distributed Cloud (GDC) עם air gap. ביטול הגישה של משתמש מוציא אותו מ-Distributed Cloud ומסיר את התפקידים וההרשאות שלו. אפשר גם להציג את הפעילות והסשנים של המשתמש לפי שעת ההתחלה והסיום שלהם.
כדי לבטל את הגישה של משתמש בכל סביבת GDC, צריך לבטל את הגישה לכל אזור בנפרד. מבצעים את הפעולות הבאות בכל אזור:
מוודאים שאתם מחוברים לאזור שאתם רוצים לבטל את הגישה אליו. לדוגמה, מגדירים את כתובת ה-URL של האזור ב-gdcloud CLI ואז נכנסים לחשבון:
gdcloud config set organization_console_url ZONE_URL gdcloud auth loginמחליפים את
ZONE_URLבכתובת ה-URL של מסוף GDC לאזור שבו רוצים לבטל את הגישה של המשתמש, בדומה ל-https://console.ORG_NAME.ZONE_NAME.ORG_SUFFIX.למידע נוסף על מעבר בין הקשרים אזוריים, קראו את המאמר גישה לאזורים באמצעות הכלים שלכם.
מבטלים את הגישה של המשתמש לאזור:
gdcloud admin auth revoke --accounts USER_EMAILמחליפים את USER_EMAIL בכתובת האימייל של המשתמש שרוצים לבטל את הגישה שלו.
אחרי הרצת הפקודה, הפלט אמור להיראות כך: בדוגמה הזו, הגישה של המשתמש
ariel@example.comמבוטלת:Success: NUMBER of sessions revoked for user ariel@example.comבדוגמה הזו, המשתנה NUMBER מתייחס למספר הסשנים הפעילים של המשתמש.
כדי לוודא שהגישה של המשתמש בוטלה, מריצים שוב את הפקודה
gdcloud admin auth revoke. אם הפעולה בוצעה ללא שגיאות, יוצג הפלט הבא:No sessions found for account: ariel@example.comחוזרים על השלבים הקודמים לכל אזור ביקום.