בדף הזה מוסבר איך לנהל את הגישה לקטגוריות אחסון בפרויקטים של Google Distributed Cloud (GDC) עם air gap, כדי שלאנשים הנכונים יהיו ההרשאות המתאימות. הוא כולל את הדרישות המוקדמות ואת השלבים לקבלת גישה לחשבון משתמש ולחשבון שירות, ולהענקת גישה אליהם, באמצעות קישורי תפקידים ותפקידים מוגדרים מראש. המידע הזה מאפשר לכם לשלוט ביעילות בגישה למשאבי האחסון שלכם, ולשמור על האבטחה ועל היעילות התפעולית.
הדף הזה מיועד לקהלים כמו אדמינים ממחלקת IT בקבוצת מפעילי התשתית או למפתחים בקבוצת מפעילי האפליקציות שמנהלים את הגדרות הגישה לקטגוריות אחסון בסביבות GDC עם air gap. מידע נוסף זמין במאמר קהלי היעד של מסמכי התיעוד של GDC עם air gap.
לפני שמתחילים
מרחב שמות של פרויקט מנהל את משאבי הקטגוריות בשרת Management API. כדי לעבוד עם קטגוריות ואובייקטים, צריך שיהיה לכם פרויקט.
מתן גישה לקטגוריה
כדי לתת גישה למשאבי S3 API, כמו קטגוריות ואובייקטים בקטגוריות האלה, לנושאי User ו-ServiceAccount, צריך ליצור ולהחיל RoleBindings שמפנים לתפקידים מוגדרים מראש בשרת Management API.
תפקידים מוגדרים מראש
project-bucket-object-viewer: מאפשר למשתמש להציג את כל הקטגוריות בפרויקט, להציג את האובייקטים בקטגוריות האלה ולקרוא אובייקטים ומטא-נתונים של אובייקטים. הוא לא מאפשר לכתוב פעולות על אובייקטים. לדוגמה: העלאה, החלפה, מחיקה. הרשאת קריאה בלבד בקטגוריות עם שני אזורים בארגון ובפרויקטים שלו, וגם הרשאת קריאה בלבד באובייקטים שבקטגוריות האלה.
project-bucket-object-admin: מאפשר למשתמש להציג את כל הקטגוריות בפרויקט, ולבצע פעולות כתיבה וקריאה באובייקטים. לדוגמה: העלאה, החלפה, מחיקה. הרשאת קריאה בלבד בקטגוריות עם שני אזורים בארגון ובפרויקטים שלו, והרשאת קריאה וכתיבה באובייקטים שבקטגוריות האלה.
project-bucket-admin: מאפשר למשתמשים לנהל את כל הקטגוריות במרחב השמות הנתון, וגם את כל האובייקטים בקטגוריות האלה. הרשאת קריאה בלבד בקטגוריות עם שני אזורים בארגון ובפרויקטים שלו, והרשאת קריאה וכתיבה באובייקטים שבקטגוריות האלה.
רשימה מלאה של ההרשאות שניתנות לתפקידים הקודמים מופיעה בקטע הרשאות של תפקידים מוגדרים מראש.
כדי ליצור קישורי תפקידים בפרויקט, צריך להיות לכם תפקיד אדמין של פרויקט ב-IAM. בדוגמה הבאה מוצגת יצירה של משאב RoleBinding שמעניק גישה למשתמש ולחשבון שירות:
יוצרים קובץ YAML במערכת, למשל
rolebinding-object-admin-all-buckets.yaml.# Example file name: # rolebinding-object-admin-all-buckets.yaml apiVersion: rbac.authorization.k8s.io/v1 kind: RoleBinding metadata: namespace: PROJECT_NAMESPACE name: readwrite-all-buckets roleRef: kind: Role name: project-bucket-object-admin apiGroup: rbac.authorization.k8s.io subjects: - kind: ServiceAccount namespace: PROJECT_NAMESPACE name: SA_NAME - kind: User namespace: PROJECT_NAMESPACE name: bob@example.com apiGroup: rbac.authorization.k8s.io # Could be bob or bob@example.com based on your organization settings.מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_NAMESPACE: השם של מרחב השמות של הפרויקט SA_NAME: השם של חשבון השירות
-
מחילים את קובץ ה-YAML:
kubectl apply \ -f rolebinding-object-admin-all-buckets.yaml
קבלת פרטי כניסה לגישה לקטגוריה
אחרי שנותנים גישה לקטגוריה, פרטי הכניסה נוצרים ב-Secret. כדי להגדיר את ה-CLI של Distributed Cloud ולהריץ פקודות לאינטראקציה עם הקטגוריה, צריך פרטי כניסה.
הפורמט של שם הסוד הוא object-storage-key-STORAGE_CLASS-SUBJECT_TYPE-SUBJECT_HASH.
- הערכים של
STORAGE_CLASSהם:-
stdלסוג האחסוןStandard.
-
- הערכים של
SUBJECT_TYPEהם:-
userלמשתמש. saעבור ServiceAccount.
-
-
SUBJECT_HASHהוא גיבוב SHA256 בקידוד base32 של שם הנושא.
לדוגמה, למשתמש bob@foo.com יש סוד בשם:
object-storage-key-std-user-l74gbpyrsbmwy4mivocr3nur6dzrnhcfhe3otyplul42i732aama
קבלת פרטי כניסה של משתמשים
לנושא משתמש, הסוד נמצא במרחב השמות object-storage-access-keys בשרת Management API.
מריצים את הפקודה הבאה כדי להציג את משאבי הסודות שיש לכם הרשאה לראות במרחב השמות
object-storage-access-keys:kubectl auth can-i --list --namespace object-storage-access-keys | grep "object-storage-key-"אם אתם יכולים לראות סודות במרחב השמות הזה, תראו פלט שמכיל שם אחד או יותר של סודות שמתחילים ב-
object-storage-key-, בדומה לזה:secrets [] [object-storage-key-std-user-l74gbpyrsbmwy4mivocr3nur6dzrnhcfhe3otyplul42i732aama] [get]הערה: אם אתם אדמינים עם הרשאה לראות את כל משאבי הסודות או להתחזות למשתמשים אחרים, אתם יכולים להריץ את אחת מהפקודות הבאות כדי למצוא את שם הסודות של משתמש מסוים:
הצגת רשימה של כל הסודות ששייכים למשתמש מסוים:
export USER_NAME=bob@example.com kubectl get secrets --namespace object-storage-access-keys -o json | jq -r --arg USER_NAME "${USER_NAME:?}" '.items[] | select( (.metadata.annotations."object.gdc.goog/subject"==$USER_NAME)) | .metadata.name'כדי לראות לאילו סודות יש למשתמש גישה, אפשר להתחזות אליו:
export USER_NAME=bob@example.com kubectl auth can-i --list --namespace object-storage-access-keys --as "${USER_NAME:?}" | grep "object-storage-key-"
מקבלים את התוכן של הסוד התואם:
kubectl get -o yaml --namespace object-storage-access-keys secret SECRET_NAMEהפלט אמור להיראות כך:
data: access-key-id: MEhYM08wWUMySjcyMkVKTFBKRU8= create-time: MjAyMi0wNy0yMiAwMTowODo1OS40MTQyMTE3MDMgKzAwMDAgVVRDIG09KzE5OTAuMzQ3OTE2MTc3 secret-access-key: Ump0MVRleVN4SmhCSVJhbmlnVDAwbTJZc0IvRlJVendqR0JuYVhiVA==מפענחים את המזהה של מפתח הגישה ואת הסוד:
echo "MEhYM08wWUMySjcyMkVKTFBKRU8=" | base64 -d \ && echo \ && echo "Ump0MVRleVN4SmhCSVJhbmlnVDAwbTJZc0IvRlJVendqR0JuYVhiVA==" | base64 -dהפלט אמור להיראות כך:
0HX3O0YC2J722EJLPJEO Rjt1TeySxJhBIRanigT00m2YsB/FRUzwjGBnaXbTמבצעים את ההוראות בקטע הגדרת ה-gdcloud CLI, עם המידע שמתקבל.
קבלת גישה לחשבון שירות
פרטי הכניסה הסודיים של S3 נוצרים וזמינים רק אם קיימת קטגוריה במרחב השמות של הפרויקט.
לנושא של חשבון שירות (SA), הסוד נוצר באותו מרחב שמות כמו חשבון השירות.
מריצים את הפקודה הבאה כדי לוודא שאפשר לקבל ולפרט משאבי Secret במרחב השמות. אם זה לא המצב, פונים לאדמין:
export SA_NAMESPACE=PROJECT_NAMESPACE
kubectl auth can-i --list --namespace $SA_NAMESPACE
כדי למצוא את שם הסוד, מריצים את הפקודה:
export SA_NAME=SA_NAME
kubectl get secrets --namespace $SA_NAMESPACE -o json | jq -r --arg USER_NAME "${SA_NAME:?}" '.items[] | select( (.metadata.annotations."object.gdc.goog/subject"==$USER_NAME)) | .metadata.name'
הפלט אמור להיראות כך:
object-storage-key-std-sa-mng3olp3vsynhswzasowzu3jgzct2ert72pjp6wsbzqhdwckwzbq
אתם יכולים להפנות לסוד ב-Pod בתור משתני סביבה או קבצים.
הרשאות של תפקידים מוגדרים מראש
שימו לב שתפקידים מוגדרים מראש זמינים גם בשרת ה-API הגלובלי, לצורך גישה אדמיניסטרטיבית ותפעולית לקטגוריות בשני אזורים.
הרשאות של project-bucket-object-viewer
התפקיד הזה נותן הרשאות לקבל ולהציג ברשימה אובייקטים ואת המטא-נתונים של האובייקטים בקטגוריה.
רשימה של כל ההרשאות למאגר אובייקטים שמעניק הפועל project-bucket-object-viewer:
הרשאות API של קטגוריות:
- get
- list
- שעון
הרשאות לאחסון אובייקטים ב-S3:
- GetBucketVersioning
- GetObject
- GetObjectAcl
- GetObjectLegalHold
- GetObjectRetention
- GetObjectTagging
- GetObjectVersion
- GetObjectVersionTagging
- ListBucket
- ListBucketVersions
- ListBucketMultipartUploads
- ListMultipartUploadParts
הרשאות אדמין של אובייקטים בקטגוריות של פרויקטים
התפקיד הזה מעניק הרשאות להוסיף ולמחוק אובייקטים, גרסאות של אובייקטים ותגים בקטגוריה. בנוסף, הוא מעניק את כל ההרשאות בתפקיד project-bucket-object-viewer.
רשימה של כל ההרשאות הנוספות למאגר אובייקטים שהתפקיד מעניק:
הרשאות לאחסון אובייקטים ב-S3:
- AbortMultipartUpload
- DeleteObject
- DeleteObjectTagging
- DeleteObjectVersion
- DeleteObjectVersionTagging
- PutObject
- PutObjectTagging
- PutObjectVersionTagging
- PutOverwriteObject
- RestoreObject
הרשאות אדמין של קטגוריית הפרויקט
התפקיד הזה מעניק הרשאות ליצור, לעדכן או למחוק משאבי קטגוריות במרחב השמות של הפרויקט. בנוסף, הוא מעניק את כל ההרשאות ב-project-bucket-object-admin.
רשימה של הרשאות נוספות שהתפקיד מעניק:
הרשאות API של קטגוריות:
- יצירה
- עדכון
- מחיקה