目次
- .envファイルとは?
- なぜAPIキーをソースコードに直接書いてはいけない?
- .envと環境変数は同じ?
- .envなら安全?
- 2026年10月、環境変数に保存したAI APIキーが悪用
- .gitignoreに入れれば大丈夫?
- 一度GitHubに上げたAPIキーは削除すれば安全?
- なぜキーのローテーションが先?
- Git履歴から完全に消すのは意外と大変
- GitHubにはSecret Scanningがある
- 本番環境でも.envを使っていい?
- Secret Managerは何が違う?
- 環境変数そのものにも漏洩リスクがある
- AIコーディングツールから.envが読まれることもある
- JavaScriptへAPIキーを入れてはいけない理由
- NEXT_PUBLICやVITE_にも注意
- 開発用と本番用のAPIキーを分ける
- チーム全員で同じAPIキーを共有しない
- APIキーには有効期限を付ける
- 利用料金を監視する
- APIキーが漏れたときの緊急対応
- DBパスワードが漏れた場合も同じ
- バックアップにも.envが入っていないか確認
- Web公開ディレクトリに.envを置かない
- 本番環境では「長期キーを置かない」という考え方もある
- 安全なAPIキー管理チェックリスト
- まとめ|.envは「安全装置」ではなく「分離する仕組み」
OpenAI、Anthropic、Google Cloud、AWS、StripeなどのAPIを使うとき、「APIキーはソースコードに直接書かず、.envファイルや環境変数に入れましょう」と案内されることがあります。
では、.envファイルに入れておけば安全なのでしょうか。
結論から言うと、ソースコードへの直書きよりは安全ですが、「.envに入れたから絶対に漏れない」というわけではありません。
Gitへの誤コミット、サーバー設定ミス、ログ出力、AIコーディングツール、依存パッケージ、CI/CD、クラウド基盤の侵害など、さまざまな経路から環境変数やAPIキーが漏洩する可能性があります。この記事では、.envと環境変数の違い、漏洩する原因、安全な保存方法、APIキーが漏れたときの対応まで2026年版として整理します。
.envファイルとは?
.envは、アプリケーションで使う設定値をソースコードとは別に保存するためのファイルです。
例えば、
DATABASE_URL=xxxx
SMTP_PASSWORD=xxxx
STRIPE_SECRET_KEY=xxxx
のように、キーと値の組み合わせで設定します。
アプリケーション側では、直接値を書くのではなく、環境変数として読み込みます。
のように参照します。
なぜAPIキーをソースコードに直接書いてはいけない?
例えば、次のようなコードを書いたとします。
このコードをGitHubへ公開すれば、APIキーもそのまま公開される可能性があります。
さらに、非公開リポジトリでも、
などで漏れる可能性があります。
そのため、APIキーをコード本体から分離するのが基本です。
.envと環境変数は同じ?
厳密には同じではありません。
.envは、アプリ起動時に環境変数へ読み込むために使われるケースが多いです。
つまり、
↓
環境変数として読み込み
↓
アプリから利用
という構造です。
.envなら安全?
安全性は上がりますが、それだけでは十分ではありません。
.envは秘密情報をコードから分離できますが、平文ファイルとして保存されている場合、そのファイルを読めるユーザーやプロセスからは内容を確認できます。
例えば、
といった場合は、.env自体が読み取られる可能性があります。
2026年10月、環境変数に保存したAI APIキーが悪用
2026年10月30日、クラウドアプリケーション基盤Northflankがセキュリティ侵害を公表しました。
同社は利用者に対し、プラットフォームへ保存していた環境変数が復号されたものとして扱い、APIキーや認証情報を無効化・ローテーションするよう警告しました。
その後、複数の利用者から、保存していたAI APIキーが不正利用されたという報告も確認されました。
クラウドサービスや実行基盤そのものが侵害された場合、その基盤が復号できるシークレットも影響を受ける可能性があります。
.gitignoreに入れれば大丈夫?
.envをGitHubへコミットしないために、通常は.gitignoreへ追加します。
これは非常に重要です。
ただし、.gitignoreには一つ大きな注意点があります。
一度でもAPIキーをコミットした場合は、「現在のファイルから削除した」だけでは不十分です。
一度GitHubに上げたAPIキーは削除すれば安全?
漏洩した可能性があるキーは、削除ではなく失効・ローテーションを優先します。
Gitの履歴には過去のコミットが残っています。
↓
「しまった」
↓
最新コードから削除
↓
安心
これは危険です。
正しくは、
という順番です。
なぜキーのローテーションが先?
GitHub公式も、パスワード・トークン・認証情報などが漏れた場合は、リポジトリ履歴の削除より先に、その秘密情報を失効・ローテーションすることを推奨しています。
理由は単純です。
からです。
Git履歴から完全に消すのは意外と大変
Git履歴を書き換えて削除する方法もありますが、GitHub公式は注意点を多く挙げています。
例えば、
などに情報が残っている可能性があります。
そのため「GitHubから消したから、漏洩していない」とは考えない方が安全です。
GitHubにはSecret Scanningがある
GitHubには、リポジトリ内に含まれるAPIキーやトークンなどを検出するSecret Scanning機能があります。
さらにPush Protectionを有効化すると、対応するシークレットがコードに含まれている場合、push時に検出してブロックできます。
人間の確認だけに頼らず、自動検出も組み合わせると安全性が上がります。
本番環境でも.envを使っていい?
小規模な環境では、適切に権限管理された.envを使う構成もあります。
ただし、本番環境や重要システムでは、より専用の仕組みを検討する価値があります。
などです。
Secret Managerは何が違う?
専用のシークレット管理サービスでは、単なるファイル保存より高度な管理ができます。
AWSも、本番環境の認証情報や秘密情報についてSecrets Managerなどを利用するベストプラクティスを案内しています。
環境変数そのものにも漏洩リスクがある
「ファイルではなくOSの環境変数なら絶対安全」とも限りません。
Google Cloudは、シークレットを環境変数として渡す場合についても注意を促しています。
理由として、
などを通じて環境変数が露出する可能性があるためです。
AIコーディングツールから.envが読まれることもある
Claude Code、Cursor、CodexなどのAIコーディングツールは、設定によってプロジェクト内の複数ファイルへアクセスできます。
もし.envもアクセス可能な範囲にあれば、AIエージェントや周辺ツールが内容を読み取れる可能性があります。
そのため、
といった対策が有効です。
JavaScriptへAPIキーを入れてはいけない理由
ブラウザで実行されるJavaScriptへ秘密のAPIキーを入れるのは特に危険です。
フロントエンドコードはユーザーのブラウザへ配信されるため、開発者ツールやネットワーク通信から確認できる可能性があります。
OpenAIも、APIキーをブラウザやモバイルアプリなどのクライアント環境に埋め込まず、自分のバックエンドを経由するよう案内しています。
NEXT_PUBLICやVITE_にも注意
フロントエンドフレームワークでは、特定の接頭辞を付けた環境変数をブラウザへ公開する仕組みがあります。
例えば、環境によっては、
VITE_API_KEY
などがクライアント側コードへ埋め込まれることがあります。
「.envに入っているから秘密」という思い込みは危険です。
開発用と本番用のAPIキーを分ける
すべての環境で同じAPIキーを使うと、一つの環境から漏れたときの影響が大きくなります。
でキーを分けます。
可能なら権限や利用上限も分けます。
チーム全員で同じAPIキーを共有しない
一つのキーを全員で共有すると、漏洩したときに原因を追跡しにくくなります。
OpenAIも、チームメンバーごとに個別のAPIキーを利用し、キー共有を避けるよう案内しています。
個別管理できれば、特定のキーだけ失効させることもできます。
APIキーには有効期限を付ける
無期限のキーは、気付かないまま長期間漏洩状態が続く可能性があります。
利用サービスが対応している場合は、
などを設定します。
OpenAIも期限付きキーや定期的なローテーションを推奨しています。
利用料金を監視する
AI APIキーが漏れた場合、情報漏洩だけでなく高額利用につながることがあります。
そのため、
なども監視します。
OpenAIも利用状況の監視と、必要に応じたキーのローテーションを推奨しています。
APIキーが漏れたときの緊急対応
↓
2.新しいキーを発行
↓
3.本番・開発環境を更新
↓
4.使用履歴・請求を確認
↓
5.Git・ログ・CI/CDを確認
↓
6.漏洩経路を特定
↓
7.権限・保存方法を見直す
最優先は「漏れた秘密情報を使えなくすること」です。
DBパスワードが漏れた場合も同じ
.envにはAPIキーだけでなく、データベース認証情報が入っていることもあります。
例えば、
のような設定です。
これが漏れれば、ネットワーク構成やDB側の設定によってはデータベースへの不正アクセスにつながります。
そのため、APIキーと同様にパスワード変更とアクセスログ確認が必要です。
バックアップにも.envが入っていないか確認
Gitから除外していても、サーバーバックアップやZIPファイルに.envが含まれているケースがあります。
例えば、
などです。
バックアップの保存先・公開設定・アクセス権限も確認します。
Web公開ディレクトリに.envを置かない
Webサーバーの設定が正しければ.envへ直接アクセスできない構成が一般的ですが、設定ミスやサーバー変更によって意図せず配信される可能性があります。
可能なら、秘密情報は公開ディレクトリ外へ置きます。
/var/www/html/
公開領域とは別の安全な場所
本番環境では「長期キーを置かない」という考え方もある
より高度な構成では、長期間有効なAPIキー自体を保存しない方法もあります。
例えばOpenAIは、対応するワークロードでは、長期間有効なAPIキーの代わりにワークロードIDフェデレーションなどを利用し、短期間有効なアクセストークンを使う方法も案内しています。
秘密情報を「安全に保存する」だけでなく、
↓
有効期間を短くする
↓
権限を小さくする
↓
漏れても被害を小さくする
という考え方が重要です。
安全なAPIキー管理チェックリスト
まとめ|.envは「安全装置」ではなく「分離する仕組み」
.envファイルは非常に便利です。
しかし、
≠
絶対に漏れない
という点を理解しておく必要があります。
本当に重要なのは、APIキーをどこへ置くかだけではありません。
誰がアクセスできるか、どこまで使えるか、いつまで有効か、漏れたときにすぐ無効化できるか。
ここまで含めて設計することが、APIキーや環境変数を安全に管理する基本です。
今のやり方で本当に大丈夫?
Eatransformでは、APIキー、.env、GitHub、AIコーディング環境、MCP、クラウド認証情報、サーバー設定などを確認し、秘密情報が意図せず漏れない構成をご提案します。既存システムのシークレット管理診断や、AI開発環境のセキュリティチェックについてもご相談いただけます。