パスキーを二段階認証と本人確認に使う


この機能は Ver. 3.3.0 で追加予定の、リリース前の機能です

このページは、アルファ版(Ver. 3.3.0-alpha.1)時点の内容です。正式版までに仕様や設定項目が変わる可能性があります。本番サイトでは使わず、検証環境でお試しください。

パスキーは、パスワードの代わりにログインするほか、二段階認証の 2 段目と、重要な操作の前の本人確認にも使います。このページでは、その 2 つの使い方と、本人確認の設定を説明します。サイトの設定とパスキーの登録は パスキーでログインする を参照してください。

二段階認証の 2 段目に使う

二段階認証の手段は、認証アプリ・メール・パスキーの 3 つです。メールについては 二段階認証でメール認証を使う を参照してください。パスキーを 2 段目に使うには、次をすべて満たす必要があります。

  • 「ログイン設定」の「2段階認証」が「設定できるようにする」(two_factor_auth)になっている。

  • 「ログイン設定」の「パスキーでの管理ログイン」「パスキーでのサインイン」のどちらかが有効になっている。

  • 利用者がパスキーを登録している。

  • 利用者の二段階認証の設定で、パスキーが「有効」になっている(パスキーを登録すると、初めから有効です)。

パスキーを登録すると、パスワードでのログインの後にパスキーを求められるようになります

二段階認証を使えるサイトでは、パスキーを登録した利用者がパスワードでログインすると、2 段目にパスキー(主に使う手段がほかにあれば、そちら)を求めます。2 段目に使わない場合は、下の手順でオフにします。オフにしても、登録済みのパスキーは残り、パスワードの代わりのログインには使えます。

2 段目に使うかどうかを切り替える

管理ユーザーは、自分のユーザー編集画面の「2段階認証」の画面(admin/user_tfa/)で、表の「パスキー」の行の「有効」を付ける(使う)か外して(使わない)保存します。主に使う手段にするときは「メイン」を選びます。会員は、マイページの「2段階認証設定」のページ(/mypage/update-tfa/。member テーマ)の「認証手段」の「パスキー」の行で、同じように切り替えます(主に使うときは「主に使う」)。「パスキー」の行は、パスキーを登録しているときだけ表示します。テーマに組み込む方法は テーマに二段階認証(メール認証)の画面を組み込む を参照してください。

ログインの流れ

  1. ID(メールアドレス)とパスワードでログインします。

  2. 2 段目の手段がパスキーのときは、「登録済みのパスキーで認証します。」の画面になります。「パスキーで認証する」を押し、指紋・顔・PIN などで確認します。

  3. ログインできます。

  • 2 段目では、そのユーザーが登録したパスキーだけを受け付けます。

  • ほかの手段も有効にしていれば、「別の方法で認証する」の下のボタンで切り替えられます(管理ログインでは「認証アプリを使う」など、member テーマでは「認証アプリで認証する」など)。

  • 主に使う手段が使えないとき(認証アプリの秘密鍵を復号できない、など)は、使えるほかの手段に自動で切り替わります。

重要な操作の前の本人確認

ログインしていても、次の操作の前には本人確認を求めます。アカウントを乗っ取られたときに、認証の手段を書き換えられないようにするためです。

  • パスキーの登録

  • パスキーの削除

  • 管理者による、ほかのユーザーのパスキーのリセット

本人確認の流れは次のとおりです。

  1. 利用者が、上の操作のボタンを押します。

  2. 本人確認が済んでいなければ、本人確認のページへ移動します。

  3. ページで確認の方法(パスキー・パスワード・メール)を選び、確認します。二段階認証を使っている利用者は、続けて 2 段目でも確認します。

  4. 確認が済むと元のページに戻り、「本人確認が完了しました。もう一度操作してください。」と表示されます。

  5. 利用者が、同じ操作をもう一度します(パスキーの登録はブラウザの仕様で、利用者の操作をきっかけにする必要があるためです)。

利用者

本人確認のページ

テンプレート(設定キー)

会員

/mypage/verify/

_member/verify.html(tpl_verify)

管理ユーザー

/admin-verify/

_member-admin/verify.html(tpl_admin-verify)

  • 一度確認すると、sudo_mode_lifetime(既定 10 分)の間は確認を省きます。この間に操作しても、時間は延びません。

  • 二段階認証やパスキーでログインした直後も、この間は確認を省きます。

  • ユーザーを切り替えているあいだは、本人確認もパスキーの登録・削除もできません(「ユーザーを切り替えている間は、本人確認ができません。元のユーザーに戻してから操作してください。」)。

本人確認の方法の決まり方

ログインと同じ強さで確かめます。1 段目の選択肢は、サイトのログインの方式と、利用者の状態で決まります。

パスワードでログインするサイト

メール認証でログインするサイト

1 段目の選択肢

パスキー(その画面でパスキーを使えて、登録している利用者)、パスワード

パスキー(同左)、メールで送る確認コード(メールアドレスがある利用者)

2 段目(二段階認証を使っている利用者)

1 段目がパスキーなら無し。パスワードなら、二段階認証の手段(認証アプリ・メール・パスキー)

1 段目がパスキーなら無し。確認コードなら、メール以外の二段階認証の手段(認証アプリ・パスキー)

  • 「メール認証でログインするサイト」は、「ログイン設定」の「メール認証での管理ログイン」(管理ユーザー)または「メール認証でのサインイン」(会員)が有効なサイトです。

  • パスワードでログインするサイトでは、確認コードの選択肢を出しません。SNS ログインだけで登録しパスワードを知らない利用者は、パスワードを再発行するか、パスキーで確認します。

  • 使える方法が無い場合は、「本人確認に使える方法がありません。管理者にお問い合わせください。」と表示します。

設定キーの一覧

次の設定は管理画面に出ません。変えるときは、システムの設定ファイル(private/config.system.yaml)に書きます。

設定キー

既定値

説明

sudo_mode_lifetime

10

本人確認の後、確認を省く時間(分)。0 にすると毎回確認します

passkey_reauth_trial_time

5

本人確認(パスワード・確認コード・認証アプリ)の失敗を数える期間(分)

passkey_reauth_trial_number

5

上の期間に、パスワードの確認にこの回数失敗するとロックします。空にすると回数を制限しません(認証アプリのコードは、空のときも 5 回で制限します)

passkey_reauth_lock_time

5

ロックする時間(分)

sudo_mode_lifetime: 15
passkey_reauth_trial_time: 5
passkey_reauth_trial_number: 5
passkey_reauth_lock_time: 10

メールで送る確認コードでの本人確認は、次の値で固定です(変えられません)。数える期間とロックする時間は、上の passkey_reauth_trial_time / passkey_reauth_lock_time を使います。

項目

値

確認コードの有効時間

10 分

再送できるようになるまでの間隔

60 秒

確認コードを間違えてよい回数

5 回(超えるとロック)

送信できる回数

5 回(超えるとロック)

ロックしているときは「本人確認に続けて失敗したため、一時的に操作できません。時間をおいてもう一度お試しください。」と表示します。

本人確認のメール

メール認証でログインするサイトで、確認コードで本人確認するときに送るメールです。管理画面の「コンフィグ」>「メール設定」の「本人確認(パスキーの登録など)」で、差出人とテンプレートを指定します。確認コードを含むため、Bcc の設定はありません。

項目(画面の名前)

設定キー

既定値

From

mail_reauth_email_from

info@example.com

件名テンプレート

mail_reauth_email_tpl_subject

mail/reauth-email/subject.txt

本文テンプレート(TEXT)

mail_reauth_email_tpl_body

mail/reauth-email/body.txt

本文テンプレート(HTML)

mail_reauth_email_tpl_body_html

mail/reauth-email/body.html

テンプレートで使える変数は、二段階認証のメールと同じ {verifyCode}(確認コード)と {codeLifetime}(有効時間の分)です。テーマに mail/reauth-email/body.txt などを置くと、system テーマのものの代わりに使います。system テーマの本文(TEXT)は次のとおりです。

本人確認の確認コードをお知らせします。

パスキーの登録など、アカウントの重要な操作を続けるため、
画面に以下のコードを入力してください。

{verifyCode}

このコードは {codeLifetime} 分間有効です。
有効期限が切れた場合は、画面から確認コードを再送信してください。

※このメールに心当たりがない場合、第三者があなたのアカウントにログインしている可能性があります。
 コードは入力せず、パスワードの変更とログイン中の端末の確認をおすすめします。

※本メールはシステムからの自動配信メールです。

よくある質問・つまずき

症状

原因と確かめ方

パスキーを登録しようとすると、毎回本人確認のページへ移る

sudo_mode_lifetime が 0 になっていないかを確かめます。本人確認から戻った後は、もう一度ボタンを押す必要があります

本人確認のページに何も表示されない

自作のテーマの _member/verify.html にブロックが足りません(テーマにパスキーの設定ページと本人確認ページを作る)

「この方法では本人確認できません。別の方法を選んでください。」と出る

その利用者・サイトでは使えない方法を選びました(パスワードのサイトで確認コード、など)。表示されている選択肢から選び直します

確認コードのメールが届かない

「メール設定」の「本人確認(パスキーの登録など)」の From とテンプレート、サーバーのメール送信の設定を確かめます。送れなかったときは「確認コードを送信できませんでした。」と表示します

2 段目にパスキーを求められて、ログインできない

端末をなくした場合は、「別の方法で認証する」でほかの手段に切り替えるか、管理者にパスキーのリセットを頼みます(パスキーでログインする の「端末を変えたとき・なくしたとき」)