はじめに
個人情報の流出のニュースが、ほぼ毎週のように流れてきます。
サービスを作る側として考えたのは、「漏れないように守る」に加えて「漏れても読めない作りにする」 ことでした。
そこで、読書メモのアプリ「栞 - Reading Notes」を、次の方針で作りました。
- ログインはパスキーだけ(パスワードを持たない)
- 本やメモの中身は利用者の端末で暗号化してから送る(サーバーには暗号文しかない)
- 暗号化の鍵は、パスキーの PRF 拡張から取り出した値で守る
作った仕組みは、ほかのアプリにも組み込めるように部品として切り出し、MIT ライセンスで公開しています。
-
GitHub:Yu-muimi/passkey-vault-kit(Flask+素の JavaScript。外部の暗号ライブラリなし)
-
設計の判断(なぜ PRF にしたか・脅威モデル・やらなかったこと)は Zenn に書きました:「サーバーが中身を持たない」Webアプリの設計判断
- 作ったきっかけ(読む人向けの話)は note に書きました:読み終えたら、読書メモも完成している。そんなアプリを自分で作った
この記事では、その中身(鍵の持ち方・記録の暗号化・同期・ハマったところ)を紹介します。
この部品は、第三者のセキュリティ監査を受けていません。設計の考え方の共有として読んでください。
全体像
鍵は全部で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つです。
-
PRF の出力は絶対にサーバーへ送らない:ログインの応答をサーバーに送る前に、
clientExtensionResultsからprfを消しています。 -
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 バイト単位に切り上げてから暗号化しています。
端末に鍵を置いておく(毎回パスキーを使わないために)
ページを開くたびにパスキーを求めると不便なので、データ鍵を端末に置いておきます。ただし、そのままでは置きません。
- 端末の IndexedDB に 取り出せない鍵(⑥ 端末鍵) を作る
- データ鍵を⑥で暗号化し、さらに サーバーがログイン中の端末にだけ渡す割符(⑦) から作った鍵で暗号化する
ログアウトすると割符が消えるので、端末に残った控えは開けなくなります。端末を盗まれても、ログインが切れていれば中身は読めません。
複数の端末で同期する
サーバーには暗号文しかないので、衝突の解決は端末でやるしかありません。
- 記録ごとに「版」と「変更番号」を持ち、端末は「最後に同期した版」を
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 → 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 を使うと、パスワードなしで、しかも運営側が中身を持たないサービスを、ブラウザー標準の機能だけで作れます。
対応状況のばらつきという課題はありますが、新しい端末ならかなり使える状態になってきました。
実際に動いているものは、こちらで試せます。
- 読書メモ:栞 - Reading Notes
- 部品:Yu-muimi/passkey-vault-kit
- 作ったきっかけ(note):読み終えたら、読書メモも完成している。そんなアプリを自分で作った
- 設計の考え方(Zenn):読み終えたら、読書メモも完成している。そんなアプリを自分で作った
設計への指摘や改善の提案は大歓迎です。セキュリティの問題は、リポジトリの「Security」タブから非公開で知らせてください。



