導入と運用

ログインの後にパスキーの登録を促す画面:出す時機・文言・「あとで」の扱い

9 分で読めます

この記事の要点

  • 登録の案内は、パスワードや SMS でのログイン、アカウントの復旧、別の端末でのログインに成功した直後に出す。
  • 生体認証が使える端末だけに出し、断られたら間隔を空け、ログインの流れを止めない。
  • 対応するブラウザでは、保存済みのパスワードでのログインの後にパスキーを自動で作る conditional create も使える。

パスキーの登録は、利用者がパスワードや SMS でログインに成功した直後に勧めるのが基本です。本人確認を済ませたばかりで、「次回からはこの端末の指紋や顔でログインできます」という提案が最も伝わりやすい時機だからです。案内は生体認証などが使える端末だけに出し、「あとで」を選んだ人には間隔を空けて出し直し、ログインの流れは止めません。対応するブラウザでは、保存済みのパスワードでのログインの直後にパスキーを自動で作る仕組み (conditional create) もあります。

出す時機

web.dev のパスキーの導入チェックリスト (Google) と FIDO Alliance のデザインガイドラインは、パスキーの作成を促す場面として次を挙げています (SMS の後は FIDO Alliance、ほかは web.dev)。

時機 理由
パスワード (と 2 要素目) でのログインの直後 本人確認が済んだばかりで、次回の手間が減ることを実感しやすい
SMS などのワンタイムパスワードでの確認の直後 コードを待つ手間が無くなる、と伝えやすい
アカウントの復旧 (パスワード再設定) の後 新しいパスワードの代わりにパスキーを作れる
別の端末のパスキーでログインした直後 次回から QR コードを読まずに、この端末でログインできる

逆に、ログインの前 (未確認の人) や、購入の手続きの途中のように利用者が別の目的に集中している場面は避けます。

出す相手

すべての人に毎回出すと、すぐに読まれなくなります。次の条件で絞ります。

  • 端末でパスキーを作れる。 PublicKeyCredential.isUserVerifyingPlatformAuthenticatorAvailable() (SDK なら SealGate.platformAuthenticatorAvailable()) が true の端末だけに出す。生体認証も画面ロックも無い端末で出しても、利用者は進めない
  • この端末にまだパスキーが無い。 サービス側は「どの端末に鍵があるか」を正確には知れないため、登録が済んだらその端末の Cookie や localStorage に印を残すなどで判断する。重複して登録を始めても、既存の鍵を excludeCredentials に入れておけば認証器が断る
  • ログインして間もない。 web.dev のチェックリストは、パスキーを作る前に、利用できる中で最も強い方法で本人を確かめることを勧めている。ログインから時間が経ったセッションで勧めるなら、パスワードなどで確認し直す

画面の作り方

中身

  • 見出し: 何ができるか (例:「次回から指紋・顔でログインできます」)
  • 本文: 1〜2 文で、パスキーとは何か、パスワードを覚えなくてよいこと
  • 主なボタン: 「パスキーを作成」
  • 副のボタン: 「あとで」
  • 補足のリンク: 「パスキーとは」

FIDO Alliance のデザインガイドラインは、SMS の OTP の後にパスキーを勧める例で、「パスキーがあれば、複雑なパスワードやコードを覚える必要はありません」という趣旨の見出しと、「パスキーは、指紋・顔・画面ロックで作る暗号化されたデジタルの鍵です」という説明を示しています。言葉の選び方は パスキーの画面の文言 で扱います。

置き方

  • 全画面の中間画面か、ログインの後の最初の画面の上部に出す
  • 「あとで」で必ず閉じられ、元の行き先 (ログイン前に開こうとしていた画面) へ進める
  • OS の登録ダイアログを利用者が閉じた場合 (キャンセル・時間切れ) は、エラーとして扱わず、元の行き先へ進める

「あとで」の扱い

  • 「あとで」を選んだことはサーバー側の利用者のデータに記録する (端末をまたいで同じ判断をするため)
  • 次に出すのは、一定の日数や回数のログインの後にする。毎回出すと読まれなくなる
  • 何度も断る人には、ログインの後の案内をやめ、アカウントの設定画面の「パスキー」の欄に置くだけにする

アカウントの設定画面にパスキーを作成・確認・削除できる欄を置くことは、FIDO Alliance のデザインガイドラインで「必須のパターン」とされています。ログインの後の案内を止めても、利用者が自分で作れる場所は残します。

自動で作る仕組み (conditional create)

WebAuthn Level 3 は、navigator.credentials.create() に mediation: 'conditional' を付けて、目立つダイアログを出さずにパスキーを登録する仕組みを定めています。ブラウザはパスワードマネージャーにパスワードが保存されていて、最近それでログインした場合などに、パスキーを自動で作ります。

  • Chrome はパソコン版の 136 で対応し、Google パスワードマネージャーにパスワードが保存され、最近それでログインに使われた場合に作成が成功します
  • Safari は 18.0 で、登録での mediation=conditional に対応しました
  • 対応しているかは PublicKeyCredential.getClientCapabilities() の conditionalCreate で確かめる。仕様もこの確認を勧めている
  • 仕様は、conditional での作成ではユーザーの存在確認とユーザー確認を求めない (その場で行う場合を除く) としている。サーバー側でユーザー確認 (userVerification) を必須にしていると、この経路で作られた鍵は登録で拒否されうる

自動作成は利用者の操作を増やさない一方、作られたことに利用者が気付きにくい面もあります。作成の後に通知 (メールなど) を送ると、利用者が把握でき、身に覚えのない登録にも気付けます。web.dev のチェックリストも、パスキーの作成後に利用者へ通知することを挙げています。

登録の後にすること

  • 登録した鍵に呼び名を付ける (端末名や、AAGUID から分かるパスキーのプロバイダー名)
  • 「次回から使えます」と短く伝え、元の行き先へ進める
  • 利用者に登録を知らせる通知を送る
  • 登録率を測る。案内を出した数、作成を押した数、登録が完了した数を分けて数えると、どこで止まっているかが分かる。指標は パスキー導入の指標 で扱う

SealGate で実装する場合

ログインの直後の画面で、ブラウザ SDK の sg.register({ name: 'この端末' }) を呼びます。開発者のサーバーは、ログイン済みであることをセッションで確かめてから、signed_in: true を付けて /v1/register/options を呼びます。利用者が既にこの認証器に鍵を持っている場合、SDK は already_registered で失敗するので、案内を閉じて「この端末には登録済みです」と伝えれば足ります。ダイアログを閉じた場合は cancelled です。

SDK の register() は通常の登録ダイアログを出す呼び出しで、上の自動作成 (mediation: 'conditional') の指定はありません。登録の通知は、Webhook の register.completed を受けて開発者側から送れます。登録の件数は GET /v1/apps/{app_id}/stats の registrations で確かめられます。詳しくは ドキュメント を参照してください。

よくある質問

新規登録の画面で、最初からパスキーを作ってもらうべきですか?

作れる端末なら勧めてかまいません。ただし復旧の手段 (メールアドレスの確認など) を先に用意しておく必要があります。

「あとで」を選んだ人に、何回まで出してよいですか?

決まった回数はありません。サーバー側に記録して間隔を空け、何度も断る人にはログインの後の案内をやめ、設定画面に置くだけにします。

自動作成に対応していないブラウザではどうなりますか?

getClientCapabilities() で conditionalCreate が無ければ、通常の登録の案内を出します。

出典

関連する記事

ブログの一覧へ