חזרה לפיד
articlesמקור: GitGuardian Blog4.10.2026

מדריך מקיף ל-SOPS: ניהול סודות כמו מומחה, לא פקיד

אמ;לק

מאמר זה מציג מדריך מקיף לכלי SOPS לניהול סודות רגישים בארגון. הוא מסביר את אופן פעולתו וכיצד ניתן לשלבו עם שירותי ניהול מפתחות נפוצים כגון AWS KMS ו-HashiCorp Vault, לשיתוף מאובטח של מידע בין צוותים.

סיכום בעברית: מערכת VibeSec · מדיניות המקורות

נוסף ל-VibeSec:

כותרת מקורית: SOPS Guide: How to Encrypt and Manage Secrets in Git, Kubernetes, and CI/CD

מדריך מקיף ל-SOPS: ניהול סודות כמו מומחה, לא פקיד

התוכן המלא בעברית

תרגום אוטומטי מהמקור; מונחים טכניים נשארו באנגלית. לנוסח המחייב — הכתבה המקורית.

האם אי פעם היית צריך לשתף סוד עם חבר לצוות ובסופו של דבר הדבקת אותו בחלון צ'אט, והבטחת לעצמך שתנקה אותו מאוחר יותר? אם זה נשמע לך מוכר, הכתבה הזו בשבילך. בואו נראה איך SOPS עובד וכיצד להשתמש בו עם מאגרי מפתחות שצוותים מנהלים בפועל בסביבות ייצור (Production): age, AWS KMS, ו-HashiCorp Vault.

⁦TL⁩;⁦DR⁩

• מה זה: SOPS מצפין את הערכים בתוך קבצי YAML, JSON, ENV ו-INI ומשאיר את שמות המפתחות קריאים, כך שניתן לשמור סודות מוצפנים בתוך Git.

• מאגרי מפתחות: AWS KMS, GCP KMS, Azure Key Vault, HuaweiCloud KMS, age, ו-PGP, בנוסף ל-HashiCorp Vault/OpenBao, עם כללים בקובץ .sops.yaml המנתבים כל קובץ למפתח המתאים.

• במה ומתי להשתמש: age לפיתוח מקומי ו-CI, שירותי KMS בענן או Vault לייצור, שבהם מדיניות IAM קובעת מי רשאי לפענח את הנתונים.

• אוטומציה: GitHub Actions, Flux CD, helm-secrets, ו-KSOPS מבצעים פענוח בזמן בנייה (build) או סנכרון (reconcile), כך ששום סוד בטקסט גלוי אינו מועלה ל-Git.

• מגבלות: SOPS אינו מנהל סודות (Secrets Manager). כדאי לשלב אותו עם כלי כזה עבור גישה בזמן ריצה, ולהשתמש בכלי לזיהוי סודות (secrets detection) כדי למנוע דליפות מחוץ לקבצים המוצפנים.

מה זה ⁦SOPS⁩?

ראשית, בואו ניגש ישר לעניין ונדבר על הפיל שבחדר: מה זה בכלל SOPS?

מכיוון שתמונה שווה אלף מילים, הנה המחשה שלהם (כל הכבוד ל-@sec_r0 על האיור):

SOPS, הידוע בשם Mozilla SOPS, הוא עורך לקבצים מוצפנים. הוא מטפל בהצפנה, פענוח ועריכה בתוך כלי אחד. מפתחות ההצפנה נשמרים במאגר מפתחות לבחירתך: PGP (Pretty Good Privacy) / GnuPG, age, Amazon Web Services Key Management Service (AWS KMS), Azure Key Vault (Azure KMS), Google Cloud KMS, HashiCorp Vault / OpenBao, ו-HuaweiCloud KMS.

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

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

איך עובדת ההצפנה של SOPS

SOPS משתמש בשיטת הצפנת מעטפה (envelope encryption). כל קובץ מקבל מפתח נתונים אקראי משלו, ומפתח זה מצפין את ערכי הסודות באמצעות AES-256-GCM. לאחר מכן, מפתח ראשי אחד או יותר ממאגר המפתחות שבחרת מצפינים את מפתח הנתונים הזה: מפתח PGP, מפתח ציבורי של age, מפתח ARN של KMS או מפתח Transit של Vault. בלוק מטא-נתונים של SOPS בתוך הקובץ מתעד את כל הדרוש לפענוח מאוחר יותר, כולל המפתחות הראשיים ששימשו להצפנה. אין קובץ נפרד שצריך לעקוב אחריו.

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

⁦db_credentials: username: app password: hunter2⁩

⁦db_credentials: username: ENC[AES256_GCM,data:...,iv:...,tag:...,type:str] password: ENC[AES256_GCM,data:...,iv:...,tag:...,type:str] sops: age: - recipient: age1... enc: | -----BEGIN AGE ENCRYPTED FILE----- ... -----END AGE ENCRYPTED FILE----- lastmodified: "2026-08-14T09:12:41Z" mac: ENC[AES256_GCM,data:...,type:str]⁩

סוקר יכול לראות שהסיסמה השתנתה בבקשת משיכה מבלי לראות את הערך הסודי. ההצפנה הסודית הזו לפי ערך היא מה שהופך את הסודות המוצפנים ל-⁦SOPS⁩ למעשיים לשמירה באותו מאגר כמו קוד יישום ו-⁦Kubernetes⁩ מניפסטים.

כדאי לדעת שני פרטים: SOPS מצפין גם הערות ב-YAML, מכיוון שהערה ליד סוד מתארת אותו לעיתים קרובות; ו-SOPS שומר קוד אימות הודעה (MAC) על ערכי הקובץ, כולל אלה שנותרו בטקסט גלוי, כך שאם קובץ עבר שינוי זדוני, הפענוח ייכשל במקום להחזיר נתונים שגויים מבלי שנדע. אם ברצונך שה-MAC יכסה רק את הערכים ש-SOPS הצפין בפועל, השתמש בדגל --mac-only-encrypted.

פורמטים נתמכים ושירותי ניהול מפתחות

SOPS תומך בפורמטים YAML, JSON, ENV (dotenv), INI וקבצים בינאריים, מה שמכסה את רוב קבצי התצורה שצוות צריך לאבטח. עבור YAML, JSON, ENV ו-INI הוא מצפין ערכים ומשאיר את המפתחות קריאים. עבור כל סוג קובץ אחר, הוא מתייחס לתוכן כבינארי ומצפין את הקובץ כולו.

בצד המפתח, ⁦SOPS⁩ תומך במספר שיטות הצפנה, או מאגרי מפתחות, ואתה יכול לערבב אותם בתוך מאגר אחד:

אינך חייב לבחור מאגר מפתחות אחד לכל קובץ. קובץ התצורה .sops.yaml מאפשר לך לנתב קבצי ייצור (production) ל-AWS KMS, קבצי staging לקבוצה של נמעני age, וכל השאר למפתח PGP. רוצה לערוך קובץ טקסט עם מפתח age מקומי? אין בעיה. צריך קובץ dotenv מוצפן על ידי Vault? גם זה נתמך.

⁦OK⁩, מספיק תיאוריה. בואו נתקין אותו ונרגיש איך זה עובד.

כיצד להתקין את SOPS

ב-⁦macOS⁩, התקן את ⁦SOPS⁩ עם ⁦Homebrew⁩ , מנהל החבילות עבור ⁦macOS⁩:

⁦brew install sops⁩

ב-Linux ו-Windows, הורד את הקובץ הבינארי או את החבילה עבור הפלטפורמה שלך מדף ה-Releases של SOPS ב-GitHub. ב-Debian וב-Ubuntu, ניתן להוריד ולהתקין את גרסת ה-.deb העדכנית כך:

⁦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⁩

SOPS פותח את העורך שמוגדר במשתנה הסביבה SOPS_EDITOR, וחוזר ל-EDITOR אם SOPS_EDITOR לא הוגדר. כדי להשתמש ב-VS Code, הוסף export EDITOR="code --wait" לקובץ ה-~/.bashrc או ה-~/.zshrc שלך. ישנה גם תוספת קהילתית בשם vscode-sops שמפענחת ומצפינה מחדש קבצים ישירות בתוך VS Code. היא מתוחזקת על ידי הקהילה, לכן כדאי לבדוק אותה קודם על קבצים לא קריטיים.

SOPS עם מפתחות PGP

PGP הוא מאגר המפתחות הוותיק ביותר ש-SOPS תומך בו, והדרך המהירה ביותר לראות איך הוא עובד על מחשב יחיד. עבור הגדרות צוות חדשות, מתחזקי SOPS ממליצים להשתמש ב-age (נסביר זאת בסעיף הבא). זרימת העבודה זהה, לכן ההסבר על PGP הוא עדיין המקום הטוב ביותר ללמוד את היסודות.

PGP מול GPG

⁦PGP⁩, ⁦GPG⁩... מבלבל, אני יודע, נכון? שני השמות מתערבבים כל הזמן. בקיצור, ⁦GPG⁩ הוא כלי שורת פקודה שמיישם ⁦PGP⁩:

• ⁦PGP⁩ : תוכנית הצפנה המספקת פרטיות ואימות קריפטוגרפיים. הוא חותם, מצפין ומפענח טקסט, דואר אלקטרוני, קבצים, ספריות ומחיצות דיסק שלמות.

• ⁦GPG⁩ (⁦GnuPG⁩): יישום חופשי של תקן ⁦OpenPGP⁩, ⁦RFC⁩ 4880. הוא מצפין וחותם נתונים ומשלוח עם מערכת ניהול מפתחות.

עכשיו, כשהבהרנו את השמות המבלבלים, בואו ניצור מפתח PGP בעזרת GPG CLI כדי של-SOPS יהיה עם מה להצפין.

צור מפתח ⁦PGP⁩ עם ⁦GPG⁩

⁦brew install gnupg⁩

ב-⁦Linux⁩, השתמש במנהל החבילות שלך. ב-⁦Debian and 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 gpg: checking the trustdb gpg: marginals needed: 3 completes needed: 1 trust model: pgp gpg: depth: 0 valid: 1 signed: 0 trust: 0-, 0q, 0n, 0m, 0f, 1u [keyboxd] --------- pub rsa4096 2026-09-27 [SCEAR] 65E898A6DF79A111C62B7F459A815FE156C67FAC uid [ultimate] Tiexin Guo (test key for sops) sub rsa4096 2026-09-27 [SEA] 50FADB58B9194C0444CE2C67FCFF6AFD55F5D6F9⁩

מחרוזת ההקסדצימלית הארוכה תחת pub היא ה-fingerprint של מפתח ה-GPG. ניתן להדפיס אותה גם בעזרת gpg --list-secret-keys "${KEY_NAME}". שמור את ה-fingerprint של המפתח בהישג יד; SOPS מפנה למפתחות PGP באמצעות ה-fingerprint שלהם.

הגדר את ⁦SOPS⁩ עם .⁦sops.yaml⁩

⁦SOPS⁩ קורא את התצורה שלו מקובץ בשם .⁦sops.yaml⁩ . זה נראה בספרייה של הקובץ שהוא מצפין או מפענח ולאחר מכן בכל ספריית אב, כך ש-.⁦sops.yaml⁩ בשורש המאגר שלך חל על כל קובץ במאגר הזה. לבדיקה זו, צור אחד בספריית הבית שלך:

⁦creation_rules: - pgp: >- 65E898A6DF79A111C62B7F459A815FE156C67FAC⁩

החלף את ה-fingerprint בזו שיצרת. זו כל ההגדרה, ואנחנו מוכנים לצאת לדרך.

הצפנת קובץ טקסט

הפעל את הפקודה הבאה כדי ליצור קובץ חדש עם ⁦SOPS⁩:

⁦sops a-text-file.txt⁩

העורך שלך נפתח. הקלד משהו (השתמשתי ב"שלום עולם"), שמור וצא. עכשיו חתוך את הקובץ:

⁦$ cat a-text-file.txt { "data": "ENC[AES256_GCM,data:XkNRIt2aVBk/9re/,iv:M6FlDAMPV001kbm1IPT6Uwp2N3olJVkFl6hyZWttKgQ=,tag:F/ih4jLOJsKAbAg+UkT8Fw==,type:str]", "sops": { "lastmodified": "2026-09-27T02:35:13Z", "mac": "ENC[AES256_GCM,data:uP3ZfrZXw7X6w9wtgepst2CKKEyCxtjzYF4uV1EVXtiyfo6qmUpARrj6HAsO+stIMT+D3ov0dkmtPDhacTfhHp0urKerVlPhvq9JQbwrsn2Et4uCuqFL1XoNfEB4qhWMy85mdVPaeu5x7/OhIwhS4PybcG1FijYiKvBmrYRW9ns=,iv:DEQyzZ6YSEiOmwAOur/ADZvbItqibQOXkZ0ANHfrPXk=,tag:M2vUmZv4essfBZAQuSk4hw==,type:str]", "pgp": [ { "created_at": "2026-09-27T02:35:07Z", "enc": "-----BEGIN PGP MESSAGE-----\n\nhQIMA/z/av1V9db5AQ/7BPOFI4MirPnykuHJ5JkRRiTAhx/3WvOf5xBsi4WMEPyF\nhNa2KXY3RB1xUjGUrmRUSY0uHBT3uKToxr/qVW1in1cKf6agOEGt8xNxRqei7BQM\nzF/vRsUGMvE0nsBrLGymmX77hXpjmRnVTfJr/h8076lrOC4VpYx1G4J/OiSE4a0R\nLBe6gFmc8eDjZ5UpamNdICuPSBLESVlJFR6CJ+rnqUs6Gqgi9wL0BQve8xO74tkp\n6PUNhXYwdvSwimXCijNM/uMlxtx8OXA+drhWCydLH6zhTx+X4aWzuP5vMVWBziAR\nz016o8+QW9SdaJrLkKwveuMI9id3Yk0tA1euMJyz4uGhdshyaAoQKDTxeCCBA1jm\n5Eydyd01tn9TRKzLHc6VJkEZpCFwJ1W6om5L/CIbCH9BG5mEpch3ilvk2UNr7T7t\n3ylIeERchjV8KAkEuwQRcOWdUWsQucNxknEr422WkOAL9xPtBLtGM2jUkP3SfoON\nnIfmSZLUKoKesO/pkXHjyIv+pEPxPi9GWF6yQqJ+QhRTNjMc6X8OJbe4Xy3VfAcs\nclAq4DWF6CdSzWJC2HYJofAxfGo0aPACPTnipH6WHOozoj7iZhyyEOEGqNStT3dF\nPDQmfs+y+PAI7HqMVLB6SktnEtR+oTmA9BFyXBEJGuKLxBnuJ8TvEHKku7H1pr7U\naAEJAhBe+1E9DuB4dEA/YZEWoE8/tixnWRSF8hDOD+5Z+bjRzYfPzEGyn4R93L7+\npsgpbnooXrAh78Foed+tvw/pTZqIM+3BxklrT3uAlN9Wuy35VJsoWfWuWI2T1/GU\nk65gxduzDwn8\n=EkDN\n-----END PGP MESSAGE-----", "fp": "65E898A6DF79A111C62B7F459A815FE156C67FAC" } ], "version": "3.13.3" } }⁩

• כל הקובץ מוצפן (שדה ה-data). לקובץ .txt פשוט אין מבנה שניתן לשמר, ולכן SOPS מתייחס אליו כקובץ בינארי.

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

⁦sops a-text-file.txt⁩

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

הצפנת נתונים מובנים: YAML, JSON, ENV ו-INI

הצפנת קובץ טקסט שלם היא שימושית, אך כאשר הקובץ מכיל נתונים מובנים (YAML, JSON, INI, ENV), SOPS יכול לעשות עבודה טובה עוד יותר. בואו ננסה.

⁦sops a-yaml-file.yaml⁩

הוסף שני זוגות של מפתח-ערך ושמור: username: tiexin, password: test

⁦$ cat a-yaml-file.yaml username: ENC[AES256_GCM,data:mZi0E9JN,iv:2diEIuR6i5NtpRAXESdZLshxiSsALljijqufnPTA1Uo=,tag:G4IzF1d47NVbWn+nV16riw==,type:str] password: ENC[AES256_GCM,data:+wF+SQ==,iv:aThqVCSv0nmTGKeqCL9TK3DTuHknuKZPJWENaffYmYQ=,tag:gF2SpCPmfp1vIR4IyYVL9A==,type:str] ...(omitted)⁩

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

#sops#secrets-management#aws-kms#hashicorp-vault
קרא במקור