שימוש ברשויות אישורים מותאמות אישית של אשכולות

ב-Google Distributed Cloud אתם יכולים להשתמש ברשויות אישורים (CA) משלכם כדי להנפיק ולחתום על אישורים שמאמתים ומצפינים את התקשורת בין רכיבי האשכול. שימוש ברשויות אישורים בהתאמה אישית מאפשר לכם לשלוט ישירות בבסיס האמון, בפרמטרים של אלגוריתם ההצפנה, ובעומק ובמטרה של האישורים המשניים.

אפשר להחיל רשויות אישורים בהתאמה אישית במהלך יצירת אשכול (בשיטה bmctl בלבד) או סבב רשויות אישורים באשכולות של אדמינים, משתמשים, היברידיים ועצמאיים.

דרישות מוקדמות

אתם מספקים זוג של קובץ מפתח ואישור CA לכל אחד מהאישורים הבאים שנדרשים לאשכול:

  • ‫etcd CA: אישור ה-CA של etcd מאבטח את התקשורת משרת ה-API של Kubernetes לרפליקות של etcd, וגם את התקשורת בין הרפליקות של etcd.

  • רשות אישורים (CA) של האשכול: האישור של רשות האישורים של האשכול מאבטח את התקשורת בין שרת ה-API של Kubernetes לבין כל לקוחות ה-API הפנימיים של Kubernetes. הלקוחות כוללים את kubelet, מנהל הבקרים והמתזמן.

  • ‫front-proxy CA: האישור של ה-CA של שרת ה-proxy הקדמי מאבטח את התקשורת עם ממשקי API נצברים.

אתם צריכים להכין את רשויות האישורים ברמה הבסיסית (root CA) שלכם לפי הכללים הבאים:

  • רשויות אישורים בהתאמה אישית הן רשויות אישורים בסיסיות, שכל אחת מהן מורכבת מקובץ אישור עם חתימה עצמית ומקובץ מפתח פרטי.

  • מומלץ להשתמש בפורמט Distinguished Encoding Rules (DER) לאישור (ראו המלצה X.690 לכללי קידוד ASN.1). קובץ האישור צריך להכיל נתונים בקידוד Base64, עם ‑‑‑‑‑BEGIN CERTIFICATE‑‑‑‑‑ לפני הנתונים ו-‑‑‑‑END CERTIFICATE‑‑‑‑‑ אחריהם.

  • למפתח הפרטי, מומלץ להשתמש בפורמט Public-Key Cryptography Standards (PKCS) #1. קובץ המפתח צריך להכיל נתונים בקידוד base64, עם ‑‑‑‑BEGIN RSA PRIVATE KEY‑‑‑‑ לפני הנתונים ו-‑‑‑‑END RSA PRIVATE KEY‑‑‑‑ אחריהם.

  • כדי לצמצם את הסיכון לשיבושים באשכול, רצוי שתוקף רשויות האישורים בהתאמה אישית לא יפוג לפני חמש שנים. מומלץ להגדיר תקופת תפוגה ארוכה יותר, למשל 10 עד 30 שנים.

  • חשוב לוודא שקובצי האישור והמפתח נמצאים בתחנת העבודה של האדמין שבה מריצים את הפקודות של bmctl.

  • למשתמש שמריץ פקודות bmctl צריכה להיות גישה לספרייה שבה מאוחסנים הקבצים. מומלץ לשים את הקבצים בספרייה קיימת שמשמשת לאישורים ולמפתחות. לדוגמה, אתם יכולים לאחסן את הקבצים ב-~/baremetal/bmctl-workspace/.sa-keys יחד עם המפתחות של חשבון השירות.

  • למשתמש שמריץ פקודות bmctl צריכה להיות גישת קריאה לקבצים.

שימוש ברשות אישורים בהתאמה אישית במהלך יצירת האשכול

כשיוצרים אשכול באמצעות bmctl, קודם מעדכנים את קובץ התצורה של האשכול כדי לתאר את התכונות וההגדרות של האשכול. כדי להשתמש בתכונה "רשות אישורים מותאמת אישית לאשכול" כשיוצרים אשכול, יש שתי אפשרויות לציין את רשויות האישורים המותאמות אישית לאשכול בקובץ התצורה של האשכול:

  • מציינים את הנתיבים של קובצי אישורי ה-CA ושל קובצי המפתח הפרטי.
  • צריך לציין את הנתיבים של קובצי המפתחות הפרטיים בלבד

כשמציינים רק את המפתחות הפרטיים, bmctl מחפש את קובצי אישורי ה-CA התואמים באותה ספרייה. שמות קובצי האישורים צריכים להיות זהים לשמות של קובצי המפתחות הפרטיים המתאימים, עם סיומת הקובץ .crt. לדוגמה, אם הנתיב של המפתח הפרטי הוא /custom-ca/cluster_ca.key, אז bmctl מצפה שהנתיב של האישור יהיה /custom-ca/cluster_ca.crt.

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

דוגמה 1: ציון נתיבים של אישורים ומפתחות

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

gcrKeyPath: bmctl-workspace/.sa-keys/myproject-anthos-baremetal-gcr.json
...
cloudOperationsServiceAccountKeyPath: bmctl-workspace/.sa-keys/myproject-anthos-baremetal-cloud-ops.json
clusterCACertPath: bmctl-workspace/.sa-keys/cluster_ca_cert.pem
clusterCAPrivateKeyPath: bmctl-workspace/.sa-keys/cluster_ca_key.pem
etcdCACertPath: bmctl-workspace/.sa-keys/etcd_ca_cert.pem
etcdCAPrivateKeyPath: bmctl-workspace/.sa-keys/etcd_ca_key.pem
frontProxyCACertPath: bmctl-workspace/.sa-keys/front_proxy_ca_cert.pem
frontProxyCAPrivateKeyPath: bmctl-workspace/.sa-keys/front_proxy_ca_key.pem
---
apiVersion: v1
kind: Namespace
metadata:
  name: cluster-admin-test
---
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
...

דוגמה 2: ציון נתיבים של מפתחות פרטיים בלבד

הקטע הבא מקובץ תצורה של אשכול מראה איך לציין את הנתיבים לקובצי מפתחות בלבד. בדוגמה הזו, קובצי המפתח הפרטי של ה-CA נמצאים באותה ספרייה שבה נמצאים קובצי המפתח של חשבון השירות בפורמט JSON. גם קובצי אישורי ה-CA התואמים צריכים להיות בספרייה /.sa-keys. לקובצי האישורים יש שם זהה לקובצי המפתחות, אבל עם הסיומת .crt. לכן, קובץ אישור ה-CA של etcd נקרא etcd_ca.crt.

gcrKeyPath: bmctl-workspace/.sa-keys/myproject-anthos-baremetal-gcr.json
...
cloudOperationsServiceAccountKeyPath: bmctl-workspace/.sa-keys/myproject-anthos-baremetal-cloud-ops.json
clusterCAPrivateKeyPath: bmctl-workspace/.sa-keys/cluster_ca_key.pem
etcdCAPrivateKeyPath: bmctl-workspace/.sa-keys/etcd_ca_key.pem
frontProxyCAPrivateKeyPath: bmctl-workspace/.sa-keys/front_proxy_ca_key.pem
---
apiVersion: v1
kind: Namespace
metadata:
  name: cluster-admin-test
---
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
...

דוגמה 3: שימוש חוזר בצמד יחיד של קובצי מפתח ואישור CA

הקטע הבא מקובץ תצורה של אשכול מראה איך לציין את הנתיבים לקובצי מפתחות בלבד. בדוגמה הזו, זוג יחיד של מפתח ואישור משמש את כל רשויות ה-CA באשכול. קובצי אישור ה-CA והמפתח הפרטי נמצאים בספרייה /custom-ca. בהתאם למוסכמה למתן שמות, שם הקובץ של אישור ה-CA הוא custom_ca.crt.

gcrKeyPath: bmctl-workspace/.sa-keys/myproject-anthos-baremetal-gcr.json
...
cloudOperationsServiceAccountKeyPath: bmctl-workspace/.sa-keys/myproject-anthos-baremetal-cloud-ops.json
clusterCAPrivateKeyPath: /custom-ca/custom_ca.key
etcdCAPrivateKeyPath: /custom-ca/custom_ca.key
frontProxyCAPrivateKeyPath: /custom-ca/custom_ca.key
---
apiVersion: v1
kind: Namespace
metadata:
  name: cluster-admin-test
---
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
...

שימוש ברשות אישורים בהתאמה אישית במהלך רוטציה של רשויות אישורים

כשאתם מחליפים את רשויות האישורים, אתם יכולים לציין את הנתיבים של קובצי המפתח הפרטי ואישור ה-CA של האשכול בהתאמה אישית. האפשרויות דומות לאפשרויות להגדרת רשויות אישורים מותאמות אישית לאשכול במהלך יצירת האשכול. כשמריצים את הפקודה bmctl update credentials certificate-authorities rotate, יש את האפשרויות הבאות:

  • מציינים את הנתיבים של קובצי אישורי ה-CA המותאמים אישית ושל קובצי המפתחות הפרטיים.
  • צריך לציין את הנתיבים רק לקובצי המפתחות הפרטיים של רשות האישורים בהתאמה אישית. קובץ אישור ה-CA התואם חייב להיות באותה ספרייה, עם אותו שם כמו קובץ המפתח ועם סיומת הקובץ .crt.
  • כדי להשתמש שוב בזוג מפתחות של אישור CA, צריך לציין את אותם נתיבים של אישור ומפתח ליותר מ-CA אחד של אשכול.
  • משמיטים את הארגומנטים של הנתיבים של רשות האישורים בהתאמה אישית. אם לא תציינו נתיבים מותאמים אישית של רשויות אישורים כשתחליפו את רשויות האישורים, Google Distributed Cloud תיצור את רשות האישורים הרגילה של האשכול ותשתמש בה.

דוגמה 1: ציון הנתיבים של אישור ה-CA והמפתח הפרטי

bmctl update credentials certificate-authorities rotate \
    --cluster CLUSTER_NAME \
    --kubeconfig ADMIN_KUBECONFIG \
    --cluster-ca-cert-path=CLUSTER_CA_CERT_PATH \
    --cluster-ca-private-key-path=CLUSTER_CA_KEY_PATH \
    --etcd-ca-cert-path=ETCD_CA_CERT_PATH \
    --etcd-ca-private-key-path=ETCD_CA_KEY_PATH \
    --front-proxy-ca-cert-path=FRONT_PROXY_CA_CERT_PATH \
    --front-proxy-ca-private-key-path=FRONT_PROXY_CA_KEY_PATH

מחליפים את מה שכתוב בשדות הבאים:

  • ‫CLUSTER_NAME: שם האשכול שבו רוצים להחליף את רשויות האישורים.
  • ‫ADMIN_KUBECONFIG: הנתיב לקובץ kubeconfig של אשכול האדמין. באשכולות בניהול עצמי, הקובץ הזה הוא קובץ ה-kubeconfig של האשכול.
  • ‫CLUSTER_CA_CERT_PATH: הנתיב לקובץ של אישור ה-CA של האשכול.
  • ‫CLUSTER_CA_KEY_PATH: הנתיב לקובץ המפתח הפרטי של ה-CA באשכול.
  • ‫ETCD_CA_CERT_PATH: הנתיב של קובץ אישור ה-CA של etcd.
  • ‫ETCD_CA_KEY_PATH: הנתיב לקובץ המפתח הפרטי של ה-CA של etcd.
  • ‫FRONT_PROXY_CA_CERT_PATH: הנתיב של קובץ האישור של שרת ה-proxy הקדמי.
  • ‫FRONT_PROXY_CA_KEY_PATH: הנתיב של קובץ המפתח הפרטי של שרת ה-proxy הקדמי.

דוגמה 2: ציון נתיבים של מפתחות פרטיים בלבד

bmctl update credentials certificate-authorities rotate \
    --cluster CLUSTER_NAME \
    --kubeconfig ADMIN_KUBECONFIG \
    --cluster-ca-private-key-path=CLUSTER_CA_KEY_PATH \
    --etcd-ca-private-key-path=ETCD_CA_KEY_PATH \
    --front-proxy-ca-private-key-path=FRONT_PROXY_CA_KEY_PATH

מחליפים את מה שכתוב בשדות הבאים:

  • ‫CLUSTER_NAME: שם האשכול שבו רוצים להחליף את רשויות האישורים.
  • ‫ADMIN_KUBECONFIG: הנתיב לקובץ kubeconfig של אשכול האדמין. באשכולות בניהול עצמי, הקובץ הזה הוא קובץ ה-kubeconfig של האשכול.
  • ‫CLUSTER_CA_KEY_PATH: הנתיב לקובץ המפתח הפרטי של ה-CA באשכול.
  • ‫ETCD_CA_KEY_PATH: הנתיב לקובץ המפתח הפרטי של ה-CA של etcd.
  • ‫FRONT_PROXY_CA_KEY_PATH: הנתיב של קובץ המפתח הפרטי של שרת ה-proxy הקדמי.

רשויות אישורים (CA) משניות

אשכולות בגרסה 1.29 תומכים בשימוש ברשויות ביניים לאישורים כיכולת בגרסת טרום-השקה (Preview). היכולת הזו לא נמצאת באותו שלב השקה בכל גרסאות המוצר הנתמכות:

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

  • רשות אישורים של etcd
  • רשות אישורים (CA) של אשכול
  • רשות אישורים של שרת proxy קדמי

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

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

בדוגמה הבאה (שמתחילה עם ה-CA ברמה הבסיסית (root) בתחתית), הסדר מציין את הדברים הבאים:

  • אישור CA ברמה הבסיסית חתם על אישור CA ברמת ביניים A
  • אישור CA של Intermediate-B נחתם על ידי אישור CA של Intermediate-A
  • השרשרת ממשיכה עד לאישור ה-CA הסופי של Intermediate-Y, שנחתם על ידי ה-CA של Intermediate-X.
-----BEGIN CERTIFICATE-----
<Intermediate-Y CA CERT CONTENT>
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
<Intermediate-X CA CERT CONTENT>
-----END CERTIFICATE-----
...
-----BEGIN CERTIFICATE-----
<Intermediate-B CA CERT CONTENT>
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
<Intermediate-A CA CERT CONTENT>
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
<ROOT CA CERT CONTENT>
-----END CERTIFICATE----- 

כדי להמשיך בדוגמה הזו, צריך להעביר את המפתח הפרטי שמשויך לאישור Intermediate-Y CA יחד עם שרשראות אישורי ה-CA, באותו אופן כמו ב-CA בהתאמה אישית.

-----BEGIN RSA PRIVATE KEY-----
<Intermediate-Y PRIVATE KEY CONTENT>
-----END RSA PRIVATE KEY-----

כדי לבדוק אם האשכול משתמש ב-CA הביניים, בודקים את מספר האישורים בסוד ה-CA של האשכול:

kubectl get secret CLUSTER_NAME-ca \
    --kubeconfig ADMIN_KUBECONFIG
    -n cluster-CLUSTER_NAME \
    -o jsonpath='{.data.tls\.crt}' | base64 --decode | grep "BEGIN CERTIFICATE" | wc -l