コンテンツにスキップ

Claude Code でソーシャルログイン(Google・GitHub・X 等)の寄せ書きアプリを作る

⚠️ このハンズオンは作り替えの途中です。2026-10-29 にプロンプトを新しい形にした。Google の画面の画像はそのまま使えるが、アプリの画面の画像は前の版のもので、差し替える予定。

この記事では、ソーシャルログイン(「Google でログイン」のような、すでに持っているアカウントで入る方式)で本人を確かめる「みんなの寄せ書き」を作る。パスワードもメールアドレスも、自分のアプリでは持たない。

題材は「みんなの寄せ書き」。同じ寄せ書きを、ログインキー(ACC)、パスキー(PKA)、メールに届くリンク(MLA)でも作っている。違うのは本人確認の方法だけで、アプリは同じ。

付箋のようなカードで寄せ書きが並び、その下に Google でログインのボタンがある画面

完成イメージ(前の版の画面)。ログインすると自分の分を書いて編集できる

Cloudflare Workers と D1 の無料プランと、Google の無料の OAuth だけで作る。ログインの処理には、実績のあるライブラリ(Hono と @hono/oauth-providers)を使う。

ロードマップの最後の記事。D1W で Worker と D1 を一度使ったことがあるものとして、この記事では認証の部分に絞る。

ログイン方式の選び方は AUM にまとめてある。不特定多数が登録して使うアプリ向けの方式は4つあり、この記事はその1つ。

方式本人確認を任せる先使う人に求めるもの記事
ソーシャルログインGoogle などのサービスGoogle などのアカウントこの記事
パスキー本人の端末対応した端末PKA
ログインキー本人が保管する文字列文字列を自分で保管することACC
メールに届くリンク本人のメールメールアドレスだけMLA

「Google でログイン」「GitHub でログイン」のように、すでに持っているアカウントで別のサービスに入るしくみを、まとめてソーシャルログインと呼ぶ。

会社勤めの経験があれば、SSO(シングルサインオン)を思い浮かべると近い。会社の認証基盤に1回ログインすれば、勤怠や経費精算のシステムにもログインし直さずに入れるしくみ。ソーシャルログインは、その会社のアカウントの代わりに個人の Google や X のアカウントを使う、一般向けの SSO にあたる。

これは機能の呼び名であって、規格の名前ではない。中身を決めているのは次の2つ。

何を担うか
ソーシャルログイン「◯◯でログイン」という機能の呼び名
OAuth 2.0「このアプリに、ここまで許可する」を安全に受け渡すしくみ。もともとは許可(認可)のための規格で、「誰か」を伝えるためのものではない
OpenID ConnectOAuth 2.0 の上に、「この人が誰か」を伝える層を足したもの

この記事が使うのは OpenID Connect のほう。Google に求める情報を openid だけにすると、受け取るのは「この人だ」という結果(sub と呼ばれる、変わらない ID)だけになる。

1-1. 何を任せて、何を受け取るか

Section titled “1-1. 何を任せて、何を受け取るか”

ログインを Google のような信頼できる相手に代行してもらう。この代行してくれる側(Google・GitHub・X など)をプロバイダと呼ぶ。

  • 利用者は Google の画面でログイン・同意し、こちらのアプリにはパスワードを渡さない。アプリは「この人は Google のこのユーザーだ」という結果だけを受け取る
  • だからパスワードを保存しない。メールを送るしくみも要らない
  • アカウントの回復(パスワードを忘れたときなど)も Google が持っている。自分のアプリで回復の手段を作らなくてよい
  • 本人を見分けるのは、プロバイダが返す変わらない ID。メールアドレスではない(7-2)

いきなり全プロバイダを作らず、まず Google だけで一通り動かす。ログイン、投稿、ログアウトが動いたら、X や GitHub を1つずつ足す(9章)。

作るのは、この画面に飛ばすところ。どこかで見たことがあるはずで、これが Google のソーシャルログインの入口になる。

Google のアカウント選択画面

「Google でログイン」を押すと出るアカウント選択画面。この記事で作るアプリからも、これが開く

作業フォルダ・D1 データベース・Worker に付ける名前の元になるベース名を決めて、作るものの仕様と一緒に AGENTS.md に書いてもらう。この記事では yosegaki-sol を例に使う。

新しく作った作業フォルダ ~/claude/yosegaki-sol を Claudeデスクトップアプリで開く。

プロンプト
このプロジェクトのベース名と、これから作るアプリの仕様を、以下のとおり AGENTS.md に書いてください。CLAUDE.md からは AGENTS.md を読み込むようにしてください。
====
## 名前
- ベース名は yosegaki-sol
- アプリ名・Worker 名・作業フォルダ名 = ベース名
- D1データベース名 = ベース名のうしろに -db を付けた名前
## 作るもの:みんなの寄せ書き
- 名前と一言を書くと、みんなの寄せ書きに並ぶ
- 1人1件。あとから自分の分だけ編集できる
- 表示名は本人が決める。あとから変えられる
- 閲覧は誰でもできる。書き込みと編集は本人だけ
- 画面は上から「みんなの寄せ書き」の一覧、「あなたの寄せ書き」の入力欄、の順に並べる
- 寄せ書きは付箋のようなカードを並べ、本文の下に右寄せで名前を出す
- ログアウトと、アカウントの削除(自分の寄せ書きも消える)ができる
## ログイン
- 本人確認は Google でログインする方式(ソーシャルログイン)で行う。パスワードは自分のアプリで持たない
- ログインの処理は Hono と @hono/oauth-providers を使って作る
- Google に求める情報は、本人を見分けるのに要る最小限にする

yosegaki-sol を自分のベース名に置き換えて渡す。ベース名はそのまま公開 URL(https://yosegaki-sol.<アカウント>.workers.dev)になり、Google に登録する URL にも入る。人に見せてよい名前にする。

ログインの節の3行目は、安全のために足した行。これが無いと、Claude Code は Google に名前やプロフィールまで求める作りにすることがある。この1行で、求めるのは openid だけになった(3-1)。2行目は、使うライブラリの指定。OAuth のやり取りを手で書かせず、利用実績のあるライブラリに任せる。

仕様は、ほかの3つの記事と同じ。自分のアプリを作るときは、「作るもの」の節を差し替える。

本記事は Claude Code を例に進めるが、Codex など他のコーディングエージェントでも同じプロンプトで進められる(CLAUDE.md と AGENTS.md の関係は → CLM)。

仕様が書けたら、まとめて作ってもらう。

プロンプト
AGENTS.md の仕様のとおりに、寄せ書きアプリを作って。D1 データベースがまだ無ければ作って。
作ったら、ローカルで動かして、ブラウザで開いて、画面が出るところまで確かめて。Google でのログインは、公開してから試す。

ほかの3つの記事と違い、ここではログインまでは確かめない。Google のクライアント ID とシークレットをまだ作っていないため。ログインは、公開して Google に登録したあと(5章・6章)で試す。手元でもログインを試したいときの手順は 10-1 にある。

この章のプロンプトを決めるときに、Claude Code(Sonnet 5.5)に作らせた。安全のための作りは、次のものが入った。

安全策何を防ぐか
Google に求めるのは openid だけ(足した行による)メールアドレスや名前を受け取って、持ってしまうこと
表示名の初期値に Google の名前を入れない本人が気づかないまま、実名が寄せ書きに出ること
state(ログインの往復の照合)はライブラリに任せる他人が用意したログインの戻りを、本人のものとして受け付けること
Google から受け取ったトークンは保存しないデータベースが漏れたときに、Google 側の権限まで出ること
ログイン状態は、長い乱数を Cookie に入れ、データベースにはハッシュだけを保存するデータベースが漏れたときに、そのままログイン状態を使われること
Cookie に HttpOnly・Secure・SameSite=Lax を付けるページのスクリプトや、ほかのサイトからのリクエストに使われること
書き込みのリクエストは、送り元(Origin)が自分のサイトのときだけ受け付けるほかのサイトから、本人になりすまして書き込まれること(CSRF)
公開の一覧には、名前と一言と更新時刻だけを出す内部の ID や Google の ID が外に出ること
書かれた文字は HTML として扱わずに表示する寄せ書きにスクリプトを仕込まれること

試したときは、PKCE(ログインの往復をもう一段固くするしくみ)は入らなかった。@hono/oauth-providers 0.9.1 の Google 用の処理が対応していないため。state の照合と、クライアントシークレットをサーバー側だけで持つ作りで守っている。

プロンプト
本番に公開して。D1 の表を本番にも作って。
Google から受け取る2つ以外に要るシークレットは、値も作って本番に入れておいて。
公開したら、Google に登録するリダイレクト URI と、クライアント ID とシークレットを入れる変数の名前を教えて。

公開すると、https://yosegaki-sol.<アカウント>.workers.dev の形の URL が出る。この時点ではまだログインできない。Google 側の登録とシークレットがまだ無いため。

Claude Code が教えてくれた2つを控えておく。

  • リダイレクト URI:Google でログインしたあとに戻ってくる URL。公開した URL のうしろに /auth/google や /api/auth/google などが付いた形になる
  • 変数の名前:試したときは GOOGLE_ID と GOOGLE_SECRET(2026 年 9 月)、GOOGLE_CLIENT_ID と GOOGLE_CLIENT_SECRET(2026 年 11 月)だった。作るたびに変わることがあるので、教わった名前を使う

2026 年 11 月に試したときは、Claude Code がログイン状態の Cookie に署名する鍵(SESSION_SECRET)を自分で作り、本番にも入れていた。ところが同じ月のオフ会では、「SESSION_SECRET は自分で入れて」と返された人がいて、入れないまま進んだ人は 6-2 でログインがエラーになった。プロンプトの2行目は、これを防ぐための1行。それでも自分で入れるよう言われたら、「その値も作って本番に入れて」と頼む。自分で入れるのは、Google から受け取る2つだけでよい。

5. Google 側で OAuth クライアントを作る

Section titled “5. Google 側で OAuth クライアントを作る”

Google のログインを使うには、Google Cloud Console(認証まわりは「Google Auth Platform」に整理されている)で OAuth クライアントを1つ作り、クライアント ID とクライアントシークレットを受け取る。以下は 2026 年 9 月時点の実際の画面。

UI は変わりうる:Google のコンソールは頻繁に画面が変わる。ボタン名が違ったら、同じ意味の項目を探して読み替える。

5-1. 初めて Google Cloud を使うとき

Section titled “5-1. 初めて Google Cloud を使うとき”

そのアカウントで Google Cloud Console を初めて開くと、トップページにかぶさって「〈アカウント名〉 へようこそ」というダイアログが出る。国(日本)を確認し、「同意して続行」を押す。クレジットカードの登録は求められない。

チェックボックスは2つあり、どちらも最初は外れている。入れるのは上だけでよい。

チェック扱い
利用規約(Google Cloud Platform の利用規約 および 適用されるサービスと API の利用規約に同意します)入れる。これを入れないと先へ進めない
最新情報に関する通知メール入れない。Google やパートナーからの案内メールを受け取るだけの任意項目

Google Cloud の初回ダイアログ。国の選択、利用規約と通知メールのチェック、同意して続行のボタン

初回だけ出るダイアログ。チェックは2つとも外れた状態で開き、利用規約に入れるまで「同意して続行」は押せない

無料トライアルの帯は押さなくてよい。画面の上部に「$300 相当の無料トライアルをご利用ください」の帯と「無料で利用」のボタンが、ページの中にも「無料トライアルを試す」のボタンが出るが、押すとクレジットカードの登録に進む。OAuth クライアントの作成に課金は要らないので、このハンズオンでは最後まで使わない。

「割り当て内の残りのプロジェクト数は ◯ projects 件です」という警告が出ることがある。プロジェクトをいくつまで作れるかの残数で、数はアカウントによって違う(手元では別々のアカウントで 12 と 17 だった)。このハンズオンで作るのは1つなので気にしなくてよい。

Google Cloud Console を開き、「新しいプロジェクト」で、プロジェクト名(例:yosegaki-sol)を入れて作成する。作成の画面を直接開くなら https://console.cloud.google.com/projectcreate。

プロジェクト名には My Project 22604 のような既定値が最初から入っている。消してから自分のベース名を入れる。入れ直すと、下の「プロジェクト ID」もその名前になる。ID は「後で変更することはできません」と書かれているが、このハンズオンでは使わないので気にしなくてよい。同じ ID がすでにあると、yosegaki-sol-514607 のようにうしろに数字が付く。付いたままでよい。

「組織」「親リソース」の欄は「組織なし」のままでよい。会社などの Google Workspace に属していないアカウントでは、これ以外を選べない。アカウントによっては「組織」の欄自体が出ない。

新しいプロジェクトの作成画面。プロジェクト名にベース名を入れた状態

プロジェクト名に自分のベース名を入れる。プロジェクト ID も同じ名前になる

🚨 作っただけでは、そのプロジェクトに切り替わらない。 画面上部のプロジェクト選択は前に見ていたプロジェクトのままなので、明示的に切り替える。作成直後なら、右上の通知に出る「プロジェクトを選択」を押すのが早い。ここを飛ばすと、別のプロジェクトを設定してしまう。

作成完了の通知。プロジェクトを選択のリンクがある

作成の通知から「プロジェクトを選択」で切り替える

次の URL を直接開くのが確実。

https://console.cloud.google.com/auth/overview

新しいプロジェクトでは「Google Auth Platform はまだ構成されていません」と出るので「開始」を押す。

なぜメニューから辿らずに URL を開くのか。Google Auth Platform は左メニューの初期表示に出ていないことがあるうえ、ホームのダッシュボードには常設の左メニューがそもそも無い。URL で開けばどちらも関係なく着き、着いた先ではその画面用の左メニューが出る。メニューから辿るなら、「すべてのプロダクトを表示」の中に「Google Auth Platform」がある。

⚠️ 画面上部のプロジェクト選択が、5-2 で作ったプロジェクトになっているか確認する。URL を直接開いた場合も、表示されるのは「いま選ばれているプロジェクト」の設定。URL の末尾に ?project=<プロジェクト ID> が付いていれば、そのプロジェクトが選ばれている。

Google Auth Platform 未構成の画面。左に概要・ブランディング・対象・クライアントなどのメニューがある

まだ構成されていない状態。「開始」から設定する

この画面の左メニューが、以降の行き先になる。テストユーザーの登録(5-4)は「対象」、OAuth クライアントの作成(5-5)は「クライアント」で行う。

「開始」を押すと「プロジェクト構成」という4ステップのウィザードが開く。上から順に埋め、各ステップの「次へ」で下に進み、最後に「作成」を押す。

ステップ入れるもの
①アプリ情報アプリ名(例:みんなの寄せ書き。ログインの同意画面に出る名前)と、ユーザー サポートメール(自分のアドレスを選ぶ)
②対象「外部」を選ぶ
③連絡先情報メールアドレス(自分のアドレス。プロジェクトの変更を Google が知らせるのに使う)
④終了「Google API サービス: ユーザーデータに関するポリシーに同意します。」にチェックして「続行」

プロジェクト構成のウィザード。アプリ情報にアプリ名とサポートメールを入れた状態

4ステップのウィザード。①にアプリ名とサポートメールを入れ、「次へ」で②に進む

②の「対象」は「外部」を選ぶ。「内部」は組織(Google Workspace)のアカウント向けなので、個人の Gmail では選べない。「外部」を選ぶと、アプリはテストモードで始まり、テストユーザーに追加した人だけが使える状態になる(5-4)。

対象の選択。内部と外部のラジオボタン

「外部」を選ぶ。テストモードで始まり、テストユーザーだけが使える状態になる

作成すると「OAuth の構成を作成しました。」と出て、「OAuth クライアントを作成」のボタンが現れる。

OAuth の構成が作成され、OAuth クライアントを作成のボタンが出た状態

構成が完了した状態。ここから OAuth クライアントの作成に進める

⚠️ 「アプリの OAuth 構成が完了していません」という警告が出るが、このまま進めてよい。 「対象」ページの上部に「不足している情報を入力する必要があります。[ブランディング] ページにアクセスしてください」と出ることがある。ブランディングを開くと、必須(*)の項目はウィザードで入れた値で埋まっていて、「保存」も押せない。不足しているのはロゴ・ホームページ・プライバシーポリシー・利用規約という、公開(審査)のための任意項目。テストモードで動かすぶんには要らない。ホームページ・プライバシーポリシー・利用規約は、最後に本番へ切り替えるとき(6-4)に入れる(同じ画面にも「公開ステータスが『テスト中』の場合は、送信は不要です」と書かれている)。この警告が出たままでも、OAuth クライアントは作れる(手元で確認済み)。

外部=テストモードのアプリは、原則としてテストユーザーに登録した Google アカウントしか使えない。本番に切り替えるまでは自分だけが入れればよいので、「対象」ページのテストユーザーで「Add users」を押し、自分の Google アカウントのメールを追加しておく。

「対象」ページ。公開ステータス・ユーザーの種類・OAuth ユーザー数の上限・テストユーザー

「対象」ページ。ここでテストユーザーを足す。上の「公開ステータス」と「OAuth ユーザー数の上限」もあとで関わってくる

テストのあいだにほかの人にも試してもらうなら、その人のアカウントもここに足す。足していないアカウントは「アクセスをブロック」と弾かれることがある。

同じ画面の上部にある「公開ステータス:テスト中」と「OAuth ユーザー数の上限」も見ておく。テスト中のあいだはテストユーザーしか使えず、「アプリの確認前の許可済みユーザー数の上限は 100 で、この上限はアプリの全期間でカウントされる」と書かれている。

ログインを試すあいだはテストモードのままでよい。誰でも使えるようにするには、最後にこの画面の「アプリを公開」で本番に切り替える(6-4)。

左メニューの「クライアント」を開き、「+ クライアントを作成」を押す(5-3 の完了画面から「OAuth クライアントを作成」で来てもよい)。アプリケーションの種類で「ウェブ アプリケーション」を選ぶ。

アプリケーションの種類を選ぶドロップダウン

「ウェブ アプリケーション」を選ぶ

「このクライアントを AI 搭載エージェントに使用する」のチェックは外したままでよい。2026 年 11 月に増えていた項目で、この記事のアプリには関係しない。

名前には「ウェブ クライアント 1」という既定値が入っているので、消して自分の名前を入れる(例:yosegaki-sol-web)。この名前はコンソールで見分けるためだけのもので、ログインする人には表示されない。

クライアント名を入れた状態。承認済みドメインが自動追加されるという注記がある

名前を入れる。既定値は消してよい

「承認済みの JavaScript 生成元」は空のままでよい。ブラウザから直接 Google を呼ぶ作りのときに使うもので、この記事のアプリは Worker 側で受けるので要らない。

ブランディングの「承認済みドメイン」は、いまは埋めなくてよい。ログインを試すだけなら要らない。本番に切り替えるとき(6-4)に入れる。

「承認済みのリダイレクト URI」の「+ URI を追加」で、4章で Claude Code が教えてくれたリダイレクト URI をそのまま入れる。

承認済みのリダイレクト URI を入力した状態。設定の反映に時間がかかるという注記がある

リダイレクト URI を登録して「作成」(画像は前の版の URI)

⚠️ リダイレクト URI は1文字でも違うと通らない。スラッシュ・http と https・ポートまで、アプリが使う URL と完全に一致している必要がある。違うと Google が redirect_uri_mismatch を返す。

🚨 登録してもすぐには効かないことがある。同じ画面に「設定が有効になるまで 5 分から数時間かかることがあります」と書かれている。URL が合っているのに redirect_uri_mismatch が出るときは、少し待ってから試す。

5-6. クライアント ID とシークレットを控える

Section titled “5-6. クライアント ID とシークレットを控える”

作成すると「OAuth クライアントを作成しました」のダイアログが出て、クライアント ID とクライアント シークレットが並ぶ。右のコピーアイコンで写すか、ダイアログの一番下にある「JSON をダウンロード」で両方まとめて落とす(下までスクロールしないと見えない)。

この2つは扱いが違う。

あとから見られるか
クライアント ID見られる。画面にも「Google Auth Platform の [クライアント] タブでいつでも確認できます」とある
クライアント シークレット🚨 見られない。「このダイアログを閉じると、クライアント シークレットを表示およびダウンロードできなくなります」と書かれている

OAuth クライアント作成完了ダイアログ。クライアント ID とクライアント シークレットが並ぶ

作成完了。閉じる前にシークレットをコピーする。「JSON をダウンロード」は一番下にある

シークレットを控えずに閉じたら、追加で発行する。クライアント詳細の「クライアント シークレット」で「シークレットを追加(Add secret)」を押して新しいものを作る。クライアントごと作り直す必要はない。

受け取った値は秘密なので、コードに書かず、Claude Code にも貼らない。次の章で、Cloudflare のダッシュボードから Worker に入れる。

6. シークレットを入れて、確かめる

Section titled “6. シークレットを入れて、確かめる”

6-1. クライアント ID とシークレットを入れる

Section titled “6-1. クライアント ID とシークレットを入れる”

5-6 で控えた2つの値を、Cloudflare のダッシュボードから入れる。ブラウザだけで完結し、2つまとめて入れられる。ターミナルのコマンドで入れたい場合は 10-3 にある。

  1. 左メニューの Compute → Workers & Pages を開き、自分の Worker(ベース名)を選ぶ
  2. Settings タブ → 「Runtime variables and secrets」の「+ Add variable」
  3. 「Add environment variable」のダイアログで、Key に4章で教わったクライアント ID 用の名前(GOOGLE_ID や GOOGLE_CLIENT_ID など)、Value にクライアント ID を入れ、Value 欄の右にある「Secret」にチェックを入れる
  4. 「+ Add」で行を足し、2つ目にシークレット用の名前(GOOGLE_SECRET や GOOGLE_CLIENT_SECRET など)とクライアントシークレットを入れる(こちらも「Secret」にチェック)
  5. 「Add 2 variables and deploy」を押す(数字は入れた行の数)

Settings タブの Runtime variables and secrets のセクション

Settings タブを開いた直後に出る「Runtime variables and secrets」。ここの「+ Add variable」から入れる

環境変数を追加するダイアログ。Key と Value の欄、右に Secret のチェックボックス

2つまとめて入れた状態。どちらも「Secret」にチェックが入っている

自分で入れていないシークレットが並んでいても消さない。4章で Claude Code が入れたもの(SESSION_SECRET など)で、消すとログインできなくなる。

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

なぜブラウザで入れるか。wrangler secret put でも入るが、対話プロンプトを出せない環境で実行すると、値が空のまま Success と表示されることがある。シークレットは書き込み専用で、入った値を後から読んで確かめられないので、空で入ったことに気づけない。ダッシュボードなら入力欄に値が見えている。

このボタンで、デプロイまで済む(ボタン名の「and deploy」)。2026 年 9 月のボタンは「Add 2 variables」で、入れただけでは動いている Worker に反映されなかった。ボタンに「and deploy」が無いときや、ログインを押して Required parameters were not found. Please provide them to proceed. と出たときは、Claude Code に「デプロイして」と頼む。入れたシークレットは、次にデプロイしても消えない。

公開した URL を開き、「Google でログイン」を押すと、Google のアカウント選択画面に飛ぶ。

スマホの Safari のように Google にまだログインしていないブラウザでは、その前に Google へのログインを求められる。Google アカウントにパスキーを登録してあれば、顔認証などで通る。これは Google アカウントに入るためのパスキーで、このアプリがパスキーでログインしているわけではない。

⚠️ アプリ名ではなく、ドメイン名が表示される。「<アカウント>.workers.dev に移動」のように出て、5-3 で設定したアプリ名は出てこない。アプリの確認(審査)を受けていないためで、6-4 で本番に切り替えたあとも同じだった。間違っていないので、そのまま進めてよい。

アカウントを選ぶと、続行の確認が出る。openid だけを求めているので、許可する項目は「Google で公開されているお客様の個人情報とお客様を関連付ける」の1つだけ。名前やメールアドレスを渡す確認は出ない。ここで「アクセスをブロック」と出たら、5-4 でテストユーザーに足したアカウントで入っているかを見る。

アプリへのアクセス許可の同意画面

openid だけなので、許可する項目は1つだけ。名前もメールも渡さない

アプリに戻ると、ログイン状態になる。名前の欄に Google の名前は入っていない。自分の名前と一言を入れて保存すると、寄せ書きに自分のカードが並ぶ。

投稿が寄せ書きに並んだ画面

投稿が寄せ書きに反映される。下に入力欄と、ログアウト・アカウントを削除のボタンが出る

ログインでエラーになったら、出たものに合わせて次を確かめる。

出たもの確かめること
「アクセスをブロック」5-4 でテストユーザーに足したアカウントで入っているか
Required parameters were not foundシークレットを入れたあとにデプロイしたか(6-1)。Claude Code に「デプロイして」と頼む
Internal Server Error など6-1 の一覧に、4章で教わった変数がそろっているか。SESSION_SECRET のように、Google の2つ以外にも要ると言われていないか

2026 年 11 月のオフ会では、SESSION_SECRET が入っていなかった4人がログインでエラーになり、入れたら全員ログインできた。原因がいつもこれとは限らないが、最初に確かめる。どれでもなければ、出た画面をそのまま Claude Code に伝えて、原因を調べてもらう。

確かめることやり方こうなればよい
閲覧はだれでもシークレットウィンドウでトップを開く寄せ書きは見えるが、入力欄は出ない
1人1件もう一度保存するカードが増えず、上書きされる
同じアカウントは同じ人ログアウトして、同じアカウントで入り直す自分の寄せ書きを編集できる
ログアウトログアウトする一覧だけが見え、入力欄が消える
アカウント削除アカウントを削除する自分の寄せ書きが一覧から消える
個人情報を持っていない下のプロンプトでデータベースの中を見るメールアドレスも Google の名前も無い
プロンプト
本番の D1 の中身を見て、メールアドレスや Google の名前が保存されていないか確かめて。

ここまでの状態では、Google 側はテストモードのまま。使えるのは原則としてテストユーザーに登録した人だけで、その上限は 100 人(アプリの全期間で通算)。誰でもアカウントを作れる寄せ書きにするには、Google の設定を本番に切り替える。

本番に切り替える「アプリを公開」のボタンは、ブランディングにホームページ・プライバシーポリシー・利用規約のリンクを入れるまで押せない(灰色のまま「アプリを公開するには、[ブランディング] ページで構成を完了する必要があります」と出る)。そこで、まずアプリにその2つのページを足してもらう。

プロンプト
Google のログインを本番に切り替えるために、プライバシーポリシーと利用規約のページを作って、ログインしなくても開けるようにして。
プライバシーポリシーには、Google から何を受け取り、何を保存し、どうすれば消せるかを書いて。
作ったら本番に公開して、それぞれの URL を教えて。

公開したら、Google Auth Platform の左メニューの「ブランディング」を開く。「アプリのドメイン」の3つの欄に URL を入れる。

欄入れる URL
アプリケーションのホームページ公開した URL(例:https://yosegaki-sol.<アカウント>.workers.dev/)
[アプリケーション プライバシー ポリシー] リンク教わったプライバシーポリシーの URL
[アプリケーション利用規約] リンク教わった利用規約の URL

ブランディングのアプリのドメイン。ホームページ、プライバシーポリシー、利用規約の3つの欄に URL を入れた状態

「アプリのドメイン」の3つの欄に、公開した URL と2つのページの URL を入れる

入れただけでは「保存」が押せない。下の「承認済みドメイン」に「次のドメインが見つかりません: 〈アカウント〉.workers.dev」と赤字で出る。「+ ドメインの追加」を押し、出てきた「承認済みドメイン 1」の欄に <アカウント>.workers.dev を入れる(https:// も末尾の / も付けない)。赤字が消えて「保存」が押せるようになる。

承認済みドメインに ytolabo.workers.dev を追加し、保存のボタンが押せるようになった状態

承認済みドメインに <アカウント>.workers.dev を足すと「保存」が押せる

保存したら、左メニューの「対象」を開き、「公開ステータス」の「アプリを公開」を押す。「本番環境に push しますか?」と出るので「確認」を押す。

本番環境に push しますか?のダイアログ。キャンセルと確認のボタン

「確認」を押すと、Google アカウントを持つ人なら誰でも使える状態になる

公開ステータスが「本番環境」になり、ボタンは「テストに戻る」に変わる。

対象ページ。公開ステータスが本番環境になり、テストに戻るのボタンがある

本番環境になった。テストモードに戻すときは「テストに戻る」

openid だけを求めるアプリなので、審査は求められず、その場で本番になる(2026 年 11 月に確認)。ブランディングのロゴは入れない。入れると、Google の確認(審査)を受ける必要があると画面に出る。

切り替えたら、テストユーザーに登録していない Google アカウントでログインできるかを確かめる。書き込むと、自分とは別の人としてカードがもう1枚増える。ログインの画面には、アプリ名ではなく <アカウント>.workers.dev が出たままで、その下にブランディングで入れたプライバシーポリシーと利用規約へのリンクが加わる。

寄せ書きにカードが2枚並び、下に自分の寄せ書きの入力欄、ログアウトとアカウントを削除のボタンがある画面

テストユーザーに登録していないアカウントで入り、書き込んだ。カードが2枚になった

「◯◯でログイン」を載せる手軽な方法は Cloudflare Access だが、無料枠が50ユーザーで、その先は1ユーザーごとの課金になる。個人やコミュニティの無料アプリでは、人が増えるほどコストが増えて使いづらい。

50人の壁は Access という製品の制限であって、外部サービスでログインさせること自体の制限ではない。Google も GitHub も OAuth ログインに課金しないので、OAuth を自分の Worker に作れば無料・人数無制限になる。Cloudflare Access が対応していない X(Twitter)のようなプロバイダも扱える。

自前といっても、OAuth の難所(認可へのリダイレクト、state の照合、トークンの交換)は @hono/oauth-providers に任せる。プロバイダを差し替えるだけで Google でも GitHub でも X でも同じ形で書けるのが、このライブラリの利点。

認証の載せ方無料の上限コストのかかり方対応プロバイダ
Cloudflare Access50ユーザー人数で増えるGoogle/GitHub/Facebook/LinkedIn ほか(X は無い)
ソーシャルログインを自前で(この記事)無制限一定(Workers と D1 の無料枠から数ドル)Google/GitHub/X/Facebook/LinkedIn ほか

本サイトのハンズオンは、個人情報をできるだけ持たないことを基本方針にしている。作って運用するのが IT に不慣れな人であることを想定しているため。個人情報を持つほど、漏れたときの被害も、個人情報保護法の上での責任も重くなる。

ソーシャルログインは、この方針と相性がよい。

  • 本人を見分けるのに要るのは、プロバイダが返す変わらない ID(Google なら sub)だけ。メールアドレスは寄せ書きに使わない。だから Google に求める情報を openid だけにして、「保存しない」ではなく「そもそも受け取らない」ところまで進める
  • 表示名も Google の名前を初期値にしない。実名を出したい人だけが出せばよい

結果、このアプリが持つ個人に関わる情報は、Google の ID(それ単体では個人に結びつかない)と、本人が自分で決めた表示名だけになる。

この方針を、仕様の1行(「Google に求める情報は、本人を見分けるのに要る最小限にする」)で Claude Code に伝えている。この行が無いと、名前やプロフィールまで求める作りになることがある。

「取っていない」は、利用者に確かめてもらえる。アプリが何を受け取るかは、ログインを押す前に Google の同意画面に出る。Google が出す画面なので、作る側の説明より強い材料になる。

この記事のアプリは openid しか求めないので、出るのは「Google で公開されているお客様の個人情報とお客様を関連付ける」の1項目だけ(6-2 の画面)。メールアドレスも取るアプリだとどう変わるかを、同じクライアントのまま、求める情報だけを変えて確かめた。

scope に openid と email を要求したときの同意画面。メールアドレスの項目が1つだけ並んでいる

openid に email を足したとき。項目は1つのままで、中身が本人のメールアドレスに変わる

scope に openid と email と profile を要求したときの同意画面。名前とプロフィール写真、メールアドレスの2項目が並んでいる

さらに profile を足したとき。項目が2つに増え、上に名前とプロフィール写真が出る

利用者に確かめてもらうなら、次のように伝える。

同意画面のリストに、自分のメールアドレスが表示されているかどうかを見る。出ていればアプリが受け取る。出ていなければ受け取らない。

ここまでで動くものはできている。いま作ったログインの中で何が起きていたのか、どこをライブラリが守り、どこを自分のアプリが守っているのかを押さえておく。

作る側から見た流れを図にする。「寄せ書きアプリ」は、この記事で作って公開した Worker のこと。

sequenceDiagram
  participant B as ブラウザ
  participant W as 寄せ書きアプリ(Worker)
  participant G as Google など
  B->>W: 1. ログイン開始
  W->>B: 1. Google へリダイレクト(state 付き)
  B->>G: 2. 利用者が同意
  G->>B: 2. code を付けて戻す
  B->>W: 2. code を届ける
  W->>G: 3. code とシークレットを送る
  G->>W: 3. ユーザー情報
  W->>B: 4. ログイン状態の Cookie
  1. 利用者が「Google でログイン」を押す。寄せ書きアプリが Google の認可画面へリダイレクトする(state を付ける)
  2. 利用者が同意すると、Google がリダイレクト URI に一時的な code を付けて戻す
  3. 寄せ書きアプリが code をクライアントシークレットと一緒に交換し、ユーザー情報を受け取る
  4. 寄せ書きアプリが D1 で利用者を作るか引くかして、自分のアプリのログイン状態(Cookie)を発行する

1〜3 の往復は @hono/oauth-providers が受け持つ。4 は自分のアプリの部分で、プロバイダが変わっても形は同じ。

受け持つ側守っているもの
ライブラリ認可へのリダイレクト、state の生成と照合、code とトークンの交換、ユーザー情報の取得
自分のアプリクライアントシークレットを秘密に保つ、求める情報を最小にする、本人を見分ける値(プロバイダの ID)、ログイン状態の Cookie、公開の一覧に内部の情報を混ぜない
自分(Google 側の設定)リダイレクト URI を正確に登録する、テストモードと本番の切り替え

Google が動いたら、ほかのプロバイダを1つずつ足せる。@hono/oauth-providers は同じ書き方で複数のプロバイダを扱えるが、返ってくるユーザー情報はプロバイダごとに違う。この記事は本人を見分ける ID と、本人が入れる表示名しか使わないので、気にするのは「ID がどの値か」だけ。

プロバイダ本人を見分ける値メールアドレス
Googleid(sub)求めれば返る
GitHubid返らないことがある
X(Twitter)id返らない
Facebookid求めれば返る
LinkedInsub求めれば返る

メールアドレスを取らない方針なので、「返らない」「確認されていない」といったプロバイダの差は気にしなくてよい。

注意が1つある。同じ人でもプロバイダが違えば別のアカウントになる。Google の 12345 と GitHub の 12345 は別人として扱う必要があり、Google で入った人が後日 GitHub で入ると、新しいアカウントになる。

X を足すなら、まず X Developer Portal で OAuth 2.0 のアプリを作ってリダイレクト URI を登録し、クライアント ID とシークレットを 6-1 と同じようにダッシュボードから入れる。そのうえで頼む。

プロンプト
X(Twitter)でもログインできるようにして。X に求める情報も、本人を見分けるのに要る最小限にする。
Google の利用者と X の利用者が、同じ ID の値でも別人として扱われるようにして。

2行目は、上の注意を Claude Code に伝える行。いま Google の ID だけを持つ作りになっていれば、プロバイダの名前も一緒に持つ形に直す。

10. セキュリティの要点と備忘録

Section titled “10. セキュリティの要点と備忘録”
  • state の照合とトークンの交換はライブラリに任せる。OAuth の往復を手で書かない
  • クライアントシークレットは Worker のシークレットに入れる。コード・画面・リポジトリに置かない
  • リダイレクト URI は登録と完全一致。ローカルでも動かすなら、ローカルの分も登録する
  • Google に求める情報は openid だけ。メールアドレスも名前も受け取らず、保存もしない
  • 表示名は本人が入れる。プロバイダが返す実名を勝手に出さない
  • ログイン状態はサーバーが発行する Cookie で持つ。localStorage に置かないので、Safari が localStorage を消す件(→ ブラウザに保存したデータは消える)の影響も受けない
  • アカウントを削除して同じ Google で入り直すと、新しいアカウントになる(前の寄せ書きは戻らない)

10-1. ローカルでもログインを試すなら

Section titled “10-1. ローカルでもログインを試すなら”

この記事は、公開した本番でログインを試す手順にしてある。手元の wrangler dev でもログインを試したいなら、次の3つが要る。ダッシュボードに入れたシークレットは、手元には来ないため。

  1. Google のクライアント設定(5-5)に、ローカルのリダイレクト URI(http://localhost:8787/auth/google のような形)も足す
  2. 作業フォルダの .dev.vars に、クライアント ID とシークレットを書く。値はクオートで囲まない。.gitignore に入っているかを確かめる
  3. Claude Code に頼む
プロンプト
.dev.vars に Google のクライアント ID とシークレットを入れた。ポートを 8787 に固定してローカルで動かして。

ポートを固定するのは、リダイレクト URI がポートまで完全一致でないと通らないため。wrangler dev の既定は 8787 だが、別のプロジェクトが使っていると 8788 などに変わる。

  • プライバシーポリシーと利用規約の中身:6-4 で足したページは、Google の本番切り替えのためのひな形。人に使ってもらうなら、自分の運用に合わせて読み直す
  • プロバイダ側の連携の解除:アプリのアカウントを削除しても、Google 側の「このアプリへのアクセス許可」は残る。完全に切りたい人には、Google のアカウント設定で連携を解除してもらう
  • アカウント連携:同じ人が別のプロバイダで入ると別アカウントになる。1人にまとめたいなら、ログイン中に「別のログイン方法を追加」する仕組みを足す
  • 期限切れのログイン状態の掃除と、レート制限

ログインを外部サービスに預けたくないなら、端末の指紋・顔・PIN でログインするパスキー(PKA)もある。

10-3. シークレットをコマンドで入れる

Section titled “10-3. シークレットをコマンドで入れる”

6-1 ではブラウザで入れた。同じことはコマンドでもできる。ターミナルを開き、作業フォルダ(この記事では yosegaki-sol)に移動してから、次のコマンドを自分で打つ。Windows はコマンドプロンプト(cmd)を開く(→ Windowsでのセットアップ)。変数の名前は、4章で Claude Code が教えてくれたものに合わせる。

Terminal window
npx wrangler secret put GOOGLE_ID

実行するとその場で値の入力を求められるので、クライアント ID を貼り付けて Enter を押す。貼り付けた値は画面に表示されず、ターミナルの履歴にも残らない。続けて、シークレットも同じように入れる。

Terminal window
npx wrangler secret put GOOGLE_SECRET

このコマンドは入れるたびに新しいバージョンを公開するので、デプロイし直さなくてよい(→ BAU の 7-3)。

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

プロンプト
Google のクライアント ID とシークレットを、Cloudflare のシークレット GOOGLE_ID と GOOGLE_SECRET に登録して。
値は私がターミナルのタブで入力する

ターミナルのタブが開いて、Enter a secret value: と値の入力を待つ。タブに値を貼り付けて Enter を押す。2つ目も同じように入れる。Claude Code にも値は見えない。

「値は私がターミナルのタブで入力する」を添えないと、Claude Code が値を聞いてきて、コマンドに埋め込むことがある。そうすると値が会話に残る。6-1 の「なぜブラウザで入れるか」に書いた「値が空のまま Success と表示される」も、Claude Code が入力を求められない形でコマンドを実行したときに起きる。自分でターミナルに打つか、ターミナルのタブで入力を待たせれば当たらない。

10-4. Google Cloud のプロジェクトを消す

Section titled “10-4. Google Cloud のプロジェクトを消す”

試しに作ったプロジェクトや、既定の名前(My Project 94061 のような形)のまま残ったプロジェクトは、Google Cloud Console から消せる。プロジェクトを消すと、その中の OAuth クライアントも使えなくなり、そのプロジェクトで作ったアプリは Google でログインできなくなる。

  1. 「リソースの管理」の画面を開く(https://console.cloud.google.com/cloud-resource-manager。メニューでは「IAM と管理」の中にある)
  2. 消したいプロジェクトの行の左端にチェックを入れる
  3. 上部の「削除」を押す
  4. 確認の欄にプロジェクト ID を入れて確定する

確定すると「プロジェクトは削除保留中です」と出て、プロジェクトは「シャットダウン」された状態になる。その場では消えず、約30日後に削除される(手元では、2026-11-03 にシャットダウンして「2026/12/03以降に削除される予定です」と出た)。それまでは、同じ画面の下にある「削除保留中のリソース」から戻せる。

⚠️ 行を取り違えない。一覧には同じアカウントのプロジェクトが並ぶので、名前の似たものが隣り合う。確定の前に、チェックした行のプロジェクト ID と、確認の欄に入れる ID が同じかを見る。

  • 2026-10-29 に、工程ごとのプロンプト(データベース・骨組み・ログイン・セッション・API・画面を順に頼む形)から、仕様を書いて作ってもらう形に作り替えた。Google 側の設定は、公開して URL が決まってから行う順にした
  • 3章のプロンプトは、Sonnet 5.5 で試した。試したのはローカルで、Google の応答は偽物に差し替えた。本物の Google でのログインは、前の版(2026-09-02)で同じライブラリと openid だけの組み合わせで通している
  • 試したとき、リダイレクト URI のパスは /auth/google になった。前の版は /api/auth/google。作るたびに変わりうるので、4章で Claude Code に聞いてから登録する
  • 9章の X を足すプロンプトは、作り替えたあとには試していない