EN

ラズパイの匿名チャット管理画面に、ポートを開けずにLANの外からOIDCでログインする

目次

はじめに

個人で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トークンといった用語を、実際の構成に当てはめていきます。

全体の構成

ブラウザから管理画面に届くまでに、リクエストは次の場所を通ります。

管理画面に届くまでの全体の構成図。ブラウザは443番のHTTPSでCloudflare Accessに届く。Cloudflare AccessはGoogleが発行したIDトークンを検証する。通ったリクエストは、ラズパイのcloudflaredが7844番で張ったTunnelを通り、JWT付きでcloudflaredに届き、3000番でRailsに渡る。RailsはJWTを検証し、だめなら403を返す。Railsは443番で本体の管理APIを静的なBearerトークンで呼ぶ。 ラズパイ(家の中) Dockerネットワーク ブラウザ (外出先) Cloudflare Access (RP) IDトークンを検証 Google (OP) cloudflared Tunnelのクライアント Rails 管理画面 JWTを検証、だめなら403 本体の管理API (AWS) 443 HTTPS IDトークン 443 Tunnel 7844 JWT付きで転送 (接続はラズパイから張る) 3000 HTTP 443 Bearerトークン

角の丸い枠の数字は、その接続のポート番号です。外から来たリクエストは、まず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本もありません。

Cloudflare Tunnelの接続の向きの図。上の段は起動したとき:ラズパイのcloudflaredが、ルーターを通って外向きに、Cloudflareのエッジへ7844番で接続を張り、張ったままにする。ルーターのポートは閉じたまま。下の段はリクエストが来たとき:外出先のブラウザは443番でCloudflareに届き、Cloudflareは張ってある同じ接続を逆向きに使ってcloudflaredへリクエストを流し、cloudflaredが3000番でRailsに渡す。ブラウザからラズパイに直接は入れない。 ① 起動したとき:ラズパイから接続を張る 家の中 cloudflared ラズパイ ルーター ポートは閉じたまま Cloudflare (エッジ) 7844 外向きに接続 張りっぱなし ② リクエストが来たとき:同じ接続を逆向きに使う ブラウザ (外出先) 家の中 Dockerネットワーク cloudflared ラズパイ ルーター ポートは閉じたまま Cloudflare (エッジ) Rails :3000で待つ 443 7844 同じ接続を逆向きに 3000 直接は入れない

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でログインする
OPGoogleパスワードや2段階認証で本人を確かめ、IDトークンを発行する
RPCloudflare AccessIDトークンを検証し、メールアドレスを許可リストと照らす
(OIDCの外)RailsCloudflare 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の部分です。

Cloudflare Accessを通したログインのシーケンス図。緑の3、7、8、9がGoogleとAccessのあいだのOIDCで、AccessがRPとしてIDトークンを受け取って検証する。オレンジの10、12、13がAccessの発行するJWTで、Railsはそれを検証し、だめなら403を返す。RailsはGoogleと直接やり取りしない。 ブラウザ (あなた) Cloudflare Access (RP) *.cloudflareaccess.com Google (OP) accounts.google.com Rails管理画面 (ラズパイ) admin.anonymtopic.com 1 admin.anonymtopic.comを開く 2 Googleへ転送 3 認可リクエスト(scope=openid email) 4 ログイン(2段階認証・パスキー) 5 リダイレクト(認可コード付き) 6 認可コードを渡す 7 認可コード+シークレット 8 IDトークン 9 IDトークンを検証、メールを照合 10 JWT入りのクッキー 11 クッキー付きで開き直す 12 Cf-Access-Jwt-Assertionを付けて転送 13 JWTを検証(だめなら403) 14 管理画面を返す

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のJWTGoogleのIDトークン
isshttps://<チーム名>.cloudflareaccess.comhttps://accounts.google.com
audCloudflare 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トークンで「誰か」を確かめるところ(認証)だけです。「写真を読ませてよいか」という認可が主役だった前回までとは、ここが違います。

まあ、肝心の匿名チャットには相変わらず誰も来ないので、この管理画面の出番はまだありません。

参考