メインコンテンツへスキップ
AMPL/ dev
開発系講座一覧

鍵が漏れたら

API キーが人に見えてしまったら、記録を消すより先に、その鍵を使えなくします。Claude Console で古い鍵を消し、新しい鍵を作って入れ替えます。公開リポジトリで見つかった鍵は、自動で止められる仕組みもあります。

デモ動画の練習に、画面を録画して見返していたとき、佐藤さん(会社員で、実家の和菓子店を手伝う、架空の人物)は、ぎくりとしました。一瞬だけ .env のファイルが開いて、鍵の文字が映っています。

問い

佐藤さんの疑問

鍵が漏れたかもしれない。まず、何をすればいいんだろう。

2つに折れた鍵の挿絵。

前の回で、API キー(あなたの利用分で Claude を使うための鍵)を、.env(手元で環境変数を書いておくファイル)にしまいました。

気をつけていても、漏れることはあります。この回では、漏れたと気づいたときに、何を、どの順でするかを見ていきます。

漏れたかもしれない、と思う場面

  • .env を、うっかりコミット(記録として残すこと)して、GitHub に送ってしまった
  • 鍵が写った画面の写真を、人に送ってしまった
  • デモ動画に、鍵が映っていた
  • 鍵を、チャットや Discord に貼ってしまった

「たぶん大丈夫」と思っても、漏れたものとして動きます。

最初にすること:鍵を使えなくする

いちばん先にするのは、漏れた鍵を使えなくすることです。これを、キーの無効化と呼びます。Claude Console では、鍵を止める(Disable)か、消す(Delete)ことで、使えなくできます。記録から消す作業は、そのあとです。

Claude のヘルプセンターには、こう書かれています。

DOCUMENTATION

“If you suspect that your API key may be compromised, we recommend revoking the key immediately.”

API キーが漏れたかもしれないと思ったら、すぐにその鍵を取り消すことをおすすめします。

AnthropicWhat should I do if I suspect my API key has been compromised?(Claude ヘルプセンター)

同じ記事によると、手順は次のとおりです。画面の言葉は英語のことがあります。

  1. Claude Console にログインし、API キーのページ(platform.claude.com/settings/keys)を開く
  2. 漏れた鍵の横にある、点が3つ並んだ印を押す
  3. 「Delete API key」(API キーを消す)を選ぶ

Claude API の公式の説明によると、同じページには、Disable(止める)と Delete(消す)があります。Disable は、あとで元に戻せます。Delete は、元に戻せません。漏れたと分かっているなら、消します。

第5部の第9回で見た GitHub の公式の説明にも、記録から鍵を消したいときは、まず、その鍵を使えなくするように、と書かれていました。使えなくした鍵は、記録に残っていても、もう使えません。

次にすること:作り直して、入れ替える

鍵を消すと、作品の中の Claude も動かなくなります。そこで、新しい鍵を作り直します。これを、再発行と呼びます。

  1. 同じ API キーのページで「Create key」を押し、新しい鍵を作る(第6部の第2回)
  2. 手元の .env の鍵を、新しい鍵に貼り替える(第6部の第4回)
  3. Claude に、開発サーバーを動かし直してもらい、写真を撮って、表に数が入るかを確かめる

作品をインターネットに置いたあとは、置き場のほうの鍵も入れ替えます。その方法は、第7部で扱います。

漏れたら、まず使えなくする

鍵が漏れたかもしれないときの順番

1. 使えなくする Console で鍵を消す 2. 作り直す 新しい鍵を作る 3. 入れ替える .env の鍵を貼り替える いちばん先に 記録から消す作業は、そのあと いちばん先に 1. 使えなくする Console で鍵を消す 2. 作り直す 新しい鍵を作る 3. 入れ替える .env の鍵を貼り替える 記録から消す作業は、そのあと
図1鍵を消すと、作品の中の Claude も止まります。作り直して入れ替えるまでが、ひと続きです。

公開リポジトリで見つかった鍵は、自動で止められる

Claude のヘルプセンターによると、Anthropic は GitHub と組んでいます。GitHub は、公開リポジトリ(誰でも見られる作品の置き場)に Claude の API キーがないかを見回っていて、見つけると Anthropic に知らせます。Anthropic は、その鍵を自動で使えなくし、持ち主にメールで知らせます。

ありがたい仕組みですが、自動で止まるのを待つ必要はありません。気づいたら、自分で先に止めます。それに、公式の説明にあるのは、公開リポジトリの話です。非公開のリポジトリや、画面の写真、チャットに貼った鍵は、見つけてもらえると期待せず、自分で気づいて、自分で止めます。

鍵が漏れたかもしれないと思ったら、まず Claude Console で鍵を消して使えなくし、新しい鍵を作って入れ替えます。

注意

ただし、記録から消しただけでは、鍵は生きている

漏れた鍵を、ファイルから消してコミットしても、前のコミットには鍵が残っています。誰かがすでに写しを取っていれば、その鍵は使えてしまいます。

だから、順番は必ず「使えなくする」が先です。そのあと、どうしても記録から消したいときは、Claude に相談します。記録の書き換えは、写しを持つ全員と調整が要る、手間のかかる作業です(第5部の第9回)。

次回の問い

佐藤さんの次の疑問です。作品の中で使う Claude は、どのモデルを選べばよいのでしょうか。

参考

API キーが漏れたかもしれないときは(Claude ヘルプセンター)
漏れた鍵を消し、新しい鍵を作る手順。英語。
support.claude.com · support.claude.com
API キーのベストプラクティス(Claude ヘルプセンター)
GitHub と組んだ、公開リポジトリの鍵の見回りの説明を含む。日本語。
support.claude.com · support.claude.com

このレッスンは役に立ちましたか?