בקרת גישה מבוססת-תפקידים (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:
- נכנסים לפרטי המכונה:
במסוף Google Cloud , נכנסים לדף Cloud Data Fusion.
לוחצים על Instances (מכונות), ואז לוחצים על שם המכונה כדי לעבור לדף Instance details (פרטי המכונה).
- מוודאים שהאינסטנס שודרג לגרסה 6.5 ואילך. אם המכונה היא בגרסה מוקדמת יותר מ-6.5, צריך לשדרג אותה לגרסה 6.5 ואילך.
- לוחצים על Enable RBAC.
- לוחצים על Save.
- מחכים עד שפעולת העדכון של המכונה תסתיים.
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:
נכנסים לפרטי המכונה:
במסוף Google Cloud , נכנסים לדף Cloud Data Fusion.
לוחצים על Instances (מכונות), ואז לוחצים על שם המכונה כדי לעבור לדף Instance details (פרטי המכונה).
לוחצים על Disable RBAC.
לוחצים על Save.
מחכים עד שפעולת העדכון של המכונה תסתיים.
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:
נכנסים לדף Instances של Cloud Data Fusion.
לוחצים על Instances.
לוחצים על Create an instance ומזינים את פרטי המכונה.
בוחרים באפשרות Enterprise edition. אפשר להשתמש ב-RBAC רק במהדורת Enterprise.
בקטע Advanced options, בוחרים באפשרות Enable Granular Role-Based Access Control.
התכונה הזו זמינה רק במכונות שמשתמשות בגרסה 6.5 ואילך של Cloud Data Fusion.
לוחצים על יצירה.
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:
נכנסים לדף Permissions של Cloud Data Fusion.
לוחצים על הוספה .
תיפתח תיבת הדו-שיח הוספת גישה למשתמשים.
בשדה New members, מזינים רשימה של חשבונות משתמשים (משתמשים, קבוצות או כתובות אימייל של חשבונות שירות) שרוצים לתת להם תפקידים.
מסמנים את התיבה לצד כל מכונה שרוצים לתת לה את ההרשאות האלה.

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

אם נותנים הרשאות ברמת מרחב השמות, לוחצים על Select.
תיפתח תיבת הדו-שיח הוספת הרשאות גישה.
בוחרים מרחב שמות ובוחרים את התפקיד המוגדר מראש ב-Cloud Data Fusion שרוצים להקצות למרחב השמות.
לוחצים על בחירה כדי לשמור את ההגדרות החדשות.
אופציונלי: כדי להעניק הרשאות למרחב שמות למכונות אחרות, חוזרים על שלב 5.
לוחצים על Save.
כדי לבדוק אילו תפקידים הוקצו, קראו את המאמר אימות תפקידים במסוף Google Cloud .
gcloud
אפשר להשתמש ב-Google Cloud CLI כדי לשלוט בגישה באופן פרוגרמטי.
כדי להקצות תפקיד באמצעות ה-CLI של gcloud, משתמשים ברשימה של מזהי משתמשים שמופרדים בפסיקים בפורמט הבא:
[user|group|serviceAccount][email_address]
מספקים את הערכים הבאים:
user:useremail@example.comgroup:groupemail@example.comserviceAccount:serviceaccount@project.
דוגמאות נוספות מופיעות במאמר הקצאת תפקיד.
הקצאת התפקיד "גישה למכונה" (חובה)
קודם צריך לתת למשתמש גישה למכונה באמצעות הקצאת התפקיד Accessor במכונה:
מייצאים את המשתנים הבאים באמצעות הפקודה הבאה, ומחליפים את המשתנים בערכים שלכם:
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.
מריצים את הפקודה הבאה כדי להקצות את התפקיד:
gcloud beta data-fusion add-iam-policy-binding ${INSTANCE} --project ${PROJECT} --location=${REGION} --member="${USER_TYPE}:${USER_ID}" --role="roles/datafusion.accessor"
הקצאת תפקידים למרחב שמות (בהתאם לתרחיש לדוגמה)
בהתאם לתרחיש לדוגמה, מקצים תפקידים באמצעות הפקודות הבאות:
מייצאים את המשתנים הבאים באמצעות הפקודה הבאה, ומחליפים את המשתנים בערכים שלכם:
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.
מריצים את הפקודה הבאה כדי להקצות תפקיד לחשבון משתמש במרחב שמות נתון:
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.
הקצאת תפקיד הגישה במכונה:
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"'אחזור של מדיניות ה-IAM הנוכחית ושמירה שלה בקובץ:
gcurl https://datafusion.googleapis.com/v1beta1/projects/${PROJECT}/locations/${REGION}/instances/${INSTANCE}:getIamPolicy > iam_policy.jsonמוסיפים קישור לתפקיד ולמשתמש במדיניות. לדוגמה:
{ "policy": { "bindings": [ { "role": "roles/datafusion.accessor", "members": [ "${USER_TYPE}:${USER_ID}" ] } ] } }מעדכנים את מדיניות ה-IAM של המכונה:
gcurl \ -d @iam_policy.json \ https://datafusion.googleapis.com/v1beta1/projects/${PROJECT}/locations/${REGION}/instances/${INSTANCE}:setIamPolicy
הקצאת תפקידים למרחב שמות (בהתאם לתרחיש לדוגמה)
בהתאם לתרחיש לדוגמה, מקצים תפקידים באמצעות הפקודות הבאות:
מייצאים את המשתנים הבאים באמצעות הפקודה הבאה, ומחליפים את המשתנים בערכים שלכם:
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.
אחזור של מדיניות ה-IAM הנוכחית ושמירה שלה בקובץ:
gcurl https://datafusion.googleapis.com/v1beta1/projects/${PROJECT}/locations/${REGION}/instances/${INSTANCE}/namespaces/{NAMESPACE}:getIamPolicy > iam_policy.jsonמחליפים את iam_policy.json בשם הקובץ שלכם.
מוסיפים קישור לתפקיד ולמשתמש בקובץ המדיניות. לדוגמה, קובץ המדיניות יכול להיראות כך:
{ "policy": { "bindings": [ { "role": "roles/ROLE_NAME", "members": [ "${USER_TYPE}:${USER_ID}" ] } ] } }אפשר לציין כמה קישורי תפקידים במדיניות מסוימת, וכמה חשבונות משתמשים ברשימת ה-members של קישור תפקיד מסוים. בחשבון ראשי נתון, מחליפים את ROLE_NAME באחד מהערכים הבאים:
- לתפקיד 'עריכה' במרחב שמות, משתמשים ב-
datafusion.editor - לתפקיד "מפעיל" במרחב שמות, משתמשים ב-
datafusion.operator - לתפקיד מפתח במרחב שמות, משתמשים ב-
datafusion.developer - לתפקיד "צפייה" במרחב שמות, משתמשים ב-
datafusion.viewer
- לתפקיד 'עריכה' במרחב שמות, משתמשים ב-
מריצים את הפקודה הבאה כדי לעדכן את קובץ המדיניות:
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