0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

パスキーだけでログインし、メモは端末で暗号化する。WebAuthn PRF で「サーバーが中身を持たない」Web アプリを作った

0
Last updated at Posted at 2026-11-14

はじめに

個人情報の流出のニュースが、ほぼ毎週のように流れてきます。
サービスを作る側として考えたのは、「漏れないように守る」に加えて「漏れても読めない作りにする」 ことでした。

そこで、読書メモのアプリ「栞 - Reading Notes」を、次の方針で作りました。

  • ログインはパスキーだけ(パスワードを持たない)
  • 本やメモの中身は利用者の端末で暗号化してから送る(サーバーには暗号文しかない)
  • 暗号化の鍵は、パスキーの PRF 拡張から取り出した値で守る

作った仕組みは、ほかのアプリにも組み込めるように部品として切り出し、MIT ライセンスで公開しています。

この記事では、その中身(鍵の持ち方・記録の暗号化・同期・ハマったところ)を紹介します。

この部品は、第三者のセキュリティ監査を受けていません。設計の考え方の共有として読んでください。

全体像

鍵は全部で7種類あります。いちばん大事なのは ④データ鍵 で、これだけが中身を暗号化・復号できます。④は読める形ではどこにも保存せず、別の鍵で「包んで」預けます。

鍵 どこにあるか
① パスキー 利用者の端末やパスワードマネージャー(秘密鍵は外に出ない)
② ユーザーID 復旧のときの名札(秘密ではない)
③ 復旧キー 利用者の控えだけ。サーバーには「確認用の値」しか送らない
④ データ鍵 中身を暗号化する唯一の鍵。読める形では保存しない
⑤ 包み ④を①や③から作った鍵で暗号化したもの。サーバーに預ける
⑥ 端末鍵 端末の IndexedDB にある「取り出せない鍵」
⑦ 割符 サーバーがログイン中の端末にだけ渡す値。⑥と二重にかけて④を端末に置く

PRF 拡張とは

WebAuthn の PRF 拡張は、パスキーごとの秘密と、こちらが渡す値(salt)から、毎回同じ 32 バイトを返してくれる機能です。
パスキーの秘密鍵そのものは外に出ませんが、この出力を鍵の材料に使えます。

// ログイン(navigator.credentials.get)のときに PRF を頼む
const cred = await navigator.credentials.get({
  publicKey: {
    challenge,                       // サーバーからのチャレンジ
    rpId: location.hostname,
    userVerification: 'required',
    extensions: { prf: { eval: { first: prfSalt } } },  // salt はサイトで1つの決まった値(秘密ではない)
  },
});
const out = cred.getClientExtensionResults().prf?.results?.first;  // 32 バイト(ArrayBuffer)

ポイントは2つです。

  1. PRF の出力は絶対にサーバーへ送らない:ログインの応答をサーバーに送る前に、clientExtensionResults から prf を消しています。
  2. salt は秘密でなくてよい:出力はパスキーの秘密から作られるので、salt を知っていても計算できません。部品では SHA-256("<アプリのラベル>/prf") を使っています。

対応状況のばらつき

PRF は比較的新しい機能で、端末・ブラウザー・パスキーの保存先の組み合わせで使えたり使えなかったりします。
そこで、パスキーを作った時点で PRF が使えるか確かめ、使えなければアカウントを作る前に止めるようにしました。

const cred = await navigator.credentials.create({ publicKey: { /* … */ extensions: { prf: {} } } });
const r = cred.getClientExtensionResults().prf;
if (!(r && (r.enabled === true || r.results?.first))) {
  throw new Error('この端末は、データの暗号化に必要な機能に対応していません');  // ここで止める
}

もう1つハマったのが、作るとき(create)には PRF の出力を返さない端末があることです。その場合は、作った直後にもう一度パスキーを使ってもらい(get)、出力を受け取っています。

鍵を作って包む

鍵の材料(PRF の出力・復旧キー)から、用途ごとに別の鍵を HKDF-SHA256 で作ります。作った鍵は extractable: false で、JavaScript からも取り出せません。

async function derive(ikm, label) {
  const base = await crypto.subtle.importKey('raw', ikm, 'HKDF', false, ['deriveKey']);
  return crypto.subtle.deriveKey(
    { name: 'HKDF', hash: 'SHA-256', salt: SALT, info: new TextEncoder().encode(label) },
    base, { name: 'AES-GCM', length: 256 }, false, ['encrypt', 'decrypt']);
}

// データ鍵(ランダムな 32 バイト)を、パスキーの PRF から作った鍵で包む
const wrapForPasskey = async (raw, prfOut, uid, credId) =>
  seal(await derive(prfOut, 'wrap/passkey'), raw, `${prefix}/wrap/passkey|${uid}|${credId}`);

包むときの AES-GCM には、AAD(追加の認証データ)に「だれの・どのパスキーの包みか」 を入れています。
サーバーが別の人の包みを渡してきても、開けずに失敗します。

復旧キー

パスキーを全部なくしたときのために、復旧キー(32 文字種×24 文字=120 ビット)を端末で作ります。
サーバーに送るのは、復旧キーから HKDF で作った「確認用の値」だけです(さらにサーバー側で秘密鍵の HMAC をかけて保存)。
「包みを開ける鍵」は別のラベルから作るので、確認用の値からは計算できません。

const recoveryAuth = async key => hex(await deriveBits(enc.encode(norm(key)), 'recovery/auth'));   // サーバーへ
const wrapForRecovery = async (raw, key, uid) => seal(await derive(enc.encode(norm(key)), 'recovery/wrap'), raw, `${prefix}/wrap/recovery|${uid}`);

UX で工夫したのは、復旧キーを控えたことの確かめです。「控えました」を押すとキーを隠し、控えた場所を見て最後の4文字を入れてもらいます。チェックボックスだけだと、読まずに押されてしまうためです。

記録を1件ずつ暗号化する

本・メモなどは、1件ずつ JSON にして AES-256-GCM で暗号化します。

// 封(AAD)に「だれの・どの種類の・どの番号の・どの版か」を入れる
const recordAad = (uid, kind, id, ver) => `${prefix}/rec|${uid}|${kind}|${id}|${ver}`;

AAD に版の番号まで入れているので、サーバーが記録を取り替えたり、古い版を返したりすると開けません。
また、暗号文の大きさから中身の長さが推測されないよう、256 バイト単位に切り上げてから暗号化しています。

端末に鍵を置いておく(毎回パスキーを使わないために)

ページを開くたびにパスキーを求めると不便なので、データ鍵を端末に置いておきます。ただし、そのままでは置きません。

  1. 端末の IndexedDB に 取り出せない鍵(⑥ 端末鍵) を作る
  2. データ鍵を⑥で暗号化し、さらに サーバーがログイン中の端末にだけ渡す割符(⑦) から作った鍵で暗号化する

ログアウトすると割符が消えるので、端末に残った控えは開けなくなります。端末を盗まれても、ログインが切れていれば中身は読めません。

複数の端末で同期する

サーバーには暗号文しかないので、衝突の解決は端末でやるしかありません。

  • 記録ごとに「版」と「変更番号」を持ち、端末は「最後に同期した版」を base として送る
  • サーバーは base が今の版と同じときだけ書き込み、違えば今の版(暗号文)を返す
  • 端末が両方を復号して、項目ごとに混ぜる(両方が変えた項目はどちらかを残し、利用者に知らせる)
  • 消したほうを優先する

この部分はバグが出やすかったので、試験を厚くしました。3 台の端末がランダムに読み書き・削除を 300 回重ねて、最後に全端末がそろうかを確かめています。
実際に、「ほかの端末が先に直したあとに消すと、削除が送られずに戻ってくる」という不具合をこの試験で見つけました。

守れること・守れないこと

正直に書いておきます。

守れること

  • サーバーの DB やバックアップが漏れても、中身は読めない
  • サーバーが記録を取り替えたり、古い版を返したりしても、端末が受け付けない
  • パスワードの漏えい・使い回しの被害がない

守れないこと

  • 配るスクリプトが書き換えられた場合:ブラウザーで暗号化する仕組みの共通の限界です。サーバー(や配る経路)が悪意のある JS を配れば、鍵を盗めます。対策として、スクリプト・字体・アイコンはすべて自分のサーバーから配り、CSP で script-src 'self' に絞っています。
  • 端末そのものの乗っ取り
  • 中身以外の情報(アカウントの名前、ログインの記録、記録の件数・大きさ・時刻)
  • パスキーと復旧キーを両方なくした場合(運営者にも戻せない。これは設計どおり)

ちなみに、Cloudflare の後ろに置いたら、Cloudflare がアクセス解析のスクリプトを勝手に差し込もうとして、CSP に止められていました。Cache-Control: no-transform を付けると差し込まれなくなります。

部品の使い方

サーバー(Flask):

from flask import Flask
from pkvault import PasskeyVault, Config

app = Flask(__name__)
pkv = PasskeyVault(app, Config(
    app_name="メモ帳",
    crypto_prefix="memo/v1",          # 暗号のラベル(決めたら変えない)
    record_kinds={"note": 5000},      # 預かる記録の種類 → 1人あたりの「件数」の上限(容量ではない)
    user_bytes_max=50 * 1024 * 1024,  # 1人が預けられる暗号文の合計(容量の上限。標準は 100MB)
    data_dir="data",
))

画面:

<script src="/pkvault/pkvault-crypto.js"></script>
<script src="/pkvault/pkvault-client.js"></script>
<script src="/pkvault/pkvault-store.js"></script>
<script src="/pkvault/pkvault-ui.js"></script>
<script>
const pkv = PKVClient.create();
const ui = PKVUI.create({ client: pkv, appName: 'メモ帳', root: document.getElementById('auth'), onReady: start });
ui.boot();   // ログイン → 鍵を開く → start()

async function start() {
  const store = PKVStore.create({ client: pkv });
  await store.load();
  store.put('note', store.newId(), { title: 'はじめて', body: '…' });  // 端末で暗号化して送る
}
</script>

ログイン・登録・復旧・パスキーの追加・ログイン中の端末の一覧・退会の画面まで入っています。見本として「暗号化されたメモ帳」が sample/ にあります。

試験

本物のブラウザーなしで試すために、Node で動く試験用のパスキー(ソフトウェアの認証器) を書きました。PRF も返します。

  • サーバー 71 項目:CSRF、チャレンジの使い回し、別サイトの応答、他人の記録、復旧の総当たり対策(作業証明・ネットワーク単位の制限)など
  • 通し 40 項目:登録 → 同期 → 衝突 → 削除 → すり替え → 復旧 → 退会、ランダム操作 300 回
  • 暗号 15 項目:改ざんの検出、長さを隠す切り上げなど

GitHub Actions で、変更のたびに全部動かしています。

計測してみた

「端末で暗号化すると重いのでは?」が気になったので、部品を使って測りました。
手元の PC の中だけで、Node.js(WebCrypto)と開発用のサーバーを動かした結果です。ブラウザーや端末によって変わるので、目安として見てください。

記録の数と、暗号化・復号にかかる時間

1件ずつ暗号化しても、1万件で暗号化 0.9 秒・復号 0.6 秒ほどでした。件数にほぼ比例して増え、急に重くなる場面はありません。

中身の大きさと、預ける暗号文の大きさ

暗号文は 256 バイト単位に切り上げているので、階段の形になります。サーバーから見えるのは「どの段か」だけで、中身の細かい長さは分かりません。そのかわり、短いメモでも 1 段ぶん(base64url で約 380 文字)の大きさになります。

新しい端末で、すべての記録を受け取って開くまで

新しい端末でログインして、サーバーから全部の暗号文を受け取り、復号し終えるまでの時間です。5,000 件で約 0.35 秒でした(サーバーも同じ PC なので、実際は通信の分だけ増えます)。

同時に使う人が増えたときの、1回の保存の待ち時間

同時に保存する人を 1 → 16 人に増やしても、中央値は 9〜14 ミリ秒でほぼ変わりません。遅いほうの 5% は 0.15 秒ほどまで伸びますが、これは書き込みを1本ずつ順番に通しているため(同時の書き込みで中身が壊れないようにするロック)です。

栞で行ったセキュリティの検査と攻撃の試し

部品の元になった栞では、公開の前に「攻撃者になったつもり」の試験を一通り行いました。
どれもテスト用のサーバー(本番と同じコードを手元で動かしたもの) に対して行い、本番のデータには触れていません。

攻撃者ごとの試験(37 項目・すべて防げた)

想定した攻撃者 試したこと 結果
ログインしていない外の人 本人用・管理用の窓口を直接呼ぶ すべて断る(管理用のものは「存在しない」と同じ応答)
ほかの利用者 他人の記録・鍵の包み・端末・パスキーを読む/変える/消す 自分のもの以外は届かない
クッキーを盗んだ人 盗んだセッションで中身を取る・退会させる、クッキーを作る/書き換える 受け取れるのは暗号文と包みだけでデータ鍵はない。退会などはパスキーでの本人確認が要る。作った・壊したクッキーは通らず、ログアウトや「ほかの端末をすべてログアウト」で使えなくなる
ログインの通信を盗み見た人 同じ応答をもう一度送る(リプレイ) チャレンジは1回きりで、使い回しは断る
復旧キーを総当たりする人 大量・同時に復旧を試す 作業証明と回数制限で止まり、当て推量で入れた要求は0本
別のサイトから操作させる人(CSRF) 印のない書き込み・別サイトからの要求 断る
壊れた・巨大な入力を送る人 変な型、巨大な数値、上限を超える量 400 で止まり、サーバーの例外は0件

あわせて、存在しないユーザーIDと、キー違いの答えが同じになること(IDがあるかどうかを探れない)も確かめています。

分離と保存された中身の検査(51 項目)

  • 利用者Bの同期に、利用者Aの暗号文は入らない。BがAと同じ番号・版で送っても、Aの記録は変わらない
  • 管理者にも、中身(暗号文を含む)を受け取る窓口がない
  • DB に保存された中身は暗号文だけで、読める形の本やメモは残っていない
  • 名前などに HTML を入れても、記録や画面でそのまま動かない

同時に届く要求の試験(13 項目)

スレッドで本当に同じ瞬間に要求を出して確かめました。

  • 同じ記録を同じ版から 16 本が同時に直す → 通るのは1本だけ、ほかは「衝突」になる
  • 8 台の端末が違う記録を同時に大量に送る → 取りこぼしも、変更番号の重なりもない
  • 上限ぎりぎりで同時に送る → 件数・量の上限をすり抜けない
  • 端末のログアウトと、その端末の保存が同時 → ログアウトのあとの保存は通らない

端末の同期の試験

  • 3 台の端末が、ばらばらの遅れの中で読み書き・削除をくり返しても、最後に全端末が同じ中身にそろう(30 項目)
  • 「消す」と「ほかの端末で直す」が重なったとき、どの順でも消したほうが残り、直した側には書いた文を知らせる(9 項目)

試験で見つけて直したもの

試験は、通すためではなく見つけるためにやりました。実際に見つかって直したものです(どれも公開前に修正済み)。

  • 同時に保存すると、黙って上書きされたり、上限をすり抜けたりすることがあった → 書く要求は最初に書き込みのロックを取るようにした
  • 端末が、ほかの端末の変更を取りこぼすことがあった → 受け取り済みの番号の進め方を直した
  • 本を消すのと同時に足したメモが、本のないまま残った → 同期のときに片付け、書いた文は知らせる
  • 同期型のパスキーで、ログインのチャレンジを使い回せる余地があった → 使ったチャレンジを記録して断る
  • 巨大な数値を送るとエラーになる箇所があった → 範囲を確かめて 400 で止める
  • クッキーに Secure が付いていなかった → 本番では必ず付ける
  • 「ほかの端末が先に直したあとに消すと、削除が戻ってくる」同期の不具合 → 消した記録を送り直すようにした(重なりの試験を追加)

公開している環境の確認

  • TLS 1.0・1.1 は断り、1.2 以上だけ受け付ける
  • CSP・HSTS・クリックジャッキング対策などのヘッダーをすべてのページに付けている
  • 字体・アイコン・バーコード読み取りの部品も自分のサーバーから配り、開いたときに外のサイトへの通信は0件
  • 管理用の画面やスクリプトは、一般の利用者には配らない

ちなみに速さは、メモ 5,000 件で開くのに約 2.5 秒(復号は 0.1 秒ほど)、メモを1件足すのは 0.03 秒ほどでした。

おわりに

パスキーの PRF を使うと、パスワードなしで、しかも運営側が中身を持たないサービスを、ブラウザー標準の機能だけで作れます。
対応状況のばらつきという課題はありますが、新しい端末ならかなり使える状態になってきました。

実際に動いているものは、こちらで試せます。

設計への指摘や改善の提案は大歓迎です。セキュリティの問題は、リポジトリの「Security」タブから非公開で知らせてください。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?