ラズパイの匿名チャット管理画面に、ポートを開けずにLANの外からOIDCでログインする
目次
- はじめに
- 全体の構成
- ポートを開けないCloudflare Tunnel
- OIDCの役の当てはめ
- ログインの流れ
- Railsに届くCloudflare AccessのJWT
- RailsでのJWTの検証
- Railsでも確かめる理由
- まとめ
- 参考
はじめに
個人でanontopicという匿名チャットを作って公開しています。公開はしたものの、クソほど誰も来ません。人が来ない以上、荒らしも通報もまだありませんが、来たときに備えて、話題の管理や通報の確認、BANをする管理画面を別に作りました。管理画面はRailsで、本体の管理APIを呼ぶだけのアプリです。
この管理画面を、家のラズパイの上でコンテナとして動かしています。ここまではカスみたいな作業です。docker compose upすれば、同じLANの中からは開けます。
困るのは、外出先から開きたいときです。ルーターのポートを開けて管理画面を直接インターネットに出すのは避けたいですし、管理者が自分1人しかいないアプリのために、ログインの仕組みを一から作るのもクソだるいです。
そこで、Cloudflare Tunnelでポートを開けずに外とつなぎ、入口のCloudflare AccessでGoogleのアカウントでログインさせることにしました。ログインはGoogleのOIDC(OpenID Connect)で、Railsは届いたJWTを検証し、合わなければ403を返します。
この記事では、この仕組みを順に追います。OAuthとOIDCについては、以前の記事で認可コードフロー、PKCE、OpenID Connectを図で整理しました。今回はそこで出てきたOP・RP・IDトークンといった用語を、実際の構成に当てはめていきます。
全体の構成
ブラウザから管理画面に届くまでに、リクエストは次の場所を通ります。
角の丸い枠の数字は、その接続のポート番号です。外から来たリクエストは、まずCloudflareのエッジにあるCloudflare Accessで止まります。ここで、ログインしていない人をGoogleのログインへ回し、許可したメールアドレスの人だけを通します。通ったリクエストはTunnelを通ってラズパイのcloudflaredに届き、cloudflaredがそれを同じDockerネットワークの中のRailsに渡します。
図で見てほしいのは、署名付きのトークンが2つあることです。Cloudflare Accessは、緑のIDトークンを検証する側であり、オレンジのJWTを発行する側でもあります。緑はGoogleが発行し、オレンジはRailsが検証します。Googleが発行したIDトークンはRailsまで届きません。 RailsがGoogleのトークンを直接検証しているように見えますが、実際に検証しているのはCloudflareが署名したJWTです。この違いは、後の「OIDCの役の当てはめ」で詳しく見ます。
右下の本体の管理APIは、この話の外にあります。Railsは、本体と共有している静的なトークンをAuthorization: Bearerに付けて管理APIを呼びます。人のログイン(誰が管理画面を開いたか)と、サーバー同士の信頼(リクエストが管理画面から来たか)は、別の仕組みで守っています。
ポートを開けないCloudflare Tunnel
ルーターのポートを開けずに済むのは、接続の向きが逆だからです。cloudflaredはラズパイの中からCloudflareへ接続を張り、外からのリクエストはその接続を逆向きに流れてきます。家に入ってくる接続は1本もありません。
cloudflaredがつなぎに行く先は、Cloudflareの7844番です。外出先のブラウザがつなぐのはCloudflareの443番で、ラズパイには直接届きません。
cloudflaredが中で何をしているか(QUICやHTTP/2の上での多重化、接続の冗長化など)の技術的な詳細は、Cloudflare Tunnelのドキュメントとcloudflaredのソースを見てください。
compose.yamlには、管理画面のadminと並べてcloudflaredを置いています。
services:
admin:
build: .
env_file: .env
# 外から届かないよう、ラズパイの127.0.0.1にだけ出す
ports:
- "127.0.0.1:3000:3000"
# (read_onlyやhealthcheckは省略)
cloudflared:
image: cloudflare/cloudflared:2026.10.7
profiles: ["tunnel"]
restart: unless-stopped
command: ["tunnel", "--no-autoupdate", "run"]
environment:
TUNNEL_TOKEN: ${TUNNEL_TOKEN}
depends_on:
admin:
condition: service_healthy
cloudflaredのイメージは、Docker Hubのcloudflare/cloudflaredから取ってきています。Cloudflareが公開しているTunnelのクライアントで、ARMのイメージもあるのでラズパイでもそのまま動きます。タグはlatestにせず、バージョンを固定しています。
TUNNEL_TOKENは、CloudflareのダッシュボードでTunnelを作ったときに出てくる文字列です。これを持っているcloudflaredが、そのTunnelとしてCloudflareにつながります。
どのホスト名をどこへ送るかは、ダッシュボードのTunnelの設定で決めます。今回はadmin.anonymtopic.comをhttp://admin:3000に送るようにしました。adminはcomposeのサービス名なので、同じDockerネットワークの中からしか引けません。
profiles: ["tunnel"]にしてあるのは、.envでCOMPOSE_PROFILES=tunnelにしたときだけcloudflaredを起動するためです。LANの中で試すだけなら、Tunnelなしでadminだけを動かせます。
ブラウザとCloudflareのあいだはHTTPSですが、cloudflaredからRailsまではHTTPです。HTTPSはCloudflareで終わっているので、RailsはRAILS_ASSUME_SSL=trueで「外側はHTTPS」とみなしています。これを忘れると、ブラウザが送るhttps://のOriginとRailsの想定が食い違い、フォームの送信がすべてCSRFとして断られます。
OIDCの役の当てはめ
ここから認証の話です。OpenID Connectの記事では、OIDCの登場人物をOP(OpenID Provider)とRP(Relying Party)と呼びました。OPは「ユーザーが誰かを証明する側」、RPは「その証明を信頼してログインさせる側」です。今回の構成に当てはめると、次のようになります。
| OIDCでの役 | 今回は誰か | 何をするか |
|---|---|---|
| エンドユーザー | 自分(管理者) | Googleでログインする |
| OP | パスワードや2段階認証で本人を確かめ、IDトークンを発行する | |
| RP | Cloudflare Access | IDトークンを検証し、メールアドレスを許可リストと照らす |
| (OIDCの外) | Rails | Cloudflare Accessが発行したJWTを検証する |
大事なのは3行目と4行目です。RPはRailsではなく、Cloudflare Accessです。Google Cloudのコンソールで作ったOAuthクライアントのクライアントIDとシークレットは、Cloudflareのダッシュボードに入れました。ラズパイにはどちらも置いていません。
Railsは、OIDCのやり取りには参加していません。リダイレクトも認可コードも扱わず、Cloudflare Accessがリクエストのヘッダに付けてくるJWTを確かめるだけです。このように、アプリの前に立ってログインを肩代わりし、結果をヘッダで渡すプロキシを、identity-aware proxyと呼びます(Google Cloudの同名のサービスIdentity-Aware Proxyの説明が分かりやすいです)。
ログインの流れ
Cloudflare Accessのクッキーを持っていない状態で、初めて管理画面を開いたときの流れです。緑がGoogleとのあいだのOIDC、オレンジがRailsに渡すJWTの部分です。
1〜8は、認可コードフローの記事で見た流れとほとんど同じです。違うのは、3の認可リクエストのscopeにopenidが入っていて、8でアクセストークンと一緒にIDトークンが返ってくるところです。これはOIDCの記事で見た形そのものです。
Googleに登録したリダイレクトURIは、https://<チーム名>.cloudflareaccess.com/cdn-cgi/access/callbackです。5で認可コードを付けて戻す先がCloudflare Accessなので、RailsのURLではなく、そちらのURLを登録します。RPがRailsではないことが、ここからも分かります。
2段階認証やパスキーを求めるのは、4のGoogleです。管理画面の側では何もしていません。Googleのアカウントで2段階認証を必須にしておけば、それがそのまま管理画面のログインの強さになります。
9でCloudflare AccessはIDトークンを検証し、中のemailを、アプリケーションに付けたポリシー(許可するメールアドレスの一覧)と比べます。ここで落ちると、Cloudflare側のエラー画面が出て、リクエストはRailsまで届きません。
通ったら、Cloudflare Accessは自分で署名したJWTを作り、10でクッキーとしてブラウザに渡します。以降は、12でリクエストを転送するたびに、同じJWTをCf-Access-Jwt-Assertionヘッダに付けます。2回目からはクッキーがあるので、1からいきなり12に進みます。クッキーの有効期間は、アプリケーションの設定で決めた期間です。
Railsに届くCloudflare AccessのJWT
Railsに届くJWTは、GoogleのIDトークンではありません。ただ、形はよく似ています。IDトークンの中身と同じく、header.payload.signatureの3つに分かれた署名付きのJWTで、ペイロードには次のようなクレームが入っています。
| クレーム | Cloudflare AccessのJWT | GoogleのIDトークン |
|---|---|---|
iss | https://<チーム名>.cloudflareaccess.com | https://accounts.google.com |
aud | Cloudflare AccessのアプリケーションのAUDタグ | RPのクライアントID |
email | ログインした人のメールアドレス | 同じ |
exp | 有効期限 | 同じ |
| 署名の鍵 | Cloudflare Accessの秘密鍵 | Googleの秘密鍵 |
違いが出るのはissとaudです。issは発行者で、Cloudflareのチームのドメインになります。audは「このトークンは誰宛てか」で、IDトークンならRPのクライアントIDが入るところに、Cloudflare Accessのアプリケーションごとに振られたAUDタグが入ります。同じアカウントで別のアプリケーションを作っても、そちら向けのJWTはaudが違うので、この管理画面では通りません。
署名の検証に使う公開鍵は、https://<チーム名>.cloudflareaccess.com/cdn-cgi/access/certsにJWKS(JSON Web Key Set)として公開されています。GoogleがIDトークンの公開鍵をjwks_uriで公開しているのと同じ仕組みです。Cloudflare Accessはこの鍵を数週間ごとに入れ替えるので、鍵をファイルに保存しておくのではなく、その都度取りに行きます。
RailsでのJWTの検証
Railsでは、すべてのリクエストの前にbefore_actionで検証します。
class ApplicationController < ActionController::Base
before_action :require_cloudflare_access
private
def require_cloudflare_access
verifier = CloudflareAccess::TokenVerifier.default
return if verifier.nil? # Cloudflare Accessの設定が空なら確かめない
email = verifier.verify(request.headers["Cf-Access-Jwt-Assertion"])
logger.info("Cloudflare Access: #{email}")
rescue CloudflareAccess::TokenVerifier::Invalid => e
logger.warn("Cloudflare Access refused the request: #{e.message}")
render plain: t("errors.cloudflare_access"), status: :forbidden
end
end
検証の中身はCloudflareAccess::TokenVerifierにまとめ、JWTの扱いはruby-jwtに任せています。
module CloudflareAccess
class TokenVerifier
class Invalid < StandardError; end
KEYS_TTL = 1.hour
def initialize(team_domain:, audience:)
@issuer = "https://#{team_domain}"
@audience = audience
@mutex = Mutex.new
@connection = Faraday.new(url: @issuer) { |f| f.response :json }
end
# 通ればメールアドレスを返す。だめならInvalidを投げる
def verify(token)
raise Invalid, "no Cf-Access-Jwt-Assertion header" if token.blank?
payload, = JWT.decode(token, nil, true,
algorithms: [ "RS256" ],
jwks: method(:keys),
iss: @issuer, verify_iss: true,
aud: @audience, verify_aud: true)
payload.fetch("email")
rescue JWT::DecodeError, KeyError => e
raise Invalid, e.message
end
private
# JWT.decodeが公開鍵を取りに来るときに呼ぶ
def keys(options)
@mutex.synchronize do
if @keys.nil? || options[:kid_not_found] || Time.current >= @keys_expire_at
@keys = { keys: @connection.get("/cdn-cgi/access/certs").body.fetch("keys") }
@keys_expire_at = KEYS_TTL.from_now
end
@keys
end
end
end
end
(実際のコードでは、タイムアウトや鍵の取得に失敗したときの扱いも書いています。)
確かめていることを、OIDCの記事のRPがする検証と並べると次のようになります。
| 確かめるもの | Railsでの確かめ方 |
|---|---|
| ヘッダ | Cf-Access-Jwt-Assertionがなければ、Cloudflare Accessを通っていないので403 |
| 署名 | ヘッダのkidに合う鍵をJWKSから選び、RS256で確かめる |
iss | 自分のチームのドメインが発行したものか |
aud | この管理画面のAUDタグが入っているか |
exp | 期限が切れていないか(JWT.decodeが既定で確かめる) |
OIDCのRPが確かめるnonceは、ここにはありません。nonceは、RPが認可リクエストのときに作った値と、返ってきたIDトークンの値を突き合わせて、すり替えを防ぐためのものでした。Railsは認可リクエストを送っていないので、突き合わせる相手がいません。nonceの確認は、RPであるCloudflare Accessの仕事です。
公開鍵は1時間使い回し、知らないkidのトークンが来たときはその場で取り直します。ruby-jwtは、手元の鍵に一致するkidがないと、kid_not_found: trueを付けてもう一度keysを呼びます。Cloudflare Accessが鍵を入れ替えた直後でも、1時間待たずに新しい鍵で検証できます。
どれか1つでも通らなければ、403と「Cloudflare Accessを通っていないため、管理画面を開けません」という文言を返し、理由をログに残します。通ればemailをログに残して、画面を返します。誰が操作したかは、このログで追えます。
なお、コンテナのヘルスチェックに使う/upは、RailsのRails::HealthControllerが返すので、ApplicationControllerのbefore_actionを通りません。JWTのないヘルスチェックが403で落ちることはありません。
Railsでも確かめる理由
Cloudflare Accessが入口で止めているのに、なぜRailsでももう一度確かめるのか。入口で止められるのは、Cloudflareを通ってきたリクエストだけだからです。
管理画面のポートは、ラズパイの127.0.0.1にだけ出しています。ふだんは外から届きませんが、設定を間違えたときや、ラズパイの中の別のプロセスから直接3000番にリクエストが来たときは、入口を通りません。Railsが署名を確かめていれば、そういうリクエストも断れます。Cloudflare Accessの秘密鍵を持っていない限り、正しい署名のJWTは作れないからです。
実際に、ラズパイの上でcurl http://127.0.0.1:3000/を叩くと403が返ります。Cloudflare Accessを通っていないリクエストを、Railsが断っていることがここで確かめられます。
その代わり、Cloudflareに障害があると、外から開けなくなるだけでなく、SSHのポート転送で開くこともできなくなります。そのときは.envのCF_ACCESS_TEAM_DOMAINとCF_ACCESS_AUDを空にして起動し直します。どちらかが空なら、TokenVerifier.defaultがnilを返し、Railsは確かめずに通す作りにしてあります。
まとめ
- ラズパイの管理画面は、Cloudflare Tunnelでポートを開けずに外とつなぎ、入口のCloudflare AccessでGoogleのアカウントでログインさせた
- OIDCで見るとOPはGoogle、RPはCloudflare Accessで、Railsはそのやり取りに参加していない
- Railsが検証しているのは、GoogleのIDトークンではなく、Cloudflare Accessが署名したJWT。署名・
iss・aud・expを確かめ、だめなら403を返す - Railsでも確かめておくと、Cloudflare Accessを通らずに届いたリクエストも断れる
以前の記事でOAuthとOIDCを整理したときは、架空のサービスで考えていました。実際に組んでみると、「RPは誰か」を最初に決めると、どの値をどこに入れればよいかが分かりやすくなりました。クライアントIDとシークレットがCloudflare側に入り、リダイレクトURIがCloudflareのドメインになり、Railsがnonceを見なくてよいのは、どれもRPがCloudflare Accessだからです。
ただ、今回はOIDCといっても、前回までの記事とは少し毛色が違います。Cloudflare AccessとGoogleのあいだは前回までと同じOAuth 2.0の認可コードフローで、アクセストークンも返ってきます。ただ、そのアクセストークンでAPIを呼ぶことはなく、使っているのはIDトークンで「誰か」を確かめるところ(認証)だけです。「写真を読ませてよいか」という認可が主役だった前回までとは、ここが違います。
まあ、肝心の匿名チャットには相変わらず誰も来ないので、この管理画面の出番はまだありません。