הענקה וביטול של הרשאות גישה

כל נושא – משתמש או קבוצה – עובר תהליך דו-שלבי כדי לקבל גישה לשרת ה-API הגלובלי. מתן הרשאות לנושא בשרת ה-API הגלובלי באמצעות IAMRoleBinding ל-IAMRole מוגדר מראש. כל התפקידים וקישורי התפקידים הם גלובליים.

הדף הזה מיועד לאדמינים של הפלטפורמה שמנהלים את ההרשאות בארגון. מידע נוסף זמין במאמר קהלי היעד של GDC עם air gap.

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

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

בקשת תפקידים ב-IAM

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

  • מנהל חשבון ארגוני ב-IAM (organization-iam-admin): יצירה, עדכון ומחיקה של קישורי תפקידים ברמת הארגון וברמת הפרויקט.
  • מנהל חשבון ארגוני של סשנים (org-session-admin): ביטול הסשנים הפעילים והגישה של משתמש באזור ספציפי.

הכנת הסביבה

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

הגדרת קישורי תפקידים

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

הקצאת תפקיד למשתמש מורשה:

המסוף

  1. נכנסים למסוף GDC.
  2. בוחרים ארגון או פרויקט בכלי לבחירת היקף.
    • כדי להגדיר קישורי תפקידים לארגון, בוחרים ארגון.
    • כדי להגדיר קישורי תפקידים לפרויקט, בוחרים פרויקט.
  3. בתפריט הניווט, לוחצים על Identity and Access > Access.
  4. לוחצים על הוספת חבר.
  5. בוחרים אם להוסיף משתמשים ספציפיים או קבוצות.
  6. ברשימה Identity provider, בוחרים ספק זהויות.
  7. בשדה שם משתמש או כתובת אימייל חלופית של קבוצה, מזינים את שם המשתמש, כתובת האימייל או כתובת האימייל החלופית.
  8. ברשימה Role, בוחרים את התפקיד שרוצים להקצות למשתמש או לקבוצה, למשל Organization Viewer ברמת הארגון או Project Creator ברמת הפרויקט.
  9. לוחצים על הוספה.

המשתמש מופיע ברשימה משתמשים מורשים.

gdcloud

  1. מוודאים שהתקנתם את ה-CLI של gdcloud.

  2. נכנסים באמצעות הפקודה gdcloud auth login כדי לאמת את ספק הזהויות. מידע נוסף זמין במאמר אימות ב-gdcloud CLI.

  3. מגדירים קישורי תפקידים.

    • הגדרת קישורי תפקידים לארגון:

      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

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

    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).
  2. יוצרים ומחילים משאב מותאם אישית של 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
    

הסרה של קישורי תפקידים

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

כדי להסיר חברים, פועלים לפי השלבים הבאים:

המסוף

  1. נכנסים למסוף GDC.
  2. בתפריט הניווט, לוחצים על Identity and Access > Access.
  3. ברשימה Authorized members, בוחרים חבר.
  4. לוחצים על הסרה מהקבוצה המשפחתית.
  5. כשמופיעה בקשה, לוחצים על הסרה מהקבוצה המשפחתית כדי לאשר.

gdcloud

  1. מוודאים שהתקנתם את ה-CLI של gdcloud.

  2. נכנסים באמצעות הפקודה gdcloud auth login כדי לאמת את ספק הזהויות. מידע נוסף זמין במאמר אימות ב-gdcloud CLI.

  3. הסרת קישורי תפקידים.

    • הסרת קישורי תפקידים לארגון:

      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, צריך לבטל את הגישה לכל אזור בנפרד. מבצעים את הפעולות הבאות בכל אזור:

  1. מוודאים שאתם מחוברים לאזור שאתם רוצים לבטל את הגישה אליו. לדוגמה, מגדירים את כתובת ה-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.

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

  2. מבטלים את הגישה של המשתמש לאזור:

    gdcloud admin auth revoke --accounts USER_EMAIL
    

    מחליפים את USER_EMAIL בכתובת האימייל של המשתמש שרוצים לבטל את הגישה שלו.

    אחרי הרצת הפקודה, הפלט אמור להיראות כך: בדוגמה הזו, הגישה של המשתמש ariel@example.com מבוטלת:

    Success: NUMBER of sessions revoked for user ariel@example.com
    

    בדוגמה הזו, המשתנה NUMBER מתייחס למספר הסשנים הפעילים של המשתמש.

  3. כדי לוודא שהגישה של המשתמש בוטלה, מריצים שוב את הפקודה gdcloud admin auth revoke. אם הפעולה בוצעה ללא שגיאות, יוצג הפלט הבא:

    No sessions found for account: ariel@example.com
    
  4. חוזרים על השלבים הקודמים לכל אזור ביקום.