Claude CodeでWebアプリに管理画面を追加して、その部分だけをCloudflare Accessで守る
Cloudflare Accessでサイトに鍵をかけるでは、サイト全体に鍵をかけた。ただ、アプリによっては「ほとんどは誰でも見られてよいが、一部だけは自分しか入れないようにしたい」ことがある。
たとえば D1でデータ共有型Webアプリを作るで作った掲示板。投稿は誰でも読み書きできてよいが、不適切な投稿を非表示にする管理画面は、管理者だけが開けるようにしたい。
管理するのが自分ひとりなら、管理画面を作らずに Claude Code に頼めば足りる(→ ログイン方式の選び方の1-1)。この記事は、複数人で管理する、自分以外の人に運営を任せる、といったときに管理画面を足す手順。
この記事では、掲示板に管理画面を足し、管理画面と、その裏の管理用の API の部分だけに Cloudflare Access をかける。掲示板そのものは、今までどおり誰でも見られる。
本記事の位置付け
Section titled “本記事の位置付け”前提は2つ。
- Cloudflare Accessでサイトに鍵をかけるの3〜5章を済ませている:Zero Trust の初回設定、One-time PIN の追加、ポリシーの作り方。この記事ではもう一度説明しない
- D1でデータ共有型Webアプリを作るの掲示板を、Workers で公開している:Claude Code の作業フォルダは
~/claude/<ベース名>
鍵のかけ方は、サイト全体のときとは別の画面を使う。
| サイト全体(前の記事) | 一部だけ(この記事) | |
|---|---|---|
| 鍵をかける画面 | Worker の Access タブ | Zero Trust の Applications |
| 守る範囲 | その Worker に届くすべての URL | 登録したパス(/admin など)だけ |
| Version URL | まとめて守られる | 別に塞ぐ必要がある(2-2) |
1. 作るもの
Section titled “1. 作るもの”前回作った掲示板に、管理画面(/admin/)を足す。投稿の一覧が並び、1件ずつ表示/非表示を切り替えられる。非表示にした投稿は、掲示板からは見えなくなる。
前回作った掲示板
今回作る管理画面
鍵をかけるのは次の2か所。
| パス | 中身 |
|---|---|
/admin | 管理画面(public/admin/index.html) |
/api/admin | 管理画面が使う API(全件の取得、表示/非表示の切り替え) |
管理画面だけに鍵をかけて API を開けたままにすると、管理画面を通さずに API を直接呼べば、誰でも投稿を非表示にできてしまう。画面と、その画面が使う API はセットで守る(Basic認証でサイトに鍵をかけるの 5-3 と同じ考え方)。
公開用の API(/api/posts)は、今までどおり誰でも使える。
2. 管理画面の場所に、先に鍵をかける
Section titled “2. 管理画面の場所に、先に鍵をかける”管理画面を作る前に、鍵をかけておく。作ってから鍵をかけると、その間だけ管理画面が誰でも開ける状態になるため。鍵は、まだ何も無い /admin にもかけられる。
2-1. パスを登録する
Section titled “2-1. パスを登録する”Zero Trust の左サイドバーで Access controls → Applications を開き、右上の Create new application をクリックする。「Add an application」という画面が出るので、Self-hosted and private が選ばれていることを確かめて、右下の Continue with Self-hosted and private をクリックする。
「Create new self-hosted application」という画面が出る。Destinations(守る場所)の欄には、最初に Private IPs の入力欄が出ているが、これは社内ネットワーク向けなので使わない。下に並ぶボタンから + Add public hostname をクリックすると、Subdomain・Domain・Path の3つの欄に変わる。
| 欄 | 入れるもの |
|---|---|
| Subdomain | <ベース名>(例:my-bbs) |
| Domain | 一覧から <サブドメイン>.workers.dev を選ぶ |
| Path | admin |
もう一度 + Add public hostname をクリックし、2行目は Path を api/admin にする(Subdomain と Domain は1行目と同じ)。
2行入れたところ。下に Access policies の欄がある
/admin を登録すると、/admin/ や /admin/index.html のような、その下のパスもまとめて守られる(手元で確かめた)。
次に、その下の Access policies(誰を通すか)を決める。前の記事で作ったポリシーは Add current policies から選べるが、ここでは管理者用のポリシーを新しく作る。前の記事の5章に書いたとおり、ポリシーを直すとそれを使っているすべての場所に反映されるので、「サイトを見られる人」と「管理画面に入れる人」を同じポリシーにしないほうがよい。
Create new policy をクリックすると、前の記事の5章と同じ入力画面が開く。
| 項目 | 入れるもの |
|---|---|
| Policy Name | admins |
| Include の Selector | Emails |
| Include の Value | 管理者(自分)のメールアドレス |
Save policy をクリックすると、元の画面の Access policies に admins が入る。
さらに下の Authentication の欄は、最初の状態(Accept all available identity providers がオン)のままでよい。前の記事で足した One-time PIN が使われる。
いちばん下の Create をクリックする。Applications の一覧に、<ベース名> のアプリが増える。
2-2. Version URL を塞ぐ
Section titled “2-2. Version URL を塞ぐ”2-1 で登録したのは、公開URL(<ベース名>.<サブドメイン>.workers.dev)の /admin と /api/admin だけ。Workers がデプロイのたびに作る Version URL(前の記事の 2-3)は別のアドレスなので、このままでは守られない。手元で確かめると、Version URL の /admin/ は誰でも開けた。
これを塞ぐには、Worker の Access タブで「プレビューだけ」に鍵をかける。
Cloudflare のダッシュボード → Compute → Workers & Pages → <ベース名> → Access タブを開く。上の Hostname policies の欄に、2-1 で登録した2つのパスが並んでいる。
下の Worker policies にある Enable access をクリックすると、前の記事の6章と同じ Manage Worker access の画面が出る。
| 項目 | 選ぶもの |
|---|---|
| Scope | Previews only(最初に選ばれているまま) |
| Authentication policy | admins |
Apply Access をクリックする。「Previews only」「Require login on preview URLs. Production stays public」と出れば、Version URL には鍵がかかり、公開URLは今までどおり(/admin と /api/admin 以外は誰でも見られる)。
2-3. 鍵の状態を確かめる
Section titled “2-3. 鍵の状態を確かめる”まだ管理画面は無いが、鍵がかかったかどうかは確かめられる。
公開URLの /、/api/posts、/admin/、/api/admin/posts と、いまのバージョンの Version URL の / と /admin/ に curl -I でアクセスして、それぞれの返事のステータスを見せて| URL | 期待する返事 |
|---|---|
公開URLの /・/api/posts | 200(誰でも見られる) |
公開URLの /admin/・/api/admin/posts | 302(ログイン画面へ転送) |
| Version URL は全部 | 302(ログイン画面へ転送) |
/admin/ と /api/admin/posts は、まだ中身が無いので本来なら 404 になるところ。302 になっていれば、中身より先に鍵が働いている。
3. 管理画面を作る
Section titled “3. 管理画面を作る”ここからは Claude Code に頼む。作業フォルダは掲示板の ~/claude/<ベース名>。
3-1. 投稿に「非表示」の印を足す
Section titled “3-1. 投稿に「非表示」の印を足す”投稿ごとに「表示/非表示」を覚えておく列をデータベースに足す。
投稿テーブルに、非表示かどうかを表す hidden 列(整数、初期値 0)を足すマイグレーションファイルを作って。テーブル名は既存のスキーマに合わせて。ファイルは migrations/0002_add_hidden.sql3-2. 管理用の API を足す
Section titled “3-2. 管理用の API を足す”src/index.js に、管理画面用の API を足して。パスは既存の投稿 API に合わせて。1. GET /api/admin/posts:非表示のものも含めて全投稿を返す2. PATCH /api/admin/posts/:id:リクエストの hidden(0 か 1)で、その投稿の hidden 列を更新する3. 公開用の GET /api/posts は、hidden が 0 の投稿だけを返すようにする手元でこの依頼文を渡すと、/api/admin/posts(一覧)と /api/admin/posts/:id(切り替え)が足され、公開用の /api/posts は非表示の投稿を返さない形に変わった。
管理用の API は必ず /api/admin/ の下に置く。 2-1 で鍵をかけたのはこのパスなので、ほかの場所に作ると鍵がかからない。
3-3. 管理画面を作る
Section titled “3-3. 管理画面を作る”管理画面 public/admin/index.html を作って。GET /api/admin/posts で全投稿を一覧にして、1件ずつ表示/非表示を切り替えるボタンを付けたい。非表示の投稿はグレーで表示して。投稿の中身は HTML として解釈されないように表示して。シンプルなデザインで4. 本番に反映して確かめる
Section titled “4. 本番に反映して確かめる”4-1. 反映する
Section titled “4-1. 反映する”3-1 でデータベースの形が変わったので、D1でデータ共有型Webアプリを作るの7-2 と同じく、2つをセットで行う。
- 本番のデータベースにマイグレーションを当てる
本番の D1 データベースに、まだ当てていないマイグレーションを当てて- コードを本番に反映する(ケース1なら「wrangler で Cloudflare に再デプロイして」、ケース2なら「コミットしてpushして」)
4-2. 管理画面に入る
Section titled “4-2. 管理画面に入る”公開URLの /admin/ を開く。前の記事と同じログイン画面が出るので、2-1 で admins に登録したアドレスで、メールに届いたコードを入れて入る。
投稿の一覧が出たら、どれか1件を非表示にしてみる。グレーになり、「非表示」の印が付く。
別のタブで掲示板(/)を開き直すと、その投稿が消えている(手元で確かめた)。
4-3. 管理者以外は入れないことを確かめる
Section titled “4-3. 管理者以外は入れないことを確かめる”2-3 と同じ依頼文で、もう一度確かめる。公開URLの /admin/ と /api/admin/posts が 302、/ と /api/posts が 200、Version URL が全部 302 なら、管理画面を作ったあとも鍵の形は変わっていない。
5. 守れるもの・守れないもの
Section titled “5. 守れるもの・守れないもの”守れるもの
- 管理画面と管理用の API は、
adminsの人しか開けない。 大文字・小文字を変える、スラッシュを重ねる、文字をエンコードする(/Admin/、//admin/、/%61dmin/など)といった、よくあるすり抜け方を20通りほど試したが、どれもログイン画面で止まった(手元で確かめた) - 掲示板そのものは、今までどおり誰でも使える
- Version URL からも入れない(2-2)
守れないもの・気をつけること
- 鍵は「登録したパス」にしかかからない。 管理用の機能をあとから足すときは、必ず
/adminか/api/adminの下に作る。別の場所に作るなら、2-1 のパスも足す - Access の設定を消すと、管理用の API は誰でも呼べるようになる。 前の記事の9章と同じで、サイトの側には「Access が外れたら閉じる」仕組みが無い。この掲示板のように静的ファイルとコードが同居する Worker では、コードの側でログインした人を確かめる
ctx.accessも届かない(前の記事の 10-3) - 2-2 を飛ばすと、Version URL から管理画面が見える。 パスで守るやり方で、見落としやすいところ
- 独自ドメインを足したら、そのドメインのパスも登録する。 2-1 で登録したのは
<ベース名>.<サブドメイン>.workers.devのパスだけ。独自ドメインでも同じ Worker が開けるようにすると、そのドメインの/adminには鍵がかかっていない
- 2-1 の Domain の一覧には、自分のアカウントの
<サブドメイン>.workers.devが出る。独自ドメインを使っている場合は、そのドメインも並ぶ - パスの鍵を作ると、Worker の Access タブの Hostname policies にも表示される(2-2 の画像)。どこに鍵がかかっているかは、Worker の画面からも確かめられる
- Version URL を塞ぐ別の方法として、
wrangler.jsoncに"preview_urls": falseを書いて Version URL そのものを出さない、というやり方もある(手元では試していない) - 以前の版(2026-07 まで)は Cloudflare Pages と Google のログイン(Google Cloud Console)で書いていた。Pages で同じことをする場合も、Zero Trust の Applications でパスを登録する手順は同じ。ただし Pages のデプロイごとの URL(
<ハッシュ>.<プロジェクト名>.pages.dev)も同じように塞ぐ必要がある(試していない)











