パスキーでログインする
この機能は Ver. 3.3.0 で追加予定の、リリース前の機能です
このページは、アルファ版(Ver. 3.3.0-alpha.1)時点の内容です。正式版までに仕様や設定項目が変わる可能性があります。本番サイトでは使わず、検証環境でお試しください。
パスキー(WebAuthn)を使うと、パスワードの代わりに、端末の指紋・顔・PIN などでログインできます。管理画面のログイン(/login/)と、会員のサインイン(/signin/)のどちらでも使えます。パスワードでのログインは、パスキーを登録した後もこれまでどおり使えます。
このページでは、サイトの設定から、利用者の登録・ログイン、端末を変えたとき・なくしたときまでを、管理ユーザーと会員に分けて説明します。関連するページは次のとおりです。
パスキーを二段階認証と本人確認に使う:二段階認証の 2 段目にパスキーを使う、重要な操作の前の本人確認
テーマにパスキーのログインを組み込む:会員のサインイン画面にボタンを置く
テーマにパスキーの設定ページと本人確認ページを作る:会員のマイページにパスキーの設定と本人確認のページを作る
パスキーの使いみち
使いみち | 内容 | 使える条件 |
|---|---|---|
パスワードの代わりにログインする | ID もパスワードも入力せず、パスキーだけでログインします | サイトで有効にしていて、利用者がパスキーを登録している |
二段階認証の 2 段目 | パスワードでログインした後の 2 段目に使います(認証アプリ・メールと並ぶ手段) | 上に加えて、二段階認証を使えるサイトである(パスキーを二段階認証と本人確認に使う) |
重要な操作の前の本人確認 | パスキーの登録・削除などの前に、本人であることを確かめます | ログインと同じ(パスキーを二段階認証と本人確認に使う) |
パスキーでログインした場合は、二段階認証を求めません。パスキー自体が「端末を持っていること」と「本人であること(指紋・顔・PIN)」の 2 つを確かめているためです。
使える条件
https でアクセスしていること。 ブラウザの仕様で、パスキーは https でしか使えません。例外として、
localhost(*.localhost)と127.0.0.1などのループバックのアドレスでは http でも使えます。http でアクセスしているときは、ログイン画面にパスキーのボタンを出しません。サイトの設定で有効にしていること。 管理画面のログインと会員のサインインは、別々に有効にします(次の節)。
ブラウザと端末がパスキーに対応していること。 対応していないブラウザでは、ボタンを出さず、パスワードでのログインだけになります。
登録したときと同じホスト名でアクセスすること。 パスキーは、登録したときのホスト名(
www.example.comなど。ポートは含まない)に結び付きます。別のドメインのブログや、wwwの有無が違うホスト名では、同じパスキーを使えません。会員のサインインでは、一般サインイン機能が有効なこと。 「ログイン設定」の「一般サインイン機能」が無効だと、
/signin/は 404 になります。
ブラウザに出る「サイト名」は、アクセスしたブログのブログ名です。管理ユーザーと会員のどちらとして扱うかは、利用者の権限で決まります。管理画面にログインできる権限のユーザーは「パスキーでの管理ログイン」、それ以外(会員)は「パスキーでのサインイン」の設定に従います。
サイトの設定
管理画面の「コンフィグ」で、サイトで使っているコンフィグセットの「一般設定」の「ログイン設定」(URL は /bid/{ブログID}/admin/config_login/?setid={コンフィグセットのID})を開き、「パスキー」の欄で使うものにチェックを付けて保存します。管理ユーザーだけに使わせるなら「パスキーでの管理ログイン」、会員にも使わせるなら「パスキーでのサインイン」にもチェックを付けます(会員に使わせるときは「一般サインイン機能」も有効にします)。https でログイン画面(/login/)またはサインイン画面(/signin/)を開き、パスキーのボタンが出ることを確かめます(ボタンはパスキーを登録していなくても出ます)。
パスキーにかかわる「ログイン設定」の項目は次のとおりです。
項目(画面の名前) | 設定キー | 既定値 | 説明 |
|---|---|---|---|
パスキーでの管理ログイン |
| 無効 | 「パスワードを使わずパスキーで管理ログインします」。管理ユーザーのログイン・登録・本人確認でパスキーを使えるようにします |
パスキーでのサインイン |
| 無効 | 「パスワードを使わずパスキーでサインインします」。会員のサインイン・登録・本人確認でパスキーを使えるようにします |
一般サインイン機能 |
| 有効 | 「一般サインイン機能を有効にする」。無効だと会員のサインイン画面( |
一般サインイン権限 |
| 読者のみ | サインイン画面からログインできる権限(読者のみ / 投稿者以下)。パスキーでのサインインにも同じ制限がかかります |
2段階認証 |
| 有効 | 「設定できるようにする」。パスキーを二段階認証の 2 段目に使うときに必要です(パスキーを二段階認証と本人確認に使う) |
アカウントロック |
|
| パスキーでのログインの失敗も、この設定で数えます(接続元の IP アドレスごと) |
アカウントロック時間 |
|
| ロックしている時間 |
「ログイン設定」は、コンフィグセット(またはブログ)ごとの設定です。複数のブログでコンフィグセットを分けている場合は、ログインに使うブログの設定を変えてください。
管理ユーザーの手順
パスキーを登録する
パスキーを使う端末とブラウザで、https の管理画面にログインし、自分のユーザー編集画面(/bid/{ブログID}/uid/{ユーザーID}/admin/user_edit/)の「パスキー」の行から「パスキー」の画面(admin/user_passkey/)を開き、「このデバイスにパスキーを登録」を押します。本人確認を求められたら、本人確認の画面(/admin-verify/)で確認し、戻ってからもう一度押します。ブラウザの画面で指紋・顔・PIN などで確認すると、「登録済みのパスキー」に、端末とブラウザから付けた名前で追加されます。
名前は後から変えられます(本人確認は求めません)。削除の前には本人確認を求めます。
パスキーが 1 つだけのときは、端末をなくしたときに備えて、別の端末にも登録するよう案内します。
サイトの設定で無効にしているとき、または http でアクセスしているときは、登録のボタンを出さず、その理由を表示します。登録済みのパスキーの一覧・名前の変更・削除はできます。
パスキーでログインする
ログアウトした状態で管理ログインの画面(/login/)を開き、「パスキーでログイン」を押します(ID とパスワードは入力しません)。ブラウザが選ばせるパスキーを指紋・顔・PIN などで確認すると、パスワードでのログインと同じ規則で移動します。
会員の手順
会員のページは、テーマのテンプレートで作ります。ここでは公式テーマ member の画面で説明します。自分のテーマに組み込む方法は テーマにパスキーのログインを組み込む と テーマにパスキーの設定ページと本人確認ページを作る を参照してください。
パスキーを登録する
パスキーを使う端末とブラウザで、サインイン画面(/signin/)からパスワードでサインインし、マイページの「プロフィール変更」(/mypage/update-profile/)から「パスキー設定」のページ(/mypage/update-passkey/)を開いて「パスキーを登録」を押します。本人確認を求められたら、本人確認のページ(/mypage/verify/)で確認し、元のページに戻ってからもう一度押します。ブラウザの画面で確認すると、「登録済みのパスキー」に追加されます。名前は後から変えられます。
パスキーでサインインする
サインイン画面(/signin/)で「パスキーでサインイン」を押し、ブラウザが選ばせるパスキーを確認します。閲覧制限のあるページからサインイン画面に来た場合は、そのページへ戻ります。
サインインしてよいかは、パスワードでのサインインと同じ条件(アカウントの状態、一般サインイン権限、ログインの有効期限、端末の制限)で確かめます。
失敗の回数は接続元ごとに数え、「アカウントロック」の設定でロックします。
端末を変えたとき・なくしたとき
新しい端末に変えた
古い端末を使えるうちに、新しい端末でパスワードでログイン(サインイン)します。
新しい端末で、上の手順でパスキーを登録します。
古い端末のパスキーを使わなくなったら、「パスキー」の画面(会員は「パスキー設定」のページ)で削除します。
パスキーを同期する仕組み(OS やパスワード管理ツールの同期)を使っていると、同じアカウントの別の端末でも同じパスキーを使えることがあります。使えるかどうかは端末とブラウザの機能です。
端末をなくした(本人がパスワードを知っている)
ほかの端末で、パスワードでログイン(サインイン)します。
二段階認証の 2 段目にパスキーを求められた場合は、「別の方法で認証する」から、認証アプリ・メールなど有効にしているほかの手段に切り替えます。ほかの手段が無い場合は、管理者にリセットを頼みます(次の手順)。
「パスキー」の画面(会員は「パスキー設定」のページ)で、なくした端末のパスキーを削除します(本人確認はパスワードなどで行います)。
管理者がリセットする
本人がログインできないときは、ブログの管理者が、そのユーザーのパスキーをすべて削除できます。
管理者が、対象のユーザー(会員を含む)が所属するブログか、その上の階層のブログの管理画面で、対象のユーザーの編集画面(会員は「会員」から開く)の「パスキー」の行の「パスキーをリセット」を押し、確認のメッセージで OK を押します。管理者本人の本人確認を求められたら、確認してからもう一度押します。そのあと、本人にパスワードでログインしてパスキーを登録し直すよう伝えます。
リセットすると、二段階認証の 2 段目にパスキーを使う設定も初期状態に戻ります。
リセットできるのは、操作しているブログの管理者が、そのブログか下の階層のブログに所属するユーザーに対してだけです。
自分自身のパスキーはリセットできません(「パスキー設定」から削除します)。管理者自身が端末をなくしたときは、ほかの管理者に頼みます。
リカバリーコード(認証アプリを設定したときに発行)で二段階認証を解除した場合も、2 段目にパスキーを使う設定はオフになります。登録済みのパスキーは残ります。
よくある質問・つまずき
症状 | 原因と確かめ方 |
|---|---|
ログイン画面にパスキーのボタンが出ない | (1) http でアクセスしている。アドレスバーが https か確かめます。(2) 「ログイン設定」の「パスキーでの管理ログイン」「パスキーでのサインイン」が無効。(3) ブラウザがパスキーに対応していない。(4) 自作のテーマのサインイン画面に |
サインイン画面が 404 になる | 「ログイン設定」の「一般サインイン機能」が無効です |
「パスキーで認証できませんでした。」と出る | 登録したときと違うホスト名( |
ブラウザでパスキーを選ぶ画面を閉じた | 何も起きません。もう一度ボタンを押します |
「有効期限が切れました。もう一度お試しください」と出る | ボタンを押してから 5 分以上たちました。もう一度押します |
「パスキーは利用できません」と出る | 押したときに、サイトの設定でパスキーが無効になっていたか、https ではありません |
「この認証器のパスキーはすでに登録されています。別のデバイスや認証器で登録してください。」と出る | この端末(認証器)のパスキーは、このユーザーにすでに登録されています |
登録のボタンが出ない | 「パスキーは現在無効になっています」「パスキーは https でのみ利用できます。」の表示を確かめます。表示が無ければ、ブラウザがパスキーに対応していません |
何度か失敗したらログインできなくなった | 「アカウントロック」の設定でロックしています。「アカウントロック時間」がたってから試します |
登録したら、パスワードでログインしたときにパスキーを求められるようになった | パスキーを登録すると、二段階認証の 2 段目にパスキーを使う設定が有効になるためです。2 段目に使わないときは、二段階認証の設定でオフにします(パスキーを二段階認証と本人確認に使う) |
サーバー側の記録は、管理画面の「監査ログ」で確かめられます(「パスキーが無効なため、認証しませんでした」「試行回数を超えているため、パスキー認証を中止しました」など)。
