AIを使ってサービスやツールを作り、GitHubに公開し始めた。そんなとき、「APIキーも一緒に置いて大丈夫なのかな」と不安になることはありませんか。
APIキーは、外部サービスを使うための認証情報です。公開リポジトリに含めると、知らない人にも見られる可能性があります。もし第三者に使われると、APIの不正利用や従量課金の増加、キーに許可された範囲でのサービス利用につながることがあります。
先に結論をお伝えすると、APIキーはコードに直接書かず、環境変数などに分けて管理します。すでにGitHubへ上げてしまった場合は、ファイルを消すだけで安心せず、そのキーを無効化して再発行してください。
公開リポジトリでは、履歴も確認されます
GitHubの公開リポジトリは、URLを知っている人だけが見られる場所ではありません。誰でも内容を確認でき、コードを複製することもできます。
気をつけたいのは、現在のファイルだけではありません。APIキーを含むファイルを後から削除しても、以前の変更履歴に残っている場合があります。ファイルを消したことで、公開済みのキーが使えなくなるわけでもありません。
キーの種類や設定によって影響は異なりますが、たとえばAPIの利用料金が増えたり、キーに許可された機能を第三者に使われたりする可能性があります。公開しているアプリの画面にキーを埋め込む場合も、利用者のブラウザから確認できることがあります。コードを見えにくくするだけでは、秘密情報の保護にならない点にも注意が必要です。


APIキーをコードから分ける
まず、APIキーをソースコードに直接書かないようにします。開発環境では、プロジェクト内の.envファイルに保存し、アプリから環境変数として読み込む方法があります。
たとえば、.envには次のように書きます。
API_KEY=発行したAPIキー
このファイルがGitHubに上がらないよう、.gitignoreに次の行を追加します。
.env
ただし、すでに.envをGitの管理対象にしていた場合、.gitignoreに追加するだけでは公開を止められないことがあります。GitHub上のファイル一覧と、コミット履歴を確認してください。また、アプリを公開するサービス側で環境変数を設定できるなら、公開環境ではそちらに登録します。
使っているフレームワークや公開先によって設定方法が異なるため、開発環境だけで動く状態のまま公開しないよう、設定の場所も確認しておきましょう。
すでに上げたときは、キーを再発行する
APIキーを公開リポジトリに上げた可能性がある場合は、まず発行元のサービスでそのキーを無効化し、新しいキーを発行します。キーを無効にすることで、公開済みの情報が後から見られても使われにくくできます。新しいキーは.envや公開先の環境変数に設定し、ソースコードには書きません。
そのうえで、リポジトリ内の現在のファイルだけでなく、変更履歴にもキーが残っていないか確認します。履歴から削除する作業をしても、すでに複製された内容まで取り消せるとは限りません。公開した可能性があるキーは、履歴の削除だけに頼らず、無効化と再発行を優先してください。利用明細やアクセスログを確認できるサービスなら、不審な利用がないかも見ておきます。
「コードを作って公開する」までできても、環境変数やGitHubの履歴、公開先の設定を一人で確認するのは、慣れないうちは戸惑いやすいところです。設定を知らないまま進めると、気づかないうちにキーを共有してしまうこともあります。
何を公開してよいか、鍵をどう守るか。作ったものを出す前に、一人だと見落としが起きやすいところです。AIで自分のサービスややりたいことを形にしたい方は、公開前の確認から相談してみる方法もあります。ZELK IT・AI相談所では、安全に公開する進め方を含めて、1対1で伴走しています。





