はじめに
プリザンター 1.5.10.0 のリリースノートには、パスキー認証に関する修正が 3 つ入っています。
- セッションの保存先を Redis にすると、パスキー認証が利用できない
- 無効にしたユーザでもパスキー認証でログインできる
- パスキーの登録途中で別のユーザでログインし直しても、登録が完了できてしまう
この記事では、1.5.9.1 から 1.5.10.0 までの差分を追いかけて、どのコードがどう変わったのかを具体的に読み解きます。パスキーの仕組みを知らなくても読めるように、先に処理の流れを整理します。
対象は 1.5.9.1 → 1.5.10.0 の差分です。コードの引用は 1.5.10.0 のコミット(c6d8974df84ab5ba6029aaf394f9613b3a4211cb)、修正前は 1.5.9.1 のコミット(1c693a1ee379a87e588232e43216400431376653)に固定しています。いずれもソースを読んだ結果で、各経路を実行して再現した結果ではありません。
パスキーの処理の流れ
パスキー(WebAuthn)の登録とログインは、どちらもサーバーが作った「チャレンジ入りのオプション」をブラウザーに渡し、ブラウザーが認証器で署名した応答を返し、サーバーが元のオプションと突き合わせて検証するという 2 往復です。
つまりセッションに預けたオプションが、2 回目のリクエストで確実に、1 回だけ、正しい相手のものとして取り出せるかが安全性の要です。今回の 3 つの修正は、この前後の扱いに関わっています。
プリザンターでは PasskeysController が 4 つの入口(登録のオプション作成・登録の完了、ログインのオプション作成・ログインの完了)を持ち、オプションは PasskeyUtilities.SessionSet でセッションに保存します。キーには Passkeys_ の接頭辞が付きます。
SessionUtilities.Set(
context: context,
key: $"Passkeys_{key}",
value: stringValue);
修正1:取り出しと削除を「1 回の原子的な操作」に変えた
修正は、セッションからの取り出し方そのものを変えています。
修正前:読んでから別操作で消す
1.5.9.1 の MakeCredential(登録の完了)と MakeAssertion(ログインの完了)は、次の順に処理していました。
var bodyData = JsonSerializer.Deserialize<AuthenticatorAttestationRawResponse>(context.Forms.Data("data"));
var optionsJson = PasskeyUtilities.SessionGetString(
context: context,
key: Fido2AttestationOptions);
if (optionsJson.IsNullOrWhiteSpace())
{
return Messages.ResponsePasskeyResponseInvalid(context: context)
.ToJson();
}
PasskeyUtilities.SessionRemove(context: context, key: Fido2AttestationOptions);
SessionGetString が取得し、その後で SessionRemove が削除します。2 つの別操作です。
修正後:Take で取得と削除を同時に行う
1.5.10.0 では SessionTakeString に置き換わり、SessionRemove は削除されました。
var optionsJson = PasskeyUtilities.SessionTakeString(
context: context,
key: Fido2AttestationOptions);
if (optionsJson.IsNullOrWhiteSpace())
{
return Messages.ResponsePasskeyResponseInvalid(context: context)
.ToJson();
}
var bodyData = JsonSerializer.Deserialize<AuthenticatorAttestationRawResponse>(context.Forms.Data("data"));
(PasskeysController.cs#L134-L142)
細かい点ですが、応答の JSON のデシリアライズを、オプションの取り出しより後ろに移動しています。不正な本文を送ってもオプションの取り出し(=消費)は先に済むので、「失敗しても同じオプションで何度でも試せる」状態にはなりません。
SessionTakeString の中身は、新設された SessionUtilities.Take です。
public static string SessionTakeString(Context context, string key)
{
return SessionUtilities.Take(
context: context,
key: $"Passkeys_{key}") ?? string.Empty;
}
Take の実装:保存先ごとに原子的に取り出す
Take は、保存先によって 2 通りに分かれます(SessionUtilities.cs#L30-L100)。
Redis(Parameters.Session.UseKeyValueStore)の場合は、Lua スクリプトで取得と削除を 1 回の命令にまとめます。
var result = Implem.Pleasanter.Libraries.Redis.CacheForRedisConnection.Connection
.GetDatabase().ScriptEvaluate(
script: "local value = redis.call('HGET', KEYS[1], ARGV[1]); "
+ "if value then redis.call('HDEL', KEYS[1], ARGV[1]); return value end; return false",
keys: new StackExchange.Redis.RedisKey[] { target },
values: new StackExchange.Redis.RedisValue[] { field });
return (string)result;
Redis はスクリプトを 1 つの命令として実行するので、HGET と HDEL の間に他のリクエストが割り込めません。
データベース(SQL Server・PostgreSQL・MySQL)の場合は、DBMS ごとに「削除しながら値を返す」SQL にします。
| DBMS | 方法 |
|---|---|
| SQL Server | delete ... output deleted."Value" |
| PostgreSQL | delete ... returning "Value" |
| MySQL |
select ... for update で行を押さえ、続けて delete(削除できた件数が 1 のときだけ値を返す) |
MySQL は returning を持たないため、トランザクションの中で for update により行をロックしてから削除しています。この 3 つ以外の DBMS は NotSupportedException で、原子的に取り出せない状態を黙って通すことはしません。さらに、削除の条件には ReadOnce と UserArea のどちらも立っていない行だけを対象にする条件が付いています。
これで何が防がれるか
「オプションは 1 回しか使えない」ことが、チャレンジを使った検証の前提です。取得と削除が別操作だと、同じセッションで 2 つのリクエストをほぼ同時に送ると、両方が「まだ残っている」オプションを取得できる可能性があります。Take は、片方だけが値を受け取り、もう片方は空文字列になるため、optionsJson.IsNullOrWhiteSpace() の分岐で ResponsePasskeyResponseInvalid になります。
この競合が実際に悪用できるかどうかは、ここでは検証していません。コードから言えるのは、修正前は取得と削除が別操作で、修正後は 1 回の原子的な操作になった、という点までです。
修正2:Redis のときにオプションを取り出せなかった問題
リリースノートの「セッションの保存先を Redis にすると、パスキー認証が利用できない」は、Take の追加でなぜ直るのかが、コードから読み取れます。
修正前:キーを _ で分割して先頭だけを使っていた
Redis 利用時の SessionUtilities.Get は、Redis のハッシュのフィールド名を _ で分割し、先頭の要素をキーにした辞書を返していました。
var sessions = iDatabase.HashGetAll(key)
.Where(dataRow =>
dataRow.Name.ToString().Split('_').Count() == 1 ||
(context.Page == null && sessionGuid == null) ||
dataRow.Name.ToString().Split('_')[1] == context.Page)
.ToDictionary(dataRow => dataRow.Name.ToString().Split('_')[0], dataRow => dataRow.Value.ToString());
(1.5.9.1 の SessionUtilities.cs#L44)
これは、Redis のフィールド名が キー または キー_ページ名 の形で保存されることを前提にした作りです。ところがパスキーのキーは、Passkeys_Fido2AttestationOptions のように、キー自体に _ を含みます。Split('_')[0] を取ると、辞書のキーは Passkeys になってしまいます。
一方、取得する側は修正前の SessionGetString で、次のようにキーを探します。
var dic = SessionUtilities.Get(context: context);
if (dic.TryGetValue($"Passkeys_{key}", out var json))
{
return json;
}
return string.Empty;
辞書にあるのは Passkeys で、探しているのは Passkeys_Fido2AttestationOptions ですから、Redis のときは一致せず、必ず空文字列が返ります。空なら ResponsePasskeyResponseInvalid になるので、登録もログインも完了できません。リリースノートの症状と一致します。データベースを使う構成では、Key 列を丸ごと辞書のキーにするため、この問題は起きません。
修正後:分割せずフィールド名をそのまま使う
Take は Get を経由せず、フィールド名をそのまま HGET / HDEL に渡します。
var field = pageName.Length == 0 ? key : $"{key}_{pageName}";
key は Passkeys_Fido2AttestationOptions のままで、分割しません。これで Redis でも取り出せます。
削除側にあった、もう 1 つの穴
修正前の SessionRemove は、SessionUtilities.Remove を呼んでいました。この関数は Rds.PhysicalDeleteSessions でデータベースの Sessions テーブルだけを削除します(1.5.9.1 の SessionUtilities.cs#L248)。Redis にある値には触れません。そのため、仮に取得できていたとしても、Redis では「使い終わったオプションが消えずに残る」ことになります。Take は取得と削除を Redis 側で行うので、この点も解消しています。
修正3:登録の完了時に「誰のオプションか」を確認する
もう 1 つは、リリースノートの「パスキーの登録途中で別のユーザでログインし直しても、登録が完了できてしまう」です。
登録のオプションには、ユーザーが埋め込まれている
登録を始めるとき(CreateOptions 側)、オプションにはログイン中のユーザーの ID が Fido2User.Id として入ります。
var fido2User = new Fido2User
{
Id = System.Text.Encoding.UTF8.GetBytes(context.UserId.ToString()),
Name = context.LoginId,
DisplayName = context?.User?.Name ?? string.Empty
};
(PasskeysController.cs#L80-L85)
修正前:完了時に、今ログインしているユーザーの ID で保存していた
登録を完了する MakeCredential は、オプションを取り出した後、**そのときのセッションのユーザー(context.UserId)**で、パスキーを保存します。
var passkeyModel = new PasskeyModel(
context: context,
userId: context.UserId)
{
CredentialId = credential.Id.ToBase64UrlString(),
...
オプションを作ったユーザーと、完了時のユーザーが一致するかどうかの確認がありませんでした。同じブラウザーのセッションで、ユーザー A で登録を始めてオプションを作り、ユーザー B でログインし直してから完了させると、A 用のオプションに対する応答が、B のパスキーとして登録される経路があったことになります。リリースノートの「登録途中で別のユーザでログインし直しても」はこの状況のことです。
修正後:オプションのユーザー ID と現在のユーザー ID を比較する
1.5.10.0 では、取り出したオプションを作り直した後に、次の確認が加わりました。
var options = CredentialCreateOptions.FromJson(optionsJson);
if (context.UserId <= 0
|| options.User?.Id == null
|| !options.User.Id.SequenceEqual(System.Text.Encoding.UTF8.GetBytes(context.UserId.ToString())))
{
return Messages.ResponsePasskeyResponseInvalid(context: context)
.ToJson();
}
(PasskeysController.cs#L143-L151)
条件は 3 つで、どれか 1 つでも満たすと拒否します。
| 条件 | 意味 |
|---|---|
context.UserId <= 0 |
ログインしていない |
options.User?.Id == null |
オプションにユーザーが入っていない |
| ID のバイト列が一致しない | オプションを作ったユーザーと、今のユーザーが違う |
比較は、オプションを作ったときと同じ方法(UserId の文字列を UTF-8 のバイト列にしたもの)で行います。登録の最後に、オプションが「いま完了しようとしているユーザーのために作られたもの」であることを確かめる形です。なお、この確認より前に Take でオプションが消費されているので、拒否されたオプションを使い回すこともできません。
修正4:無効なユーザーはパスキーでもログインさせない
最後が、リリースノートの「無効にしたユーザでもパスキー認証でログインできる」です。
ログインの完了までの流れ
MakeAssertion(ログインの完了)は、署名の検証を終えると、パスキーに結び付いた UserId からユーザーを引き、UserModel.Authenticate を呼びます。このとき isAuthenticationByPasskey: true を渡します。
json = new UserModel(
context: context,
ss: ss,
userId: passkey.UserId)
.Get(
context: context,
ss: ss,
where: Rds.UsersWhere()
.UserId(passkey.UserId))
.Authenticate(
context: context,
returnUrl: returnUrl,
isAuthenticationByMail: false,
isAuthenticationByPasskey: true);
(PasskeysController.cs#L328-L341)
Authenticate はパスキーのときパスワード側の検証を飛ばす
UserModel.Authenticate の中には、次の分岐があります。
if (!isAuthenticationByPasskey && !Authenticate(context: context))
{
...
return Deny(context: context);
}
パスキーで認証済みの場合は、パスワードなどを検証する Authenticate(context) をまるごと飛ばします。署名の検証はすでに終わっているためです。ただし、パスワード側の検証を飛ばしたことで、その検証に含まれていた確認まで通らなくなる可能性があります。
修正:Disabled を先に拒否する
1.5.10.0 では、この分岐より前に、パスキー認証で Disabled(無効)のユーザーを拒否する判定が加わりました。
if (isAuthenticationByPasskey && Disabled)
{
return Deny(context: context);
}
位置にも意味があります。直前には、Parameters.Security.RevealUserDisabled が有効なときに「ユーザーが無効です」と具体的に返す処理があり、その後ろ、RejectUnregisteredUser や、パスワード側の Authenticate の分岐より前です。パスキーで来た無効ユーザーは、他のどの確認よりも先に、Deny(一般的な拒否応答)で止まります。
なお、署名の検証は MakeAssertion の中で先に済んでいます。無効にしたユーザーでも、パスキーそのものは有効な署名を返せるため、署名の検証だけでは止められません。認証の成功と、アカウントが使える状態であることは別の確認、という典型的な穴です。
3 つの修正の関係
| 症状 | 変更した場所 | 変更の要点 |
|---|---|---|
| Redis でパスキー認証が使えない |
SessionUtilities.Take(新設) |
_ で分割せず、フィールド名のまま HGET・HDEL
|
| オプションが使い回せる可能性 |
PasskeysController、SessionUtilities.Take
|
取得と削除を原子的に(Lua/delete ... output/returning/for update) |
| 登録途中でユーザーを替えられる | PasskeysController.MakeCredential |
オプションの User.Id と context.UserId を比較 |
| 無効ユーザーがログインできる | UserModel.Authenticate |
パスキー認証で Disabled なら Deny
|
この表の 2 行目と 3 行目は、セットで効いています。**1 回しか使えないオプションを(2 行目)、作った本人のためのものとして確認する(3 行目)**ことで、登録の入口が閉じる形です。
更新時の確認ポイント
| 確認する項目 | 見るもの |
|---|---|
| 利用中の版 | 1.5.9.1 以前なら、いずれの修正も入っていません。1.5.10.0 以降へ更新します |
| パスキーを使っているか |
Authentication.json の PasskeyParameters.Enabled
|
| Redis を使っているか |
Session.json の UseKeyValueStore。有効なら、更新前はパスキーが使えなかった可能性があります |
| 無効ユーザーの運用 | パスキー登録済みのユーザーを無効にした場合に、ログインが拒否されること |
| 登録の動作 | 検証環境で、別ユーザーでログインし直す手順を入れて、登録が失敗すること |
この表は、ソースから整理した確認項目です。実機での検証までは行っていません。
まとめ
1.5.10.0 のパスキー関連の修正 3 点を、コード差分から読み解きました。
-
Redis:キーを
_で分割して先頭だけを使う作りが、Passkeys_...というキーと噛み合っていなかった。Takeはフィールド名をそのまま使う -
使い回し:取得と削除が別操作だったものを、
Takeで原子的な 1 操作にした。保存先ごとに Lua・output・returning・for updateで実現している - 登録:完了時に、オプションを作ったユーザーと今のユーザーが同じかどうかを確認するようにした
-
無効ユーザー:パスキー認証でも
Disabledを先にDenyする
パスキーは、署名が正しいことと、その署名を受け入れてよい状況であることが別々の確認になります。今回の修正は、署名の検証の前後にある「セッションの扱い」と「アカウントの状態」の確認を埋めるものでした。パスキーを使っている環境は、早めに 1.5.10.0 以降への更新を検討してください。