本文へスキップ

ブログセキュリティ

招待制アプリにGoogleログインを付ける。Cloudflare Accessに任せること、アプリで確かめること

社内のWorkspace利用者と社外のGmail利用者を同じアプリに招待するため、Cloudflare AccessをOpenID Connectでつなぎました。IDトークンの検証と招待の照合を、email_verifiedが届かずログインに失敗した実例から説明します。

濃紺の地に白い招待券と半券が並ぶ。両方のちぎり目がぴたりと合う形で、ログインした人と招待先の照合を表している。

社内ではGoogle Workspaceを使っています。社内プロダクトに社外の協力者を招待するときも、相手が普段使っているGmailやWorkspaceでログインできれば十分です。一般の利用者が初めてログインするには、管理者からの招待が必要です。ログインした人が管理者の招待した相手かどうかを、どこで確かめればよいでしょうか。

Cloudflare AccessでGoogleログインを受け付ける

Cloudflare Accessは、アプリごとに誰のアクセスを許可するかを決められるサービスです。本人の認証にはGoogleなどの外部サービスを利用できます。この認証元をIdP(Identity Provider)と呼びます。今回はGoogleをIdPに選びました。Accessでは社内の利用者をメールのドメインで許可し、社外の協力者はメールアドレスを個別に指定しました。

アプリがAccessから認証結果を受け取る仕組みにはOpenID Connect(OIDC)を使いました。利用者が「Googleでログイン」を押すとアプリはブラウザをAccessに案内します。Googleで本人確認を済ませてAccessの許可条件を満たすと、ブラウザは認可コードを持ってアプリに戻ります。アプリのサーバーはそのコードをAccessに渡して、誰がログインしたかを示す署名付きのIDトークンを受け取ります。Cloudflare公式のOIDCアプリ設定

この構成なら、社内の人も協力者も同じボタンから入れます。アプリがGoogleのパスワードを預かる必要もありません。Accessが判定するのはここまでです。誰を招待したか、その人がどの情報を閲覧できるかは社内プロダクト側で管理します。

アプリはIDトークンをどう確かめるか

たとえば協力者が初めてログインするとき、アプリはIDトークンに書かれたメールアドレスを招待先と照合します。その前に、そのトークンが「このアプリで今始めたログイン」に対してAccessが発行したものだと確かめる必要があります。今回のサーバーではOIDCライブラリの openid-client を使い、次の順に処理しています。

アプリが確かめること今回の実装
アプリで始めたログインの続きか開始時に保存した state と戻ってきた値を照合します。認可コードの交換には開始時に用意した検証値を使います(PKCE)。
信頼するAccessがこのアプリ向けに発行したかIDトークンの署名を検証し、発行者(iss)と宛先(aud)を設定値と照合します。有効期限(exp)と今回のログインに結び付ける値(nonce)も確認します。
招待した相手の初回ログインかメール確認済みを示す項目(email_verified)が真偽値の true であることを求めます。Gmail・Workspaceとして受け付ける条件もここで確かめます。そのメールアドレスがアプリに登録した招待先と一致すれば受け入れます。

メールアドレスを使うのは、管理者が招待する時点で相手のアドレスを知っているからです。初回ログインで本人を紐付けた後は、発行者の iss と、その発行者が利用者に割り当てた識別子 sub の組で同じ人を識別できます。一度登録した人はログインのたびに招待を受け直す必要がありません。

AccessはAllowでも、招待の照合まで届かなかった

招待した個人のGmailで初回ログインを試すと、アプリに入れませんでした。Accessの認証ログは Allow で、アプリのDBにもそのアドレス宛ての招待が残っていました。私は最初にサーバー側のログイン処理のバグを疑いました。

招待を残したまま同じGmailでログインを試すと、アプリのログに email_not_verified が出ました。一緒に記録していた email_verified の型は undefined でした。確認結果が false だった場合は型が boolean になります。今回は項目そのものが届いていませんでした。

Accessで見えた名前は verified_email

どこで確認結果が抜けたのかを調べるため、AccessがGoogleから取り込んだユーザー情報とアプリ側のログを見比べました。

見た場所メールの確認結果
Accessに取り込まれたGoogleのユーザー情報verified_email が true
Access発行のIDトークンを検証するアプリemail_verified が欠落

email_verified はOpenID Connectの標準クレームで、Google自身が発行するIDトークンの仕様でもこの名前です。今回 verified_email を見つけた場所はAccess側のユーザー情報です。OpenID Connectの標準クレーム・GoogleのIDトークン仕様

Accessで対象アプリのOIDCクレームを開き、IdPから取得した属性をアプリに渡す名前に対応付けました。

IdPクレーム(取得元)名前(アプリに渡す項目)スコープ必要
verified_emailemail_verifiedprofileオン

「必要」はその項目が存在することをAccess側で要求する設定です。値が true かどうかは引き続きアプリが検証します。設定を保存してもう一度試すと、同じ招待で初回ログインできました。ログアウト後も再招待せずに入り直せました。Cloudflare AccessのOIDCクレーム設定

hdを全員に要求すると個人のGmailが入れない

もう一つ扱いを決めたのが hd(hosted domain)です。Google Workspaceの組織アカウントでは所属先のドメインを示します。個人のGmailにはこの値がありません。

招待する相手を考えると、GmailとWorkspaceを受け付ければ足ります。Google以外で管理するメールアドレスでもGoogleアカウントは作れますが、私が実際にそういうアカウントを見たのは一度だけです。

外部で管理されるアドレスの場合、Googleアカウントを作ったときにメールを確認できても、その後メールボックスの持ち主が変わることがあります。Googleもメールアドレスの管理元を判断する条件として、Gmailのアドレスと、email_verified が真で hd があるWorkspaceアカウントを挙げています。GoogleのIDトークン検証ガイド

そこで hd は同じ名前でアプリへ渡し、Accessの「必要」はオフにします。アプリでは初回登録時に次のように使い分けます。一般利用者はいずれも招待先との一致が前提です。

招待先初回登録で確認すること
@gmail.comemail_verified が true なら hd は不要
それ以外のアドレスemail_verified が true で、かつ hd が空でない文字列であること

社外のWorkspaceからも招待するので、ここでは hd を自社のドメインに限定していません。今回のGmailでも招待先との照合に必要だったのは、Accessから届くはずのメールの確認結果でした。

自分たちのWebアプリも確かめたいときは、ソースコードと設定を読んで事故につながる点を調べます。結果は報告書とオンラインでお伝えし、直すところやその後の見守りまで続けて相談できます。

Webアプリの診断内容を見る
ブログ一覧へ戻る