.envは暗号化してGitに置ける — SOPSとage

SOPSとage。鍵と施錠された設定書類、履歴を示す枝分かれ線。

‘.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点だということ。そして個人には過剰だということ
  • 漏れたときにやることは、履歴の掃除ではなく作り直しだということ(セキュリティ点検の回の回収)

この記事でやること

  1. コマンドで棚卸しする。 VMの中の .env を全部見つけ、Gitの履歴に入っていないかを確かめる
  2. 段階の表を作って、いま自分がどこにいるかを決める
  3. SOPS と age を入れて、.env を暗号化する。 暗号化後のファイルを開いて、キーは読めて値だけ暗号化されていることを目で見る
  4. 値を1つ変えて再暗号化し、git diff が1行だけ変わることを確かめる
  5. 鍵の置き場所を決めて、バックアップする
  6. 後片づけして、元の状態に戻す

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
平文(へいぶん)暗号化されていない、そのまま読める状態。.env は平文
公開鍵暗号鍵を2本1組で作る方式。公開鍵で暗号化し、秘密鍵で復号する。公開鍵は配ってよい
age(エイジ)公開鍵暗号をとても小さい機能に絞った道具。鍵が1行の文字列になる
SOPS(ソップス)設定ファイルの値だけを暗号化する道具。キー(項目名)は平文のまま残す
受信者(recipient)その暗号文を復号できる相手。age では公開鍵で指定する。複数指定できる
データ鍵SOPS がファイルごとに毎回作る使い捨ての鍵。中身はこれで暗号化し、この鍵自体を age の公開鍵で暗号化して同じファイルに入れる
ローテーション秘密情報を作り直して差し替えること。漏れたときにやるのはこれ
動的シークレット使うときにその場で発行され、時間が来たら自動で失効する認証情報。Vault の中心機能
監査ログ誰が・いつ・何を取り出したかの記録

① まず棚卸しする — いま秘密がどこにあるか

対策の前に現状です。 順番を逆にすると、塞いだつもりの穴の隣が開いたままになります。

打つ場所: VM の中(Ubuntu)

1. .env 系のファイルを全部見つける

bash
$ find "$HOME" -maxdepth 4 \( -name '.env' -o -name '.env.*' -o -name '*.pem' -o -name 'id_*' -o -name '*.key' \) -not -path '*/node_modules/*' 2>/dev/null

出力の例です(中身は環境によって違います)。

/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 でなくても、秘密は入ります。

bash
$ grep -rIlE '(PASSWORD|SECRET|TOKEN|API_KEY)=' "$HOME" --exclude-dir=node_modules --exclude-dir=.git 2>/dev/null | head -30
/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 したものは、消しても履歴に残ります。

bash
$ cd ~/server
$ git ls-files | grep -iE '\.env|\.pem|id_'

何も出なければ、いまは追跡されていません。 次に過去を見ます。

bash
$ git log --all --oneline -- .env .env.migrate
(何も出ない = 一度も入っていない)

リポジトリが複数あるなら、まとめて回します。

bash
$ find "$HOME" -maxdepth 3 -type d -name .git -exec sh -c 'echo "--- $1"; git -C "${1%/.git}" log --all --oneline -- .env .env.* 2>/dev/null | head -5' _ {} \;
--- /home/ubuntu/server/.git
--- /home/ubuntu/k8s-manifests/.git

リポジトリ名だけが並んで、その下に行が出なければ合格です。

ここで行が出た人は、この記事を読み進める前に、その値を作り直してください。 手順は最後の「⑨ 漏れたときの手順」にあります。暗号化の勉強より、そちらが先です。

4. ファイル以外の置き場所も数える

忘れられがちな3つです。

bash
$ docker compose config 2>/dev/null | grep -iE 'password|secret|token' | head
$ kubectl get secret -A 2>/dev/null
$ grep -icE 'password|secret|token' ~/.bash_history
      MYSQL_PASSWORD: ********
NAMESPACE   NAME                  TYPE     DATA   AGE
default     app-secret            Opaque   2      3d
7

3つ目に注目してください。 これは ~/.bash_history に、秘密らしき文字列を含む行が7行あるという意味です。

コマンドラインに打った秘密は、履歴ファイルに平文で残ります。 mysql -p'パスワード' のような打ち方をした人は、そのファイルが4枚目の置き場所になっています。

中身を確認するときは、画面共有していないことを確かめてからにしてください。

同じ理由で、環境変数もこう読めます。

bash
$ tr '\0' '\n' < /proc/self/environ | head -5
SHELL=/bin/bash
PWD=/home/ubuntu
LANG=C.UTF-8
HOME=/home/ubuntu
TERM=xterm-256color

/proc/<番号>/environ は、そのプロセスの環境変数です。自分のプロセスと、root なら他人のプロセスも読めます。 「環境変数にすれば安全」ではありません。 同じマシンに入れる人には見えます。

棚卸しの結果を、1枚の表にする

私の場合はこうなりました。あなたも同じ形で書き出してください。

どこに何が平文か配り方
~/server/.envDBパスワード、セッション署名鍵平文手でコピー
~/server/.env.migrate管理用DBユーザーのパスワード平文手でコピー
docker-compose.ymlMySQL の 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 を読まず、環境変数だけで渡す」というやり方です。

bash
$ DB_PASSWORD='ダミーの値' node app.js

これはファイルを1枚減らします。 ただし①でやったとおり、環境変数は /proc から読めますし、コマンドラインに書けば履歴に残ります。

環境変数は「ファイルに残さない」ための道具であって、「見えなくする」ための道具ではありません。

アプリに渡す最終形としては正しいのですが、それだけでは②③④が解けません。 だから次に行きます。


④ SOPS と age で .env を暗号化する

ここがこの記事の中心です。

やることを先に1行で言います。

.env を、値だけ暗号化した .env.sops に変換して、そちらを Git に入れる。

「値だけ」がポイントです。 DB_PASSWORD というキー(項目名)は平文のまま残り、右辺だけが暗号文になります。

なぜそれが嬉しいのかは⑤で確かめます。 まず動かします。

4-1. age を入れる

打つ場所: VM の中(Ubuntu)

まず、そもそも apt に有るかを確かめます。

bash
$ apt-cache policy age
age:
  インストールされていません: (なし)
  候補: 1.1.1-1
  バージョンテーブル:
     1.1.1-1 500
        500 http://jp.archive.ubuntu.com/ubuntu noble/universe amd64 Packages

「候補」に数字が出れば有ります。 入れます。

bash
$ sudo apt update
$ sudo apt install -y age
$ age --version
v1.1.1

「候補: (なし)」だった人は、age のリリース一覧から linux-amd64 の .tar.gz を落として、中の age と age-keygen を /usr/local/bin に置いてください。ファイル名はバージョンで変わるので、ページで実物を見てから打ちます。 これはapt の回で書いた「apt に無いものは自分で置く」の実例です。

4-2. 鍵を1組つくる

bash
$ mkdir -p ~/.config/sops/age
$ age-keygen -o ~/.config/sops/age/keys.txt
$ chmod 600 ~/.config/sops/age/keys.txt
Public key: age1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

上の age1xxx... はダミーです。 あなたの画面には、別の実在する文字列が出ます。この記事の文字列をコピーしても動きません。

ファイルの中を見ます。

bash
$ cat ~/.config/sops/age/keys.txt
# 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 を失うと、暗号化したファイルは二度と戻りません。 バックアップの話は⑥でやります。先に読みたい人は⑥へ飛んでください。

公開鍵だけを取り出しておきます。あとで何度も使います。

bash
$ grep 'public key' ~/.config/sops/age/keys.txt

[スクリーンショット: 02_age鍵作成.png] age-keygen を実行して Public key: が表示された画面を撮ってください。cat keys.txt の画面は撮らないでください。秘密鍵が写ります。

4-3. SOPS を入れる

SOPS は apt には有りません。 GitHub のリリースから直接置きます。

bash
$ cd /tmp
$ curl -LO https://github.com/getsops/sops/releases/download/v3.9.1/sops-v3.9.1.linux.amd64
$ sudo install -m 0755 sops-v3.9.1.linux.amd64 /usr/local/bin/sops
$ sops --version
sops 3.9.1 (latest)

バージョンの数字は変わります。 リリース一覧で最新を見て、linux.amd64 と付いているファイル名に読み替えてください。.deb が置いてある版もあります。

install -m 0755 は、cp + chmod を1回でやるコマンドです。実行権限を付け忘れる事故が減ります(権限の回)。

--version が出なかったら、先へ進まないでください。 ここで止まっているほうが、あとで悩むより早いです。

4-4. どの鍵で暗号化するかを設定ファイルに書く

毎回コマンドに公開鍵を打つのは、間違いのもとです。 リポジトリの一番上に .sops.yaml を置きます。

bash
$ cd ~/server
$ nano .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 を先に確認します。

bash
$ cat ~/server/.env
DB_HOST=127.0.0.1
DB_USER=appuser
DB_PASSWORD=dummy-db-password-1234
SESSION_SECRET=dummy-session-secret-abcdefg
PORT=3000

上の値は全部ダミーです。 記事に出すために書いています。あなたの実物とは違います。

暗号化します。

bash
$ cd ~/server
$ sops --encrypt --input-type dotenv --output-type dotenv .env > .env.sops

何も表示されずにプロンプトが戻れば成功です。

なぜ --input-type dotenv を毎回書くのか。 SOPS は拡張子で形式を見分けます。 .env.sops という名前は SOPS にとって未知なので、「これは KEY=値 の形式だ」と明示しています。書かないと Error: could not get file type で止まります。

4-6. 中身を見る — キーは読めて、値だけ暗号化されている

ここがこの記事で一番見てほしい画面です。

bash
$ cat ~/server/.env.sops
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. 戻せることを確かめる

暗号化は、戻せて初めて成功です。

bash
$ sops --decrypt --input-type dotenv --output-type dotenv .env.sops
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 ... のように渡します。

アプリに食わせるなら、こうします。

bash
$ sops --decrypt --input-type dotenv --output-type dotenv .env.sops > .env
$ node --env-file=.env app.js

復号した .env は必ず .gitignore に入れてください。 これから設定します。

4-8. Git に入れる — 何を入れて、何を入れないか

bash
$ cd ~/server
$ nano .gitignore
node_modules/
.env
.env.migrate
!.env.sops
!.env.example

4行の意味です。

行意味
.env平文。絶対に入れない
.env.migrate同上
!.env.sops! は「除外の取り消し」。 暗号化済みは入れる
!.env.example値をダミーにした見本。入れる

確認してから commit します。

bash
$ git status --short
$ git add .env.sops .sops.yaml .gitignore
$ git status --short
?? .env.sops
?? .sops.yaml
A  .env.sops
A  .sops.yaml
M  .gitignore

git add . を打たないでください。 .gitignore を書く前に平文が混ざっていると、その1回で履歴に入ります。 ファイル名を明示して add します。

最後に、平文が入っていないことをもう一度確かめてから commit します。

bash
$ git diff --cached --name-only
.env.sops
.gitignore
.sops.yaml

.env が出ていないことを目で見てから、次に進みます。

bash
$ git commit -m "秘密情報をSOPSで暗号化してリポジトリに入れる"

⑤ 差分が読めることを確かめる — Gitと相性が良い理由

ここが「なぜファイル全体を gpg で暗号化しないのか」の答えです。

値を1つ変えてみます。

bash
$ cd ~/server
$ EDITOR=nano sops --input-type dotenv --output-type dotenv .env.sops

nano が開き、復号された状態の中身が表示されます。 PORT を 3000 から 3100 に変えて保存し、閉じます。

これが SOPS の編集モードです。 復号 → 編集 → 再暗号化を、1コマンドでやります。 途中で平文がディスクに落ちますが、一時ファイルは終了時に消されます。

差分を見ます。

bash
$ git diff --stat
$ git diff .env.sops
 .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 だけが差分に出ている画面を撮ってください。

確かめ終わったら、戻しておきます。

bash
$ git checkout -- .env.sops

⑥ 鍵をどこに置くのか — 鍵の鍵問題

ここは、ごまかさずに書きます。

④でやったことを、正直に言い直します。

秘密の値を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 を知った今なら、違いが読めます。

名前何をするか鍵はどこに
SOPSGitに置く前に、値を暗号化しておく。 ArgoCD 側にプラグインを足して復号させるクラスタに置いた age の秘密鍵
Sealed Secretsクラスタ内のコントローラが持つ鍵で暗号化する。kubeseal で暗号化した SealedSecret をGitに置き、クラスタ側が Secret に戻すクラスタが自分で作って持つ
External Secrets OperatorGitには「どこから取るか」だけ書く。 実物は 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分だけ動かせます。(この節は飛ばして構いません)

bash
$ docker run --rm -d --name vault-dev -p 8200:8200 \
    -e VAULT_DEV_ROOT_TOKEN_ID=dummy-root-token hashicorp/vault:1.17
$ docker exec -e VAULT_ADDR=http://127.0.0.1:8200 -e VAULT_TOKEN=dummy-root-token \
    vault-dev vault kv put secret/app db_password=dummy-value
$ docker exec -e VAULT_ADDR=http://127.0.0.1:8200 -e VAULT_TOKEN=dummy-root-token \
    vault-dev vault kv get secret/app

-dev モードは、メモリ上にしかデータを持たず、停止すると全部消えます。 本番では絶対に使いません。 トークン dummy-root-token もダミーです。

止めます。

bash
$ docker stop vault-dev

ライセンスの話も1行だけ。 Vault は 2023年に BUSL というライセンスに変わりました。 個人の学習と利用には支障ありませんが、それを嫌って作られた OpenBao という分岐版があります。 中身はほぼ同じです。


⑨ 漏れたときの手順 — 作り直す以外にない

セキュリティ点検の回で書いたことの回収です。

秘密の値が一度でも外に出たときの正解は、たった1つ。作り直すことです。

この記事の言葉で言い直します。

暗号化は、漏れたあとには何もしてくれません。 平文の .env を push した人も、keys.txt を漏らした人も、やることは同じです。

順番があります。上から順にやります。

1. 新しい値を作る

bash
$ openssl rand -base64 32

2. 使う側を新しい値に差し替える

bash
$ sudo mysql
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つ変えただけなのに、全行が差分になった

⑤をやる前に、こう打っていました。

bash
$ sops --decrypt --input-type dotenv --output-type dotenv .env.sops > .env
$ nano .env
$ sops --encrypt --input-type dotenv --output-type dotenv .env > .env.sops

git diff を見たら、5行全部が変わっていました。

原因は、--encrypt を打つたびに新しいデータ鍵が作られることです。 鍵が変われば、中身が同じでも暗号文は別物になります。

編集モードを使ったら、変えた行だけの差分になりました。

bash
$ EDITOR=nano sops --input-type dotenv --output-type dotenv .env.sops

編集モードはデータ鍵を作り直しません。 「差分が読める」という 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 の中

bash
$ cd ~/server
$ sops --decrypt --input-type dotenv --output-type dotenv .env.sops > .env
$ rm .env.sops .sops.yaml

.gitignore の !.env.sops の行も消します。

bash
$ nano ~/server/.gitignore

.env が復元できたことを確かめてから rm してください。 順番を逆にすると戻せません。

② Git にコミットしたものを取り消したい場合

まだ push していないなら、直前のコミットを取り消せます。

bash
$ cd ~/server
$ git reset --soft HEAD~1
$ git status --short

--soft は「コミットだけ取り消して、ファイルはそのまま」という意味です。--hard は書き換えたファイルも消えます。 ここでは使いません。

③ SOPS と age を消す

bash
$ sudo rm /usr/local/bin/sops
$ sudo apt remove -y age

④ age の鍵を消すかどうか

bash
$ ls -l ~/.config/sops/age/keys.txt

.env.sops をどこかに1つでも残しているなら、鍵を消さないでください。 消した瞬間に、そのファイルは二度と開きません。 全部復号し終わってから消します。

bash
$ rm ~/.config/sops/age/keys.txt

⑤ Vault を触った人

bash
$ docker stop vault-dev
$ docker rmi hashicorp/vault:1.17

--rm を付けて起動しているので、stop でコンテナは消えます。

⑥ 一時ファイルを消す

bash
$ rm -f /tmp/sops-v3.9.1.linux.amd64

まとめ

  • 秘密情報の置き場は、他が全部できたあとに最後に残る問題。 だから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 との決定的な差。 一度復号された値は、ただの文字列で止められない
  • それでも個人には過剰。 サーバーが増え、アンシールが要り、アプリの改造が要る
  • 漏れたときは作り直す。 暗号化は漏れたあとには何もしてくれない
  • 順番は「作る → 差し替える → 全部のコピーを直す → 古いのを止める」。 履歴の掃除は最後の任意作業
  • 「新しいのを作った」と「古いのを止めた」は別の作業

参考リンク


次に読む

この記事は 【第6段階】インフラとコンテナ の 17 / 25 本目です。

記事
← 前の記事同じ設定を3台に手でやらない — Ansible入門
→ 次の記事Webサーバーはnginxだけではない — ApacheとCaddy

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

DevOps›Secret Management
  • Vault
  • Sealed Secrets
  • SOPS
  • age による暗号化

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次