環境変数
Environment Variables
環境変数とは?
- コードの外に保管する設定値
- APIキー・パスワードを安全に
- 環境ごとに値を切り替え
環境変数を使い始めると、コードの性格そのものが変わります。キーを取り除いたコードは外部に見せても構わない資産になり、開発・ステージング・運用のサーバーに同じコードをそのまま載せても、各サーバーが自分の環境の値を読んで動きます。デプロイのたびにファイルを開いてサーバーアドレスやパスワードを手作業で直す作業がなくなるので、テスト用の設定が運用サーバーにそのまま反映される事故も同時に減ります。
環境変数に入れる値は性質が2つに分かれます。一つは、APIキー・DBパスワード・トークンのように漏れると費用や顧客データに直結する秘密値で、もう一つはサーバーアドレス・ログレベル・機能のオン/オフなど環境ごとの設定値です。前者は保管の等級を上げる必要があります。一人で使う段階では.envファイルで十分ですが、チームで使うようになったらGitHub ActionsのSecretsやデプロイ先プラットフォームの環境変数画面へ、顧客データまで扱う段階ではAWS Secrets Managerのような専用の金庫と、四半期に1回のキー交換というルールへ移行するのが一般的です。
注意すべき境界が一つあります。.envは暗号化ではありません。単に名前と値を書いておいたテキストファイルなので、そのサーバーやそのノートパソコンにアクセスできる人は誰でも開けてしまいます。そのため実務では、ファイルを分けることと同じくらい、誰がそのサーバーに入れるのかを同じ重みで管理し、キーごとに月間の利用上限と呼び出し通知を設定して、流出しても被害が上限内にとどまるようにします。
現場で最もよくずれる点は、「.envファイルを作ったので、もう安全だ」という思い込みです。gitignoreを後から追加しても、一度コミットされたキーは履歴にそのまま残るため、リポジトリを非公開にしていても、過去の記録をたどれば見つかります。ブラウザで使うフロントエンドの変数(NEXT_PUBLIC_系)は、名前が環境変数なだけで、利用者には全部見えるという点、そしてエラーログをまるごとAIのチャット画面に貼り付けた瞬間にキーも一緒に渡ってしまう点もよく見落とされます。流出したキーは消すのではなく、破棄して新しく発行し直すことが唯一の解決策です。
OSがプログラムに設定を渡す古くからの仕組みで、コードと設定・秘密値を分けるという実務上の原則として定着しました。
仮想の事例で見てみましょう。役職員140名規模の化粧品流通会社A社では、開発者のいないマーケティング部がAIに尋ねながら、商品問い合わせチャットボットを2週間で作りました。コードはチームメンバー同士で動かして試すため、GitHubの公開リポジトリに載せました。10日後、普段は月18万ウォン(約2.2万円)だったAI APIの利用料が470万ウォン(約56万円)で請求されました。
- マーケティング部のパク代理が決済通知を見て、'弊社のチャットボットを使った人は300人もいないはずなのですが'と報告し、IT部門がログから海外IPからの呼び出し4万件余りを確認しました。
- IT運用のキム次長は30分で既存のキーを破棄し新しいキーを発行しましたが、コミット履歴に残っていたキーまで消すために、リポジトリを丸ごと作り直す必要がありました。
- その後チームはキーを.envファイルに移し、gitignoreに登録しました。また、値の名前だけを書いた.env.exampleをリポジトリに残し、新しいメンバーが15分で環境構築を終えられるようにしました。
- キム次長は開発用と運用用のキーを分け、アカウントごとに月30万ウォン(約3.6万円)の上限と利用量アラートを設定して、上限を超えると呼び出しが自動で止まるようにしました。
- 非開発職の社員26名に40分間の社内研修を実施した後、6カ月間キーの流出は0件で、API料金は月470万ウォン(約56万円)から21万ウォン(約2.5万円)へ下がりました。
ク・ジャリョン
金鍾赫