חשבונות שירות הם החשבונות שעומסי עבודה או שירותים משתמשים בהם כדי לצרוך משאבים באופן פרוגרמטי ולגשת לשירותי מיקרו באופן מאובטח. זהו סוג מיוחד של זהות שמשמש אפליקציה או עומס עבודה, ולא אנשים. בדומה לחשבון משתמש, אפשר להעניק לחשבונות שירות הרשאות ותפקידים, אבל אי אפשר להיכנס לחשבונות האלה כמו משתמשים רגילים.
חשבונות שירות שימושיים לניהול תשתית של מכשיר עם בידוד פיזי (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 בפרויקט יכול להקצות את התפקיד הזה בהיקף של הפרויקט הספציפי שלו.
הכנת הסביבה
כדי להשתמש בכלי שורת הפקודה לניהול זהויות בשירות, צריך להשלים את ההגדרה הבאה:
כדי להשתמש ב-API עם
kubectl, צריך לבצע הגדרה נוספת:- מתקינים את ה-CLI של
kubectl, כמו שמתואר במאמר בנושא התקנת רכיבים. - יוצרים את קובץ kubeconfig עבור שרת ה-API לניהול כדי להגדיר גישה ל-
kubectl.
- מתקינים את ה-CLI של
יצירת זהות בשירות
למשתמשים עם גישה לחשבונות שירות יש גישה לכל חשבונות השירות בפרויקט.
כדי ליצור זהויות שירות בפרויקט, משתמשים במסוף GDC, ב-gdcloud CLI או ב-API.
המסוף
- נכנסים למסוף GDC.
- בתפריט הניווט, בוחרים באפשרות זהות וגישה > זהויות שירות.
- לוחצים על Create Service Identity. ייפתח הדף פרטי הזהות בשירות.
- בשדה Service identity name (שם זהות השירות), מזינים שם לזהות השירות. לדוגמה:
Test service identity. - לוחצים על יצירה.
gdcloud
יוצרים זהות בשירות:
gdcloud iam service-accounts create NAME \
--project=PROJECT
מחליפים את הערכים הבאים:
- NAME: השם של
ProjectServiceAccount. השם חייב להיות ייחודי במרחב השמות של הפרויקט. - PROJECT: הפרויקט שבו רוצים ליצור את זהות השירות. אם
gdcloud initכבר מוגדר, לא צריך להוסיף את הדגל--project.
הפקודה הזו יוצרת את ProjectServiceAccount במרחב השמות של הפרויקט.
API
יוצרים קובץ YAML של משאב בהתאמה אישית, למשל
ProjectServiceAccount:my-project-sa.yamlapiVersion: 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.
-
מחילים את המשאב המותאם אישית
ProjectServiceAccountעל שרת ה-Management API:kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG apply -f my-project-sa.yamlמחליפים את המשתנה
MANAGEMENT_API_SERVER_KUBECONFIGבנתיב לקובץ kubeconfig של שרת ה-API לניהול.
צפייה בזהויות בשירות
כדי לראות רשימה של חשבונות שירות בפרויקט, משתמשים במסוף GDC או ב-gdcloud CLI.
המסוף
- נכנסים למסוף GDC.
- בוחרים פרויקט.
- בתפריט הניווט, לוחצים על Identity & Access > Service Identities (זהויות וגישה > זהויות שירות) כדי לראות את רשימת חשבונות השירות של הפרויקט.
gdcloud
מציגים את רשימת חשבונות השירות בפרויקט:
gdcloud iam service-accounts list \
--project=PROJECT
הקצאת קישור תפקיד לזהות בשירות
אפשר להשתמש במסוף GDC או ב-gdcloud CLI כדי להקצות תפקיד.
המסוף
- נכנסים למסוף GDC.
- בוחרים פרויקט.
- בתפריט הניווט, בוחרים באפשרות Identity & Access > Access (זהות וגישה > גישה).
- ברשימה חברים, לוחצים על הוספת חבר. מוצג הדף משתמשים ותפקידים.
- ברשימה סוג החבר, בוחרים באפשרות זהות שירות.
- ברשימה Service identity, בוחרים את זהות השירות שרוצים להקצות לה את הקישור לתפקיד.
- ברשימה Role, בוחרים את התפקיד שרוצים להקצות לזהות השירות, כמו Backup Creator.
- אופציונלי: כדי להוסיף עוד תפקיד, לוחצים על הוספת תפקיד נוסף. בוחרים את התפקיד הנוסף.
- לוחצים על הוספה.
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.
אחרי שמוחקים זהות שירות, לאפליקציות אין גישה למשאבי הפרויקט דרך זהות השירות הזו.
המסוף
- נכנסים למסוף GDC.
- בתפריט הניווט, בוחרים באפשרות זהות וגישה > זהויות שירות.
- מסמנים את התיבה של זהות השירות שרוצים למחוק.
- לוחצים על Delete.
- מופיעה תיבת הדו-שיח לאישור. בשדה Confirm by typing the following below (אישור על ידי הקלדת הטקסט הבא), מזינים את הטקסט
remove. - לוחצים על Delete.
gdcloud
כדי למחוק זהות בשירות, מריצים את הפקודה הבאה:
gdcloud iam service-accounts delete NAME \
--project=PROJECT
יצירה והוספה של זוגות מפתחות
כדי ליצור זוגות מפתחות ולהוסיף אותם לפרויקט, משתמשים במסוף GDC, ב-gdcloud CLI או ב-API.
המסוף
- נכנסים למסוף GDC.
- בתפריט הניווט, בוחרים באפשרות זהות וגישה > זהויות שירות.
- לוחצים על השם של זהות השירות שרוצים להוסיף למפתח.
- לוחצים על Create New Key.
- המפתח החדש מופיע ברשימה 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
יוצרים זוג של מפתחות ציבוריים ופרטיים. בדוגמאות הבאות נעשה שימוש ב-
openssl, כלי נפוץ למטרה הזו.openssl ecparam -name prime256v1 -genkey -noout -out "key.pem" openssl ec -in "key.pem" -pubout > "pub.pem"מקודדים את המפתח הציבורי ב-Base64 ומאחזרים את מזהה המפתח שלו:
KEY_ID=$(openssl pkey -in key.pem -pubout -outform der | openssl dgst -sha256 | sed 's/^.* //') BASE64_ENCODED_KEY=$(cat pub.pem | base64)יוצרים או מעדכנים את קובץ ה-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.
-
מחילים את המשאב המותאם אישית
ProjectServiceAccountעל שרת ה-Management API:kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG apply -f my-project-sa.yamlמחליפים את המשתנה
MANAGEMENT_API_SERVER_KUBECONFIGבנתיב לקובץ kubeconfig של שרת ה-API לניהול.יוצרים את קובץ ה-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: הכתובת של נקודת הקצה של האימות.
-
מוסיפים את צמד המפתחות לפרויקט על ידי הפעלת חשבון השירות:
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.
המסוף
- נכנסים למסוף GDC.
- בתפריט הניווט, בוחרים באפשרות זהות וגישה > זהויות שירות.
- לוחצים על השם של זהות השירות שכוללת את המפתח שרוצים למחוק.
- לוחצים על מחיקה.
- בתיבת הדו-שיח לאישור, לוחצים על מחיקה.
gdcloud
מסירים את המפתח הציבורי עם מזהה המפתח מהפרויקט הספציפי ProjectServiceAccount:
gdcloud iam service-accounts keys delete KEY_ID \
--project=PROJECT \
--iam-account=NAME
אישור חשבון שירות באמצעות מפתח לחשבון שירות
אפשר להשתמש בפקודה gdcloud כדי להפעיל חשבון שירות באמצעות מפתח לחשבון שירות:
אם עדיין אין לכם קובץ מפתח של חשבון שירות, יוצרים קובץ כזה.
מפעילים את חשבון השירות באמצעות הפקודה הבאה:
gdcloud auth activate-service-account --key-file=KEY_FILEמחליפים את KEY_FILE בנתיב לקובץ המפתח של חשבון השירות.
אחרי שמפעילים את חשבון השירות,
gdcloudמשתמש בפרטי הכניסה של חשבון השירות לפקודות הבאות, במקום בפרטי הכניסה של המשתמש.