コンテンツにスキップ

Claude CodeでWebアプリに管理画面を追加して、その部分だけをCloudflare Accessで守る

Cloudflare Accessでサイトに鍵をかけるでは、サイト全体に鍵をかけた。ただ、アプリによっては「ほとんどは誰でも見られてよいが、一部だけは自分しか入れないようにしたい」ことがある。

たとえば D1でデータ共有型Webアプリを作るで作った掲示板。投稿は誰でも読み書きできてよいが、不適切な投稿を非表示にする管理画面は、管理者だけが開けるようにしたい。

管理するのが自分ひとりなら、管理画面を作らずに Claude Code に頼めば足りる(→ ログイン方式の選び方の1-1)。この記事は、複数人で管理する、自分以外の人に運営を任せる、といったときに管理画面を足す手順。

この記事では、掲示板に管理画面を足し、管理画面と、その裏の管理用の API の部分だけに Cloudflare Access をかける。掲示板そのものは、今までどおり誰でも見られる。

前提は2つ。

鍵のかけ方は、サイト全体のときとは別の画面を使う。

サイト全体(前の記事)一部だけ(この記事)
鍵をかける画面Worker の Access タブZero Trust の Applications
守る範囲その Worker に届くすべての URL登録したパス(/admin など)だけ
Version URLまとめて守られる別に塞ぐ必要がある(2-2)

前回作った掲示板に、管理画面(/admin/)を足す。投稿の一覧が並び、1件ずつ表示/非表示を切り替えられる。非表示にした投稿は、掲示板からは見えなくなる。

匿名一行掲示板。投稿欄と、会員1号のテスト投稿が2件

前回作った掲示板

管理画面。全投稿の一覧と、1件ずつの「非表示にする」ボタン

今回作る管理画面

鍵をかけるのは次の2か所。

パス中身
/admin管理画面(public/admin/index.html)
/api/admin管理画面が使う API(全件の取得、表示/非表示の切り替え)

管理画面だけに鍵をかけて API を開けたままにすると、管理画面を通さずに API を直接呼べば、誰でも投稿を非表示にできてしまう。画面と、その画面が使う API はセットで守る(Basic認証でサイトに鍵をかけるの 5-3 と同じ考え方)。

公開用の API(/api/posts)は、今までどおり誰でも使える。

2. 管理画面の場所に、先に鍵をかける

Section titled “2. 管理画面の場所に、先に鍵をかける”

管理画面を作る前に、鍵をかけておく。作ってから鍵をかけると、その間だけ管理画面が誰でも開ける状態になるため。鍵は、まだ何も無い /admin にもかけられる。

Zero Trust の左サイドバーで Access controls → Applications を開き、右上の Create new application をクリックする。「Add an application」という画面が出るので、Self-hosted and private が選ばれていることを確かめて、右下の Continue with Self-hosted and private をクリックする。

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 を選ぶ
Pathadmin

もう一度 + Add public hostname をクリックし、2行目は Path を api/admin にする(Subdomain と Domain は1行目と同じ)。

Destinations に my-bbs と workers.dev とパス admin、api/admin の2行が入った状態。下に Access policies の欄

2行入れたところ。下に Access policies の欄がある

/admin を登録すると、/admin/ や /admin/index.html のような、その下のパスもまとめて守られる(手元で確かめた)。

次に、その下の Access policies(誰を通すか)を決める。前の記事で作ったポリシーは Add current policies から選べるが、ここでは管理者用のポリシーを新しく作る。前の記事の5章に書いたとおり、ポリシーを直すとそれを使っているすべての場所に反映されるので、「サイトを見られる人」と「管理画面に入れる人」を同じポリシーにしないほうがよい。

Create new policy をクリックすると、前の記事の5章と同じ入力画面が開く。

Create new policy の画面。Policy Name に admins、Include の Emails に管理者のアドレス

項目入れるもの
Policy Nameadmins
Include の SelectorEmails
Include の Value管理者(自分)のメールアドレス

Save policy をクリックすると、元の画面の Access policies に admins が入る。

Access policies の表に admins(Allow)が1行入っている

さらに下の Authentication の欄は、最初の状態(Accept all available identity providers がオン)のままでよい。前の記事で足した One-time PIN が使われる。

いちばん下の Create をクリックする。Applications の一覧に、<ベース名> のアプリが増える。

Applications の一覧に my-bbs(Policies: admins)と、前の記事の my-members-site が並んでいる

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 の Access タブ。Hostname policies に /admin と /api/admin(admins)が並び、下の Worker policies に Enable access ボタン

下の Worker policies にある Enable access をクリックすると、前の記事の6章と同じ Manage Worker access の画面が出る。

Manage Worker access。Scope が Previews only、Authentication policy に admins

項目選ぶもの
ScopePreviews only(最初に選ばれているまま)
Authentication policyadmins

Apply Access をクリックする。「Previews only」「Require login on preview URLs. Production stays public」と出れば、Version URL には鍵がかかり、公開URLは今までどおり(/admin と /api/admin 以外は誰でも見られる)。

Worker Access に Previews only と Require login on preview URLs. Production stays public の表示

まだ管理画面は無いが、鍵がかかったかどうかは確かめられる。

プロンプト
公開URLの /、/api/posts、/admin/、/api/admin/posts と、
いまのバージョンの Version URL の / と /admin/ に curl -I でアクセスして、
それぞれの返事のステータスを見せて
URL期待する返事
公開URLの /・/api/posts200(誰でも見られる)
公開URLの /admin/・/api/admin/posts302(ログイン画面へ転送)
Version URL は全部302(ログイン画面へ転送)

/admin/ と /api/admin/posts は、まだ中身が無いので本来なら 404 になるところ。302 になっていれば、中身より先に鍵が働いている。

ここからは Claude Code に頼む。作業フォルダは掲示板の ~/claude/<ベース名>。

3-1. 投稿に「非表示」の印を足す

Section titled “3-1. 投稿に「非表示」の印を足す”

投稿ごとに「表示/非表示」を覚えておく列をデータベースに足す。

プロンプト
投稿テーブルに、非表示かどうかを表す hidden 列(整数、初期値 0)を足すマイグレーションファイルを作って。
テーブル名は既存のスキーマに合わせて。ファイルは migrations/0002_add_hidden.sql
プロンプト
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 で鍵をかけたのはこのパスなので、ほかの場所に作ると鍵がかからない。

プロンプト
管理画面 public/admin/index.html を作って。
GET /api/admin/posts で全投稿を一覧にして、1件ずつ表示/非表示を切り替えるボタンを付けたい。
非表示の投稿はグレーで表示して。投稿の中身は HTML として解釈されないように表示して。シンプルなデザインで

3-1 でデータベースの形が変わったので、D1でデータ共有型Webアプリを作るの7-2 と同じく、2つをセットで行う。

  1. 本番のデータベースにマイグレーションを当てる
プロンプト
本番の D1 データベースに、まだ当てていないマイグレーションを当てて
  1. コードを本番に反映する(ケース1なら「wrangler で Cloudflare に再デプロイして」、ケース2なら「コミットしてpushして」)

公開URLの /admin/ を開く。前の記事と同じログイン画面が出るので、2-1 で admins に登録したアドレスで、メールに届いたコードを入れて入る。

投稿の一覧が出たら、どれか1件を非表示にしてみる。グレーになり、「非表示」の印が付く。

管理画面。テスト投稿1がグレーになり「非表示」の印と「表示する」ボタン

別のタブで掲示板(/)を開き直すと、その投稿が消えている(手元で確かめた)。

掲示板。テスト投稿2だけが表示されている

4-3. 管理者以外は入れないことを確かめる

Section titled “4-3. 管理者以外は入れないことを確かめる”

2-3 と同じ依頼文で、もう一度確かめる。公開URLの /admin/ と /api/admin/posts が 302、/ と /api/posts が 200、Version URL が全部 302 なら、管理画面を作ったあとも鍵の形は変わっていない。

守れるもの

  • 管理画面と管理用の 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)も同じように塞ぐ必要がある(試していない)