セルフホスト型シークレットマネージャーの比較と選び方
OpenBaoやInfisicalなどのサービス型と、SOPSやsystemd credentials等のファイル型を比較。1台のVPS運用において、管理コストとセキュリティの観点から最適な選択肢を解説します。過剰な設計を避け、環境変数ファイルで十分なケースと、導入すべきタイミングを判断基準とともに紹介します。
パスワードマネージャーではできない、セルフホスト型シークレットマネージャーの役割
セルフホスト型シークレットマネージャーは、認証情報をプロセスに渡します。パスワードマネージャーは、認証情報を人に渡します。その他の違いは、すべてこの違いから生じます。パスワードマネージャーは、その場にいて操作している人がロックを解除します。シークレットマネージャーは、誰も起きていない 03:00 に、アプリケーションへデータベースのパスワードを渡さなければなりません。
障害の形態も異なります。この違いは運用上重要です。ロックされたパスワードマネージャーは不便なだけです。マスターパスワードをもう一度入力すれば済みます。封印されたシークレットマネージャーは停止障害になります。封印中に再起動したすべてのサービスは、認証情報なしで起動し、そのまま停止します。自分用のパスワードマネージャーとして Vaultwarden を運用することで、人に関する問題は適切に解決できます。しかし、マシンに関する問題は解決できません。そもそも、そのために作られたものではありません。これと併用する場合、強化すべき対象は、クライアントがすでに暗号化している vault の内容ではなく、管理者トークンとバックアップファイルです。Vaultwarden のセキュリティ強化で、この両方を扱えます。
1 台のサーバーで現実的な選択肢は、2 つのグループに分かれます。OpenBao と Infisical はサービスです。API、データベース、TLS (transport layer security)、ログイン処理、そして稼働状態を維持するプロセスが必要になります。SOPS と age、systemd credentials、Docker secrets はファイルです。保存時は暗号化され、すでに稼働している何かが復号します。追加で監視するものはありません。
先に率直な結論を述べます。1 台のサーバーを 1 人か 2 人で使う場合、通常はファイルベースの選択肢が適切です。適切に unseal されず、ローテーションも行われない OpenBao は、mode 600 の env ファイルより悪い選択です。可動部分と、誤った方法で取得することになるバックアップが増える一方で、手作業で実施していなかったローテーション機能は得られないためです。
mode 600 の環境変数ファイルで十分ですか?
多くの場合は十分です。防ぐ脅威は、同じサーバー上の別ユーザーがデータベースのパスワードを読み取ることです。Unix のファイル権限でこれを防げます。ネットワークが起動する前にも機能します。
sudo install -d -m 750 -o root -g myapp /etc/myapp
sudo install -m 640 -o root -g myapp /dev/null /etc/myapp/env
sudoedit /etc/myapp/env両方の立場から確認します。
sudo -u myapp cat /etc/myapp/env
sudo -u nobody cat /etc/myapp/env1 つ目のコマンドはファイルを表示します。2 つ目のコマンドは cat: /etc/myapp/env: Permission denied を表示します。nobody は myapp グループに属しておらず、ファイルにも他ユーザー向けの権限がないためです。これがセキュリティモデルのすべてです。実際に有効な対策です。
問題は、その後に発生する情報漏えいです。EnvironmentFile= を指定した systemd unit は、これらの値をプロセス環境にコピーします。プロセス環境は読み取り可能です。
[Service]
User=myapp
EnvironmentFile=/etc/myapp/env
ExecStart=/usr/local/bin/myappsudo cat /proc/$(pgrep -n myapp)/environ | tr '\0' '\n'/proc/<pid>/environ は root とプロセスの実行ユーザーが読み取れるため、このコマンドは Secret を平文で表示します。クラッシュレポーターが環境変数をレポートに添付する場合も、同じ情報を取得できます。同じアカウントで実行されるツールも同様です。そのため、AI エージェントから Secret を除外することは、まず環境変数から Secret を除外することから始まります。ファイルを 権限を最小限にした専用サービスユーザーと組み合わせ、「プロセスの実行ユーザー」が root にならないようにします。
age を使用した SOPS: Git にコミットできる暗号化済み Secret
SOPS (secrets operations) は、YAML または JSON ファイル内の値を暗号化し、キーは平文のまま残します。age は、小規模な暗号化ツールです。1 つの鍵ペアを使用し、鍵サーバーは必要ありません。両者を組み合わせると、コードと一緒に secrets.enc.yaml をコミットできます。また、git diff により、読み手に変更後の値を知らせずに、どの設定が変更されたかを確認できます。ただし SOPS が保護するのは暗号化したファイルだけで、Claude Code でパスワードを含むコマンドを「はい、今後は聞かないでください」で許可すると、そのコマンドが .claude/settings.local.json に平文で残り、コードと一緒にコミットされることもあるため、このファイルに残った秘密情報の点検と対処も確認してください。
age は Ubuntu 24.04 にパッケージとして含まれています。SOPS は含まれていないため、リリースページから .deb を取得します。2026 年 10 月時点の最新バージョンは 3.13.3 でした。
sudo apt update && sudo apt install -y age
curl -LO https://github.com/getsops/sops/releases/download/v3.13.3/sops_3.13.3_amd64.deb
sudo apt install -y ./sops_3.13.3_amd64.deb
sops --version鍵ペアを生成します。age-keygen は秘密鍵をファイルに書き込み、公開鍵を表示します。そのため、Public key: age1... で始まる行が表示されます。
mkdir -p ~/.config/sops/age
age-keygen -o ~/.config/sops/age/keys.txt
chmod 600 ~/.config/sops/age/keys.txt
age-keygen -y ~/.config/sops/age/keys.txtリポジトリのルートにある .sops.yaml に公開鍵を記載します。これにより、コマンドラインで recipient を指定する必要がなくなります。
creation_rules:
- age: age1s3cqcks5genc6ru8chl0hkkd04zmxvczsvdxq99ekffe4gmvjpzsedk23csops encrypt secrets.yaml > secrets.enc.yaml
sops decrypt secrets.enc.yamlpath_regex のないルールはすべてに一致します。最初はこの設定で問題ありません。後から追加する場合は、sops に渡すファイルに一致するように記述します。ルールは出力をリダイレクトする先のファイルではなく、入力パスに対して評価されるためです。
実行時は、値を 1 つのプロセスだけに渡します。
sops exec-env secrets.enc.yaml './myapp'sops exec-env はメモリ内で復号し、子プロセスの環境変数に値を設定します。そのため、平文がディスクに書き込まれることはありません。ただし、前のセクションで説明した環境変数に関する注意点は、その子プロセスにも当てはまります。
ここでは 2 つの問題が起きやすくなります。systemd で Failed to get the data key required to decrypt the SOPS file というエラーが出る場合、ほとんどの場合は SOPS が誤ったホームディレクトリを参照しています。unit はユーザーの HOME を引き継がないためです。unit 内で Environment=SOPS_AGE_KEY_FILE=/etc/sops/age.txt を使用してパスを明示的に設定します。もう 1 つは、.sops.yaml を編集しても、既存のファイルは再暗号化されないことです。同僚の公開鍵を追加しても、新しいファイルにしか適用されないため、既存の各ファイルに対して sops updatekeys secrets.enc.yaml を実行します。設定がすでに Ansible 経由で管理されている場合は、同じ値を Ansible Vault で暗号化することで、別のツールを追加せずに同じ構成を実現できます。
systemd credentials: 環境に渡らないシークレット
Ubuntu 24.04 には systemd 255 が含まれているため、インストールは不要です。systemd-creds はホスト上でシークレットを暗号化し、systemd はそのシークレットを、対象サービスだけが読み取れるプライベートディレクトリに復号します。
sudo systemd-creds setup
sudo install -d -m 700 /etc/myapp
echo -n 'hunter2' | sudo systemd-creds encrypt --name=db_password - /etc/myapp/db_password.cred[Service]
User=myapp
LoadCredentialEncrypted=db_password:/etc/myapp/db_password.cred
ExecStart=/usr/local/bin/myappサービスは、$CREDENTIALS_DIRECTORY が示すディレクトリ内の db_password というファイルから値を読み取ります。値は環境変数に含まれないため、/proc/<pid>/environ を実行しても有用な情報は表示されません。平文が root ファイルシステムに書き込まれることもありません。
unit で使用する前に、ファイルを復号できることを確認します。
sudo systemd-creds decrypt /etc/myapp/db_password.cred -どの鍵で暗号化したかを把握してください。バックアップが役立つかどうかは、それによって決まります。デフォルトの --with-key=auto は、TPM2(trusted platform module version 2)チップが存在し、コンテナ内で実行されていない場合は TPM2 を使用します。また、/var/lib/systemd/ が永続メディア上にある場合はホスト鍵を使用します。両方の条件を満たすマシンでは、credential は両方に紐付けられ、復号には両方が必要です。ほとんどの VPS インスタンスには TPM2 がありません。
systemd-analyze has-tpm2no は、ホスト鍵だけが使用されたことを示します。この鍵は /var/lib/systemd/credential.secret に保存され、root だけが読み取れます。そのファイルがない状態で、新しい VPS に db_password.cred を復元しても、二度と復号できません。同じバックアップに credential.secret を含めるか、引き続きアクセスできる場所に平文を保存してください。yes と表示された場合、その credential はマシンのチップにも紐付いています。そのため、credential.secret があっても別の場所では復号できず、平文のコピーだけが役立ちます。
Docker secrets: /run/secrets 配下のファイル
Compose はホスト上のファイルを読み込み、/run/secrets/<name> にコンテナへマウントします。
services:
app:
image: myapp:latest
environment:
DB_PASSWORD_FILE: /run/secrets/db_password
secrets:
- db_password
secrets:
db_password:
file: ./db_password.txtdocker compose exec app cat /run/secrets/db_password
docker compose exec app env | grep -i password1つ目のコマンドは Secret の内容を出力します。2つ目は DB_PASSWORD_FILE=/run/secrets/db_password だけを出力します。ここが重要です。値はコンテナの環境変数に入らないため、docker inspect の出力にも現れません。多くの公式イメージはこの形式を前提としており、Postgres イメージも POSTGRES_PASSWORD_FILE をこの方法で読み取ります。
この仕組みの意味を明確にしておきます。Swarm mode の外部では、どの層でも暗号化されません。./db_password.txt はホスト上の平文ファイルであり、保護手段はファイルのモードと所有者だけです。これらは自分で設定してください。Compose は、警告なしに誰でも読み取れるファイルをマウントするためです。通常の env_file の簡易的な方法との幅広いトレードオフについては、Compose の env ファイルと Secret に関するガイドを参照してください。
OpenBao と Vault の実際の運用コスト
OpenBao は、HashiCorp が 2023 年に Vault のライセンスを Business Source License に変更した後に始まった、Linux Foundation による HashiCorp Vault のフォークです。OpenBao は MPL 2.0(Mozilla Public License)のままです。2026 年 10 月 26 日に公開された Release 2.7.2 が、2026 年 10 月 27 日に確認した時点での最新リリースでした。フォーク後もコマンド体系が維持されているため、以下のほとんどは Vault にも当てはまります。
docker pull docker.io/openbao/openbaoDebian と Ubuntu の .deb パッケージは各リリースに GitHub で添付されています。apt でインストールを管理したい場合に利用できます。サーバーには、リスナーとストレージバックエンドを指定した設定ファイルが必要です。
listener "tcp" {
address = "127.0.0.1:8200"
tls_cert_file = "/path/to/full-chain.pem"
tls_key_file = "/path/to/private-key.pem"
}
storage "raft" {
path = "/path/to/raft/data"
node_id = "raft_node_1"
}次に、1 回起動します。
bao operator initデフォルトでは、root key が 5 個の share に分割され、そのうち 3 個を指定しないと unseal できません。これが -key-shares フラグと -key-threshold フラグです。share と初期 root token が表示されます。この時点で両方を記録してください。share がなければ、ストレージを復号できません。
ここからが、多くの比較記事で省略されている部分です。再起動したサーバーは sealed 状態です。 OpenBao は root key をメモリにだけ保持するため、再起動後は、誰かが必要数の share を指定するまで自身のストレージを復号できません。そのため、カーネル更新や out of memory による kill が発生すると、サーバーは sealed 状態になり、アプリケーションはログインできなくなります。
1 人で使用する VPS では、Shamir split による保護効果はありません。5 個の share がすべて、同じ人が所有する同じ password manager に保存されるためです。Auto unseal を使うと、key は信頼するデバイスまたはサービスに移されます。大規模な cloud では managed key service が通常ですが、VPS では多くの場合、保護対象のデータと同じディスク上に key file を置くことになります。これはセキュリティを実際に低下させる代わりに、再起動後もサーバーが自動的に復旧する構成です。トレードオフを理解したうえで選択し、どちらを採用したか記録してください。
Infisical: UI、データベース、そして手元で保持するマスターキー
Infisical は、Web インターフェース、プロジェクト、環境、ユーザーごとのアクセス制御を備えた Secret プラットフォームです。Compose でセルフホストする手順は簡潔です。
curl -o docker-compose.prod.yml https://raw.githubusercontent.com/Infisical/infisical/main/docker-compose.prod.yml
curl -o .env https://raw.githubusercontent.com/Infisical/infisical/main/.env.example
docker compose -f docker-compose.prod.yml up -d最後のコマンドを実行する前に .env を編集します。2 つの値は自分で設定し、そのうち 1 つは以後手動で変更してはいけません。
openssl rand -hex 16
openssl rand -base64 321 つ目は ENCRYPTION_KEY です。16 byte の 16 進文字列です。PostgreSQL 内で Secret を暗号化するキーであるため、これを失うと完全なデータベースバックアップも暗号文の集合になります。稼働中のインスタンスで自分で用意した値に置き換えると、既存の Secret を復号できなくなります。ローテーションする場合は、Infisical の公式手順に従ってください。サーバーコンソールが新しいキーを生成し、すべてのインスタンスが切り替わって削除するまで、古いキーは有効なままです。削除しなければ、Infisical はデフォルトで retention period の 7 days が経過した後、最初に実行される weekly cleanup で古いキーを自動的に削除します。そのため、まだ必要であれば、その前に古いキーを保存してください。2 つ目は AUTH_SECRET です。セッションに使用する 32 byte の base64 文字列です。SITE_URL には、protocol を含む、実際にアクセスする絶対 URL を指定する必要があります。そうしないとログインリダイレクトが機能しません。
実際に必要なのが人のための機能である場合、Infisical は OpenBao より適しています。つまり、小規模チーム向けの Web インターフェースと環境間の分離が必要であり、自動的に期限切れになるデータベース認証情報が必要なわけではない場合です。その代わり、PostgreSQL、Redis、TLS 証明書が必要になり、これらも自分でパッチ適用とバックアップを行うことになります。
秘密管理サービスが停止中にアプリケーションを再起動するとどうなるか
この問題によって、秘密管理サービスを 1 台のサーバー上に置くべきかどうかが決まります。ファイルはネットワークの起動前でも読み取れます。サービスは読み取れません。
サーバーを再起動すると、アプリケーションと OpenBao は同時に起動します。アプリケーションがデータベースのパスワードを要求した時点で OpenBao がまだ sealed だと、要求は失敗します。unit に Restart= が設定されている場合、systemd は人が unseal shares を入力するまで、または StartLimitIntervalSec= と StartLimitBurst= で設定された起動レート制限に達するまで、アプリケーションを再起動します。レート制限に達すると、アプリケーションは failed のままになります。Restart= がなく、そのデフォルト値が no の場合、アプリケーションは単に停止したままです。何かが壊れているわけではありません。ただ、何も起動していない状態になります。
この問題には、正直な対処方法が 2 つあります。unit の起動順序を設定し、アプリケーションに再試行させます。After= で秘密管理サービスを指定し、さらに Restart=on-failure と、API に過剰な要求を送らないために十分な長さの RestartSec= を設定します。また、誰かが unseal できる前に再試行を打ち切らないよう、起動レート制限も設定します。もう 1 つは、起動時ではなくデプロイ時に取得する方法です。秘密情報を mode 600 のファイルまたは systemd credential に展開し、実行中のシステムが API ではなくファイルに依存するようにします。
トークンの有効期限切れも、時間の進み方が遅いだけで同じ問題です。OpenBao のトークンと lease には time to live が設定されているため、更新しない長時間稼働プロセスは、デプロイとは無関係な時点でアクセス権を失います。その日に何も変更していないため、この障害は特に分かりにくくなります。
ストア自体のバックアップ
ここで扱う各方式には鍵があり、その鍵がないバックアップには価値がありません。自分の鍵がどこにあるかを書き留めてください。
env ファイルを使う場合、ファイル自体が Secret なので、バックアップを暗号化する必要があります。SOPS では、暗号化ファイルは公開されている場所に保存しても問題ありません。失ってはならないのは、~/.config/sops/age/keys.txt にある age の秘密鍵です。systemd credentials では、.cred ファイルと一緒に /var/lib/systemd/credential.secret をバックアップしてください。Infisical では PostgreSQL のダンプを取得し、ENCRYPTION_KEY をダンプとは別の場所に保存してください。ローテーション後は、ローテーション前に取得したダンプとともに古い鍵を保管してください。そのダンプの復元には古い鍵が必要です。
raft ストレージを使用する OpenBao では、専用のスナップショットを作成します。
bao operator raft snapshot save backup.snap
bao operator raft snapshot restore backup.snapスナップショットには暗号化されたストレージが含まれます。そのため、新しいサーバーに復元する場合でも、bao operator init の unseal share が必要です。スナップショットをオブジェクトストレージへコピーする夜間ジョブを実行していても、share をどこにも保存していなければ、それは何もバックアップしていないのと同じです。依存する前に、使い捨ての VPS で復元をテストしてください。
監査ログ: どのユーザーがどの Secret を読み取ったか
ファイルだけでは監査証跡を確認できません。mode と所有者からは、その Secret を読み取れたユーザーは分かります。しかし、実際に読み取ったユーザーまでは分かりません。パスを auditd で監視する方法が最も近い代替手段ですが、報告できるのはファイルが開かれたことだけで、どの値が使用されたかは分かりません。
OpenBao は、明示的に有効化した監査デバイスにすべてのリクエストを記録します。2.3.2 以降、bao audit enable が実行する API 経由での監査デバイス作成は、サーバー設定で unsafe_allow_api_audit_creation = true が設定されている場合にのみ機能します。このオプションはデフォルトで無効です。代わりに、listener の隣にあるサーバー設定でデバイスを宣言します。OpenBao は再起動時、または SIGHUP でデバイスを有効化します。
audit "file" "local" {
description = "Local audit log"
options {
file_path = "/var/log/openbao_audit.log"
}
}このログの変更により、サーバーの運用方法が変わる点が 2 つあります。リクエストとレスポンスに含まれる多くの文字列は、salt と HMAC-SHA256 でハッシュ化されます。そのため、ログ自体に平文を残さず、既知の値とログを照合できます。整数とブール値はそのまま平文で記録されるため、数値の Secret はこのハッシュ化による保護を受けません。
次に、運用上の落とし穴があります。有効な監査デバイスが 1 つもリクエストを記録できない場合、OpenBao はリクエストに応答しません。ブロッキング状態で失敗したデバイスがあると、誰かが修正するまでリクエストがハングします。/var/log のディスク容量が枯渇すると、設計上、Secret API が停止します。監査ログ専用の領域と logrotate のルールは、最初の障害が発生してからではなく、初日に用意してください。
どの self-hosted secrets manager を運用すべきか
マシンの台数と利用者の人数を数えてから選びます。
- マシンが 1 台で利用者が 1 人の場合: root が所有する env ファイルを使います。サービスのグループだけが読み取れるようにします(前述の mode 640)。または、systemd 自身が
EnvironmentFile=を通じてサービス用に読み取る mode 600 のファイルを使います。値をプロセス環境から切り離したい場合は、systemd credentials を追加します。 - マシンが 1 台で利用者が 2 人から 5 人、設定がすでに git で管理されている場合: SOPS と age を使います。各利用者に key pair を割り当て、
.sops.yamlに復号を許可するすべての public key を記載します。 - 複数のマシンで 1 つの設定リポジトリを使用し、有効期限付きの credentials が不要な場合: 引き続き SOPS と age を使います。各ホストに 1 つの recipient key を割り当てます。これにより、ホストの key が盗まれても、そのホストのファイルだけを復号できます。
- 複数のマシンと複数のチームがあり、有効期間付きの database credentials と、実際に確認される audit trail が必要な場合: OpenBao を使います。unseal と restore の訓練に、operator の作業時間を月 1 時間確保します。
4 つすべてに共通する原則は同じです。口頭で説明できる要件を満たす、最小限のものを運用します。停止している secrets manager は、空の secrets manager と区別できないためです。
FAQ
自己ホスト型の Secret 管理システムは、単一の VPS で使う価値がありますか?
通常はありません。OpenBao や Infisical のようなサービスを指す場合は特にそうです。1 台のマシンを 1 人または 2 人で使う場合、mode 600 の環境変数ファイルや systemd の暗号化 credential で、別のローカルユーザーに対して同じ保護を実現できます。unseal の手順や、追加サービスへのパッチ適用も不要です。複数のマシンと複数のユーザーがある場合、または誰も手動でローテーションしなくても期限切れになる credential が本当に必要な場合に、Secret サービスの導入効果が現れます。
password manager と Secret manager の違いは何ですか?
password manager は、人が入力する credential を保存し、人がその場にいる間にロックを解除します。一方、Secret manager はプロセスに credential を渡すため、誰も監視していない 03:00 でも動作する必要があります。この点が両者を分けます。ロックされた password manager では master password の再入力が必要ですが、sealed 状態の Secret manager では、再起動したすべてのサービスが停止します。
再起動後に OpenBao が sealed になると、アプリには何が起こりますか?
アプリは Secret を取得できないため、起動に失敗します。unit に Restart= が設定されている場合、誰かが unseal threshold を満たすまで systemd が再試行します。デフォルトでは 5 個の share のうち 3 個が必要です。unit の起動レート制限により、再試行が停止する場合もあります。OpenBao は root key をメモリ内にのみ保持するため、再起動するたびに再び sealed 状態になります。auto unseal を有効にすると、この問題を回避できます。ただし単一の VPS では、unseal key がデータと同じディスクに保存されることになります。別の方法として、deploy 時に Secret をファイルへ出力し、起動が API に依存しないようにします。
SOPS の暗号化ファイルを公開リポジトリに commit できますか?
値は暗号化されているため、age private key を持たないユーザーからは保護されます。ただし、key 自体は暗号化されません。閲覧者は、STRIPE_SECRET_KEY と SMTP_PASSWORD を保持していることや、それぞれが変更される頻度を確認できます。このメタデータは、ほとんどのプロジェクトでは許容できますが、一部のプロジェクトでは許容できません。age private key をリポジトリの外で管理し、recipient を追加または削除するたびに、既存のすべてのファイルに対して sops updatekeys を実行してください。