Claude CodeでWebアプリのユーザーアカウント管理を始める
この記事では、メールアドレスもパスワードも使わないアカウント管理を作る。ランダムな鍵(ログインキー)をひとつ発行して、それを持っている人を本人とみなす、いちばん軽い方式。
題材は「みんなの寄せ書き」。同じ寄せ書きを、パスキー(PKA)、ソーシャルログイン(SOL)、メールに届くリンク(MLA)でも作っている。違うのは本人確認の方法だけで、アプリは同じ。
完成イメージ(前の版の画面)。書いた一言が付箋のように並ぶ
Cloudflare Workers と D1 だけで作り、外部のサービスは使わない。無料プランの範囲で動く。
本記事の位置付け
Section titled “本記事の位置付け”ログイン方式の選び方は AUM にまとめてある。特定の少人数に使わせるなら、合言葉(BAU)か Cloudflare Access(CFA)で足りる。この記事は、不特定多数が登録して使うアプリ向けの方式の1つ。
| 方式 | 本人確認を任せる先 | 使う人に求めるもの | 記事 |
|---|---|---|---|
| ログインキー | 本人が保管する文字列 | 文字列を自分で保管すること | この記事 |
| パスキー | 本人の端末 | 対応した端末 | PKA |
| ソーシャルログイン | Google などのサービス | Google などのアカウント | SOL |
| メールに届くリンク | 本人のメール | メールアドレスだけ | MLA |
前提として、D1W で Worker と D1 を一度使ったことがあるものとする。D1 の作成やデプロイの流れはそちらで説明しているので、この記事では認証の部分に絞る。
1. 作るもの
Section titled “1. 作るもの”1-1. みんなの寄せ書き
Section titled “1-1. みんなの寄せ書き”名前と一言を書くと、みんなの寄せ書きに並ぶ。閲覧はだれでもでき、書き込みと編集はログインキーを持っている本人だけができる。
- 初めて書く人に、ログインキーを1つ渡す
- 別の端末でもキーを入れれば、同じ自分として続けられる。キーを渡すリンクも作れる
- キーが漏れたかもしれないときは、本人が作り直せる
1-2. 3つの「名前」を分けて考える
Section titled “1-2. 3つの「名前」を分けて考える”各利用者は、役割の違う3つの識別子を持つ。
| 識別子 | 役割 | 秘密か |
|---|---|---|
| 内部の主キー | データベースが内部で使う、変わらない ID。寄せ書きと本人を結びつける | 秘密ではない(が、むやみに見せない) |
| 表示名 | 寄せ書きに出る名前。本人が決める | 公開 |
| ログインキー | 本人であることの証明。これを持つ人が本人 | 秘密。他人に渡さない |
ログインキーは、表示名でも主キーでもない。合言葉(パスワードのランダム版)であって、データベースの行を指す ID とは別のもの。そのため、キーはサーバーにそのまま保存せず(ハッシュにする)、URL やログに出さない。漏れたら、表示名や寄せ書きを残したまま、キーだけを作り直せる。
表示名を変えても寄せ書きが同じ人のものとして残るのも、この分け方による。表示名で結びつけていたら、名前を変えたときに過去の寄せ書きと切り離される。
1-3. 軽い代わりに弱点もある
Section titled “1-3. 軽い代わりに弱点もある”この方式は、メールもパスワードも要らない代わりに、はっきりした弱点がある。キーが漏れたら、その人になりすませる(だれが使ったかも分からない)。キーは本人も覚えられないので、保管も本人まかせになる。
そのため、向くのは漏れても致命的でない情報を扱うアカウントに限る(寄せ書き、アンケートの回答、趣味の記録など)。強いのは「推測されない」ことであって、「漏れない」ことではない。
もう1つ、どれくらいの頻度で使うサービスかで向き不向きが分かれる。ログインキーは端末の localStorage に置くが、ここは永続的な保存場所ではない。iPhone・iPad のブラウザ(Safari も Chrome も中身は同じ WebKit)と Mac の Safari は、そのサイトを7日ほど開かないでいると中身を消す(→ ブラウザに保存したデータは消える)。
週に何度も開くサービスならキーは実質消えないが、年に数回しか使わないサービスでは、次に開いたときには消えていることが多い。そのとき頼れるのは本人が控えたキーだけで、この方式には復旧の手段がない。作る側にできるのは保存を促すところまで。
年に数回しか使わないサービスなら、この方式は選ばない。メールに届くリンクやソーシャルログインのように、本人確認の手段をアプリの外に持つ方式にする。
2. 名前と仕様を決める
Section titled “2. 名前と仕様を決める”作業フォルダ・D1 データベース・Worker に付ける名前の元になるベース名を決めて、作るものの仕様と一緒に AGENTS.md に書いてもらう。この記事では yosegaki-key を例に使う。
新しく作った作業フォルダ ~/claude/yosegaki-key を Claudeデスクトップアプリで開く。
このプロジェクトのベース名と、これから作るアプリの仕様を、以下のとおり AGENTS.md に書いてください。CLAUDE.md からは AGENTS.md を読み込むようにしてください。====## 名前- ベース名は yosegaki-key- アプリ名・Worker 名・作業フォルダ名 = ベース名- D1データベース名 = ベース名のうしろに -db を付けた名前
## 作るもの:みんなの寄せ書き- 名前と一言を書くと、みんなの寄せ書きに並ぶ- 1人1件。あとから自分の分だけ編集できる- 表示名は本人が決める。あとから変えられる- 閲覧は誰でもできる。書き込みと編集は本人だけ- 画面は上から「みんなの寄せ書き」の一覧、「あなたの寄せ書き」の入力欄、の順に並べる- 寄せ書きは付箋のようなカードを並べ、本文の下に右寄せで名前を出す- ログアウトと、アカウントの削除(自分の寄せ書きも消える)ができる
## ログイン- 本人確認はログインキーで行う。メールアドレスもパスワードも使わない- 別の端末でも使えるように、ログインキーを渡すリンクを作れる- キーが漏れたかもしれないときに、本人がキーを作り直せる- 発行したキーは、ブラウザのパスワード保存機能にも保存できるようにするyosegaki-key を自分のベース名に置き換えて渡す。ベース名はそのまま公開 URL(https://yosegaki-key.<アカウント>.workers.dev)になる。
ログインの節の2行目から4行目は、作ってほしい機能の行。安全のために足した行は無い。何も足さなくても、キーをハッシュで保存する、URL に載せない、といった安全策は Claude Code が入れた(3-1)。
仕様は、ほかの3つの記事と同じ。自分のアプリを作るときは、「作るもの」の節を差し替える。
仕様が書けたら、まとめて作ってもらう。
AGENTS.md の仕様のとおりに、寄せ書きアプリを作って。D1 データベースがまだ無ければ作って。作ったら、ローカルで動かして、ブラウザで開いて、ログインして寄せ書きを書けるところまで確かめて。2行目は、作ったものを Claude Code 自身に試させるための行。「ブラウザで開いて」があると、画面を実際に操作して確かめる。試したときは、すでに開いているタブでキーを渡すリンクを開くとキーが取り込まれない不具合を、Claude Code が自分で見つけて直した。
3-1. 言わなくても入った安全策
Section titled “3-1. 言わなくても入った安全策”この章のプロンプトを決めるときに、Claude Code(Sonnet 5.5)に、ログインの節を1行だけにした仕様から作らせた。安全のための作りは、次のものが入った。
| 安全策 | 何を防ぐか |
|---|---|
| キーは長い乱数で作る(256ビット) | キーを推測して当てられること |
| サーバーにはキーのハッシュだけを保存する | データベースが漏れたときに、キーが出ること |
| キーは URL ではなく、リクエストのヘッダで送る | サーバーやネットワークの途中の記録(アクセスログ)にキーが残ること |
キーを渡すリンクは #key= の形にし、開いたらアドレスバーから消す | # から後ろはサーバーに送られないので、リンクを開いてもログにキーが残らない |
| 発行したキーは1回だけ見せて、保存を促す | 保存しないまま、ログアウトやブラウザの削除でキーを失うこと |
| キーをレスポンスやログに出さない(発行時の1回を除く) | ログや画面から漏れること |
何も足さなくても、これまでの記事でプロンプトに書いていた安全策がそろった。仕様に足した3行(リンク・作り直し・パスワード保存)は機能の行で、どれも1行で記事の機能どおりに入った。
4. 公開する
Section titled “4. 公開する”本番に公開して。D1 の表を本番にも作って。公開すると、https://yosegaki-key.<アカウント>.workers.dev の形の URL が出る。
5. 確かめる
Section titled “5. 確かめる”公開した URL を開いて、表示名を入れて始める。キーが表示されたら保存しておく。
| 確かめること | やり方 | こうなればよい |
|---|---|---|
| 別の端末で同じ自分になれる | シークレットウィンドウで開き、キーを入れる | 自分の寄せ書きを編集できる |
| リンクで渡せる | キーを渡すリンクを、別の端末(またはシークレットウィンドウ)で開く | 同じ自分になり、アドレスバーからキーが消える |
| 表示名を変えても自分のまま | 表示名を変えて保存する | 寄せ書きが自分のものとして残る |
| 作り直せる | キーを作り直し、古いキーで入ってみる | 古いキーでは入れず、新しいキーでは同じ自分 |
| キーを保存していない | 下のプロンプトでデータベースの中を見る | キーそのものが出てこない |
データベースの中は、Claude Code に見てもらう。
本番の D1 の中身を見て、ログインキーがそのまま保存されていないか確かめて。パスワード保存機能の提案が出るかは、ブラウザによって違う。出ないブラウザもあるので、コピーやリンクで控える方法も残しておく。
6. 守れるもの・守れないもの
Section titled “6. 守れるもの・守れないもの”- キーそのものはサーバーに無いので、データベースが漏れてもキーは出ない
- キーは推測では当たらない。256ビットの乱数は、毎秒1兆回試しても全部試し終わらない
- キーが漏れたら、その人になりすませる。気づいたら作り直す。ただし、漏れたキーを手にした人が先に作り直すと、本人のほうが締め出される。漏れても致命的でない情報に限って使う前提での割り切り
- キーをなくして、どの端末にも残っていなければ、その人には戻れない。作り直しは、いまログインしている本人が鍵を差し替える操作で、なくした人を戻す操作ではない
- キーは localStorage にあるので、ページに不正なスクリプトが入り込むと読まれる。画面の表示で、利用者が書いた文字をそのまま HTML として扱わない作り(Claude Code は
textContentで表示した)が前提になる
7. ここから広げる
Section titled “7. ここから広げる”ここまでできると、次のような発展が同じ仕組みで作れる。
- マイページ:自分の寄せ書きだけを一覧する画面。寄せ書きを本人に結びつけてあるので、そのまま作れる
- 1人1件をやめる:何度でも書けるようにして、それぞれを本人だけが編集・削除できるようにする。掲示板に近づく
この方式の弱点(漏れたら終わり、なくしたら戻れない、たまにしか使わないサービスには向かない)が気になるなら、ほかの方式に替える。
- パスキー:端末の指紋・顔・PIN でログインする。漏れる合言葉が無く、回復用コードも持てる → PKA
- ソーシャルログイン:Google などに本人確認を任せる → SOL
- メールに届くリンク:メールを受け取れることで本人を確かめる → MLA
ログインキーの方式で作るときの要点(キーはハッシュで保存する、ヘッダで送る、リンクは #key= にする、発行したキーの保存を促す、など)は、Claude Code のスキル uuid-key-auth にまとめてある。入れ方は AUM の6章にある。
- 2026-10-29 に、工程ごとのプロンプト(データベース・API・画面を順に頼む形)から、仕様を書いて作ってもらう形に作り替えた。あわせて Cloudflare Pages Functions から Workers に移した
- 3章のプロンプトは、Sonnet 5.5 で試した。この記事を書くときに試したのはローカルまでで、作るたびに細かい作りは変わる
- キーを渡すリンク(
#key=)は、すでにそのサイトを開いているタブで開くと、#から後ろが変わるだけでページが読み込み直されない。作りによってはキーが取り込まれない。別の端末で開く本来の使い方では起きない - localStorage はオリジンごとに分かれる。プレビュー用の URL は本番と別のオリジンなので、キーも別になる。案内は本番の URL で
