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

בדף הזה מוסבר איך לנהל את הגישה לקטגוריות אחסון בפרויקטים של 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 שמעניק גישה למשתמש ולחשבון שירות:

  1. יוצרים קובץ 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: השם של חשבון השירות

  2. מחילים את קובץ ה-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.

  1. מריצים את הפקודה הבאה כדי להציג את משאבי הסודות שיש לכם הרשאה לראות במרחב השמות 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-"
      
  2. מקבלים את התוכן של הסוד התואם:

    kubectl get -o yaml --namespace object-storage-access-keys secret SECRET_NAME
    

    הפלט אמור להיראות כך:

    data:
      access-key-id: MEhYM08wWUMySjcyMkVKTFBKRU8=
      create-time: MjAyMi0wNy0yMiAwMTowODo1OS40MTQyMTE3MDMgKzAwMDAgVVRDIG09KzE5OTAuMzQ3OTE2MTc3
      secret-access-key: Ump0MVRleVN4SmhCSVJhbmlnVDAwbTJZc0IvRlJVendqR0JuYVhiVA==
    
  3. מפענחים את המזהה של מפתח הגישה ואת הסוד:

    echo "MEhYM08wWUMySjcyMkVKTFBKRU8=" | base64 -d \
        && echo \
        && echo "Ump0MVRleVN4SmhCSVJhbmlnVDAwbTJZc0IvRlJVendqR0JuYVhiVA==" | base64 -d
    

    הפלט אמור להיראות כך:

    0HX3O0YC2J722EJLPJEO
    Rjt1TeySxJhBIRanigT00m2YsB/FRUzwjGBnaXbT
    
  4. מבצעים את ההוראות בקטע הגדרת ה-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 של קטגוריות:

    1. get
    2. list
    3. שעון
  • הרשאות לאחסון אובייקטים ב-S3:

    1. GetBucketVersioning
    2. GetObject
    3. GetObjectAcl
    4. GetObjectLegalHold
    5. GetObjectRetention
    6. GetObjectTagging
    7. GetObjectVersion
    8. GetObjectVersionTagging
    9. ListBucket
    10. ListBucketVersions
    11. ListBucketMultipartUploads
    12. ListMultipartUploadParts

הרשאות אדמין של אובייקטים בקטגוריות של פרויקטים

התפקיד הזה מעניק הרשאות להוסיף ולמחוק אובייקטים, גרסאות של אובייקטים ותגים בקטגוריה. בנוסף, הוא מעניק את כל ההרשאות בתפקיד project-bucket-object-viewer.

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

  • הרשאות לאחסון אובייקטים ב-S3:

    1. AbortMultipartUpload
    2. DeleteObject
    3. DeleteObjectTagging
    4. DeleteObjectVersion
    5. DeleteObjectVersionTagging
    6. PutObject
    7. PutObjectTagging
    8. PutObjectVersionTagging
    9. PutOverwriteObject
    10. RestoreObject

הרשאות אדמין של קטגוריית הפרויקט

התפקיד הזה מעניק הרשאות ליצור, לעדכן או למחוק משאבי קטגוריות במרחב השמות של הפרויקט. בנוסף, הוא מעניק את כל ההרשאות ב-project-bucket-object-admin.

רשימה של הרשאות נוספות שהתפקיד מעניק:

  • הרשאות API של קטגוריות:

    1. יצירה
    2. עדכון
    3. מחיקה