ניהול מאובטח של סיסמאות ומפתחות ב-Helm
אמ;לק
ניהול נכון של סודות (Secrets) ב-Helm הוא קריטי לאבטחת שרשרת האספקה בענן. המאמר מציג טכניקות עבודה מומלצות כדי לוודא שמידע רגיש לא דולף בעת פריסת אפליקציות.
סיכום בעברית: מערכת VibeSec · מדיניות המקורות
נוסף ל-VibeSec:
כותרת מקורית: How to Handle Secrets in Helm

התוכן המלא בעברית
תרגום אוטומטי מהמקור; מונחים טכניים נשארו באנגלית. לנוסח המחייב — הכתבה המקורית.
• קידוד Base64 אינו הצפנה: Kubernetes Secrets מקודדים ב-Base64 ואינם מוצפנים, לכן הוספתם ל-Helm chart מכניסה אישור עבודה (credential) חשוף ל-Git.
• הצפנה בתוך ה-chart או סנכרון בזמן הפריסה: הצפן ערכים בתוך ה-chart באמצעות helm-secrets ו-SOPS או Sealed Secrets, או השאר את הערכים מחוץ ל-chart וסנכרן אותם בזמן הפריסה באמצעות External Secrets Operator או Vault Secrets Operator.
• External Secrets Operator כברירת מחדל: External Secrets Operator אינו דורש התקנה מיוחדת במקום שבו Helm פועל, כך ש-Argo CD, Flux ו-GitHub Actions ממשיכים לפעול ללא שינוי, מה שהופך אותו לבחירה המועדפת.
• שימוש ב-SOPS עם age במקום מפתחות PGP: השתמש בהצפנת age במקום במפתחות PGP עם SOPS. היא מעניקה הגנה דומה להצפנת קובץ ערכים, עם ניהול מפתחות פשוט הרבה יותר.
• שימוש ב-Reloader לעדכון פודים לאחר רוטציית סודות: רענון (rotation) של סוד אינו מפעיל מחדש את הפודים שלך באופן אוטומטי, פער שרוב המדריכים מחמיצים. הוסף את Reloader ואת ה-annotation המתאים כדי לסגור את הפער הזה.
אם אי פעם הדבקת סיסמת מסד נתונים לתוך values.yaml ואז עצרת לרגע לפני ביצוע git commit, המדריך הזה בשבילך. Helm chart מיועד לשיתוף, בעוד סיסמה אינה מיועדת לשיתוף עם אף אחד. מדריך זה סוקר ארבע דרכים שבהן צוותים מיישבים את שתי העובדות הללו, עם דוגמה מעשית לכל אחת, בתוספת הפער ברוטציית סודות שנוטה לצוץ חודשים לאחר מכן.
שתי הדרכים לשמור סודות מחוץ ל-Charts שלך
כל גישה במדריך זה היא וריאציה על אחד משני רעיונות, ואחרי שנים של עשייה זאת טרם מצאתי את השלישי:
• אחסון סודות מוצפנים בתוך ה-chart: הצפן את הערכים לפני שהם מגיעים ל-Git, ולאחר מכן פענח אותם בזמן הפריסה. ה-chart נשאר עצמאי ובטוח לביצוע (commit). אחסון סודות בדרך זו אומר שאתה האחראי על מפתחות ההצפנה ועל הפצתם.
• שמור את הערכים הסודיים מחוץ לתרשים לחלוטין. התרשים מכיל רק אסמכתא, והערך האמיתי נלקח ממנהל סודי בעת פריסת האפליקציה. שום דבר רגיש לא מאוחסן ב-Git. אתה לוקח על עצמך תלות בזמן ריצה בתמורה.
helm-secrets ו-Sealed Secrets מייצגים את הרעיון הראשון. External Secrets Operator ו-Vault Secrets Operator מייצגים את הרעיון השני.
אפשרות ראשונה: הצפנת ערכי ה-chart באמצעות helm-secrets ו-SOPS
תוסף helm-secrets הוא אפשרות נפוצה לניהול סודות ב-Helm והוא מכסה את שתי הגישות: הוא יכול להצפין ערכי Helm בתוך ה-chart, או למשוך אותם ממנהל סודות בענן בזמן ההתקנה.
כיצד פועל התוסף helm-secrets
מהו בעצם תוסף Helm? תוספי Helm הם הרחבות שמוסיפות פקודות ל-Helm CLI. אתה מתקין אותם באמצעות helm plugin install, ואז מריץ אותם כמו כל פקודה מקורית.
הפרט החשוב, וזה שמכשיל אנשים רבים: תוסף helm-secrets אינו מבצע הצפנה בעצמו. הוא מסתמך על SOPS, עורך Secrets Operations שנבנה במקור ב-Mozilla ונתרם ל-CNCF (Cloud Native Computing Foundation) בשנת 2023. SOPS מצפין ומפענח קבצים מובנים במקומם, מותיר את המפתחות גלויים ומצפין רק את הערכים, כך שהשוואת גרסאות (diff) בקובץ מוצפן עדיין מראה איזה הגדרה השתנתה במקום להציג גוש מידע לא ברור.
SOPS תומך במפתחות PGP, age, AWS Key Management Service (KMS), GCP KMS, Azure Key Vault, HashiCorp Vault, OpenBao ו-HuaweiCloud KMS כמפתחות הצפנה. בחירה זו חשובה יותר מהתוסף עצמו, מכיוון שהיא קובעת כיצד הצוות שלך ישתף גישה וכיצד תבצע רוטציה למפתחות ההצפנה בעתיד. לדוגמה, מפתח KMS לכל סביבה מאפשר ביטול הרשאות באופן שלא ניתן לעשות עם מחזיק מפתחות (keyring) PGP משותף. למדריך מעמיק על כל ספק, ראה A Comprehensive Guide to SOPS.
מדריך: הצפנת ערכי Helm chart באמצעות SOPS ו-PGP
PGP הוא סוג המפתחות הוותיק ביותר ש-SOPS תומך בו והדרך המהירה ביותר לראות את זרימת העבודה על מחשב בודד. עבור צוותים חדשים, המתחזקים של SOPS ממליצים להשתמש ב-age; השלבים זהים, לכן ניתן להתחיל מכאן.
brew install sops
ב-Debian או Ubuntu, אחזר את ה-.deb העדכני ביותר מדף ההפצות SOPS שהוא v3.13.3 בזמן הכתיבה:
SOPS_VERSION=$(curl -s https://api.github.com/repos/getsops/sops/releases/latest | grep -o '"tag_name": *"[^"]*"' | cut -d'"' -f4) curl -LO "https://github.com/getsops/sops/releases/download/${SOPS_VERSION}/sops_${SOPS_VERSION#v}_amd64.deb" sudo dpkg -i "sops_${SOPS_VERSION#v}_amd64.deb" sops --version
לאחר מכן, התקן את GnuPG וצור זוג מפתחות:
brew install gnupg
ב-Debian או Ubuntu, הפקודה sudo apt-get install gnupg מבצעת את אותה עבודה. לאחר מכן, צור את המפתח והזן את שמך ב-KEY_NAME:
export KEY_NAME="Tiexin Guo" export KEY_COMMENT="test key for sops" gpg --batch --full-generate-key <<EOF %no-protection Key-Type: 1 Key-Length: 4096 Subkey-Type: 1 Subkey-Length: 4096 Expire-Date: 0 Name-Comment: ${KEY_COMMENT} Name-Real: ${KEY_NAME} EOF
קרא את טביעת האצבע בחזרה עם gpg --list-keys:
$ gpg --list-keys [keyboxd] --------- pub rsa4096 2026-09-27 [SCEAR] 65E898A6DF79A111C62B7F459A815FE156C67FAC uid [ultimate] Tiexin Guo (test key for sops) sub rsa4096 2026-09-27 [SEA] 50FADB58B9194C0444CE2C67FCFF6AFD55F5D6F9
מחרוזת ההקסדצימלית הארוכה תחת pub היא טביעת האצבע, וזו הדרך שבה SOPS מתייחס למפתחות PGP. הפקודה gpg --list-secret-keys "${KEY_NAME}" תציג אותה גם כן.
כעת הגדר את SOPS להשתמש במפתח זה. SOPS קורא את התצורה שלו מקובץ בשם .sops.yaml, תוך חיפוש בספרייה של הקובץ אותו הוא מצפין ולאחר מכן בספריות האב; לכן, קובץ .sops.yaml אחד בשורש מאגר ה-chart שלך יחול על כל קובץ ערכים במאגר:
creation_rules: - pgp: >- 65E898A6DF79A111C62B7F459A815FE156C67FAC
החלף את טביעת האצבע בערך שלך, וזהו כל התהליך.
כעת התקן את התוסף. הצמד את הגרסה במקום להשתמש בגרסה האחרונה, כדי להבטיח שתחנות העבודה ושרתי ה-CI שלך יישארו מסונכרנים:
helm plugin install https://github.com/jkroepke/helm-secrets --version v4.7.8
$ helm plugin list NAME VERSION DESCRIPTION secrets 4.7.8 This plugin provides secrets values encryption for Helm charts secure storing
צור קובץ ערכי טקסט פשוט בשם credentials.yaml.dec :
password: test
helm secrets encrypt credentials.yaml.dec > credentials.yaml
פתח את credentials.yaml ותראה את שם המפתח (password) בטקסט גלוי ואת ערכו מוצפן, בתוספת בלוק מטא-נתונים של SOPS שמתעד באיזה מפתח נעשה שימוש.
התייחס לערך מתבנית Secret של התרשים שלך ב-your-chart/templates/secrets.yaml :
apiVersion: v1 kind: Secret metadata: name: helloworld labels: app: helloworld chart: "{{ .Chart.Name }}-{{ .Chart.Version }}" release: "{{ .Release.Name }}" heritage: "{{ .Release.Service }}" type: Opaque data: password: {{ .Values.password | b64enc | quote }}
התוויות כאן הן מטא-נתונים רגילים של אפליקציה, המוצגים על ידי ה-Helm template כמו כל שדה אחר. אם אתה מעדיף לדלג על פעולת ה-base64, השתמש ב-stringData במקום ב-data, ו-Kubernetes יקודד את הערך עבורך.
התקן עם הפקודה helm secrets install במקום helm install. התוסף יפענח את קובץ הערכים תוך כדי ריצה:
helm secrets install release-name -f values.yaml -f credentials.yaml your-chart
שני כללים חשובים: לעולם אל תבצע commit לקובץ credentials.yaml.dec, מכיוון שהוא מכיל טקסט גלוי; הוסף את *.yaml.dec ל-gitignore. הקובץ המוצפן credentials.yaml בטוח לביצוע כחלק מה-chart.
יש גם מלכודת בסיומת .dec שכדאי להכיר לפני שתבזבז על כך זמן יקר. אם קובץ credentials.yaml.dec מפוענח קיים והוא חדש יותר מ-credentials.yaml, התוסף ישתמש בקובץ הטקסט הגלוי במקום לפענח את הקובץ המוצפן. זו נוחות עבור פיתוח מקומי, אך זה אומר שקובץ מקומי מיושן עלול לעקוף בשקט את הערכים שביצעת להם commit, ופריסה שעובדת על המחשב שלך עלולה להיכשל ב-CI, שם קובץ ה-.dec אינו קיים. מחק אותו לאחר ההצפנה.
כדי לשתף גישה בין צוותי פיתוח, הוסף את טביעות האצבע של המפתחות הציבוריים שלהם ל-.sops.yaml והרץ את sops updatekeys credentials.yaml כדי להצפין מחדש את מפתח הנתונים של הקובץ עבור רשימת הנמענים המעודכנת. הפעולה משכתבת רק את בלוק המטא-נתונים, לכן ה-diff נשאר קטן, והיא מבקשת אישור אלא אם כן תוסיף את הדגל -y. בקרת הגישה מתבצעת בתצורת SOPS ולא בתוסף, כך שהוספת משתמש חדש דורשת commit אחד בלבד ולא יצירת סוד חדש.
כשמישהו עוזב את הצוות, הסדר קריטי. הסר תחילה את המפתח שלו מ-.sops.yaml, הרץ sops updatekeys כך שמפתח הנתונים לא יהיה מוצפן עבורו יותר, ורק אז הרץ sops rotate -i כדי ליצור מפתח נתונים חדש. ביצוע רוטציה לפני הסרת המפתח יגרום להצפנה מחדש עבור כל המפתחות שעדיין רשומים בקובץ, כולל המפתח שלו.
מדריך: העברת SOPS ממפתחות PGP להצפנת age
PGP עובד, אך ניהול מחזיקי מפתחות, מודלי אמון ושרתי מפתחות מהווה תקורה משמעותית להצפנת קובץ ערכים. החלופה המודרנית הנפוצה היא age (שנכתבת תמיד באותיות קטנות), כלי הצפנת קבצים קטן עם פורמט מפתחות קומפקטי: ללא מחזיקי מפתחות, ללא שרתי מפתחות, ללא תאריכי תפוגה, וזוג מפתחות שמתאים לקובץ טקסט יחיד. זה מקל מאוד על יצירת מפתח הצפנה נפרד לכל סביבה והפצת החלק הציבורי שלו.
brew install age
ב-Debian או Ubuntu, sudo apt install age . לאחר מכן צור זוג מפתחות:
mkdir -p ~/.config/sops/age age-keygen -o ~/.config/sops/age/keys.txt
age-keygen מדפיס את המפתח הציבורי, המתחיל ב-age1, וכותב את שני חלקי הזוג לקובץ keys.txt. התייחס לקובץ הזה כמו למפתח SSH פרטי: הוא הדבר היחיד שמאפשר פענוח.
הנתיב חשוב, כי SOPS מחפש את המפתח הפרטי במיקום ברירת מחדל בעת הפענוח. ב-Linux המיקום הוא $XDG_CONFIG_HOME/sops/age/keys.txt, עם חזרה ל-$HOME/.config/sops/age/keys.txt. ב-macOS המיקום הוא $HOME/Library/Application Support/sops/age/keys.txt, לכן אם ביצעת את הפקודה לעיל על Mac, הצבע במפורש על הקובץ עבור SOPS:
export SOPS_AGE_KEY_FILE=~/.config/sops/age/keys.txt
SOPS_AGE_KEY הוא משתנה סביבה נוסף שכדאי להכיר, מכיוון שהוא מקבל את תוכן המפתח הפרטי ישירות במקום נתיב. בזה משתמשת הדוגמה של GitHub Actions בהמשך המדריך, מכיוון של-CI runner אין ספריית בית נוחה לכתיבה.
כעת ציין את המפתח הציבורי ב-.sops.yaml. כדי לאפשר למספר אנשים בצוות לפענח את אותם קבצי ערכים, רשום את המפתחות הציבוריים שלהם מופרדים בפסיקים; המפתח הציבורי של כל נמען מצפין עותק משלו של מפתח הנתונים של הקובץ, וכל משתמש מפענח באמצעות המפתח הפרטי שלו:
creation_rules: - age: >- age12lycjufx6awzqv68439jm8hf24y6wz2nme3km465yrv6ga7ury8qmm09x8, age1qe5lxzzeppw5k79vxn3872272sgy224g2nzqlzy3uljs84say3yqgvd0sw
כל השאר נשאר אותו הדבר. הפקודות helm secrets encrypt ו-helm secrets install מתנהגות באופן זהה, לכן העברת ה-chart הקיים פירושה הצפנה מחדש של קבצי הערכים עבור הנמען החדש ומחיקת כלל ה-PGP הישן.
אזהרה אחת שכדאי לציין בבירור, שכן פוסטים רבים בבלוגים מגזימים לגביה: הצפנת age פשוטה יותר ויש לה משטח תקיפה קטן בהרבה ממפתחות PGP, אך היא אינה קריפטוגרפיה חזקה יותר עבור מקרה השימוש הזה, והצפנת קבצים אינה מעניקה forward secrecy בכל מקרה. בחר ב-age כי ניהול המפתחות קל יותר, לא כי היא מקשה על פיצוח סוד מוצפן.
שמור את המפתח הפרטי מחוץ למאגר. הפץ אותו דרך מנהל הסודות הקיים שלך או האחסון המוצפן של ספק ה-CI שלך, וגבה אותו במקום שאינו המחשב הנייד שבו הוא נוצר. ל-SOPS אין נתיב שחזור: אם המפתח היחיד שיכול לפענח קובץ ערכים הולך לאיבוד, הקובץ הזה לא יהיה ניתן לקריאה לעולם.
מדריך: משיכת ערכים ממנהל סודות בענן באמצעות vals
לתוסף helm-secrets יש מצב עבודה שני שאינו מאחסן שום דבר רגיש ב-Helm chart. במקום ערכים מוצפנים, קובץ הערכים של Helm מכיל הפניה (reference), והתוסף פותר אותה בזמן ההתקנה באמצעות vals.
export HELM_SECRETS_BACKEND=vals
vals זקוק להרשאות של ספק הענן בכל מכונה שמריצה Helm, לכן ודא שהמריץ (caller) יכול לקרוא ממאגר הסודות. שמור על אותה תבנית Secret, הפעם עם stringData כדי שתוכל לראות את החלופה: