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

鍵は画面の裏に置く

ブラウザに届くコードは、使う人なら誰でも読めます。だから API キーは、ブラウザ(クライアント)の側ではなく、サーバー側に置き、そこから Claude API を呼びます。

読み取りの機能を頼む依頼文の最後に、佐藤さん(会社員で、実家の和菓子店を手伝う、架空の人物)は、教わったとおりの一文を書き添えました。「鍵がブラウザに届かないよう、API はサーバー側から呼んでください」。書いてはみたものの、意味はよく分かっていません。

問い

佐藤さんの疑問

サーバー側から呼ぶって、どういうことだろう。ブラウザに届くと、何が困るんだろう。

奥の棚にのせた、ふたの開いた木箱に、鍵が1本入っている挿絵。

前の回で、佐藤さんは、読み取りの機能を Claude Code に頼みました。

この回では、その意味を見ていきます。

ブラウザに届くものは、誰でも読める

第1部の第6回で、ブラウザが「このページをください」と頼むと、サーバーがファイルを返す、と見ました。返されたファイル(HTML や JavaScript)は、使う人のパソコンやスマホのブラウザに届きます。

届いたものは、その人の手元にあります。ブラウザの奥の道具(第4部の第9回で見たコンソールと同じ場所)を開けば、中身を読めます。開き方は、覚えなくて大丈夫です。

もし、app.js のような、ブラウザに届くファイルに API キーが入っていたら、作品を開いた人なら誰でも、鍵を読み取れてしまいます。

お店の、売り場と作業場

お店で考えてみます。売り場に並んだ品物は、お客さんが手に取って、裏返して、値札まで見られます。一方、奥の作業場には、お客さんは入れません。金庫の鍵を、売り場の棚に置く店はありません。作業場にしまいます。

作品も同じです。使う人のブラウザに届くものは、売り場の品物です。鍵は、使う人が入れない、奥の作業場に置きます。

クライアントとサーバー側

売り場にあたる、使う人の手元で動く側を、クライアント(client、英語で「お客さん」)と呼びます。作品なら、ブラウザで動く部分です。第1部の第8回で見た、フロントエンド(画面に映って、人が見て触る部分)が、ここで動きます。

作業場にあたる、作品を置いた場所のコンピューターで動く側を、サーバー側と呼びます。第1部の第8回で見た、バックエンド(サーバーの側で動く、見えない部分)です。サーバー側のコードは、使う人のブラウザには届きません。

Claude API の公式の説明には、こう書かれています。

DOCUMENTATION

“Call the Claude API from your own back end, not from code that runs in your users’ browsers. Anyone who uses a webpage can read an API key in that page’s code.”

Claude API は、使う人のブラウザで動くコードからではなく、自分のバックエンドから呼んでください。ウェブページを使う人なら誰でも、そのページのコードに入った API キーを読めてしまいます。

AnthropicAuthentication(Claude API Docs)

佐藤さんの作品の流れ

鍵をサーバー側に置くと、読み取りの流れは、こうなります。

  1. お父さんが、ブラウザで「写真を撮る」を押す(クライアント)
  2. 写真が、作品のサーバー側に送られる
  3. サーバー側が、環境変数(作品の外から渡す値)の鍵を使って、Claude API に写真を送る
  4. Claude の答えが、サーバー側に返る
  5. サーバー側が、答えだけをブラウザに返し、表に入る

鍵は、3のところで使われるだけで、ブラウザには一度も届きません。

鍵は、作業場の中だけで使う

概念図。色を敷いた区画が、売り場と作業場

売り場 クライアント 作業場(サーバー側) ブラウザ 使う人の手元 受付の仕組み 答えだけ返す 鍵(API キー) 環境変数に入れる Claude API 読んで答える 写真 答えだけ 鍵を添えて 頼む 答え 使う 鍵は外へ 出ない 売り場(クライアント) ブラウザ 使う人の手元 作業場(サーバー側) 受付の仕組み 答えだけ返す 鍵(API キー) 環境変数に入れる 写真 答えだけ 使う 鍵は外へ出ない Claude API 読んで答える 鍵を添えて頼む 答え
図1鍵はサーバー側で使われるだけで、使う人のブラウザには、答えだけが届きます。

サーバー側は、どこにあるのでしょうか。手元で作っているあいだは、第4部の第6回で見た、自分のパソコンの中の開発サーバーが、作業場の役をします。人に使ってもらうときは、作品を置く場所(第7部)のコンピューターが、その役をします。

第4部で作った「売れ残り帳」は、ブラウザだけで動く形でした。そこで、写真を受け取り、鍵を使って Claude API に送り、答えだけを返す、小さな受付の仕組みを、サーバー側に足します。どんな形で足すかは、作品を置く場所によって変わるので、Claude Code に、置く場所の候補と一緒に相談して決めます。

届いていないかを、確かめてもらう

作り終えたら、こう頼みます。

鍵がブラウザに届いていないか確かめる例
API キーが、ブラウザに届くコードに入っていないかを確かめてください。ブラウザで動くファイルの中に、鍵の値や、ANTHROPIC_API_KEY を直接読むところがないかを調べて、結果を教えてください。Claude API を呼んでいるのが、サーバー側のコードだけであることも確かめてください。

この依頼文は、説明のための架空の例です。

返事に、「ブラウザで動くファイルには、鍵の値も ANTHROPIC_API_KEY も出てこない」「Claude API を呼んでいるのは、サーバー側の(ファイル名)だけ」とあれば、大丈夫です。「ブラウザ側で鍵を読んでいる」とあれば、サーバー側から呼ぶ形に直してもらいます。

API キーは、サーバー側に置き、そこから Claude API を呼びます。ブラウザ(クライアント)に届くコードには、鍵を入れません。

注意

ただし、「ブラウザから直接呼ぶ」作り方を提案されることがある

作るのを早くするために、ブラウザから直接 Claude API を呼ぶ作り方が出てくることがあります。公式の説明によると、Claude API の公式の部品には、そのための設定(dangerouslyAllowBrowser など)がありますが、名前に「dangerous」(危ない)という言葉が入っていて、鍵がブラウザのコードに出てしまう危なさが書かれています。

Claude Code の計画や、許可の確認(第4部の第2回)に、dangerous や dangerously という言葉が出てきたら、止めて、「サーバー側から呼ぶ形にしてください」と頼みます。

次回の問い

佐藤さんの次の疑問です。それでも、思わぬ使いすぎを防ぐには、どうすればよいのでしょうか。

参考

認証(Claude API Docs)
API キーの扱いと、ブラウザから直接呼ばない理由。
platform.claude.com · platform.claude.com
Vibe Coding 用語集:クライアント
クライアントとサーバーの説明。
AMPL · Web

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