‘.env’ はGitに置けません。ただし暗号化すれば置けます。SOPSとageで、鍵を持っている人だけが読める形にします。
前回: 同じ設定を3台に手でやらない — Ansible入門
はじめに のカリキュラムでは 第6段階「運用する」 にあたります。
作業場所は VM の中(Ubuntu Server)です。 Windows 側では何もしません。
始める前に、VMのスナップショットを取ってください。 この記事は
~/server/.envを触ります。戻し方は最後の「後片づけ」に書きます。
GitOps の回の終わりで、こう書いて逃げました。
秘密情報は Git に置けない。解決策には名前が付いています。名前だけ挙げます。 Sealed Secrets / External Secrets / SOPS / Vault
この記事は、その回収です。
そして Ansible の回でも、同じことをやりました。
「秘密を書きたくなったときに、Ansible Vault という仕組みがある」ことだけ覚えて、先に進んでください。
先送りが2回続いています。 これは偶然ではありません。秘密情報の置き場は、他の全部を作り終わったあとに、最後に残る問題だからです。
ここまでで、あなたのVMには秘密の値が散らばっています。~/server/.env にDBのパスワード。GitHub の Secrets にトークン。Kubernetes の Secret に同じ値の base64。Docker Compose の environment: に、たぶんもう1枚。
何枚あるか、いま言えますか。
言えないなら、それがこの記事の出発点です。
そして、はじめに言っておきたいことがあります。この記事のゴールは Vault を建てることではありません。
秘密情報の置き場には段階があって、あなたはまだ2段目にいる、と分かること。 そして2段目から3段目(暗号化してGitに置く)へ、実際に上がること。
いきなり最上段に行こうとすると、必ず途中で投げます。 私は一度投げました。
対象レベル: 中級 / 区分: 必修
この記事でわかること
.envの問題は「平文だから」だけではないこと。配るのが手作業・誰が見たか分からない・変えるのが大変の3つのほうが、実務では効くこと- 置き場所には4段階あること。
.env→ 環境変数 → 暗号化してGitに置く → 専用サーバー。いきなり Vault に行く必要はないこと - SOPS は「ファイル全体」ではなく「値だけ」を暗号化すること。だから Git の差分が読める(=Gitと相性が良い)こと
- 暗号化しても「鍵をどこに置くか」は残ること。この問題は消えず、減るだけだということ
- Kubernetes では Sealed Secrets と External Secrets が何を分担しているか(GitOpsの回の宿題)
- Vault が本当に違うのは「暗号化」ではなく「動的に発行する・失効させられる・記録が残る」の3点だということ。そして個人には過剰だということ
- 漏れたときにやることは、履歴の掃除ではなく作り直しだということ(セキュリティ点検の回の回収)
この記事でやること
- コマンドで棚卸しする。 VMの中の
.envを全部見つけ、Gitの履歴に入っていないかを確かめる - 段階の表を作って、いま自分がどこにいるかを決める
- SOPS と age を入れて、
.envを暗号化する。 暗号化後のファイルを開いて、キーは読めて値だけ暗号化されていることを目で見る - 値を1つ変えて再暗号化し、
git diffが1行だけ変わることを確かめる - 鍵の置き場所を決めて、バックアップする
- 後片づけして、元の状態に戻す
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| 平文(へいぶん) | 暗号化されていない、そのまま読める状態。.env は平文 |
| 公開鍵暗号 | 鍵を2本1組で作る方式。公開鍵で暗号化し、秘密鍵で復号する。公開鍵は配ってよい |
| age(エイジ) | 公開鍵暗号をとても小さい機能に絞った道具。鍵が1行の文字列になる |
| SOPS(ソップス) | 設定ファイルの値だけを暗号化する道具。キー(項目名)は平文のまま残す |
| 受信者(recipient) | その暗号文を復号できる相手。age では公開鍵で指定する。複数指定できる |
| データ鍵 | SOPS がファイルごとに毎回作る使い捨ての鍵。中身はこれで暗号化し、この鍵自体を age の公開鍵で暗号化して同じファイルに入れる |
| ローテーション | 秘密情報を作り直して差し替えること。漏れたときにやるのはこれ |
| 動的シークレット | 使うときにその場で発行され、時間が来たら自動で失効する認証情報。Vault の中心機能 |
| 監査ログ | 誰が・いつ・何を取り出したかの記録 |
① まず棚卸しする — いま秘密がどこにあるか
対策の前に現状です。 順番を逆にすると、塞いだつもりの穴の隣が開いたままになります。
打つ場所: VM の中(Ubuntu)
1. .env 系のファイルを全部見つける
出力の例です(中身は環境によって違います)。
/home/ubuntu/.ssh/id_ed25519
/home/ubuntu/.ssh/id_ed25519.pub
/home/ubuntu/server/.env
/home/ubuntu/server/.env.migrate
/home/ubuntu/server/.env.example
findの\( ... \)は「この中はひとかたまり」という意味です。-o(または)を並べるときは囲まないと、最後の条件にしか-not -pathが効きません。 括弧の前の\は、シェルに括弧を食べさせないためのものです。
ここで「思ったより多い」と感じたら、それが正常な反応です。
[スクリーンショット: 01_env棚卸し.png] 上の find を実行して、.env 系のファイルが一覧で出た画面を撮ってください。パスだけが写るので、値は写りません。
2. 中身に秘密が入っていそうなファイルを探す
ファイル名が .env でなくても、秘密は入ります。
/home/ubuntu/server/.env
/home/ubuntu/server/.env.migrate
/home/ubuntu/server/docker-compose.yml
/home/ubuntu/k8s-manifests/apps/web/secret.yaml
-lは「ファイル名だけ出す」、-Iはバイナリを飛ばす、-rは再帰です。-lを付けているので、値そのものは画面に出ません。 棚卸しでうっかり画面に秘密を出さないための書き方です。
3. Gitの履歴に入っていないか確かめる
ここがいちばん大事です。 GitHub の回で書いたとおり、一度 push したものは、消しても履歴に残ります。
何も出なければ、いまは追跡されていません。 次に過去を見ます。
(何も出ない = 一度も入っていない)
リポジトリが複数あるなら、まとめて回します。
--- /home/ubuntu/server/.git
--- /home/ubuntu/k8s-manifests/.git
リポジトリ名だけが並んで、その下に行が出なければ合格です。
ここで行が出た人は、この記事を読み進める前に、その値を作り直してください。 手順は最後の「⑨ 漏れたときの手順」にあります。暗号化の勉強より、そちらが先です。
4. ファイル以外の置き場所も数える
忘れられがちな3つです。
MYSQL_PASSWORD: ********
NAMESPACE NAME TYPE DATA AGE
default app-secret Opaque 2 3d
7
3つ目に注目してください。 これは ~/.bash_history に、秘密らしき文字列を含む行が7行あるという意味です。
コマンドラインに打った秘密は、履歴ファイルに平文で残ります。
mysql -p'パスワード'のような打ち方をした人は、そのファイルが4枚目の置き場所になっています。中身を確認するときは、画面共有していないことを確かめてからにしてください。
同じ理由で、環境変数もこう読めます。
SHELL=/bin/bash
PWD=/home/ubuntu
LANG=C.UTF-8
HOME=/home/ubuntu
TERM=xterm-256color
/proc/<番号>/environは、そのプロセスの環境変数です。自分のプロセスと、root なら他人のプロセスも読めます。 「環境変数にすれば安全」ではありません。 同じマシンに入れる人には見えます。
棚卸しの結果を、1枚の表にする
私の場合はこうなりました。あなたも同じ形で書き出してください。
| どこに | 何が | 平文か | 配り方 |
|---|---|---|---|
~/server/.env | DBパスワード、セッション署名鍵 | 平文 | 手でコピー |
~/server/.env.migrate | 管理用DBユーザーのパスワード | 平文 | 手でコピー |
docker-compose.yml | MySQL の root パスワード | 平文 | Gitに入っている(!) |
| GitHub の Secrets | デプロイ用トークン | 暗号化 | 画面で登録 |
| Kubernetes の Secret | 上と同じ値の base64 | 実質平文 | kubectl apply |
~/.bash_history | 過去に打ったパスワード | 平文 | — |
同じ値が3箇所にある、という状態になっているはずです。 これがこの記事で潰す本丸です。
② .env の何が問題なのか
「平文だから危ない」だけだと思っていると、対策を間違えます。
問題は4つあって、平文はそのうちの1つでしかありません。
| 問題 | どう困るか |
|---|---|
| ① 平文で置いてある | VMに入れた人・バックアップを取った人・スナップショットを見た人が、そのまま読めます |
| ② 配るのが手作業 | 新しいVMを立てるたびに、人がコピーして貼ります。 チャットに貼った時点で、チャットが5枚目の置き場所になります |
| ③ 誰が見たか分からない | ファイルを cat しても記録は残りません。 「漏れたかどうか」を後から調べる手段が無い |
| ④ 変えるのが大変 | 同じ値が3箇所にあるので、3箇所とも直さないとアプリが落ちます。 だから誰も変えなくなります |
このうち一番効くのは④です。
変えるのが大変だから、変えない。変えないから、5年前のパスワードが動き続ける。
セキュリティの問題は、たいていこの形をしています。 危険だから漏れるのではなく、面倒だから直さないので、いつまでも危険なままになります。
だから、道具を選ぶときの基準はこうなります。
「漏れにくいか」ではなく、「変えるのが楽になるか」。
この視点で見ると、.gitignore に .env を書くのは①しか解いていないと分かります。②③④はそのまま残っています。
.gitignoreは対策ではなく、事故の予防です。 大事ですが、これで完了ではありません。
③ 置き場所には段階がある
ここで一気に Vault の話をしません。 段階を並べます。
| 段階 | やり方 | 解ける問題 | 残る問題 |
|---|---|---|---|
| 1段目 | ソースコードに直書き | 何も解けていない | 全部。 Gitに入る |
| 2段目 | .env に出して .gitignore | ① Gitに入らなくなる | ②③④が丸ごと残る |
| 3段目 | 暗号化してGitに置く(SOPS) | ①② 配布がGitになる。差分も残る | ③④が残る。鍵の置き場が増える |
| 4段目 | 専用サーバー(Vault) | ①②③④ 全部 | サーバーを運用する仕事が増える |
いま、あなたは2段目にいます。 .gitignore に .env を書いた時点で2段目です。
そして、多くの個人開発は 2段目〜3段目で十分です。
「本気でやるなら Vault」ではありません。 4段目は、秘密を取り出す人が複数いて、誰が取ったか記録する必要があるときに効く道具です。1人でVM1台なら、記録する相手があなたしかいません。
この記事では、2段目 → 3段目を実際にやります。 4段目は⑧で「何が違うのか」だけ見ます。
なぜ環境変数が段階の途中にあるのか
表に書かなかった中間の姿があります。「.env を読まず、環境変数だけで渡す」というやり方です。
これはファイルを1枚減らします。 ただし①でやったとおり、環境変数は /proc から読めますし、コマンドラインに書けば履歴に残ります。
環境変数は「ファイルに残さない」ための道具であって、「見えなくする」ための道具ではありません。
アプリに渡す最終形としては正しいのですが、それだけでは②③④が解けません。 だから次に行きます。
④ SOPS と age で .env を暗号化する
ここがこの記事の中心です。
やることを先に1行で言います。
.envを、値だけ暗号化した.env.sopsに変換して、そちらを Git に入れる。
「値だけ」がポイントです。 DB_PASSWORD というキー(項目名)は平文のまま残り、右辺だけが暗号文になります。
なぜそれが嬉しいのかは⑤で確かめます。 まず動かします。
4-1. age を入れる
打つ場所: VM の中(Ubuntu)
まず、そもそも apt に有るかを確かめます。
age:
インストールされていません: (なし)
候補: 1.1.1-1
バージョンテーブル:
1.1.1-1 500
500 http://jp.archive.ubuntu.com/ubuntu noble/universe amd64 Packages
「候補」に数字が出れば有ります。 入れます。
v1.1.1
「候補: (なし)」だった人は、age のリリース一覧から
linux-amd64の.tar.gzを落として、中のageとage-keygenを/usr/local/binに置いてください。ファイル名はバージョンで変わるので、ページで実物を見てから打ちます。 これはapt の回で書いた「apt に無いものは自分で置く」の実例です。
4-2. 鍵を1組つくる
Public key: age1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
上の
age1xxx...はダミーです。 あなたの画面には、別の実在する文字列が出ます。この記事の文字列をコピーしても動きません。
ファイルの中を見ます。
# created: 2026-09-09T10:12:33+09:00
# public key: age1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
AGE-SECRET-KEY-1XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
3行の意味です。
| 行 | 何か | 扱い |
|---|---|---|
# created: | 作った日時。ただのコメント | — |
# public key: | 公開鍵。 暗号化に使う | 人に見せてよい。 Gitに入れてよい |
AGE-SECRET-KEY-1... | 秘密鍵。 復号に使う | 絶対に外に出さない |
この
keys.txtを失うと、暗号化したファイルは二度と戻りません。 バックアップの話は⑥でやります。先に読みたい人は⑥へ飛んでください。
公開鍵だけを取り出しておきます。あとで何度も使います。
[スクリーンショット: 02_age鍵作成.png] age-keygen を実行して Public key: が表示された画面を撮ってください。cat keys.txt の画面は撮らないでください。秘密鍵が写ります。
4-3. SOPS を入れる
SOPS は apt には有りません。 GitHub のリリースから直接置きます。
sops 3.9.1 (latest)
バージョンの数字は変わります。 リリース一覧で最新を見て、
linux.amd64と付いているファイル名に読み替えてください。.debが置いてある版もあります。
install -m 0755は、cp+chmodを1回でやるコマンドです。実行権限を付け忘れる事故が減ります(権限の回)。
--version が出なかったら、先へ進まないでください。 ここで止まっているほうが、あとで悩むより早いです。
4-4. どの鍵で暗号化するかを設定ファイルに書く
毎回コマンドに公開鍵を打つのは、間違いのもとです。 リポジトリの一番上に .sops.yaml を置きます。
creation_rules:
- path_regex: \.env
age: age1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
2行の意味です。
| 項目 | 意味 |
|---|---|
path_regex: \.env | 「パスに .env を含むファイル」 に、このルールを当てる。部分一致なので .env も .env.migrate も拾う |
age: | 暗号化に使う公開鍵。 あなたの # public key: の値に置き換えます |
path_regexが見るのは「入力ファイルの名前」です。出力先の名前ではありません。.envを読んで.env.sopsを作るときも、判定されるのは.envのほうです。
.sops.yamlは Git に入れて構いません。 中にあるのは公開鍵だけです。
4-5. 暗号化する
元の .env を先に確認します。
DB_HOST=127.0.0.1
DB_USER=appuser
DB_PASSWORD=dummy-db-password-1234
SESSION_SECRET=dummy-session-secret-abcdefg
PORT=3000
上の値は全部ダミーです。 記事に出すために書いています。あなたの実物とは違います。
暗号化します。
何も表示されずにプロンプトが戻れば成功です。
なぜ
--input-type dotenvを毎回書くのか。 SOPS は拡張子で形式を見分けます。.env.sopsという名前は SOPS にとって未知なので、「これはKEY=値の形式だ」と明示しています。書かないとError: could not get file typeで止まります。
4-6. 中身を見る — キーは読めて、値だけ暗号化されている
ここがこの記事で一番見てほしい画面です。
DB_HOST=ENC[AES256_GCM,data:dGVzdGRhdGE=,iv:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=,tag:AAAAAAAAAAAAAAAAAAAAAA==,type:str]
DB_USER=ENC[AES256_GCM,data:dGVzdA==,iv:BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB=,tag:BBBBBBBBBBBBBBBBBBBBBB==,type:str]
DB_PASSWORD=ENC[AES256_GCM,data:ZHVtbXlkYXRh,iv:CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC=,tag:CCCCCCCCCCCCCCCCCCCCCC==,type:str]
SESSION_SECRET=ENC[AES256_GCM,data:c2VjcmV0,iv:DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD=,tag:DDDDDDDDDDDDDDDDDDDDDD==,type:str]
PORT=ENC[AES256_GCM,data:MzAwMA==,iv:EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE=,tag:EEEEEEEEEEEEEEEEEEEEEE==,type:str]
sops_age__list_0__map_recipient=age1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
sops_age__list_0__map_enc=-----BEGIN AGE ENCRYPTED FILE-----\n(省略)\n-----END AGE ENCRYPTED FILE-----\n
sops_lastmodified=2026-09-09T01:22:41Z
sops_mac=ENC[AES256_GCM,data:...,type:str]
sops_version=3.9.1
上の暗号文はすべてダミーです。 形を見せるために書いています。復号できません。
この画面から読み取ってほしいことが3つあります。
1. 左側(キー)は平文のまま残っている
DB_PASSWORD SESSION_SECRET PORT — 項目名は普通に読めます。 つまり「このアプリはDBパスワードとセッション鍵を使う」という構造は隠れていません。
これは弱点ではなく、設計です。 隠したいのは値であって、設定の形は隠すとレビューできなくなります。
2. 値は ENC[AES256_GCM,...] に置き換わっている
AES256_GCM は暗号化の方式名です。data が暗号文、iv と tag は復号に必要な付属情報です。中身を推測する手がかりはありません。
3. sops_ で始まる行が増えている
これがSOPSの仕掛けです。
| 行 | 何をしているか |
|---|---|
sops_age__list_0__map_recipient | 誰が復号できるか(公開鍵) |
sops_age__list_0__map_enc | データ鍵そのものを、その公開鍵で暗号化したもの |
sops_mac | 改ざん検知用の値。 1文字でも書き換えると復号が失敗する |
SOPS は「ファイルごとに使い捨てのデータ鍵を作って中身を暗号化し、そのデータ鍵を age の公開鍵で暗号化して、同じファイルの中に同梱する」という仕組みです。 だから、この1ファイルだけあれば(秘密鍵を持っている人は)復号できます。 サーバーへの問い合わせは要りません。
[スクリーンショット: 03_暗号化されたenv.png] cat .env.sops の画面を撮ってください。キーが読めて値が ENC[...] になっていることが分かる範囲で構いません。
4-7. 戻せることを確かめる
暗号化は、戻せて初めて成功です。
DB_HOST=127.0.0.1
DB_USER=appuser
DB_PASSWORD=dummy-db-password-1234
SESSION_SECRET=dummy-session-secret-abcdefg
PORT=3000
元に戻りました。
--decryptで秘密鍵を指定していません。 SOPS は~/.config/sops/age/keys.txtを自動で見に行きます。 これが 4-2 でその場所に作った理由です。別の場所に置いた人は
SOPS_AGE_KEY_FILE=/パス/keys.txt sops --decrypt ...のように渡します。
アプリに食わせるなら、こうします。
復号した
.envは必ず.gitignoreに入れてください。 これから設定します。
4-8. Git に入れる — 何を入れて、何を入れないか
node_modules/
.env
.env.migrate
!.env.sops
!.env.example
4行の意味です。
| 行 | 意味 |
|---|---|
.env | 平文。絶対に入れない |
.env.migrate | 同上 |
!.env.sops | ! は「除外の取り消し」。 暗号化済みは入れる |
!.env.example | 値をダミーにした見本。入れる |
確認してから commit します。
?? .env.sops
?? .sops.yaml
A .env.sops
A .sops.yaml
M .gitignore
git add .を打たないでください。.gitignoreを書く前に平文が混ざっていると、その1回で履歴に入ります。 ファイル名を明示してaddします。
最後に、平文が入っていないことをもう一度確かめてから commit します。
.env.sops
.gitignore
.sops.yaml
.env が出ていないことを目で見てから、次に進みます。
⑤ 差分が読めることを確かめる — Gitと相性が良い理由
ここが「なぜファイル全体を gpg で暗号化しないのか」の答えです。
値を1つ変えてみます。
nano が開き、復号された状態の中身が表示されます。 PORT を 3000 から 3100 に変えて保存し、閉じます。
これが SOPS の編集モードです。 復号 → 編集 → 再暗号化を、1コマンドでやります。 途中で平文がディスクに落ちますが、一時ファイルは終了時に消されます。
差分を見ます。
.env.sops | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
-PORT=ENC[AES256_GCM,data:MzAwMA==,iv:EEEE...,type:str]
+PORT=ENC[AES256_GCM,data:MzEwMA==,iv:FFFF...,type:str]
-sops_lastmodified=2026-09-09T01:22:41Z
-sops_mac=ENC[AES256_GCM,data:GGGG...,type:str]
+sops_lastmodified=2026-09-09T01:31:07Z
+sops_mac=ENC[AES256_GCM,data:HHHH...,type:str]
変わったのは3行だけです。
PORTの行(実際に変えた値)sops_lastmodifiedとsops_macの行(更新日時と、改ざん検知用の値。保存のたびに変わります)
DB_PASSWORD や SESSION_SECRET の行は、1文字も動いていません。
これが「Gitと相性が良い」の中身です。
| 差分がどう見えるか | |
|---|---|
| ファイル全体を暗号化 | 毎回、全部が変わります。 「何を変えたのか」がレビューで一切わからない |
| SOPS(値だけ) | 変えた項目の行(と、管理用の2行)だけが変わります。 「PORT を触ったんだな」が読める |
レビューできない変更は、レビューされません。 そしてレビューされない場所に、事故は溜まります。 SOPS の価値は暗号の強さではなく、「暗号化したまま人間が扱える形にした」ことです。
[スクリーンショット: 04_git差分.png] git diff .env.sops で、変えた1項目と sops_lastmodified・sops_mac だけが差分に出ている画面を撮ってください。
確かめ終わったら、戻しておきます。
⑥ 鍵をどこに置くのか — 鍵の鍵問題
ここは、ごまかさずに書きます。
④でやったことを、正直に言い直します。
秘密の値を10個から、秘密の鍵1本に減らしました。 ゼロにはしていません。
~/.config/sops/age/keys.txt は平文です。これを盗られたら、暗号化した意味は全部消えます。
これを「鍵の鍵問題」と言います。 鍵を守るために鍵が要り、その鍵を守るためにまた鍵が要る。どこかで必ず「生の秘密を置く場所」が1つ残ります。
この問題に「解決」はありません。 できるのは、守る対象を1つに絞って、そこだけ本気で守ることです。
10箇所を全部守るのは無理ですが、1箇所なら守れます。 それが3段目に上がる意味です。
実際にどう置くか
用途ごとに答えが違います。
| どこで復号するか | 鍵の置き場所 |
|---|---|
| 自分のVM・PC | ~/.config/sops/age/keys.txt に置いて chmod 600。Gitには絶対に入れない |
| GitHub Actions | 秘密鍵をまるごと1つの Secret に入れる。 ワークフローから SOPS_AGE_KEY として渡す |
| 本番サーバー | 配置時に1回だけ置く。 Ansible なら Ansible Vault、手作業なら scp して chmod 600 |
| バックアップ | 紙に印刷して物理的にしまうか、パスワード管理ソフトに入れる。 同じVMの中に置いても意味がありません |
GitHub Actions での渡し方は、こう書きます。
- name: 秘密情報を復号する
env:
SOPS_AGE_KEY: ${{ secrets.SOPS_AGE_KEY }}
run: |
sops --decrypt --input-type dotenv --output-type dotenv .env.sops > .env
CI/CDの回で「Secrets は置き場所が増えるほど漏れやすくなるから使わない」と書きました。 その方針とこれは矛盾しません。 Secrets に置くのは1つだけで、残りの10個は暗号化されて Git に載るからです。置き場所は増えるのではなく、減っています。
鍵をなくしたときのために
受信者は複数指定できます。 ノートPCとVMの2本の鍵で、同じファイルを開けるようにできます。
creation_rules:
- path_regex: \.env
age: >-
age1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx,
age1yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy
カンマ区切りで並べます。 追加したあとは
sops updatekeys .env.sopsで既存ファイルに反映します。新しい鍵を足しただけでは、過去のファイルは開けません。
そして、これも正直に書きます。
秘密鍵をなくしたら、暗号化した値は永久に戻りません。 ただし、それは致命傷ではありません。 ⑨で書くとおり、秘密の値は作り直せばいいからです。 困るのは「暗号化した文章」であって、パスワードではありません。
⑦ Kubernetes の場合 — GitOpsの回の宿題
GitOps の回で残した宿題を回収します。
あの回の詰まりどころは、これでした。
GitOps は「全部 Git に書く」と言う。でも Secret は Git に置けない。
そして、Kubernetes の Secret が base64 なだけで暗号化ではないことも見ました。
解き方は3つあります。SOPS を知った今なら、違いが読めます。
| 名前 | 何をするか | 鍵はどこに |
|---|---|---|
| SOPS | Gitに置く前に、値を暗号化しておく。 ArgoCD 側にプラグインを足して復号させる | クラスタに置いた age の秘密鍵 |
| Sealed Secrets | クラスタ内のコントローラが持つ鍵で暗号化する。kubeseal で暗号化した SealedSecret をGitに置き、クラスタ側が Secret に戻す | クラスタが自分で作って持つ |
| External Secrets Operator | Gitには「どこから取るか」だけ書く。 実物は AWS Secrets Manager や Vault から取ってくる | 外部の保管庫。 クラスタは接続情報だけ持つ |
選び方は、こう考えます。
| 状況 | 向くもの |
|---|---|
| クラスタが1つ。ファイルとして持ちたい | SOPS。この記事でやったものがそのまま使える |
| クラスタが1つ。Kubernetes に閉じたい | Sealed Secrets。ただしそのクラスタ専用になる(作り直すと復号できない) |
| クラウドの保管庫や Vault をすでに使っている | External Secrets。秘密の正が1箇所になる |
Sealed Secrets の落とし穴を1つだけ。 暗号化はそのクラスタの鍵で行われます。 minikube を
minikube deleteで消して作り直すと、Git に置いたSealedSecretは新しいクラスタでは復号できません。 鍵をバックアップするか、作り直しを前提にするかを、先に決めてください。
この記事では、どれも入れません。 名前と分担が分かっていれば、必要になったときに調べられます。分からないまま GitOps を本番に持ち込むことだけは避けてください。
⑧ Vault は何が違うのか — そして個人には過剰
ここまで「暗号化」の話をしてきました。Vault は、そこが本題ではありません。
Vault が本当に違うのは3点です。
| Vault にしかないこと | どういうことか |
|---|---|
| ① 動的に発行する | DBのパスワードを、使うときにその場で作ります。 「アプリ用のDBユーザー」を毎回新規に発行し、1時間後に自動で消します |
| ② 失効させられる | 配ったものを、後から無効にできます。 「漏れたかもしれない」と思った瞬間に、その1本だけ止められます |
| ③ 記録が残る | 誰が・いつ・どの秘密を取り出したかが監査ログに残ります。 ②の「何を止めるべきか」がここから分かります |
②の意味を、SOPS と比べます。
SOPS では「配った値を止める」ができません。 一度復号された値は、ただの文字列です。止めたければ、DB側でパスワードを変えるしかありません。 Vault では、Vault 側で「あの発行分を取り消す」と言えます。
そして③が、②の1歳の弟です。 記録が無いと、何を止めればいいかが分かりません。 セキュリティ点検の回で「見られた前提で全部差し替える」と書いたのは、記録が無いから全部差し替えるしかないという話でした。記録があれば、範囲を絞れます。
それでも個人には過剰
正直に書きます。
| Vault を建てると増える仕事 | 中身 |
|---|---|
| サーバーが1つ増える | 落ちるとアプリが秘密を取れずに起動しなくなります。 冗長化の話が付いてきます |
| アンシール(unseal) | 起動のたびに、鍵を分割して持っている人が集まって解錠します。 自動化するとまた「鍵の鍵問題」です |
| アプリの改造 | .env を読む代わりに、Vault に問い合わせるコードを書くことになります |
1人で1クラスタなら、Vault は「守るものより守る仕組みのほうが大きい」状態になります。 ③の監査ログは、取り出す人があなたしかいないなら、あなたの記録しか残りません。
触ってみたいだけなら、Docker で開発モードを5分だけ動かせます。(この節は飛ばして構いません)
-devモードは、メモリ上にしかデータを持たず、停止すると全部消えます。 本番では絶対に使いません。 トークンdummy-root-tokenもダミーです。
止めます。
ライセンスの話も1行だけ。 Vault は 2023年に BUSL というライセンスに変わりました。 個人の学習と利用には支障ありませんが、それを嫌って作られた OpenBao という分岐版があります。 中身はほぼ同じです。
⑨ 漏れたときの手順 — 作り直す以外にない
セキュリティ点検の回で書いたことの回収です。
秘密の値が一度でも外に出たときの正解は、たった1つ。作り直すことです。
この記事の言葉で言い直します。
暗号化は、漏れたあとには何もしてくれません。 平文の
.envを push した人も、keys.txtを漏らした人も、やることは同じです。
順番があります。上から順にやります。
1. 新しい値を作る
2. 使う側を新しい値に差し替える
ALTER USER 'appuser'@'localhost' IDENTIFIED BY 'ここに新しいパスワード';
FLUSH PRIVILEGES;
3. コピーがある場所を全部直す
①の棚卸しの表が、ここで効きます。
.env.sops(sopsの編集モードで)- Kubernetes の Secret
- GitHub の Secrets
docker-compose.yml
1箇所でも直し忘れると、アプリが
Access deniedで落ちます。 落ちるのは良いことです。 気づけるからです。気づかないまま古い値が生き残るほうが危険です。
4. 古い値を無効にする
トークンなら、発行元の画面で「取り消し(revoke)」を押します。 「新しいのを作った」と「古いのを止めた」は別の作業です。 止めるまでは、古いほうも使えます。
5. 履歴の掃除は、最後の任意作業
git filter-repo などで履歴から消せます。 ただし、
掃除は「これから見る人」への対策であって、「もう見た人」には効きません。 1〜4を飛ばして5だけやるのが、いちばんまずいやり方です。 消したことで安心してしまいます。
6. 記録を見る
⑧で書いた「監査ログ」が無い環境では、ここで何もできません。 できるのは DBのログイン記録や nginx のアクセスログを見ることくらいです(ログ集約の回)。「調べる手段が無い」と分かっていることが、いまは十分です。
つまずいたところ
Error: could not get file type で止まった
Error: could not get file type: unknown file type
.env.sops という拡張子を、SOPS が知らないためです。
--input-type dotenv --output-type dotenv を付けたら通りました。
拡張子で形式を判定する道具は、名前を変えた瞬間に動かなくなります。
.yamlや.jsonのままなら自動で判定されます。
値を1つ変えただけなのに、全行が差分になった
⑤をやる前に、こう打っていました。
git diff を見たら、5行全部が変わっていました。
原因は、--encrypt を打つたびに新しいデータ鍵が作られることです。 鍵が変われば、中身が同じでも暗号文は別物になります。
編集モードを使ったら、変えた行だけの差分になりました。
編集モードはデータ鍵を作り直しません。 「差分が読める」という SOPS の長所は、編集モードを使ったときだけ出ます。 これを知らずに使うと、SOPS を使っている意味の半分が消えます。
復号できるのに、別のVMでは復号できなかった
Error: Error getting data key: 0 successful groups required, got 0
鍵を配っていませんでした。 .env.sops は誰でもコピーできますが、開けるのは秘密鍵を持っている人だけです。
メッセージが不親切ですが、意味は「復号できる鍵が1つも見つからない」です。
ls ~/.config/sops/age/keys.txtが最初の確認です。
.gitignore に .env と書いたのに .env.sops も無視された
git status に .env.sops が出ませんでした。
.env という行は、「.env で始まるもの」ではなく「.env という名前」にしか効きませんが、私は .env* と書いていました。 これだと .env.sops も巻き込みます。
!.env.sops を後ろに足したら出るようになりました。
.env*
!.env.sops
!の行は、打ち消したい行より後ろに書かないと効きません。 順番が意味を持ちます。
秘密鍵を、暗号化したファイルと同じリポジトリに入れかけた
「鍵も一緒に管理したほうが分かりやすい」と思いました。
これをやると、暗号化の意味が完全に消えます。 金庫と、金庫の鍵を、同じ箱に入れて送るのと同じです。
手が滑らないように、.gitignore に先に書きました。
*.agekey
keys.txt
「やらないように気をつける」で防げるものは、いつか必ずやります。 機械で止まるようにしておきます。
後片づけ
この記事で入れたもの・作ったものを戻します。
① 暗号化をやめて元に戻したい場合
打つ場所: VM の中
.gitignore の !.env.sops の行も消します。
.envが復元できたことを確かめてからrmしてください。 順番を逆にすると戻せません。
② Git にコミットしたものを取り消したい場合
まだ push していないなら、直前のコミットを取り消せます。
--softは「コミットだけ取り消して、ファイルはそのまま」という意味です。--hardは書き換えたファイルも消えます。 ここでは使いません。
③ SOPS と age を消す
④ age の鍵を消すかどうか
.env.sopsをどこかに1つでも残しているなら、鍵を消さないでください。 消した瞬間に、そのファイルは二度と開きません。 全部復号し終わってから消します。
⑤ Vault を触った人
--rm を付けて起動しているので、stop でコンテナは消えます。
⑥ 一時ファイルを消す
まとめ
- 秘密情報の置き場は、他が全部できたあとに最後に残る問題。 だからGitOpsの回でもAnsibleの回でも先送りになった
- 対策の前に棚卸し。
findとgrep -lで.envを数え、git log --allで履歴に入っていないかを確かめる - 同じ値が3箇所にある状態が普通に起きる。VM・Compose・GitHub Secrets・Kubernetes の Secret
- 忘れられる置き場所は
~/.bash_historyと環境変数。/procから読めるので、環境変数は「見えなくする」道具ではない .envの問題は4つ。 平文 / 配るのが手作業 / 誰が見たか分からない / 変えるのが大変- 一番効くのは「変えるのが大変」。 大変だから変えず、変えないから古い値が生き残る
- 道具を選ぶ基準は「漏れにくいか」ではなく「変えるのが楽になるか」
.gitignoreに.envを書くのは①しか解いていない。 予防であって対策ではない- 置き場所には4段階。 直書き →
.env→ 暗号化してGit(SOPS) → 専用サーバー(Vault) - いきなり4段目に行かない。 個人開発は2〜3段目で足りる
- SOPS は値だけを暗号化する。 キー(項目名)は平文で残る。構造は隠さない
- だから
git diffが読める。 ファイル全体を暗号化すると、毎回全部が差分になってレビューできない - SOPS の仕組みは「使い捨てのデータ鍵で中身を暗号化し、その鍵を age の公開鍵で暗号化して同梱」
--input-type dotenvを書く。.env.sopsという名前は SOPS が知らない- 差分が読めるのは編集モード(
EDITOR=nano sops ファイル)を使ったときだけ。--encryptは毎回データ鍵を作り直す git add .を打たない。.gitignoreを書く前の1回で履歴に入る- 鍵の鍵問題は消えない。 秘密が10個から1個に減っただけ。ゼロにはならない
- 10箇所は守れないが、1箇所なら守れる。 それが3段目に上がる意味
- 秘密鍵のバックアップを、同じVMの中に置かない。 紙かパスワード管理ソフト
- 受信者は複数指定できる。 ただし足したあと
sops updatekeysを打たないと、過去のファイルは開かない - Kubernetes は3択。 SOPS(ファイルとして持つ)/ Sealed Secrets(クラスタの鍵)/ External Secrets(外部から取る)
- Sealed Secrets はそのクラスタ専用。
minikube deleteすると Git のファイルが開かなくなる - Vault の本題は暗号化ではない。 動的に発行する・失効させられる・記録が残るの3点
- 失効させられるのが SOPS との決定的な差。 一度復号された値は、ただの文字列で止められない
- それでも個人には過剰。 サーバーが増え、アンシールが要り、アプリの改造が要る
- 漏れたときは作り直す。 暗号化は漏れたあとには何もしてくれない
- 順番は「作る → 差し替える → 全部のコピーを直す → 古いのを止める」。 履歴の掃除は最後の任意作業
- 「新しいのを作った」と「古いのを止めた」は別の作業
参考リンク
- roadmap.sh — DevOps
- SOPS 公式サイト
- SOPS 公式ドキュメント
- SOPS リポジトリ(getsops/sops)
- SOPS のリリース一覧
- age リポジトリ(FiloSottile/age)
- age のリリース一覧
- Sealed Secrets(bitnami-labs)
- External Secrets Operator 公式
- Argo CD — Secret Management
- Kubernetes — Secret(公式・日本語)
- HashiCorp Vault 公式ドキュメント
- OpenBao(Vault の分岐版)
- Ansible Vault(公式)
- GitHub Actions で Secrets を使う(公式)
次に読む
この記事は 【第6段階】インフラとコンテナ の 17 / 25 本目です。
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- Vault
- Sealed Secrets
- SOPS
- age による暗号化
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント