אימות באמצעות חשבונות שירות בפרויקטים

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

חשבונות שירות שימושיים לניהול תשתית של מכשיר עם בידוד פיזי (air-gapped) ב-Google Distributed Cloud‏ (GDC), למשל:

  • שירותים פנימיים של מכשיר GDC עם air gap ועומסי עבודה כדי לגשת בצורה מאובטחת לממשק תכנות אפליקציות (API) של מישור הבקרה של מכשיר GDC עם air gap.
  • עומסי עבודה של לקוחות במכשיר GDC עם air gap כדי לגשת לשירותי מכשיר GDC עם air gap ולבצע קריאות מורשות לממשקי תכנות יישומים (API).
  • עומסי עבודה חיצוניים לאיחוד עם מכשיר GDC עם air gap.
  • שירותי מכשיר או בקרי מערכת של GDC עם air gap כדי לגשת למשאבי לקוחות בצורה מאובטחת. לדוגמה, חשבונות שירות יכולים לנהל תהליכי עבודה של אימות והרשאה, שבהם בקרי השירות שפועלים באשכול Kubernetes של Bare Metal צריכים להריץ עומסי עבודה שמנוהלים על ידי לקוחות.

ניהול זהויות של שירותים כולל גם את זהות השירות (שמיוצגת על ידי משאב ProjectServiceAccount) וגם את פרטי הכניסה המשויכים אליה (זוגות של מפתחות ציבוריים ופרטיים). אפשר לנהל חשבונות באמצעות מסוף GDC,‏ gdcloud CLI או ה-API. ב-CLI של gdcloud, התכונה 'זהות שירות' מבוססת על ProjectServiceAccount API.

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

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

בנוסף, צריך לוודא שיש לכם את ההרשאות הדרושות ולהכין את הסביבה.

שליחת בקשה לתפקידי IAM

כדי ליצור, לעדכן ולמחוק זהויות שירות בפרויקט, צריך לפנות לאדמין IAM בארגון או לאדמין IAM בפרויקט ולבקש את התפקיד אדמין IAM בפרויקט (project-iam-admin).

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

הכנת הסביבה

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

יצירת זהות בשירות

למשתמשים עם גישה לחשבונות שירות יש גישה לכל חשבונות השירות בפרויקט.

כדי ליצור זהויות שירות בפרויקט, משתמשים במסוף GDC, ב-gdcloud CLI או ב-API.

המסוף

  1. נכנסים למסוף GDC.
  2. בתפריט הניווט, בוחרים באפשרות זהות וגישה > זהויות שירות.
  3. לוחצים על Create Service Identity. ייפתח הדף פרטי הזהות בשירות.
  4. בשדה Service identity name (שם זהות השירות), מזינים שם לזהות השירות. לדוגמה: Test service identity.
  5. לוחצים על יצירה.

gdcloud

יוצרים זהות בשירות:

gdcloud iam service-accounts create NAME \
        --project=PROJECT

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

  • ‫NAME: השם של ProjectServiceAccount. השם חייב להיות ייחודי במרחב השמות של הפרויקט.
  • ‫PROJECT: הפרויקט שבו רוצים ליצור את זהות השירות. אם gdcloud init כבר מוגדר, לא צריך להוסיף את הדגל --project.

הפקודה הזו יוצרת את ProjectServiceAccount במרחב השמות של הפרויקט.

API

  1. יוצרים קובץ YAML של משאב בהתאמה אישית, למשל ProjectServiceAccount:my-project-sa.yaml

    apiVersion: resourcemanager.gdc.goog/v1
    kind: ProjectServiceAccount
    metadata:
      name: NAME
      namespace: PROJECT
    spec:
      keys:
      - algorithm: ALGORITHM
        id: KEY_ID
        key: BASE64_ENCODED_KEY
        validAfter: "START_TIME"
        validBefore: "EXPIRATION_TIME"
    

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

    • ‫NAME: השם של ProjectServiceAccount המשאב. השם חייב להיות ייחודי במרחב השמות של הפרויקט.
    • ‫PROJECT: הפרויקט שבו רוצים ליצור את זהות השירות.
    • ‫ALGORITHM: האלגוריתם של המפתח. יש תמיכה רק במפתחות ES256.
    • ‫KEY_ID: המזהה הייחודי של המפתח. המזהה משמש לקביעת המפתח שצריך לאמת מולו.
    • ‫BASE64_ENCODED_KEY: המפתח הציבורי בקידוד Base64 בפורמט PEM שמשמש לאימות. המפתח הפרטי שמשמש ליצירת המפתח הציבורי הזה צריך להיות בפורמט ECDSA P256 PEM.
    • ‫START_TIME: שעת ההתחלה שבה המפתח הופך לתקף, למשל 2025-02-07T00:59:34Z.
    • ‫EXPIRATION_TIME: זמן התפוגה של המפתח, למשל 2026-02-07T00:59:34Z.
  2. מחילים את המשאב המותאם אישית ProjectServiceAccount על שרת ה-Management API:

    kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG apply -f my-project-sa.yaml
    

    מחליפים את המשתנה MANAGEMENT_API_SERVER_KUBECONFIG בנתיב לקובץ kubeconfig של שרת ה-API לניהול.

צפייה בזהויות בשירות

כדי לראות רשימה של חשבונות שירות בפרויקט, משתמשים במסוף GDC או ב-gdcloud CLI.

המסוף

  1. נכנסים למסוף GDC.
  2. בוחרים פרויקט.
  3. בתפריט הניווט, לוחצים על Identity & Access > Service Identities (זהויות וגישה > זהויות שירות) כדי לראות את רשימת חשבונות השירות של הפרויקט.

gdcloud

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

gdcloud iam service-accounts list \
    --project=PROJECT

הקצאת קישור תפקיד לזהות בשירות

אפשר להשתמש במסוף GDC או ב-gdcloud CLI כדי להקצות תפקיד.

המסוף

  1. נכנסים למסוף GDC.
  2. בוחרים פרויקט.
  3. בתפריט הניווט, בוחרים באפשרות Identity & Access > Access (זהות וגישה > גישה).
  4. ברשימה חברים, לוחצים על הוספת חבר. מוצג הדף משתמשים ותפקידים.
  5. ברשימה סוג החבר, בוחרים באפשרות זהות שירות.
  6. ברשימה Service identity, בוחרים את זהות השירות שרוצים להקצות לה את הקישור לתפקיד.
  7. ברשימה Role, בוחרים את התפקיד שרוצים להקצות לזהות השירות, כמו Backup Creator.
  8. אופציונלי: כדי להוסיף עוד תפקיד, לוחצים על הוספת תפקיד נוסף. בוחרים את התפקיד הנוסף.
  9. לוחצים על הוספה.

gdcloud

הפקודה הזו יוצרת את קישור התפקיד בפרויקט ונותנת לו שם כדי לקשר את התפקיד שצוין עם ProjectServiceAccount:

gdcloud iam service-accounts add-iam-policy-binding \
    --project=PROJECT \
    --role=ROLE \
    --iam-account=NAME

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

  • PROJECT: הפרויקט שבו רוצים ליצור את קישור התפקידים. אם gdcloud init כבר מוגדר, אפשר להשמיט את הדגל --project.
  • ‫ROLE: התפקיד המוגדר מראש שרוצים להקצות ל-ProjectServiceAccount. מציינים תפקידים בפורמט Role/name, כאשר Role הוא הסוג של Kubernetes, כמו Role או ProjectRole, ו-name הוא השם של התפקיד המוגדר מראש. לדוגמה, כדי להקצות את התפקיד Project Viewer, מגדירים את התפקיד ל-Role/project-viewer.
  • ‫NAME: השם של זהות השירות שבה רוצים להשתמש.

מחיקה של זהות שירות

כדי למחוק חשבונות שירות בפרויקט, משתמשים במסוף GDC או ב-gdcloud CLI.

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

המסוף

  1. נכנסים למסוף GDC.
  2. בתפריט הניווט, בוחרים באפשרות זהות וגישה > זהויות שירות.
  3. מסמנים את התיבה של זהות השירות שרוצים למחוק.
  4. לוחצים על Delete.
  5. מופיעה תיבת הדו-שיח לאישור. בשדה Confirm by typing the following below (אישור על ידי הקלדת הטקסט הבא), מזינים את הטקסט remove.
  6. לוחצים על Delete.

gdcloud

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

gdcloud iam service-accounts delete NAME \
    --project=PROJECT

יצירה והוספה של זוגות מפתחות

כדי ליצור זוגות מפתחות ולהוסיף אותם לפרויקט, משתמשים במסוף GDC, ב-gdcloud CLI או ב-API.

המסוף

  1. נכנסים למסוף GDC.
  2. בתפריט הניווט, בוחרים באפשרות זהות וגישה > זהויות שירות.
  3. לוחצים על השם של זהות השירות שרוצים להוסיף למפתח.
  4. לוחצים על Create New Key.
  5. המפתח החדש מופיע ברשימה Keys (מפתחות), ובתיבת דו-שיח מוצג אישור שיצרתם את המפתח בהצלחה.

gdcloud

הפקודה gdcloud יוצרת את קובץ ה-JSON של פרטי ברירת המחדל של האפליקציה ואת זוגות המפתחות הציבורי והפרטי:

gdcloud iam service-accounts keys create APPLICATION_DEFAULT_CREDENTIALS_FILENAME \
    --project=PROJECT \
    --iam-account=NAME \
    --ca-cert-path=CA_CERTIFICATE_PATH

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

  • ‫APPLICATION_DEFAULT_CREDENTIALS_FILENAME: השם של קובץ ה-JSON.
  • ‫PROJECT : בחירת הפרויקט שעבורו רוצים ליצור את המפתח. אם gdcloud init כבר מוגדר, אפשר להשמיט את הדגל --project.
  • ‫NAME: השם של זהות השירות שרוצים להוסיף לה את המפתח.
  • ‫CA_CERTIFICATE_PATH: אופציונלי: הנתיב של אישור רשות האישורים (CA) לאימות נקודת הקצה של האימות. אם לא מציינים את הנתיב הזה, המערכת משתמשת באישור ה-CA. חובה להתקין את ה-CA באישור ה-CA של המערכת.

ה-appliance של GDC עם air gap מוסיף את המפתח הציבורי לProjectServiceAccountהמפתחות שבהם אתם משתמשים כדי לאמת את אסימוני האינטרנט מסוג JSON‏ (JWT) שהמפתח הפרטי חותם עליהם. המפתח הפרטי נכתב לקובץ ה-JSON של פרטי הכניסה שמוגדרים כברירת מחדל באפליקציה.

בדוגמה הבאה מוצג קובץ JSON של פרטי ברירת המחדל של האפליקציה:

{
"type": "gdch_service_account",
"format_version": "1",
"project": "project_name",
"private_key_id": "abcdef1234567890",
"private_key": "-----BEGIN PRIVATE KEY-----\nETC\n-----END PRIVATE KEY-----\n",
"name": "service_identity_name",
"ca_cert_path": "service_identity_name",
"token_uri": "https://service-identity.<Domain>/authenticate"
}

בדוגמה הזו נעשה שימוש בערכים הבאים:

  • ‫project: מרחב השמות של הפרויקט בארגון.
  • ‫private_key_id: המזהה שהוקצה למפתח.
  • ‫private_key: המפתח הפרטי ECDSA P256 בפורמט PEM שנוצר על ידי ה-CLI.
  • ‫name: השם של זהות השירות.
  • ‫token_uri: הכתובת של נקודת הקצה לאימות.

API

  1. יוצרים זוג של מפתחות ציבוריים ופרטיים. בדוגמאות הבאות נעשה שימוש ב-openssl, כלי נפוץ למטרה הזו.

    openssl ecparam -name prime256v1 -genkey -noout -out "key.pem"
    openssl ec -in "key.pem" -pubout > "pub.pem"
    
  2. מקודדים את המפתח הציבורי ב-Base64 ומאחזרים את מזהה המפתח שלו:

    KEY_ID=$(openssl pkey -in key.pem -pubout -outform der | openssl dgst -sha256 | sed 's/^.* //')
    BASE64_ENCODED_KEY=$(cat pub.pem | base64)
    
  3. יוצרים או מעדכנים את קובץ ה-YAML של המשאב המותאם אישית ProjectServiceAccount, כולל פרטי המפתח שנוצרו בשלב הקודם:

    apiVersion: resourcemanager.gdc.goog/v1
    kind: ProjectServiceAccount
    metadata:
      name: NAME
      namespace: PROJECT
    spec:
      keys:
      - algorithm: ALGORITHM
        id: KEY_ID
        key: BASE64_ENCODED_KEY
        validAfter: "START_TIME"
        validBefore: "EXPIRATION_TIME"
    

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

    • ‫NAME: השם של ProjectServiceAccount המשאב. השם חייב להיות ייחודי במרחב השמות של הפרויקט.
    • ‫PROJECT: הפרויקט שבו יוצרים את המפתח.
    • ‫ALGORITHM: האלגוריתם של המפתח. יש תמיכה רק במפתחות ES256.
    • ‫KEY_ID: המזהה הייחודי של המפתח. המזהה משמש לקביעת המפתח שצריך לאמת מולו.
    • ‫BASE64_ENCODED_KEY: המפתח הציבורי בקידוד Base64 בפורמט PEM שמשמש לאימות. המפתח הפרטי שמשמש ליצירת המפתח הציבורי הזה צריך להיות בפורמט ECDSA P256 PEM.
    • ‫START_TIME: שעת ההתחלה שבה המפתח הופך לתקף, למשל 2025-02-07T00:59:34Z.
    • ‫EXPIRATION_TIME: זמן התפוגה של המפתח, למשל 2026-02-07T00:59:34Z.
  4. מחילים את המשאב המותאם אישית ProjectServiceAccount על שרת ה-Management API:

    kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG apply -f my-project-sa.yaml
    

    מחליפים את המשתנה MANAGEMENT_API_SERVER_KUBECONFIG בנתיב לקובץ kubeconfig של שרת ה-API לניהול.

  5. יוצרים את קובץ ה-JSON של פרטי הכניסה שמוגדרים כברירת מחדל לאפליקציה, שמכיל את המפתח הפרטי. חשוב לוודא שהמשתנה KEY_ID בקובץ ה-JSON מוגדר לאותו ערך כמו המשתנה KEY_ID שבו השתמשתם במפרט ProjectServiceAccount.

    cat <<EOF > "key_file.json"
    {
      "format_version": "1",
      "name": "NAME",
      "private_key": "$(tr '\n' '\t' < "key.pem" | sed 's/\t/\\n/g')",
      "private_key_id": "KEY_ID",
      "project": "PROJECT",
      "token_uri": "AUTH_URL",
      "type": "gdch_service_account"
    }
    EOF
    

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

    • ‫NAME: השם של זהות השירות.
    • ‫KEY_ID: המזהה הייחודי של המפתח. המזהה משמש לקביעת המפתח שצריך לאמת מולו, והוא חייב להיות זהה לערך KEY_ID שמשמש במפרט ProjectServiceAccount.
    • ‫PROJECT: מרחב השמות של הפרויקט בארגון.
    • ‫AUTH_URL: הכתובת של נקודת הקצה של האימות.
  6. מוסיפים את צמד המפתחות לפרויקט על ידי הפעלת חשבון השירות:

    gdcloud auth activate-service-account –-key-file=key_file.json
    

הצגת רשימת פרטי הכניסה לחשבונות שירות

הצגת רשימה של המפתחות הציבוריים מ-ProjectServiceAccount ספציפי בפרויקט:

gdcloud iam service-accounts keys list \
    --project=PROJECT \
    --iam-account=NAME

מחיקת פרטי הכניסה

כדי למחוק את המפתח הציבורי, משתמשים במסוף GDC או ב-gdcloud CLI.

המסוף

  1. נכנסים למסוף GDC.
  2. בתפריט הניווט, בוחרים באפשרות זהות וגישה > זהויות שירות.
  3. לוחצים על השם של זהות השירות שכוללת את המפתח שרוצים למחוק.
  4. לוחצים על מחיקה.
  5. בתיבת הדו-שיח לאישור, לוחצים על מחיקה.

gdcloud

מסירים את המפתח הציבורי עם מזהה המפתח מהפרויקט הספציפי ProjectServiceAccount:

gdcloud iam service-accounts keys delete KEY_ID \
    --project=PROJECT \
    --iam-account=NAME

אישור חשבון שירות באמצעות מפתח לחשבון שירות

אפשר להשתמש בפקודה gdcloud כדי להפעיל חשבון שירות באמצעות מפתח לחשבון שירות:

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

  2. מפעילים את חשבון השירות באמצעות הפקודה הבאה:

    gdcloud auth activate-service-account --key-file=KEY_FILE
    

    מחליפים את KEY_FILE בנתיב לקובץ המפתח של חשבון השירות.

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