.envと環境変数で秘密情報を守る|APIキーをGitに上げない方法と漏れたときの対処
Web の API を使うプログラムを書くと、API キー(サービスを使うための合言葉のような文字列)やデータベースのパスワードを、どこかに書いておく必要が出てきます。ソースコードに直接書いて GitHub に push すると、キーを世界中に公開してしまいます。この記事では、秘密情報をソースコードから切り離す方法として、環境変数と .env ファイルの使い方、Git に上げないための設定、そして「うっかりコミットしてしまったとき」の対応の順番を、実際に動かした結果つきで説明します。
コマンドと実行結果は、Windows 11 の PowerShell 5.1・Git Bash(Git 2.49.0)・Python 3.12 で、練習用のフォルダーとリポジトリを作って確かめたものです。例に出てくる dummy-key-1234 は説明用のダミーの値で、実在するサービスのキーではありません。
API キーやパスワードをソースコードに書いてはいけない理由
次のように、キーをそのまま変数に書いたプログラムがあるとします。
API_KEY = "dummy-key-1234"
print("API に接続します")
このやり方には、次のような問題があります。
- Git の履歴にずっと残る:あとでソースコードからキーを消しても、過去のコミットには残っています(このあと実際に確かめます)
- 公開すると誰でも読める:GitHub の公開リポジトリに push すると、キーも公開されます。公開した瞬間から、悪用される前提で考える必要があります
- 共有する範囲を選べない:ソースコードを見られる人全員にキーが見えます
- 環境ごとに切り替えにくい:開発用と本番用でキーを変えたいとき、ソースコードを書き換えることになり、間違いのもとです
ソースから消しても履歴に残ることを確かめる
練習用のリポジトリで、上の app.py をコミットしたあと、キーを環境変数から読むように書き換えて、もう一度コミットしました。最新のコミットの中身を git show で表示すると、次のようになります。
git show HEAD
commit 0e28a42b9c09a9e3030785c33ed706b8f29532e1
Author: hr <hr@example.com>
Date: Sun Oct 18 10:00:00 2026 +0900
キーを環境変数から読むように変更
diff --git a/app.py b/app.py
index 15b2061..08cdbd7 100644
--- a/app.py
+++ b/app.py
@@ -1,2 +1,4 @@
-API_KEY = "dummy-key-1234"
+import os
+
+API_KEY = os.environ["MY_API_KEY"]
print("API に接続します")
先頭が - の行は「消した行」ですが、消したキーそのものがはっきり表示されています。git log -S を使うと、指定した文字列が増えたり減ったりしたコミットを探せます。
git log -S "dummy-key" --oneline
0e28a42 キーを環境変数から読むように変更
a8a2de2 API に接続する処理を追加
リポジトリを手に入れた人は、誰でもこの 2 つのコマンドでキーを見つけられます。つまり「あとで消せばよい」は通用しません。最初から書かないことが大切です。コミットの取り消し方は「Gitで取り消す方法まとめ」でも説明していますが、push 済みのコミットを revert しても、キーは履歴に残ったままです。
環境変数で渡す
環境変数は、OS がプログラムに渡す「名前と値」の組です。有名なのは PATH で、くわしくは「環境変数PATHとは?」で説明しています。キーを環境変数に入れておけば、ソースコードには「MY_API_KEY という名前の環境変数を読む」としか書かれないので、コードを公開してもキーは漏れません。
Python で読む:os.environ と os.getenv
Python では os モジュールで環境変数を読みます。書き方は 2 通りあり、変数がないときの動きが違います。
| 書き方 | 環境変数がないとき | 向いている場面 |
|---|---|---|
| os.environ[“MY_API_KEY”] | KeyError(エラー)で止まる | 必ず必要な値。ないなら止まってほしいとき |
| os.getenv(“MY_API_KEY”) | None が返る | なくても動ける値。自分でエラーメッセージを出したいとき |
| os.getenv(“DEBUG”, “false”) | 2 つ目の引数(既定値)が返る | 設定がなければ既定値を使ってよいとき |
次の app.py を、環境変数を設定しないで実行してみます。
import os
api_key = os.getenv("MY_API_KEY")
if api_key is None:
raise SystemExit("環境変数 MY_API_KEY が設定されていません")
print("キーの長さ:", len(api_key))
py app.py
環境変数 MY_API_KEY が設定されていません
os.environ["MY_API_KEY"] の書き方なら、KeyError: 'MY_API_KEY' というエラーで止まります。どちらでもよいですが、エラーの原因がすぐ分かるように、足りない環境変数の名前を表示して止めるのがおすすめです。例ではキーそのものではなく「長さ」だけを表示している点にも注目してください(理由はあとの「ログやエラーメッセージに出さない」で説明します)。
PowerShell で設定する:$env:
PowerShell では $env:名前 = "値" で環境変数を設定します。
$env:MY_API_KEY = "dummy-key-1234"
同じウィンドウで実行すると、今度は値を読めます。
py app.py
キーの長さ: 14
この方法で設定した環境変数は、そのウィンドウ(セッション)の中だけで有効です。ウィンドウを閉じると消え、別のウィンドウからは見えません。今のウィンドウで消したいときは次のコマンドを使います。
Remove-Item Env:MY_API_KEY
Microsoft の公式ドキュメント(about_Environment_Variables)には、ずっと残す方法として [Environment]::SetEnvironmentVariable() なども紹介されていますが、レジストリーに保存され、そのユーザーで動くすべてのプログラムから読めます。プロジェクト専用のキーは、次の .env ファイルで管理するほうが扱いやすいです。
bash で設定する:export
Git Bash や Linux の bash では export を使います。= の前後に空白を入れないのが決まりです。
export MY_API_KEY=dummy-key-1234
これも今のシェルの中だけで有効です。1 回の実行だけに渡したいときは、コマンドの前に 名前=値 を付ける書き方もあります。この場合、実行が終わったあとのシェルには環境変数が残りません。
MY_API_KEY=dummy-key-1234 py app.py
コマンドの履歴にも残ることに注意
キーを直接打ち込むと、その行がコマンドの履歴ファイルに残ることがあります。PowerShell の公式ドキュメント(about_PSReadLine)によると、password・asplaintext・token・apikey・secret を含む行は保存しないように絞り込まれますが、MY_API_KEY のように「apikey」という文字の並びを含まない名前は対象外です。bash も ~/.bash_history に履歴を保存します。
.env ファイルにまとめて、python-dotenv で読み込む
環境変数をいくつも使うようになると、毎回コマンドで設定するのは大変です。そこで、プロジェクトのフォルダーに .env(ドットエンブ)という名前のファイルを作り、名前=値 を 1 行に 1 つずつ書いておくのがよく使われる方法です。
# 自分の PC だけで使う設定(Git に入れない)
MY_API_KEY=dummy-key-1234
DB_PASSWORD="pass word#1"
DEBUG=true
.env は Python が自動で読んでくれるわけではありません。読み込むには python-dotenv というライブラリを使います。仮想環境を有効にしてから pip でインストールします(仮想環境の作り方は「Pythonの仮想環境venvの使い方」を参照)。
py -m pip install python-dotenv
インストールするときの名前は python-dotenv ですが、プログラムで import するときの名前は dotenv です。この記事では、PyPI の公式ページで確認した 2026 年 10 月時点の最新版 1.2.4 を使いました。
import os
from dotenv import load_dotenv
load_dotenv()
api_key = os.getenv("MY_API_KEY")
db_password = os.getenv("DB_PASSWORD")
debug = os.getenv("DEBUG", "false") == "true"
print("キーあり:", api_key is not None)
print("パスワードの長さ:", len(db_password))
print("DEBUG:", debug)
py app.py
キーあり: True
パスワードの長さ: 11
DEBUG: True
load_dotenv() が .env の中身を環境変数として読み込むので、そのあとは os.getenv() でふつうに読めます。読み込んだ値はすべて文字列なので、DEBUG のような真偽値は == "true" のように自分で比べます。
python-dotenv の動きで知っておきたいこと
| 項目 | 動き |
|---|---|
| .env を探す場所 | 実行した Python ファイルと同じフォルダー(なければ上のフォルダー)。試しに 1 つ上のフォルダーから実行しても、Python ファイルの隣の .env が読まれた |
| すでにある環境変数 | 上書きしない(override=False が既定)。override=True を付けると .env の値で上書きする |
| 値の引用符 | "pass word#1" のように引用符で囲むと、空白や # もそのまま値になる |
| コメント | 行頭の # はコメント。B=abc # メモ のように空白のあとの # もコメントになり、値は abc |
本番のサーバーでは環境変数、手元の PC では .env、という使い分けに便利です。bash で MY_API_KEY=from-shell を付けて実行すると、.env に dummy-key-1234 と書いてあっても from-shell が表示されました。

.env を .gitignore に入れ、.env.example を用意する
.env を作ったら、最初のコミットより前に .gitignore に登録します。.gitignore の書き方全般は「.gitignoreの書き方と、無視されないときの確認方法」でくわしく説明しているので、ここでは .env に関係する部分だけを扱います。
.env
.env.*
!.env.example
1 行目で .env を、2 行目で .env.local のような派生ファイルを無視し、3 行目の ! で見本ファイルの .env.example だけを無視の対象から戻しています。git check-ignore -v で、どの行が効いているかを確かめます。
git check-ignore -v .env .env.local .env.example
.gitignore:1:.env .env
.gitignore:2:.env.* .env.local
.gitignore:3:!.env.example .env.example
.env.example は 3 行目の ! の行に一致しているので、無視されずにコミットできます。この状態で git add .env と直接指定しても、「The following paths are ignored by one of your .gitignore files」と表示されて追加されません。
.env.example には「名前だけ」を書く
.env は Git に入らないので、ほかの人がリポジトリを clone しても、どんな環境変数が必要か分かりません。そこで、値を空にした見本の .env.example をコミットしておきます。
# .env.example をコピーして .env を作り、値を入れてください
MY_API_KEY=
DB_PASSWORD=
DEBUG=false
見本には本物の値を書かないことを徹底します。

うっかりコミットしてしまったときの対応
練習用のリポジトリで、.gitignore を書く前に .env をコミットしてしまい、あとから git rm --cached .env で管理から外した、という状況を作りました。今のファイル一覧からは消えていますが、git log -p で .env の履歴を見ると、中身がそのまま残っています。
git log -p --format="%h %s" -- .env
7778900 .env を管理から外す
diff --git a/.env b/.env
deleted file mode 100644
index f8a6876..0000000
--- a/.env
+++ /dev/null
@@ -1 +0,0 @@
-MY_API_KEY=dummy-key-5678
219d8ef 設定を追加
diff --git a/.env b/.env
new file mode 100644
index 0000000..f8a6876
--- /dev/null
+++ b/.env
@@ -0,0 +1 @@
+MY_API_KEY=dummy-key-5678
git show 219d8ef:.env のように、コミットを指定してファイルの中身を取り出すこともできます。.gitignore や git rm --cached は「これから先」を防ぐだけで、過去は消せません。対応は次の順番で行います。
- キーを無効化して、新しいキーを発行する(最優先):API を提供しているサービスの管理画面で、漏れたキーを削除(無効化)し、新しいキーを作ります。パスワードなら変更します。新しい値は .env に書き、コミットしません
- 漏れた範囲を調べる:
git log -S "漏れた文字列" --oneline --allで、どのコミットに入っているかを確認します。サービス側に利用履歴があれば、身に覚えのない使われ方がないかも確認します - 必要なら履歴から消す:次の git filter-repo を使います。ただし、無効化したキーはもう使えないので、履歴の書き換えは「あとから見つかって誤解されないため」の後始末です
- push 済みなら「漏れた」前提で動く:公開リポジトリに push したなら、履歴を消しても、その間に誰かが clone やコピーをしているかもしれません。履歴の削除を待たずに、1 のキーの無効化を先に済ませます
GitHub の公式ドキュメント「Removing sensitive data from a repository」も、秘密情報が認証情報(キーやパスワード)なら、まず無効化(revoke)か作り直し(rotate)をするよう書いています。無効化で被害を防げるなら、履歴の書き換えは不要な場合もある、という書き方です。
git filter-repo で履歴から消す
履歴からファイルや文字列を消すには、GitHub のドキュメントで紹介されている git filter-repo を使います。Git に最初から入っているコマンドではないので、インストールが必要です。PyPI で公開されているので、仮想環境の中に pip で入れられます(GitHub のドキュメントは Homebrew での入れ方を載せています)。
py -m pip install git-filter-repo
今回入ったのは PyPI の最新版 2.47.0 です。GitHub のドキュメントによると、ここで使う --sensitive-data-removal はバージョン 2.47 以降で使えます。仮想環境を有効にしていれば、git filter-repo として実行できます。
注意:履歴の書き換えは取り消しが難しい操作です。必ず、作業用に新しく clone したリポジトリで行い、元のフォルダーはそのまま残しておきます(filter-repo 自体も、clone したばかりではないリポジトリでは実行を断ります)。
git clone my-app cleanup
clone した cleanup フォルダーに移動し、.env を全部のコミットから消します。
git filter-repo --sensitive-data-removal --invert-paths --path .env
実行すると、書き換えたコミットの数(今回は「You rewrote 2 (of 4) commits.」)と、最初に変わったコミット(First Changed Commit)、このあとにやるべきこと(NEXT STEPS)が英語で表示されます。.env を追加しただけのコミットは中身が空になり、履歴から消えて 3 つになりました(git log --oneline --all で確認)。
app.py に直接書いていたキーのように、ファイルは残したまま文字列だけ消したいときは、--replace-text を使います。まず、置き換えのルールを書いたテキストファイル(ここでは 1 つ上のフォルダーの passwords.txt)を、リポジトリの外に作ります。==> の左が消したい文字列、右が置き換え後の文字列です。
dummy-key-1234==>***REMOVED***
git filter-repo --sensitive-data-removal --replace-text ../passwords.txt
書き換えたあとに、キーの文字列が履歴のどこにも残っていないかを確かめます。何も表示されなければ成功です。
git log -S "dummy-key" --oneline --all
今回は何も表示されず、最初のコミットの app.py は API_KEY = "***REMOVED***" に変わっていました。また、書き換えたコミットとそれ以降のコミットは、すべてハッシュ(コミットの ID)が変わりました。
書き換えたあとにやること
GitHub の公式ドキュメントによると、このあと書き換えた履歴を強制的に push し(git push --force --mirror origin、リモートの履歴が丸ごと置き換わる危険な操作なので、この記事では実行していません)、ほかの人には clone し直してもらいます。古い clone から pull と push をすると、消したデータが戻ってくるためです。プルリクエストの差分表示などに残ったものは GitHub サポートへの依頼が必要で、フォークに残ったものは自分では消せません。push したあとに完全に消すのはとても大変なので、「まずキーを無効化する」が最優先になります。
GitHub の Secret scanning と push protection
GitHub には、キーの漏れを見つけたり防いだりする仕組みがあります。2026 年 10 月時点の GitHub の公式ドキュメント(docs.github.com)で確認できた範囲で紹介します。
| 機能 | 何をするか | 使える範囲(ドキュメントの記載) |
|---|---|---|
| Secret scanning | リポジトリの全ブランチの Git 履歴全体や、Issue・プルリクエストなどを調べ、キーやパスワードらしいものを見つけると知らせる(alert) | 公開リポジトリは無料で自動的に動く。組織の非公開リポジトリは GitHub Secret Protection が必要 |
| push protection(ユーザー向け) | キーらしいものを含む push を、リポジトリに入る前に止める | GitHub.com の個人アカウントで既定で有効。公開リポジトリへの push が対象 |
| push protection(リポジトリ向け) | そのリポジトリへの push を止める | 既定では無効。GitHub Secret Protection が必要で、管理者が有効にする |
push が止められたら、指摘された箇所からキーを取り除いて、もう一度 push します。
ただし、どちらも「キーらしい文字列」を探す仕組みなので、自作のパスワードなどは素通りすることがあります。最後の守りとして考え、.gitignore と環境変数で「そもそもコミットしない」ことが基本です。
ログやエラーメッセージに秘密情報を出さない
キーを Git から外しても、ログに書き出せば同じことです。ログは多くの人やシステムに渡ります。次のプログラムは、確認のつもりでキーをそのまま DEBUG ログに出しています。
import logging
import os
logging.basicConfig(level=logging.DEBUG)
api_key = os.environ["MY_API_KEY"]
logging.debug("接続設定: key=%s", api_key)
DEBUG:root:接続設定: key=dummy-key-1234
どうしても「どのキーを使っているか」を確かめたいときは、末尾の数文字だけを残して隠す(マスクする)関数を通します。
import logging
import os
logging.basicConfig(level=logging.DEBUG)
def mask(secret):
if len(secret) <= 4:
return "****"
return "****" + secret[-4:]
api_key = os.environ["MY_API_KEY"]
logging.debug("接続設定: key=%s", mask(api_key))
DEBUG:root:接続設定: key=****1234
エラーメッセージも同じです。raise RuntimeError(f"認証に失敗しました: key={api_key}") と書くと、トレースバック(エラーの詳細)の最後の行に RuntimeError: 認証に失敗しました: key=dummy-key-1234 とキーがそのまま表示されました。エラーメッセージには「どの設定が原因か」(環境変数の名前)だけを書きます。print(os.environ) で環境変数を全部表示するのも避けます。ログの基本は「Pythonのloggingの使い方」で、例外の扱い方は「Pythonの例外処理入門」で説明しています。
OneDrive などクラウド同期フォルダーに置くときの注意
Windows では、デスクトップやドキュメントのフォルダーが OneDrive と同期されていることがよくあります。その中に .env を置くと、.gitignore で Git からは外れていても、ファイルそのものは OneDrive のクラウドに保存され、同じアカウントのほかの PC にも同期されます。
- Microsoft のサポートページによると、OneDrive のファイルのバージョン履歴は 30 日間保持されます。.env を書き換えても、古いキーが入った版がしばらく残ります
- 削除したファイルもごみ箱から戻せます(個人用アカウントは 30 日以内、職場・学校のアカウントは管理者が変えていなければ 93 日以内)
対策として、本物のキーを書いた .env や設定ファイルは、同期されないフォルダー(たとえば C:\Users\ユーザー名\.myapp\ のようなホームフォルダー直下の専用フォルダー)に置き、プログラムからはそのパスを指定して読み込む方法があります。python-dotenv なら load_dotenv("C:/Users/ユーザー名/.myapp/.env") のようにファイルのパスを渡せます(読み込めると True が返ります)。
よくある間違い
pip install dotenv と打ってしまう
インストールする名前は python-dotenv です。import の名前(dotenv)と同じ名前で pip install dotenv とすると、python-dotenv とは別に登録されている「dotenv」という名前のパッケージを入れることになります(2026 年 10 月時点の PyPI では「Deprecated package」と表示されています)。PyPI の公式ページにある名前を確認してからインストールしましょう。インストールしていない状態で from dotenv import load_dotenv を実行すると、ModuleNotFoundError: No module named 'dotenv' になります。
.env をコミットしたあとで .gitignore に書いた
.gitignore は、すでに追跡しているファイルには効きません。git rm --cached .env で追跡をやめる必要があります。そして、それまでのコミットには中身が残っているので、「うっかりコミットしてしまったときの対応」のとおり、キーの無効化から始めます。
よくある質問
パスワードを保存するときもこの方法でよいですか?
この記事の方法は「自分のプログラムが外部サービスに渡すための秘密情報」を守るためのものです。Web サービスでユーザーのパスワードを保存する場合は、元に戻せない形(ハッシュ)にして保存します。くわしくは「パスワードの安全な保存方法」を参照してください。
まとめ
- API キーやパスワードはソースコードに書かない。消しても Git の履歴に残る
- プログラムは os.environ / os.getenv で環境変数から読み、値は .env に書いて python-dotenv で読み込む
- .env は最初のコミット前に .gitignore に入れ、名前だけを書いた .env.example を共有する
- コミットしてしまったら、まずキーを無効化・再発行する。履歴の削除(git filter-repo)はその後。push 済みなら漏れた前提で動く
- ログ・エラーメッセージ・コマンド履歴・クラウド同期フォルダーにも秘密情報を残さない
関連する記事・ツール
- .gitignoreの書き方と、無視されないときの確認方法・直し方を実行結果つきで解説
- Gitで取り消す方法まとめ:restore・reset・revertの使い分けを解説
- 環境変数PATHとは?Windows・Linuxの確認・設定と「認識されません」の直し方
- Pythonのloggingの使い方|printから卒業するログ出力の基本と設定例
- Pythonの仮想環境venvの使い方|Windows・Linuxでの作成と有効化を解説
- パスワードの安全な保存方法|ソルト・Argon2id・bcryptとPython実装
- JSON・YAML・TOMLの違いと選び方|同じ設定を書き比べて分かる設定ファイルの特徴