コンテンツにスキップ

Claude CodeでWebサイトにBasic認証をかけて合言葉を知っている人だけに見せる

公開したサイトを、全員には見せたくないことがある。作りかけを関係者だけに見せたい。身内向けのページを作った。管理用の画面を自分だけが開けるようにしたい。

こういうとき、合言葉をひとつ決めて、知っている人だけを通すのが手軽。Basic認証という、ブラウザに昔から備わっている仕組みを使う。

扉が2つ並んでいる。左の扉は大きく開いていて、中の部屋で犬たちがくつろいでいる。右の扉は閉まっていて南京錠がかかり、扉の前で門番の茶トラの猫が黒白の猫から耳打ちで合言葉を聞いている。その横で白い猫が首をかしげている

だれでも見られる場所と、合言葉を知っている人だけが入れる場所を分ける

この記事では2ページだけの小さなサイトを作り、サイト全体にかける場合と一部だけにかける場合の両方を試す。

ログイン機能というと大がかりに聞こえるが、Basic認証は画面を作らない。ログインフォームも、パスワードを保存するデータベースも作らない。ブラウザが合言葉を尋ねる画面を出してくれるので、こちらは「合っているか照合する」だけでよい。

そのぶん割り切りもある。誰がアクセスしたかは区別できないし、ログアウトもできない。それでも「関係者だけに見せる」用途にはこれで足りることが多い。もっと本格的な守り方が要るようになったときの選択肢は、6章で案内する。

必要な前提は「Cloudflareにサイトを公開できること」だけ。データベースも Git も使わない。公開先は Cloudflare Workers。

2ページだけのサイトを作る。

public/
├─ index.html 誰でも見られるトップ
└─ secret/index.html 合言葉を知っている人だけ

トップページは誰でも開ける。

「だれでも見られるページ」と書かれたシンプルなページ

/secret/ を開こうとすると、ブラウザが合言葉を尋ねてくる。

ブラウザが表示するログインダイアログ。ユーザー名とパスワードの入力欄がある

正しく入れると中身が見える。

「合言葉を通過しました」と表示された鍵のかかったページ

このダイアログはブラウザが出すもので、HTML 側で作るものは何もない。

まずはサイトを作る。ここはCloudflareにHTMLをアップロードして公開すると同じ話なので、さっと済ませる。

新しく作った作業フォルダ ~/claude/my-secret-site を Claudeデスクトップアプリで開く(→ SUP 1-1)。

そこで次のように頼む。

プロンプト
このフォルダに public フォルダを作って、2ページだけの静的サイトを作ってください。
- public/index.html は誰でも見られるトップページ
- public/secret/index.html は、あとで合言葉で守るページ
- 中身は見分けがつけばよく、凝らなくていい
- トップページから secret のページへのリンクを置いてください

途中でファイル操作の許可を求められたら、その都度許可する。

できあがったら public/index.html をダブルクリックして、ブラウザで表示を確認しておく。この時点ではどちらも普通のページで、鍵はかかっていない。

鍵をかける前に、まず普通のサイトとして公開する。この段階では2ページとも誰でも見られる。そこから鍵をかけるので、何が変わったのかがはっきり分かる。

Wrangler でプロジェクトを作るところからやる。ブラウザは使わない(やり方はWranglerでCloudflareに公開するの4章と同じ)。

Wrangler のログインは WranglerでCloudflareに公開するで済ませてある前提。Claude Code に頼む。

プロンプト
Cloudflare に新しい Worker「my-secret-site」を作って、public フォルダの中身を wrangler でデプロイして。
設定ファイル(wrangler.jsonc)も作ってほしい。

wrangler.jsonc が作られてから、Worker が新しく作られて公開される。公開URLは https://my-secret-site.サブドメイン.workers.dev(サブドメインはアカウントごとに決まっている)。Workers は名前の衝突が起きないので、my-secret-site のまま使ってもよい。

公開できたら、表示された URL を開いてみる。この時点では /secret/ も誰でも見られる。ここに次の章で鍵をかける。

Basic認証はブラウザに標準で備わっている認証の仕組み。保護されたページを開くと、ブラウザがユーザー名とパスワードを尋ねるダイアログを出す。入力した値はリクエストのたびにヘッダに載ってサーバーへ送られ、サーバー側で照合される。

sequenceDiagram
    participant B as ブラウザ
    participant CF as Cloudflare
    B->>CF: /secret/ にアクセス
    CF-->>B: 401(認証してね)
    Note over B: ユーザー名とパスワードの<br />ダイアログを表示・入力
    B->>CF: 同じURLに再リクエスト<br />(ユーザー名とパスワードをヘッダに載せる)
    Note over CF: 預けてある合言葉と照合
    alt 一致
        CF-->>B: ページを返す(ここで初めて中身が見える)
    else 不一致
        CF-->>B: 401(ダイアログを再表示)
    end

ポイントは 401 という返事に WWW-Authenticate というヘッダを付けること。これを見たブラウザが、自動でダイアログを出してくれる。

合言葉を確かめる処理を作ってもらう。頼むのは、どこを守るかと、合言葉をどこに置くかだけ。

プロンプト
/secret/ 以下のページを、Basic 認証の合言葉で守って。
合言葉は SITE_PASSWORD という名前で Cloudflare のシークレットに預けるので、コードにも設定ファイルにも書かない。ユーザー名は guest でよい。
守らないページは、今までどおりコードを通さずに配信する。

最後の行は、無料枠のために足した行。これが無いと、Claude Code はサイト全体のリクエストをコードに通す設定にした(run_worker_first を true にする)。鍵はかかるが、トップページも含めて全リクエストが Worker の呼び出しとして数えられる。この1行で、コードを通るのは /secret/ 以下だけになった。

できあがるのは Worker のコード(src/index.js など)で、3章で作った wrangler.jsonc にも書き足される。wrangler.jsonc には次のように入る。

"assets": {
"directory": "./public",
"binding": "ASSETS",
"run_worker_first": ["/secret", "/secret/*"]
}

守りたいパスが /secret/ という文字列は、プロンプトの中に1か所だけ。/room/ に変えたいなら、そこを書き換えるだけでよい。範囲の変え方は5章、仕組みは7章に回す。

依頼文には書いていないが、Claude Code が自分で入れたもの(Sonnet で2回試し、2回ともそろった)。

安全策何を防ぐか
run_worker_first を書き、守るパスでコードを通す認証のコードを書いても、静的ページが素通りで返ること
パスを整えてから判定する(//secret/、/SECRET/、%73ecret、../ など)書き方を変えたパスで、範囲の判定をすり抜けられること
合言葉が未設定なら、誰も通さない合言葉を預ける前に、/secret/ が開いたままになること
ユーザー名と合言葉をハッシュにしてから、常に同じ時間で比べる比較にかかる時間の差から、合言葉を1文字ずつ当てられること(7-2)
守ったページに、キャッシュさせない指定を付ける一度見せたページが、合言葉なしで経路の途中から返ること

作ったら、ここで一度デプロイする。 静的ファイルだけの Worker には、合言葉を預けられないため。Settings の Runtime variables and secrets に「Variables cannot be added to a Worker that only has static assets.」と出て、+ Add variable が出てこない。コードをデプロイすると出てくる。デプロイが終わる前に Settings を開いていたときも、この表示のままになる。Claude Code がデプロイを終えたと言ってから、ページを読み込み直す。

プロンプト
デプロイして

この時点では合言葉をまだ預けていない。それでも /secret/ は閉じたまま(上の表の3行目。手元で試すと 401 か 500 が返り、中身は出なかった)。

複数のパスを守りたいときも、並べて言えばよい(→ 5-3)。

合言葉をコードに書いてはいけない。 ファイルにも書かない。Cloudflare に預ける。ブラウザで入れる。

  1. Cloudflare ダッシュボード → Workers & Pages → 自分の Worker → Settings
  2. 「Runtime variables and secrets」の「+ Add variable」を押す
  3. Select environment で Production にチェックが入っていることを確かめる
  4. Key に SITE_PASSWORD、Value に合言葉を入れ、Value 欄の右にある Secret にチェックを入れる
  5. Add 1 variable and deploy を押す
Worker の Settings。Runtime variables and secrets の右上に Add variable のボタンがある

Runtime variables and secrets の右上の Add variable から入れる。コードをデプロイする前は、このボタンが出てこない

Add environment variable のダイアログ。Production にチェック、Key に SITE_PASSWORD、Value は伏せ字で、右の Secret にチェックが入っている

Production と Secret の両方にチェックが入っていることを確かめてから押す

🚨 「Secret」のチェックを忘れない。チェックしないとただの環境変数として保存され、あとから値が画面に表示される。チェックを入れていれば、Value が伏せ字(●●●)になる。

入れるのは合言葉だけ。ユーザー名は §4-2 で guest にしてあるので、Cloudflare 側には何も入れない。

guest 以外にしたいなら、コードのほうを変える。

プロンプト
Basic認証のユーザー名を taro に変えて

ユーザー名は秘密ではないので、コードに書いてかまわない。相手に伝えて使ってもらうものなので、隠しても意味がない。人ごとに分けたいときは §5-1 で扱う。

預けるのは秘密だけでよい。何でも厳重に扱おうとすると手間が増え、どこかで手を抜きやすくなる。秘密なのはどれかを見分けて、そこだけ守る。

4-4. 鍵をかけたあと、もう一度デプロイする

Section titled “4-4. 鍵をかけたあと、もう一度デプロイする”

ここでやることはない。 4-3 で押した Add 1 variable and deploy が、合言葉を預けるのと一緒にデプロイまで済ませている(手元で、Claude Code からデプロイし直さずに合言葉で入れた)。コードは 4-2 の最後にデプロイしてあるので、これで鍵がかかる。

/secret/ を開くと合言葉を聞かれ、トップページは今までどおり誰でも開ける。

鍵は、書いたつもりでもかかっていないことがあるので、公開したら確かめる。ブラウザは一度通した合言葉を覚えていて自動で送るので、ブラウザで開いただけでは、鍵がかかっているのか素通りなのか見分けにくい。サーバーの返事を直接見るのが確実。

プロンプト
公開URLの /secret/ に curl -I でアクセスして、401 が返るか確かめて。トップページが 200 のままかも見て

/secret/ が 401 なら鍵がかかっている。 200 が返るなら鍵がかかっていない。wrangler.jsonc の run_worker_first が抜けていることが多い(→ 4-2)。

ここまでで、合言葉はひとつ、鍵をかける範囲は /secret/ 以下だけという形ができた。使い始めると、たいていこの3つが要る。3つとも、コードの変更は Claude Code に頼める。鍵が要らなくなったときの外し方も、最後に書いておく。

いまは合言葉がひとつだけ。admin と guest を分けたい、といったことはよくある。自分用と、人に渡す用。

環境変数に複数の組を並べて、順に照合すれば増やせる。

プロンプト
Basic認証のユーザーを複数にしたい。
環境変数 SITE_USERS を "ユーザー名:合言葉,ユーザー名:合言葉" の形式として読み、
どれかに一致したら通すようにして。
値は私が自分で Cloudflare に入れるので、コードにも設定ファイルにも書かないで。

値そのものはプロンプトに書かない。 合言葉が混じっているので、§4-3 と同じ手順でブラウザから入れる。Key は SITE_USERS、Value に admin:合言葉1,guest:合言葉2 のように並べ、Secret にチェックを入れる。

コードが変わっているので、Claude Code にデプロイし直してもらう。

これで SITE_PASSWORD は使われなくなる。ダッシュボードから消してよい。残っていても害はないが、どれが使われているのか分からなくなるので、消しておくほうがよい。

増やすと2つ、できることが増える。

  • 誰が入ったか分かる。 ユーザー名はリクエストのたびに送られてくるので、記録したければ記録できる
  • 個別に止められる。 環境変数から1組消すだけ

鍵をかける範囲は、wrangler.jsonc の run_worker_first とコードの判定の2か所で決まる(→ 7-1)。変えたいときは、両方を書き換えてもらう。

かける範囲やり方
一部だけ(/secret/ 以下)/secret/ 以下だけコードを通し、そこで合言葉を求める
サイト全体すべてのリクエストをコードに通し、どのページにも合言葉を求める

サイト全体にかけたければ、これも頼めばよい。

プロンプト
Basic認証をサイト全体にかけたい。
パスの範囲判定を外して、どのページでも合言葉を求めるようにして。
鍵をかける範囲に関わる設定があれば、それも合わせて変えて

最後の1行は、run_worker_first のため。コードの判定を外すだけでは足りず、run_worker_first も全体(true)に変えないと、トップページは鍵なしで見えたままになる(手元で確かめた)。全体にすると、トップページも無料枠に数えられる(→ 4-2)。

直してもらったらデプロイし直す。 コードを変えただけでは、公開中のサイトは変わらない。

実際に両方で確かめると、こうなる。

範囲/(トップ)/secret/
/secret/ 以下だけ誰でも見られる合言葉が要る
サイト全体合言葉が要る合言葉が要る

作りかけのサイトを丸ごと隠したいときは全体に、一部のページだけ隠したいときはパスで絞る。

5-3. 管理ページと、その API をまとめて守る

Section titled “5-3. 管理ページと、その API をまとめて守る”

守りたいパスが2つ以上あるときは、並べて言えばよい。たとえば管理画面 /admin/ と、その裏側の管理API /api/admin/ の両方。

プロンプト
Basic認証をかける範囲を /admin/ と /api/admin/ の2つにして。
鍵をかける範囲に関わる設定があれば、それも合わせて変えて

これもデプロイし直すまで、かかる範囲は変わらない。

この「管理ページ+その API」の組み合わせは相性がよい。管理者が /admin/ を開くと合言葉を1回入れる。以降、その画面が /api/admin/… を呼ぶときは、ブラウザが同じ合言葉を自動で付けるので通る。いっぽう、その画面を通さずに /api/admin/… を直接開こうとしても、合言葉が無いので 401(4-1 の「認証してね」)が返るだけ。範囲に入れていない公開API(/api/posts など)は、今までどおり誰でも読める。

ページだけに鍵をかけると、API 側が素通しのまま残る。 画面は守られているのに、その裏で動いている /api/admin/… を誰でも呼べる状態になり、そこから消したり書き換えたりできてしまう。ページと、そのページが呼ぶ API は、セットで守る。

鍵が要らなくなることもある。たとえば、公開前に関係者だけに見せて確かめてもらっていたサイトを、そのまま一般に公開するとき。

外すときは、鍵の処理を止めるのではなく、消して、鍵をかける前の静的なサイトに戻す。処理を残したまま「鍵をかけない」設定にする手もあるが、使っていない処理と設定が残り、あとで見たときに何が動いているのか分からなくなる。また要るようになったら、4-2 の依頼文でもう一度作ればよい。

プロンプト
Basic認証をやめたい。認証の処理を消して、静的ファイルだけのサイトに戻して。
鍵をかける範囲に関わる設定があれば、それも元に戻して

Worker のコードが消え、wrangler.jsonc からも、4-2 で書き足された部分(コードの登録と run_worker_first)が外れる。手元で試すと、Claude Code はこの依頼文だけで wrangler.jsonc まで元に戻した。

プロンプト
デプロイして

静的ファイルだけの Worker に戻る。鍵をかけていたパスも静的ファイルの配信に戻るので、無料枠(1日10万リクエスト)に数えられなくなる(→ 4-2)。

預けた合言葉は、デプロイし直した時点で消える。 静的ファイルだけの Worker は Secret を持たないため(手元で確かめると、デプロイ後に Secret の一覧が空になった)。ダッシュボードで消す作業は要らない。もう一度鍵をかけるときは、§4-3 から預け直す。

デプロイし直すまで、鍵はかかったまま。外れたかどうかは、§4-5 の逆で確かめる。

プロンプト
公開URLの /secret/ に curl -I でアクセスして、200 が返るか確かめて

/secret/ が 200 なら外れている。手元では、デプロイから20秒ほどは 401 が返り続けた(§4-4 の「反映を待つ」と同じ)。

Basic認証は「合言葉ひとつ・最小の手間」の入り口。関係者だけに見せる用途なら、ここまでで足りることが多い。ただ、使っていると不便も見えてくる。

  • ログアウトができない:一度通すと、ブラウザを完全に終了するまで認証されたままになる。ログアウトボタンを付けようがない
  • ログイン画面の見た目を変えられない:あのダイアログはブラウザのもので、こちらからは手を出せない
  • 誰がアクセスしたかを区別できない:合言葉を知っているかどうかだけなので、複数人に配ると誰が見たのか分からない。合言葉を変えるときも全員に配り直すことになる

いっぽうで、便利な点もある。ブラウザのパスワードマネージャがそのまま使える。

Chrome が「パスワードを保存しますか?」と提案しているダイアログ

通過すると、ブラウザが保存を提案してくる。保存しておけば次からは自動で入るので、長くて複雑な合言葉にしても困らない。自前でログイン画面を作ると、パスワードマネージャに認識させるのに手間がかかることがあるが、Basic認証はブラウザ標準の仕組みなので、こちらは何もしなくていい。

用途が変わってきたら、別の方式が向いてくる。この記事では作らないが、見当をつけておくと選べるようになる。

Basic認証(この記事)トークン認証Cloudflare Access
実装・設定の手間最小少ない多い(初回のみ)
ログイン画面ブラウザ固定のダイアログ自前(自由にデザイン可)Cloudflare のログイン画面(メールに届くコードで入る)
ログアウト事実上できないできるできる
アクセス制限の単位合言葉を知っているか合言葉を知っているかメールアドレス単位
外部サービス不要不要Cloudflare Zero Trust(無料・カード登録が必要)

合言葉方式の限界は「誰がアクセスしたか」を区別できないこと。自分ひとりや信頼できる少人数で使うなら、この限界で困ることは少ない。個人を識別したくなったら上に進むとよい。

ここまでで、Basic認証は一通り使える。次の7章は補足で、読まなくてもかまわない。

ここから先は補足。合言葉をかけて使うだけなら、6章までで足りている。この章で見るのは、鍵をかける範囲をどこで決めるのか、合言葉をどう比べているのか、ブラウザを開かずにコマンドだけで預ける方法、なぜユーザー名を Cloudflare に置かないのか、の4つ。

7-1. 鍵をかける範囲をどこで決めるのか

Section titled “7-1. 鍵をかける範囲をどこで決めるのか”

4-2 で作ったのは、Worker のコードと wrangler.jsonc だった。鍵をかける範囲は2か所で決まっている。

  • run_worker_first(wrangler.jsonc):どのパスでコードを動かすか。ここに入っていないパスは、コードを通らずに静的ファイルがそのまま返る
  • コードの判定:コードが動いたパスのうち、どれに合言葉を求めるか

2つが食い違うと、広いほうではなく狭いほうに合わせて鍵がかかる。 コードだけ全体にしても、run_worker_first が /secret/* のままならトップページは素通りになる(5-2)。逆に run_worker_first を true にすれば全リクエストがコードを通るが、そのぶん全リクエストが無料枠(1日10万)に数えられる。4-2 の最後の行が無いと、Claude Code はこちらを選んだ。

コードの判定の前には、パスを整える処理が入っていた(4-2 の表の2行目)。連続したスラッシュを1つにまとめ、%73 のような書き方を元の文字に戻し、../ をたどり、大文字と小文字をそろえてから /secret かどうかを見る。

手元で試すと、//secret/ や /%73ecret/ は、コードに届く前に静的ファイルの配信が /secret/ へ転送(307)し、転送先で合言葉を聞かれた。/SECRET/ と /x/../secret/ はコードに届き、そこで合言葉を聞かれた。どちらの道でも、中身は合言葉なしでは返らなかった。

4-2 の依頼文では、比べ方を指定していない。それでも、できあがったコードはユーザー名も合言葉も、いったん SHA-256 のハッシュにしてから、常に同じ時間で比べていた。関数名や書き方は頼むたびに変わるが、形はだいたいこうなる。

const okUser = await safeEqual(user, 'guest');
const okPass = await safeEqual(pass, env.SITE_PASSWORD);

文字列を先頭から順に比べると、合っている文字数が多いほど時間がかかる。この差を何万回も測られると、合言葉を1文字ずつ当てられてしまう。常に同じ時間で比べれば、この手が使えなくなる。

ユーザー名と合言葉を両方とも必ず比較しているのも同じ理由。片方が違った時点で打ち切ると、「どちらが違ったか」が応答の速さから分かってしまう。

同じ時間で比べる部分は、crypto.subtle.timingSafeEqual を使う形と、全バイトを自分で突き合わせる形の両方が出てきた。先にハッシュにするのは、長さを揃えるため。長さが違う時点で打ち切ると、合言葉の長さが応答の速さから分かってしまう。

4章ではブラウザで預けた。同じことはコマンドでもできる。ダッシュボードを開かずに済ませたい場合はこちら。ターミナルを開いて、次のコマンドを自分で打つ。Windows はコマンドプロンプト(cmd)を開く(→ Windowsでのセットアップ)。

Terminal window
npx wrangler secret put SITE_PASSWORD

実行するとその場で入力を求められる。貼り付けても画面に表示されず、ターミナルの履歴にも残らないのが、ブラウザで入れるより優れている点。

このコマンドは新しいバージョンをその場で公開するので、入れた時点で反映される(デプロイし直さなくてよい。手元で、合言葉を変えて8秒後には新しいほうで通った)。

⚠️ npx が動かない環境ではここで止まる(Windows の PATH や実行ポリシー)。4章のブラウザ方式なら、どちらも関係ない。

Claudeデスクトップアプリなら、このコマンドを Claude Code に頼むこともできる。値は自分で入力すると添える。

プロンプト
合言葉を Cloudflare のシークレット SITE_PASSWORD に登録して。
値は私がターミナルのタブで入力する

「ターミナルでコマンドを実行します」の許可を求められるので、一度だけ許可 を押す。ターミナルのタブが開いて、値の入力を待つ。タブに合言葉を貼り付けて Enter を押す。Claude Code にも値は見えない。「値は私がターミナルのタブで入力する」を添えないと、Claude Code が値を聞いてきて、コマンドに埋め込むことがある。そうすると値が会話に残る。

Windows の Claudeデスクトップアプリでこの頼み方を試したときは、PowerShell で動いてエラーで止まった(2026年11月)。止まったら、上のコマンドをコマンドプロンプトで打つ。

7-4. なぜユーザー名を Cloudflare に置かないのか

Section titled “7-4. なぜユーザー名を Cloudflare に置かないのか”

4章では、ユーザー名をコードに書いて、Cloudflare には合言葉だけを預けた。理由は2つある。

1つは、隠す意味がないから。ユーザー名は相手に伝えて使ってもらうもので、秘密ではない。秘密でないものを秘密の置き場所に入れても、手間が増えるだけ。

もう1つは、ダッシュボードで入れた平文の変数(Secret にチェックを入れない変数)は、次に wrangler deploy すると消えるのが既定だから(wrangler.jsonc の keep_vars で残せる)。Secret は消えないので、合言葉のほうは残る。消えても、コードに既定値があれば動き続けてしまうので、「設定したはずの値が、いつのまにか使われていない」という形で出る。

この癖を避けたいので、本記事は平文の変数を使わない。Cloudflare に置くのは Secret だけ、秘密でないものはコードに書く、という切り分けにしている。

  • 合言葉が漏れたら、ダッシュボードで SITE_PASSWORD を入れ直すだけでよい(→ §4-3。入れ直した時点で反映されるので、デプロイも要らない)。単一の合言葉方式の数少ない利点
  • 掲示板などのデータを扱うアプリに管理画面を付け、その部分だけを守る例は、管理画面を Cloudflare Access で守るにある(合言葉ではなく Cloudflare Access で守る)