OAuthはログインの仕組みではない — 認可とOIDC

OAuthとOIDC。ログイン画面とアクセス許可証、鍵と確認チェック。

認証の回で、自分でログインを作りました。users 表があって、パスワードは bcrypt のハッシュで入っていて、ログインするとセッションのIDがCookieで返ってきます。

前回: 9時間ずれるのは全部同じ理由 — 日付と時刻の扱い 作業場所はVMの中(Ubuntu)です。セッションとJWTの違い|ログイン機能の実装と使い分けの ~/server/app.js と appdb をそのまま使います。ブラウザはホストのWindows側を使います(理由は④にあります)。

動いています。それでも、多くのサービスがこう書いてあります。

[ GitHubでログイン ]
[ Googleでログイン ]

この記事は、そのボタンの中身の話です。 そして、始める前に一番大きい誤解を先に潰します。

OAuth は「ログインの仕組み」ではありません。

ここを勘違いしたまま実装した結果、ログインできてしまう穴を作る、というのがこの分野で一番よくある事故です。まずそこから見ます。

対象レベル: 初級〜中級 / 区分: 必修

目次

この記事でわかること

  • OAuth は「認可(許可)」の仕組みで、ログイン(認証)用ではないこと。ログインに使うための拡張が OpenID Connect だということ
  • 「Googleでログイン」の画面遷移で、実際に何がどこへ渡っているか(そしてトークンはブラウザを通らないこと)
  • state を検証しないと、他人のアカウントに勝手に紐づけられること
  • NATの内側のVMでも、コールバックURLは http://localhost:3000/... で足りる理由
  • メールアドレスが同じというだけで既存アカウントに繋いではいけないこと

この記事でやること

  1. GitHub の OAuth App を作る(コールバックは http://localhost:3000/auth/github/callback)
  2. ホストのWindowsからVMへ SSH ポートフォワードして、ホストのブラウザでVMのアプリを開く
  3. identities 表を足して、GitHubのアカウントと users を繋ぐ
  4. 認可コードフローを自分で書く(state の生成と検証を含める)
  5. 実際に「GitHubでログイン」して、users に何が入ったかをSQLで確かめる

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
OAuth 2.0「このアプリに、私の代わりにこれをさせてよい」を安全に伝えるための決まり。認可の仕組み
OpenID Connect(OIDC)OAuth 2.0 の上に「あなたは誰か」を足した拡張。こちらが認証
プロバイダログインを提供する側。GitHub、Google など
クライアント提供を受ける側。今回はあなたのExpressアプリ
スコープ何を許可するかの範囲。read:user なら「プロフィールを読むだけ」
認可コード同意した直後に一度だけ渡される短い文字列。それ自体では何もできない
アクセストークン認可コードと引き換えに受け取る、APIを叩くための鍵
state自分で作って往復させるランダムな文字列。戻ってきたのが自分の始めた手続きかを確かめる
クライアントシークレットプロバイダが発行するアプリ側の秘密。漏れたら作り直す

「認証(あなたは誰か)」と「認可(何をしてよいか)」は別でした。認証の回で分けた、あの区別がそのまま効いてきます。 OAuth は後者、つまり認可の側の仕組みです。 前者に使いたければ、OIDC という追加のルールが要ります。

① OAuth は「ログインの仕組み」ではない

名前がそう言っています。 OAuth は Authorization(認可) の話です。Authentication(認証)ではありません。

OAuth 2.0 が本来解こうとした問題は、こういうものでした。

写真印刷サービスに、Googleフォトの写真を取りに行かせたい。 でも、Googleのパスワードを印刷サービスに教えるのは嫌だ。

これに対する答えが OAuth です。パスワードを渡す代わりに、「写真を読むことだけ許可した鍵」を渡します。

昔のやり方OAuth
渡すものGoogleのパスワード写真を読むだけの鍵(アクセストークン)
できる範囲Googleでできること全部許可した範囲だけ
取り消しパスワードを変えるしかないその鍵だけ取り消せる
期限無いある

どこにも「あなたが誰か」という話が出てきません。 これが本質です。

「トークンが取れた=本人だ」は成り立たない

ここが事故の入口です。 素のOAuthだけでログインを作ると、こういう発想になります。

アクセストークンが手に入った
 → ユーザー情報APIを叩いたら user_id=12345 と返ってきた
  → よし、12345 としてログインさせよう

トークンは「誰かが、どこかで、このアプリに何かを許可した」ことしか意味しません。

そのトークンが、いま目の前のブラウザの持ち主のものだ、という保証がどこにもありません。 悪意のある人が自分のトークンを他人のブラウザに掴ませると、その他人は攻撃者のアカウントとしてログインした状態になります。逆に、攻撃者が自分のログイン画面に被害者のコードを流し込むと、攻撃者のアカウントに被害者のGitHubが紐づきます。

これを塞ぐのが state の検証で、⑧ で必ず実装します。この手順を書いていない解説記事が本当に多いので、注意してください。

では何でログインするのか — OpenID Connect

OAuth の上に「本人確認の結果」を乗せる決まりを足したものが OpenID Connect(OIDC) です。

OAuth 2.0OpenID Connect
目的認可認証(+認可)
返るものアクセストークンアクセストークン + ID トークン
ユーザー情報の取り方プロバイダごとにバラバラUserInfo エンドポイントが決まっている
設定の場所ドキュメントを読む/.well-known/openid-configuration に全部書いてある

ID トークン が OIDC の中心です。 これは署名付きのJWTで、中にこう入っています。

iss  誰が発行したか(https://accounts.google.com)
aud  誰宛か(あなたのクライアントID)
sub  そのプロバイダの中でのユーザーID(変わらない)
exp  いつまで有効か
nonce あなたが送った使い捨ての文字列

「Googleが署名した、あなた宛の、この人だという証明書」です。 署名を検証し、aud が自分か、exp が切れていないかを確かめて初めて、「本人である」と言えます。

GitHub は OIDC ではありません。 GitHub の OAuth App が返すのはアクセストークンだけで、ID トークン は出ません。 なので今回はGitHub独自のAPI(https://api.github.com/user)を叩いてユーザー情報を取ります。 「GitHubでログイン」は、正確には OAuth をログインに流用している形です。流用でも安全にできますが、state の検証が必須になります。

② なぜ自分でパスワードを預かるのをやめたくなるのか

理由は1つです。

預からなければ、漏らせません。

認証の回で、パスワードをハッシュで持ちました。あれは「漏れても被害を小さくする」対策で、「漏れない」対策ではありません。

自分でパスワードを持つと、ずっとこれを背負い続けます。

背負うもの中身
保管ハッシュのアルゴリズムが古くなったら、全員分を移行する
パスワード忘れメール送信、期限付きトークン、その経路自体が乗っ取りの入口になる
総当たり対策回数制限、ロック、そしてロックを使った嫌がらせへの対策
使い回しの被害他所で漏れたパスワードで、あなたのサイトに入られる
二要素認証求められたら、これも自分で作る

OAuth / OIDC を使うと、この列が丸ごと相手側に移ります。 あなたのデータベースには、パスワードが1つも入っていない状態にできます。

ただし、代わりに別のものを背負います。 それは ⑪ で正直に書きます。

③ 「GitHubでログイン」で何が起きているか

画面遷移の順に分解します。 登場人物は3人です。利用者のブラウザ、あなたのサーバー、GitHub。

#起きることどこからどこへ
1利用者が [GitHubでログイン] を押すブラウザ → あなたのサーバー
2サーバーが state を作って保存し、GitHubへ302リダイレクトするサーバー → ブラウザ → GitHub
3GitHubが同意画面を出す(「このアプリに◯◯を許可しますか」)GitHub上
4利用者が Authorize を押すGitHub上
5GitHubがあなたのコールバックURLへリダイレクトする。?code=...&state=... 付きGitHub → ブラウザ → あなたのサーバー
6サーバーが state を照合するサーバー内
7サーバーが認可コードとシークレットを送り、アクセストークンを受け取るサーバー ⇄ GitHub(ブラウザを通らない)
8サーバーがトークンでユーザー情報APIを叩くサーバー ⇄ GitHub
9サーバーが自分のセッションを張り、アプリのトップへ戻すサーバー → ブラウザ

7と8に注目してください。 ここだけブラウザが一切関与していません。 サーバーとGitHubの直接通信です。

そして9が重要です。 ログインが終わったあと、利用者が持っているのはあなたのサイトのセッションCookieです。GitHubのトークンではありません。

つまり、OAuth はログインの「入口」だけです。 入ったあとの状態を持つのは、これまで通りセッションです。 認証の回で作ったものを捨てる話ではありません。入口が1つ増えるだけです。

なぜ認可コードを挟むのか

「最初からトークンを返せばいいのに」と思うところです。 実際、昔はそういうやり方がありました。暗黙フロー(Implicit Flow)といって、5でコードの代わりにトークンそのものがURLに付いて返ってきます。

使ってはいけません。

問題何が起きるか
URLに載るブラウザの履歴に残る。 リファラで他所のサイトに漏れる。プロキシのログに残る
アプリを名乗れないクライアントシークレットを使わないので、GitHubは「本当にそのアプリか」を確かめられない
JavaScriptから読めるXSSを1つ踏んだだけで、トークンごと盗まれる

認可コードフローは、これを全部避けます。

  • ブラウザに載るのは認可コードだけ。それ単体では何もできません(シークレットが無いと交換できない)
  • コードは1回使うと無効になり、寿命も数分しかありません
  • 実際のトークンはサーバーの中にしか存在しません

判断の基準はこれだけです。 サーバーがある(シークレットを隠せる)なら、認可コードフロー。 これ以外を選ぶ理由はありません。 ブラウザだけ・スマホアプリだけでシークレットを隠せない場合は、認可コードフローに PKCE という仕組みを足します(コードを交換するとき、最初に送った合言葉のハッシュと突き合わせる方式)。それでも暗黙フローには戻りません。

④ VMは外から見えない。コールバックはどうするのか

ここで手が止まります。 いまのVMはNATの内側にいて、インターネットから到達できません。

GitHub ──X──> あなたのVM   (届かない)

「GitHubがコールバックURLを叩きに来るなら、公開サーバーが要るのでは?」 と考えます。そこが誤解です。

GitHub は、あなたのサーバーに接続しません。 コールバックは「ブラウザへのリダイレクト指示」です。

③ の 5 をもう一度見てください。GitHubがやっているのは、利用者のブラウザに 302 と Location: を返すことだけです。そのURLへ実際に接続しに行くのは、利用者のブラウザです。

GitHub ──302 Location: http://localhost:3000/...──> ブラウザ
ブラウザ ────────── GET /auth/github/callback ─────> あなたのサーバー

だから、サーバーは「ブラウザから見えれば」十分です。 インターネットから見える必要はありません。

そして 7 と 8 は、VMからGitHubへの外向きの通信です。NATの内側からでも普通に出ていけます。

ブラウザをどこに置くか

Ubuntu Server には画面がありません。 ブラウザがありません。なので、ホストのWindowsのブラウザを使います。

問題は、Windowsのブラウザから見て localhost:3000 はWindows自身であって、VMではないことです。これを繋ぐのが SSH ポートフォワードです。

Windows の PowerShellで打ちます(VMの中ではありません)。

PowerShell
PS> ssh -L 3000:localhost:3000 your-name@192.168.x.x
  • your-name と 192.168.x.x はあなたのVMのユーザー名とIPに置き換えます(VMの中で ip a で確認できます)
  • -L 3000:localhost:3000 が 「Windowsの3000番へ来たものを、SSHの中を通してVMの3000番へ流す」 という意味です
  • このウィンドウは開いたままにします。 閉じると転送も止まります

VS Code の Remote SSH を使っている人へ。 VS Code は自動でポート転送をします。 ターミナルで node app.js を起動すると、下のパネルの「ポート」に 3000 が現れ、Windows側の localhost:3000 から開けるようになります。 その場合、上の ssh -L は要りません。

確認します。Windowsのブラウザで開きます。

http://localhost:3000/api/tasks

VMのAPIの応答が出れば、経路はできています。

ここで {"error":...} や 401 が返るのは正常です。 ログインしていないからです。「何かが返ってくる」ことだけ確認できれば十分です。 繋がらない場合は、VMの中でアプリが動いているか(curl http://localhost:3000/api/tasks)を先に確かめてください。

[スクリーンショット: 01_ポート転送確認.png] Windows の PowerShell で ssh -L 3000:localhost:3000 ... を実行して繋がった状態と、Windowsのブラウザで http://localhost:3000/api/tasks が応答している画面を撮ってください。IPアドレスとユーザー名は隠して構いません。

⑤ GitHub の OAuth App を作る

GitHubにログインした状態で、Settings → Developer settings → OAuth Apps → New OAuth App を開きます。

項目入れるもの
Application nameobmes-practice(何でもよい。同意画面にこの名前が出ます)
Homepage URLhttp://localhost:3000
Authorization callback URLhttp://localhost:3000/auth/github/callback

http のままで登録できます。 GitHub は localhost に限り http を許容します。外部の本番URLでは https が必要です。 コールバックURLは1文字も違ってはいけません。 末尾のスラッシュ1つで弾かれます。GitHubのOAuth Appには、コールバックURLを1つしか登録できません。

作ると Client ID が出ます。Client secret は「Generate a new client secret」を押して作ります。

シークレットは、作った直後の1回しか表示されません。 閉じると二度と見られません。見失ったら作り直すだけなので、慌てなくて大丈夫です。

[スクリーンショット: 02_oauth-app作成.png] New OAuth App の入力画面(callback URL が見えるようにして)を撮ってください。

[スクリーンショット: 03_client-id発行.png] Client ID と Client secret が表示された画面を撮ってください。必ず両方を黒く塗りつぶしてから投稿してください。

⑥ シークレットを置く場所

.env に入れます。 GitHubにpushした回で .gitignore に .env を入れたのは、まさにこのためです。

bash
$ nano ~/server/.env
DB_USER=appuser
DB_PASSWORD=(これまでのもの)
DB_NAME=appdb
SESSION_SECRET=(これまでのもの)
GITHUB_CLIENT_ID=(コピーしたClient ID)
GITHUB_CLIENT_SECRET=(コピーしたClient secret)

確認します。

bash
$ cd ~/server && git status --short

.env が一覧に出てこなければ正しいです。出てきたら .gitignore を先に直してください。

漏れたと思ったら、すぐ Generate a new client secret を押します。 古いシークレットは即座に無効になります。 「たぶん大丈夫」で放置しない。 シークレットが漏れると、攻撃者があなたのアプリを名乗って同意画面を出せます。 利用者からは区別が付きません。 Client ID のほうは秘密ではありません。 リダイレクトURLに載るので、そもそも隠せません。

⑦ 既存の users とどう繋ぐか

ここが設計の山場です。 いまの users はこうなっています。

users(id, email, password_hash, created_at)

「github_id という列を足せばいい」と思うところですが、そうしません。

やり方困ること
users に github_id 列を足すGoogleも足したくなったら google_id、次は line_id。 列が増え続ける
users に provider と provider_id を足す1人が GitHub と Google の両方で入れなくなる(1行に1つしか持てない)
別の表に分ける1人のユーザーに、外部アカウントを何個でもぶら下げられる

3つ目にします。 sudo mysql で作ります(認証の回と同じ理由で、appuser には表を作る権限がありません)。

bash
$ sudo mysql
USE appdb;

CREATE TABLE identities (
  id               INT AUTO_INCREMENT PRIMARY KEY,
  provider         VARCHAR(32)  NOT NULL,
  provider_user_id VARCHAR(64)  NOT NULL,
  user_id          INT          NOT NULL,
  created_at       TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  UNIQUE KEY uq_provider_user (provider, provider_user_id),
  FOREIGN KEY (user_id) REFERENCES users(id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
決めたこと理由
provider を文字列で持つ'github' 'google' と増やせる
provider_user_id を VARCHAR数値とは限りません。 Googleの sub は長い文字列です
UNIQUE (provider, provider_user_id)同じGitHubアカウントが2人のユーザーに紐づくのを、データベース側で防ぐ
provider_user_id にユーザー名を使わないGitHubのユーザー名は変更できます。 変えられた瞬間に別人になります。変わらないIDを使う

そして users 側を緩めます。

ALTER TABLE users MODIFY email         VARCHAR(255) NULL;
ALTER TABLE users MODIFY password_hash VARCHAR(255) NULL;
EXIT;

なぜ緩めるのか。 GitHubでログインした人には、パスワードが存在しません。 そしてメールアドレスも取れないことがあります(非公開設定の人がいます)。 NOT NULL のままだと、登録の瞬間に落ちます。

緩めたら、必ずログイン側を直します。 認証の回で書いた /api/login に、1行足します。

// bcrypt.compare の前に置く
if (!user || !user.password_hash) {
  return res.status(401).json({ error: "メールアドレスかパスワードが違います" });
}

これを忘れると危険です。 password_hash が空のまま bcrypt.compare に渡す形にしておくと、ライブラリや実装が変わったときに「空文字のパスワードで入れる」穴になり得ます。 「入れないはず」ではなく「明示的に弾く」。 認証の回と同じく、理由は返しません(どちらが違うか教えない)。

メールが同じなら同じ人、としてよいか

一番間違えやすいところです。

GitHubから a@example.com が返ってきた
 → users に a@example.com がある
  → 同じ人だ。そのアカウントにログインさせよう

これを無条件にやると、乗っ取られます。

攻撃者が、自分のGitHubアカウントのメールを a@example.com に設定するだけで、あなたのサイトの a@example.com としてログインできてしまいます。

最低限、こうします。

やることなぜ
プロバイダ側で「検証済み」のメールだけ見るGitHubの /user/emails は verified を返します。verified: false は他人のメールを名乗れます
メールが取れなければ、繋がずに新規作成する推測で繋がない
(より安全に)繋ぐ前に本人に確認させる「既存のアカウントに連携しますか? パスワードを入力してください」と聞く

この記事では「検証済みのメールなら繋ぐ」までを実装します。 実運用に出すなら、3つ目までやってください。

⑧ 書く

追加のパッケージは要りません。 Node.js 18 以降には fetch が入っています。

bash
$ node -v

v18 以上であることを確認してください。

~/server/app.js に足します。上のほう(pool を作ったあたり)に定数を置きます。

const crypto = require("crypto");

const GITHUB_CLIENT_ID = process.env.GITHUB_CLIENT_ID;
const GITHUB_CLIENT_SECRET = process.env.GITHUB_CLIENT_SECRET;
const GITHUB_CALLBACK = "http://localhost:3000/auth/github/callback";

1. GitHubへ送り出す

app.get("/auth/github", (req, res) => {
  // ⚠️ 使い捨てのランダムな文字列。あとで戻ってきたものと突き合わせる
  const state = crypto.randomBytes(16).toString("hex");
  req.session.oauthState = state;

  const url = new URL("https://github.com/login/oauth/authorize");
  url.searchParams.set("client_id", GITHUB_CLIENT_ID);
  url.searchParams.set("redirect_uri", GITHUB_CALLBACK);
  url.searchParams.set("scope", "read:user user:email");
  url.searchParams.set("state", state);

  // ⚠️ セッションを保存しきってからリダイレクトする
  req.session.save(() => res.redirect(url.toString()));
});
パラメータ意味
client_idどのアプリか。 秘密ではない
redirect_uriどこへ戻すか。 OAuth Appに登録したものと完全一致が必要
scope何を許可してもらうか。 read:user はプロフィール読み取り、user:email はメール読み取り
stateCSRF対策。 これが無いフローは壊れています

scope は最小にします。 ログインしたいだけなら repo(リポジトリの読み書き)は要りません。 同意画面には要求した範囲がそのまま出ます。 過大な要求は、利用者が同意を押さない理由になります。

なぜ req.session.save() で囲むのか。 express-session はセッションをデータベースに保存しています(認証の回でそうしました)。 保存が終わる前にリダイレクトが飛ぶと、GitHubから戻ってきたときに state が入っていないことがあります。時々失敗する、という一番厄介な壊れ方をします。

2. 戻ってきたところを受ける

app.get("/auth/github/callback", async (req, res) => {
  const { code, state } = req.query;
  const expected = req.session.oauthState;
  delete req.session.oauthState;      // 一度使ったら捨てる

  // ⚠️ ここが本体。省略しない
  if (!expected || !state || state !== expected) {
    return res.status(400).send("state が一致しません");
  }
  if (!code) {
    return res.status(400).send("code がありません");
  }

  try {
    // ① 認可コード → アクセストークン(サーバー ⇄ GitHub。ブラウザは通らない)
    const tokenRes = await fetch("https://github.com/login/oauth/access_token", {
      method: "POST",
      headers: { "Content-Type": "application/json", Accept: "application/json" },
      body: JSON.stringify({
        client_id: GITHUB_CLIENT_ID,
        client_secret: GITHUB_CLIENT_SECRET,
        code,
        redirect_uri: GITHUB_CALLBACK,
      }),
    });
    const token = await tokenRes.json();
    if (!token.access_token) {
      console.error("token error:", token);
      return res.status(502).send("トークンを取得できませんでした");
    }

    // ② トークンでユーザー情報を取る
    const gh = {
      Authorization: `Bearer ${token.access_token}`,
      Accept: "application/vnd.github+json",
      "User-Agent": "obmes-practice",
    };
    const me = await (await fetch("https://api.github.com/user", { headers: gh })).json();
    const emails = await (await fetch("https://api.github.com/user/emails", { headers: gh })).json();

    // ⚠️ 検証済みかつ主要なメールだけを使う
    const primary = Array.isArray(emails)
      ? emails.find((e) => e.primary && e.verified)
      : null;

    const userId = await findOrCreateGithubUser(String(me.id), primary ? primary.email : null);

    // ⚠️ セッションIDを作り直す(ログイン前のIDを使い回さない)
    req.session.regenerate((err) => {
      if (err) return res.status(500).send("セッションを作れませんでした");
      req.session.userId = userId;
      req.session.save(() => res.redirect("/me"));
    });
  } catch (e) {
    console.error(e);
    res.status(500).send("認証に失敗しました");
  }
});

Accept: application/json を付けているのは、これを付けないと GitHub がJSONではなくクエリ文字列の形(access_token=...&scope=...)で返してくるためです。付け忘れると token.access_token が undefined になります。

User-Agent は GitHub API で必須です。付けないと拒否されます。

req.session.regenerate は、ログインの前後でセッションIDを変えるためのものです。 これをしないと、あらかじめ用意したセッションIDを他人に掴ませておく攻撃(セッション固定)が通ります。⑦のパスワードログインにも同じ処理を入れておくと、なおよいです。

3. ユーザーを見つける、または作る

async function findOrCreateGithubUser(providerUserId, email) {
  // ① すでに紐づいていれば、それを使う
  const [linked] = await pool.query(
    "SELECT user_id FROM identities WHERE provider = 'github' AND provider_user_id = ?",
    [providerUserId]
  );
  if (linked.length) return linked[0].user_id;

  // ② 検証済みメールが既存ユーザーと一致するなら、そこへ繋ぐ
  let userId = null;
  if (email) {
    const [same] = await pool.query("SELECT id FROM users WHERE email = ?", [email]);
    if (same.length) userId = same[0].id;
  }

  // ③ どちらでもなければ、新しく作る(パスワードは持たせない)
  if (userId === null) {
    const [ins] = await pool.query(
      "INSERT INTO users (email, password_hash) VALUES (?, NULL)",
      [email]
    );
    userId = ins.insertId;
  }

  await pool.query(
    "INSERT INTO identities (provider, provider_user_id, user_id) VALUES ('github', ?, ?)",
    [providerUserId, userId]
  );
  return userId;
}

確認用のルートも足します。

app.get("/me", async (req, res) => {
  if (!req.session.userId) return res.status(401).json({ error: "ログインしていません" });
  const [rows] = await pool.query("SELECT id, email FROM users WHERE id = ?", [req.session.userId]);
  res.json(rows[0]);
});

アクセストークンを保存していないことに気付いたでしょうか。 保存していません。 今回の用途は「誰かを知る」ことだけで、その後GitHubのAPIを叩く予定がないからです。使わないものは持たない。 持てば、漏れます。

⑨ 動かす

VMの中でアプリを起動します。

bash
$ cd ~/server && node app.js

別のPowerShellウィンドウで、④のポート転送を張ったまま、Windowsのブラウザで開きます。

http://localhost:3000/auth/github

GitHubの同意画面が出れば、ここまで正しいです。

[スクリーンショット: 04_同意画面.png] GitHub の Authorize 画面(アプリ名と要求しているスコープが見えるように)を撮ってください。

Authorize を押すと /me に戻り、JSONが表示されます。

{"id":2,"email":"あなたのGitHubの主要メール"}

[スクリーンショット: 05_ログイン結果.png] /me が JSON を返している画面を撮ってください。メールアドレスは隠して構いません。

中身を確かめる

bash
$ mysql -u appuser -p appdb
SELECT id, email, password_hash IS NULL AS no_password FROM users;
SELECT * FROM identities;

no_password が 1 の行ができていれば成功です。パスワードを一切預からずにログインできています。

[スクリーンショット: 06_テーブル確認.png] 上の2つのSELECTの結果を撮ってください。

state が効いているか確かめる

壊してみます。 ブラウザで直接開きます。

http://localhost:3000/auth/github/callback?code=dummy&state=dummy

state が一致しません と 400 が返れば、正しく守れています。 これが攻撃者が外から流し込んできたコードの姿です。

⑩ どこまでを OAuth に任せたか

整理します。

これまで今回
メールとパスワードを受け取るGitHubへ送り出す
bcrypt で照合するGitHubが本人確認する
合っていたらセッションを張る戻ってきたらセッションを張る

変わったのは前半だけです。後半、つまり「セッションを張って以降を守る」部分は、そのまま残っています。

そして Cookieの3属性も、そのまま効いています。

sameSite: "strict" にしてはいけません。 strict にすると、GitHubから戻ってきたリクエストにCookieが付かず、state を保存したセッションを読めません。必ず「state が一致しません」で失敗します。 lax なら、トップレベルのGET遷移ではCookieが付くので通ります。このためだけに strict を避ける、という場面が実際にあります。

そして、いまのVMは http です。 認証の回と同じで、このまま外に出してはいけません。 外に出すときは https にして、secure: true にし、OAuth App の callback URL も https のものに登録し直します。

⑪ やりすぎない — 自前ログインで十分な場面

「これからは全部OAuthでいい」とはなりません。 移したものと同じだけ、新しく背負うものがあります。

背負うもの中身
相手が落ちたら、誰も入れないあなたのサイトの可用性が、相手の可用性に縛られます
利用者がアカウントを持っていない社内ツールや、技術者以外が使うサービスではGitHubを持っていない人のほうが多い
相手がルールを変えるAPIの仕様、スコープの粒度、料金。あなたの都合では決められません
二重登録同じ人がパスワードでも、GitHubでも登録して、アカウントが2つに割れる
退会したあと相手側でアカウントを消されたとき、あなたの側のデータをどうするかを決める必要がある

判断の目安です。

場面選ぶもの
開発者向けのサービスGitHubログインは相性がよい。 利用者は全員持っている
一般向けのサービスGoogle などの OIDC。ただし自前ログインも残すのが普通
社内ツールすでにある社内の認証基盤(あるなら)。無いなら自前で十分
学習用・小さな道具自前で十分。 増やした分だけ壊れる箇所が増えます

「両方用意する」が現実的な着地です。今回 identities を別表にしたのは、そのためでもあります。 1人のユーザーに、パスワードとGitHubとGoogleを何個でもぶら下げられる形になっています。

つまずいたところ

症状原因と対処
redirect_uri_mismatch と出るOAuth App の callback URL と、コードの GITHUB_CALLBACK が1文字違う。 末尾のスラッシュ、http/https、ポート番号を見る
token.access_token が undefinedAccept: application/json を付け忘れている。 GitHubがクエリ文字列で返している。console.error(token) の中身を見る
GitHub API が 403 を返すUser-Agent ヘッダが無い。 GitHub API では必須
時々「state が一致しません」になるreq.session.save() を待たずにリダイレクトしている。 セッション保存とリダイレクトが競争している
毎回「state が一致しません」になるsameSite: "strict" になっている。 lax にする
email が null で入るGitHubでメールを非公開にしている、または user:email スコープを要求していない。 仕様どおりの動作。null を許す設計にしてある
Column 'password_hash' cannot be null⑦の ALTER TABLE を流していない
Windowsのブラウザで localhost:3000 が開かないポート転送のPowerShellを閉じている。 開いたままにする
fetch is not definedNode.js が18より古い。 node -v で確認する
ログアウトしても、また押すと同意画面なしで入れる正常です。 GitHub側の許可が残っているだけ。あなたのサイトのセッションは切れています

後片づけ

OAuth App を消してください。 練習用に作ったものを残すと、シークレットを持ったアプリが放置されることになります。

Settings → Developer settings → OAuth Apps → 該当のアプリ → Delete application

GitHub側の「許可した記録」も消せます。 Settings → Applications → Authorized OAuth Apps から解除します。

[スクリーンショット: 07_oauth-app削除.png] OAuth App の削除確認画面を撮ってください。

.env からも消します。

bash
$ nano ~/server/.env

GITHUB_CLIENT_ID と GITHUB_CLIENT_SECRET の行を消します。

ポート転送を止めます。 ④で開いたPowerShellで exit と打つか、ウィンドウを閉じます。

全部やり直したいとき。

DROP TABLE identities;
DELETE FROM users WHERE password_hash IS NULL;

~/server/ と appdb は残してください。 ここまでで「外部のアカウントでも入れるAPI」ができています。

まとめ

  • OAuth は認可(許可)の仕組みで、ログイン用ではない。 ログインに使うための拡張が OpenID Connect
  • 「トークンが取れた=本人だ」は成り立たない。 そのトークンが目の前のブラウザの持ち主のものだという保証がどこにも無い
  • OIDC の中心は ID トークン(署名付きJWT)。iss / aud / exp を検証して初めて「本人」と言える
  • GitHub は OIDC ではない。 OAuth をログインに流用する形なので、state の検証が必須
  • state を検証しないと、攻撃者のGitHubを他人のブラウザのログインやアカウントに紐づけられる。 省略している解説が多いので注意
  • 認可コードフローを使う。 ブラウザに載るのはコードだけで、トークンはサーバーの中にしか存在しない
  • 暗黙フローは使わない。 URLに載る・履歴に残る・アプリを名乗れない
  • コールバックは「ブラウザへのリダイレクト指示」。 GitHubがあなたのサーバーに接続するわけではないので、NATの内側のVMでも http://localhost:3000/... で足りる
  • ホストのブラウザからは SSH ポートフォワード(ssh -L 3000:localhost:3000 ...)で見る
  • sameSite: "strict" にするとコールバックでCookieが送られず、必ず失敗する。 lax にする
  • 外部アカウントは別表(identities)に持つ。 users に github_id 列を足すと、増やすたびに列が増える
  • メールが同じというだけで既存アカウントに繋がない。 検証済みのメールだけを見る
  • パスワードを持たないユーザーができる。 password_hash が空のときは明示的にログインを弾く
  • OAuth に移せば安全になるわけではない。 相手の障害・仕様変更・二重登録を新しく背負う。自前で十分な場面は多い

参考リンク


次に読む

この記事は 【第5段階】バックエンドとデータベース の 21 / 29 本目です。

記事
← 前の記事9時間ずれるのは全部同じ理由 — 日付と時刻の扱い
→ 次の記事待たせるAPIをやめる — メッセージキューとRabbitMQ

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

Backend›Authentication
  • OAuth(認可コードフロー)
  • OpenID Connect(ID トークン)
  • Token Authentication
  • CSRF 対策(state の検証)

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次