שימוש בבקרת גישה מבוססת-תפקידים

בקרת גישה מבוססת-תפקידים (RBAC) ב-Cloud Data Fusion מאפשרת לכם לנהל את הרשאות המשתמשים במכונות ובמרחבי שמות. מודל הגישה הזה עוזר לבודד סביבות עבודה ולאבטח צינורות עיבוד נתונים, על ידי שליטה במי שיכול להציג, לתכנן ולהריץ עומסי עבודה של שילוב.

אפשר להשתמש ב-RBAC במכונות של Cloud Data Fusion שפועלות בגרסה 6.5 ואילך. אלא אם אתם צריכים להשתמש באוטומציה, השתמשו בGoogle Cloud כדי לבצע את משימות ה-RBAC. מידע נוסף זמין במאמר סקירה כללית על בקרת גישה מבוססת-תפקידים (RBAC).

הפעלת RBAC במכונה קיימת

אפשר להפעיל את RBAC במכונה קיימת של Cloud Data Fusion שפועלת בגרסה 6.5 ואילך.

המסוף

כדי להפעיל את RBAC במכונה קיימת של Cloud Data Fusion:

  1. נכנסים לפרטי המכונה:
    1. במסוף Google Cloud , נכנסים לדף Cloud Data Fusion.

    2. לוחצים על Instances (מכונות), ואז לוחצים על שם המכונה כדי לעבור לדף Instance details (פרטי המכונה).

      כניסה לדף Instances

  2. מוודאים שהאינסטנס שודרג לגרסה 6.5 ואילך. אם המכונה היא בגרסה מוקדמת יותר מ-6.5, צריך לשדרג אותה לגרסה 6.5 ואילך.
  3. לוחצים על Enable RBAC.
  4. לוחצים על Save.
  5. מחכים עד שפעולת העדכון של המכונה תסתיים.

gcloud

כדי להפעיל את RBAC במכונה קיימת של Cloud Data Fusion, מריצים את הפקודה הבאה:

gcloud beta data-fusion instances update --enable_rbac --location=REGION INSTANCE_ID

‫API בארכיטקטורת REST

מפעילים את RBAC במכונה קיימת באמצעות התיקון של Cloud Data Fusion API. מגדירים את הדגל enableRbac לערך true ומשתמשים בפרמטר השאילתה updateMask, כמו בפקודה לדוגמה הבאה:

export PROJECT=PROJECT_ID
export LOCATION=REGION
export INSTANCE=INSTANCE_ID
export DATA_FUSION_API_NAME=datafusion.googleapis.com
alias gcurl='curl --header "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
gcurl https://$DATA_FUSION_API_NAME/v1beta1/projects/$PROJECT/locations/$LOCATION/instances/$INSTANCE?updateMask=enable_rbac -X PATCH -d '{"enable_rbac": "true"}'

השבתת RBAC במכונה קיימת

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

המסוף

כדי להשבית את RBAC במכונה קיימת של Cloud Data Fusion:

  1. נכנסים לפרטי המכונה:

    1. במסוף Google Cloud , נכנסים לדף Cloud Data Fusion.

    2. לוחצים על Instances (מכונות), ואז לוחצים על שם המכונה כדי לעבור לדף Instance details (פרטי המכונה).

      כניסה לדף Instances

  2. לוחצים על Disable RBAC.

  3. לוחצים על Save.

  4. מחכים עד שפעולת העדכון של המכונה תסתיים.

gcloud

כדי להשבית את RBAC במכונה קיימת, משתמשים בארגומנט --no-enable_rbac במקום --enable-rbac.

gcloud beta data-fusion instances update --no-enable_rbac --location=REGION INSTANCE_ID

דוגמה לשימוש:

gcloud beta data-fusion instances update --no-enable_rbac --location=us-east1 cdf-test-instance

‫API בארכיטקטורת REST

משביתים את ה-RBAC במכונה קיימת באמצעות ה-API של Cloud Data Fusion patch. מגדירים את הדגל enableRbac לערך false ומשתמשים בפרמטר השאילתה updateMask, כמו בפקודה לדוגמה הבאה:

export PROJECT=PROJECT_ID
export LOCATION=REGION
export INSTANCE=INSTANCE_ID
export DATA_FUSION_API_NAME=datafusion.googleapis.com
alias gcurl='curl --header "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
gcurl https://$DATA_FUSION_API_NAME/v1beta1/projects/$PROJECT/locations/$LOCATION/instances/$INSTANCE?updateMask=enable_rbac -X PATCH -d '{"enable_rbac": "false"}'

יצירת מכונה חדשה עם RBAC

המסוף

כדי ליצור מכונה חדשה של Cloud Data Fusion עם RBAC:

  1. נכנסים לדף Instances של Cloud Data Fusion.

  2. לוחצים על Instances.

    כניסה לדף Instances

  3. לוחצים על Create an instance ומזינים את פרטי המכונה.

  4. בוחרים באפשרות Enterprise edition. אפשר להשתמש ב-RBAC רק במהדורת Enterprise.

  5. בקטע Advanced options, בוחרים באפשרות Enable Granular Role-Based Access Control.

    התכונה הזו זמינה רק במכונות שמשתמשות בגרסה 6.5 ואילך של Cloud Data Fusion.

  6. לוחצים על יצירה.

gcloud

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

gcloud beta data-fusion instances create --edition=enterprise \
--enable_rbac \
--location=REGION INSTANCE_ID \
--version=6.5.0

דוגמה לשימוש:

gcloud beta data-fusion instances create --edition=enterprise \
--enable_rbac \
--location=us-east1 \
--version=6.5.0

‫API בארכיטקטורת REST

כדי ליצור מכונה עם RBAC באמצעות ה-API בארכיטקטורת REST, מעבירים את הדגל enableRbac כשהוא מוגדר ל-true באפשרויות של המכונה, כמו שמוצג בפקודות הבאות:

export PROJECT=PROJECT_ID
export LOCATION=REGION
export INSTANCE=INSTANCE_ID
export DATA_FUSION_API_NAME=datafusion.googleapis.com
curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://$DATA_FUSION_API_NAME/v1beta1/projects/$PROJECT/locations/$LOCATION/instances?instanceId=$INSTANCE -X POST -d '{"description": "RBAC CDF instance created through REST", "type": "ENTERPRISE", "enableRbac": "true"}'

הקצאת תפקידים מוגדרים מראש של Cloud Data Fusion למשתמשים (חובה)

אחרי שמפעילים את RBAC, מקצים תפקידים לחשבונות משתמשים כדי לאפשר להם לבצע פעולות ספציפיות במכונה או במרחב שמות. כדי להחליט אילו תפקידים הכי מתאימים לדרישות שלכם, קראו את המאמרים תפקידים מוגדרים מראש ב-Cloud Data Fusion והמלצות אבטחה.

המסוף

כדי להקצות לחשבונות משתמשים תפקידים מוגדרים מראש ב-Cloud Data Fusion:

  1. נכנסים לדף Permissions של Cloud Data Fusion.

    לדף ההרשאות

  2. לוחצים על הוספה .

    תיפתח תיבת הדו-שיח הוספת גישה למשתמשים.

  3. בשדה New members, מזינים רשימה של חשבונות משתמשים (משתמשים, קבוצות או כתובות אימייל של חשבונות שירות) שרוצים לתת להם תפקידים.

  4. מסמנים את התיבה לצד כל מכונה שרוצים לתת לה את ההרשאות האלה.

    בחירת מכונות

  5. בעמודה Role, לוחצים על התפריט הנפתח ליד המכונות שנבחרו.

    1. כדי להעניק הרשאות אדמין למכונה, בוחרים באפשרות Instance Admin.

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

      בחירת תפקידי משתמשים במרחב השמות

      1. אם נותנים הרשאות ברמת מרחב השמות, לוחצים על Select.

        תיפתח תיבת הדו-שיח הוספת הרשאות גישה.

      2. בוחרים מרחב שמות ובוחרים את התפקיד המוגדר מראש ב-Cloud Data Fusion שרוצים להקצות למרחב השמות.

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

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

  6. לוחצים על Save.

    כדי לבדוק אילו תפקידים הוקצו, קראו את המאמר אימות תפקידים במסוף Google Cloud .

gcloud

אפשר להשתמש ב-Google Cloud CLI כדי לשלוט בגישה באופן פרוגרמטי.

כדי להקצות תפקיד באמצעות ה-CLI של gcloud, משתמשים ברשימה של מזהי משתמשים שמופרדים בפסיקים בפורמט הבא:

[user|group|serviceAccount][email_address]

מספקים את הערכים הבאים:

  • user:useremail@example.com
  • group:groupemail@example.com
  • serviceAccount:serviceaccount@project.

דוגמאות נוספות מופיעות במאמר הקצאת תפקיד.

הקצאת התפקיד "גישה למכונה" (חובה)

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

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

    export PROJECT=PROJECT_ID
    export INSTANCE=INSTANCE_ID
    export REGION=REGION
    export USER_ID=EMAIL
    export USER_TYPE=USER_TYPE
    

    מחליפים את המשתנים הבאים בערכים שלכם:

    • ‫PROJECT_ID: שם הפרויקט.
    • ‫INSTANCE_ID: שם המכונה.
    • ‫REGION: האזור שהפרויקט שייך אליו.
    • ‫EMAIL: כתובת האימייל של חשבון המשתמש.
    • ‫USER_TYPE: סוג המשתמש יכול להיות אחד מהבאים: user,‏ group או serviceAccount.
  2. מריצים את הפקודה הבאה כדי להקצות את התפקיד:

    gcloud beta data-fusion add-iam-policy-binding ${INSTANCE} --project ${PROJECT} --location=${REGION} --member="${USER_TYPE}:${USER_ID}" --role="roles/datafusion.accessor"
    

הקצאת תפקידים למרחב שמות (בהתאם לתרחיש לדוגמה)

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

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

    export PROJECT=PROJECT_ID
    export INSTANCE=INSTANCE_ID
    export REGION=REGION
    export NAMESPACE=NAMESPACE
    export USER_ID=EMAIL
    export USER_TYPE=USER_TYPE
    

    מחליפים את המשתנים הבאים בערכים שלכם:

    • ‫PROJECT_ID: שם הפרויקט.
    • ‫INSTANCE_ID: שם המכונה.
    • ‫REGION: האזור שהפרויקט שייך אליו.
    • ‫NAMESPACE: השם של מרחב השמות.
    • ‫EMAIL: כתובת האימייל של חשבון המשתמש.
    • ‫USER_TYPE: סוג המשתמש יכול להיות אחד מהבאים: user,‏ group או serviceAccount.
  2. מריצים את הפקודה הבאה כדי להקצות תפקיד לחשבון משתמש במרחב שמות נתון:

    gcloud beta data-fusion add-iam-policy-binding ${INSTANCE} --project ${PROJECT} --location=${REGION} --namespace=${NAMESPACE} --member="${USER_TYPE}:${USER_ID}" --role="roles/ROLE_NAME"
    

    מחליפים את ROLE_NAME באחד מהערכים הבאים:

    • לתפקיד 'עריכה' במרחב שמות, משתמשים ב-datafusion.editor
    • לתפקיד "מפעיל" במרחב שמות, משתמשים ב-datafusion.operator
    • לתפקיד מפתח במרחב שמות, משתמשים ב-datafusion.developer
    • לתפקיד "צפייה" במרחב שמות, משתמשים ב-datafusion.viewer

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

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

export PROJECT=PROJECT_ID
export INSTANCE=INSTANCE_ID
export REGION=REGION
export NAMESPACE=NAMESPACE
export USER_ID=EMAIL
# User type can be one of: user, group, or serviceAccount.
export USER_TYPE=USER_TYPE
export ROLE=ROLE_NAME
gcloud beta data-fusion remove-iam-policy-binding ${INSTANCE} --project ${PROJECT} --location=${REGION} --namespace=${NAMESPACE} --member="${USER_TYPE}:${USER_ID}" --role="${ROLE}"

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

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

export PROJECT=PROJECT_ID
export INSTANCE=INSTANCE_ID
export REGION=REGION
export NAMESPACE=NAMESPACE
gcloud beta data-fusion get-iam-policy ${INSTANCE} --project ${PROJECT} --location=${REGION} --namespace=${NAMESPACE}

‫API בארכיטקטורת REST

הקצאת התפקיד "גישה למכונה" (חובה)

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

מומלץ מאוד: להשתמש ב-CLI של gcloud כדי להקצות את התפקיד Accessor.

  1. הקצאת תפקיד הגישה במכונה:

    export PROJECT=PROJECT_ID
    export INSTANCE=INSTANCE_ID
    export REGION=REGION
    export USER_ID=EMAIL
    # User type can be one of: user, group, or serviceAccount.
    export USER_TYPE=USER_TYPE
    alias gcurl='curl --header "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
    
  2. אחזור של מדיניות ה-IAM הנוכחית ושמירה שלה בקובץ:

    gcurl https://datafusion.googleapis.com/v1beta1/projects/${PROJECT}/locations/${REGION}/instances/${INSTANCE}:getIamPolicy > iam_policy.json
    
  3. מוסיפים קישור לתפקיד ולמשתמש במדיניות. לדוגמה:

    {
      "policy": {
        "bindings": [
          {
            "role": "roles/datafusion.accessor",
            "members": [
              "${USER_TYPE}:${USER_ID}"
            ]
          }
        ]
      }
    }
    
  4. מעדכנים את מדיניות ה-IAM של המכונה:

    gcurl \
      -d @iam_policy.json \
      https://datafusion.googleapis.com/v1beta1/projects/${PROJECT}/locations/${REGION}/instances/${INSTANCE}:setIamPolicy
    

הקצאת תפקידים למרחב שמות (בהתאם לתרחיש לדוגמה)

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

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

    export PROJECT=PROJECT_ID
    export INSTANCE=INSTANCE_ID
    export REGION=REGION
    export NAMESPACE=NAMESPACE
    export USER_ID=EMAIL
    export USER_TYPE=USER_TYPE
    alias gcurl='curl --header "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
    

    מחליפים את המשתנים הבאים בערכים שלכם:

    • ‫PROJECT_ID: שם הפרויקט.
    • ‫INSTANCE_ID: שם המכונה.
    • ‫REGION: האזור שהפרויקט שייך אליו.
    • ‫NAMESPACE: השם של מרחב השמות.
    • ‫EMAIL: כתובת האימייל של חשבון המשתמש.
    • ‫USER_TYPE: סוג המשתמש יכול להיות אחד מהבאים: user,‏ group או serviceAccount.
  2. אחזור של מדיניות ה-IAM הנוכחית ושמירה שלה בקובץ:

      gcurl https://datafusion.googleapis.com/v1beta1/projects/${PROJECT}/locations/${REGION}/instances/${INSTANCE}/namespaces/{NAMESPACE}:getIamPolicy > iam_policy.json
    

    מחליפים את iam_policy.json בשם הקובץ שלכם.

  3. מוסיפים קישור לתפקיד ולמשתמש בקובץ המדיניות. לדוגמה, קובץ המדיניות יכול להיראות כך:

    {
      "policy": {
        "bindings": [
          {
            "role": "roles/ROLE_NAME",
              "members": [
              "${USER_TYPE}:${USER_ID}"
            ]
          }
        ]
      }
    }
    

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

    • לתפקיד 'עריכה' במרחב שמות, משתמשים ב-datafusion.editor
    • לתפקיד "מפעיל" במרחב שמות, משתמשים ב-datafusion.operator
    • לתפקיד מפתח במרחב שמות, משתמשים ב-datafusion.developer
    • לתפקיד "צפייה" במרחב שמות, משתמשים ב-datafusion.viewer
  4. מריצים את הפקודה הבאה כדי לעדכן את קובץ המדיניות:

    gcurl -d @iam_policy.json \
    https://datafusion.googleapis.com/v1beta1/projects/${PROJECT}/locations/${REGION}/instances/${INSTANCE}/namespaces/{NAMESPACE}:setIamPolicy
    

    מחליפים את iam_policy.json בשם הקובץ שלכם.

אימות התפקידים במסוף Google Cloud

בדף Permissions של Cloud Data Fusion אפשר לבדוק ולערוך את התפקידים הקיימים.

לדף ההרשאות

אימות התפקידים באמצעות קובץ המדיניות

מוודאים שהתפקידים הוקצו למשתמשים הנכונים בקובץ Policy של IAM, באמצעות ה-CLI של gcloud או באמצעות ה-API בארכיטקטורת REST.

בדוגמה הבאה לקובץ מדיניות IAM, למשתמש alice@example.com יש את התפקיד "מפתח Data Fusion":

bindings:
- members:
  - user:alice@example.com
  role: roles/datafusion.developer
- members:
  - user:bob@example.com
  - serviceAccount:myserviceaccount@myproject.
  role: roles/datafusion.operator
- members:
  - user:james@example.com
  - user:mike@example.com
  - group:mygroup@googlegroups.com
  role: roles/datafusion.editor
etag: BwXA8BAHYmw=

קבלת מדיניות ה-IAM של מכונה

gcloud

export PROJECT=PROJECT_ID
export INSTANCE=INSTANCE_ID
export REGION=REGION
gcloud beta data-fusion get-iam-policy ${INSTANCE} --project ${PROJECT} --location=${REGION}

cURL

export PROJECT=PROJECT_ID
export INSTANCE=INSTANCE_ID
export REGION=REGION
curl -H "Authorization: Bearer "$(gcloud auth print-access-token) \
https://datafusion.googleapis.com/v1beta1/projects/${PROJECT}/locations/${REGION}/instances/${INSTANCE}:getIamPolicy

קבלת מדיניות ה-IAM של מרחב שמות

gcloud

export PROJECT=PROJECT_ID
export INSTANCE=INSTANCE_ID
export REGION=REGION
export NAMESPACE=NAMESPACE
gcloud beta data-fusion get-iam-policy ${INSTANCE} --project ${PROJECT} --location=${REGION} --namespace=${NAMESPACE}

cURL

export PROJECT=PROJECT_ID
export INSTANCE=INSTANCE_ID
export NAMESPACE=NAMESPACE
export REGION=REGION
curl -H "Authorization: Bearer "$(gcloud auth print-access-token) \
https://datafusion.googleapis.com/v1beta1/projects/${PROJECT}/locations/${REGION}/instances/${INSTANCE}/namespaces/${NAMESPACE}:getIamPolicy

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