知識 · IT·データ·DX

環境変数

Environment Variables

📂IT·データ·DX⏱読了 2分📊実務🔗関連 4

環境変数とは?

一行定義
コードの外に別途保管する設定値(特にAPIキー・パスワード)。コードに直接書かないため安全で、環境ごとに値を変えられる。
このテーマを社内研修で📚 関連研修💬 研修のお問い合わせ
⚡ 3行要約
  • コードの外に保管する設定値
  • APIキー・パスワードを安全に
  • 環境ごとに値を切り替え

環境変数を使い始めると、コードの性格そのものが変わります。キーを取り除いたコードは外部に見せても構わない資産になり、開発・ステージング・運用のサーバーに同じコードをそのまま載せても、各サーバーが自分の環境の値を読んで動きます。デプロイのたびにファイルを開いてサーバーアドレスやパスワードを手作業で直す作業がなくなるので、テスト用の設定が運用サーバーにそのまま反映される事故も同時に減ります。

環境変数に入れる値は性質が2つに分かれます。一つは、APIキー・DBパスワード・トークンのように漏れると費用や顧客データに直結する秘密値で、もう一つはサーバーアドレス・ログレベル・機能のオン/オフなど環境ごとの設定値です。前者は保管の等級を上げる必要があります。一人で使う段階では.envファイルで十分ですが、チームで使うようになったらGitHub ActionsのSecretsやデプロイ先プラットフォームの環境変数画面へ、顧客データまで扱う段階ではAWS Secrets Managerのような専用の金庫と、四半期に1回のキー交換というルールへ移行するのが一般的です。

注意すべき境界が一つあります。.envは暗号化ではありません。単に名前と値を書いておいたテキストファイルなので、そのサーバーやそのノートパソコンにアクセスできる人は誰でも開けてしまいます。そのため実務では、ファイルを分けることと同じくらい、誰がそのサーバーに入れるのかを同じ重みで管理し、キーごとに月間の利用上限と呼び出し通知を設定して、流出しても被害が上限内にとどまるようにします。

現場で最もよくずれる点は、「.envファイルを作ったので、もう安全だ」という思い込みです。gitignoreを後から追加しても、一度コミットされたキーは履歴にそのまま残るため、リポジトリを非公開にしていても、過去の記録をたどれば見つかります。ブラウザで使うフロントエンドの変数(NEXT_PUBLIC_系)は、名前が環境変数なだけで、利用者には全部見えるという点、そしてエラーログをまるごとAIのチャット画面に貼り付けた瞬間にキーも一緒に渡ってしまう点もよく見落とされます。流出したキーは消すのではなく、破棄して新しく発行し直すことが唯一の解決策です。

この用語が登場する研修 · AI・DX
おすすめ研修 · おすすめ講師 · 簡易見積もり
🧮 ミニ見積もり・講師料の基準
約120万ウォン(約14万円)特別講義 2時間 · 20名以下 · 韓国語
この条件で正式な見積もりを依頼 →
💡 かんたんに言うと
パスワードを金庫に別途保管すること。コードに直接書かないため、漏えいを防ぎます。
実務でなぜ重要なのか
APIキーやパスワードをコードにそのまま置いておくと、漏えい事故につながります。環境変数は、それを防ぐ最初のセキュリティ習慣です。
由来と出典

OSがプログラムに設定を渡す古くからの仕組みで、コードと設定・秘密値を分けるという実務上の原則として定着しました。

事例で理解する

仮想の事例で見てみましょう。役職員140名規模の化粧品流通会社A社では、開発者のいないマーケティング部がAIに尋ねながら、商品問い合わせチャットボットを2週間で作りました。コードはチームメンバー同士で動かして試すため、GitHubの公開リポジトリに載せました。10日後、普段は月18万ウォン(約2.2万円)だったAI APIの利用料が470万ウォン(約56万円)で請求されました。

  1. マーケティング部のパク代理が決済通知を見て、'弊社のチャットボットを使った人は300人もいないはずなのですが'と報告し、IT部門がログから海外IPからの呼び出し4万件余りを確認しました。
  2. IT運用のキム次長は30分で既存のキーを破棄し新しいキーを発行しましたが、コミット履歴に残っていたキーまで消すために、リポジトリを丸ごと作り直す必要がありました。
  3. その後チームはキーを.envファイルに移し、gitignoreに登録しました。また、値の名前だけを書いた.env.exampleをリポジトリに残し、新しいメンバーが15分で環境構築を終えられるようにしました。
  4. キム次長は開発用と運用用のキーを分け、アカウントごとに月30万ウォン(約3.6万円)の上限と利用量アラートを設定して、上限を超えると呼び出しが自動で止まるようにしました。
  5. 非開発職の社員26名に40分間の社内研修を実施した後、6カ月間キーの流出は0件で、API料金は月470万ウォン(約56万円)から21万ウォン(約2.5万円)へ下がりました。
関連用語
この用語に関連する研修
📚デジタルトランスフォーメーションナヌム経営コンサルティング 企業研修 · 対面/オンライン研修を見る →
このテーマで社内研修が必要でしょうか?
ご担当者さま向けの研修プログラム・お見積もりを、すぐにご覧いただけます。
研修のお問い合わせ
最終更新 2026-09-13 · 監修 金鍾赫

よくある質問

コードを共有・公開すると、その中のAPIキーやパスワードも一緒に露出し、悪用される恐れがあるからです。
はい。バイブコーディングでは'APIキーをコードに入れず環境変数で管理する'ことが、必ず守るべき安全ルールです。
コードが共有・流出すると、キーやパスワードも一緒に漏れてしまうからです。環境変数に分けることで安全になります。
直接扱わない場合でも、'APIキーをコードやチャットに貼らない'という原則は知っておく必要があります。