パスキーでログインする


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

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

パスキー(WebAuthn)を使うと、パスワードの代わりに、端末の指紋・顔・PIN などでログインできます。管理画面のログイン(/login/)と、会員のサインイン(/signin/)のどちらでも使えます。パスワードでのログインは、パスキーを登録した後もこれまでどおり使えます。

このページでは、サイトの設定から、利用者の登録・ログイン、端末を変えたとき・なくしたときまでを、管理ユーザーと会員に分けて説明します。関連するページは次のとおりです。

パスキーの使いみち

使いみち

内容

使える条件

パスワードの代わりにログインする

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/)を開き、パスキーのボタンが出ることを確かめます(ボタンはパスキーを登録していなくても出ます)。

「ログイン設定」の「パスキー」の欄
「ログイン設定」の「パスキー」の欄

パスキーにかかわる「ログイン設定」の項目は次のとおりです。

項目(画面の名前)

設定キー

既定値

説明

パスキーでの管理ログイン

passkey-login

無効

「パスワードを使わずパスキーで管理ログインします」。管理ユーザーのログイン・登録・本人確認でパスキーを使えるようにします

パスキーでのサインイン

passkey-signin

無効

「パスワードを使わずパスキーでサインインします」。会員のサインイン・登録・本人確認でパスキーを使えるようにします

一般サインイン機能

member_login_enable

有効

「一般サインイン機能を有効にする」。無効だと会員のサインイン画面(/signin/)を使えません

一般サインイン権限

signin_page_auth

読者のみ

サインイン画面からログインできる権限(読者のみ / 投稿者以下)。パスキーでのサインインにも同じ制限がかかります

2段階認証

two_factor_auth

有効

「設定できるようにする」。パスキーを二段階認証の 2 段目に使うときに必要です(パスキーを二段階認証と本人確認に使う)

アカウントロック

login_trial_time / login_trial_number

5 分 / 5 回

パスキーでのログインの失敗も、この設定で数えます(接続元の IP アドレスごと)

アカウントロック時間

login_lock_time

5 分

ロックしている時間

「ログイン設定」は、コンフィグセット(またはブログ)ごとの設定です。複数のブログでコンフィグセットを分けている場合は、ログインに使うブログの設定を変えてください。

管理ユーザーの手順

パスキーを登録する

パスキーを使う端末とブラウザで、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/)で「パスキーでサインイン」を押し、ブラウザが選ばせるパスキーを確認します。閲覧制限のあるページからサインイン画面に来た場合は、そのページへ戻ります。

  • サインインしてよいかは、パスワードでのサインインと同じ条件(アカウントの状態、一般サインイン権限、ログインの有効期限、端末の制限)で確かめます。

  • 失敗の回数は接続元ごとに数え、「アカウントロック」の設定でロックします。

端末を変えたとき・なくしたとき

新しい端末に変えた

  1. 古い端末を使えるうちに、新しい端末でパスワードでログイン(サインイン)します。

  2. 新しい端末で、上の手順でパスキーを登録します。

  3. 古い端末のパスキーを使わなくなったら、「パスキー」の画面(会員は「パスキー設定」のページ)で削除します。

パスキーを同期する仕組み(OS やパスワード管理ツールの同期)を使っていると、同じアカウントの別の端末でも同じパスキーを使えることがあります。使えるかどうかは端末とブラウザの機能です。

端末をなくした(本人がパスワードを知っている)

  1. ほかの端末で、パスワードでログイン(サインイン)します。

  2. 二段階認証の 2 段目にパスキーを求められた場合は、「別の方法で認証する」から、認証アプリ・メールなど有効にしているほかの手段に切り替えます。ほかの手段が無い場合は、管理者にリセットを頼みます(次の手順)。

  3. 「パスキー」の画面(会員は「パスキー設定」のページ)で、なくした端末のパスキーを削除します(本人確認はパスワードなどで行います)。

管理者がリセットする

本人がログインできないときは、ブログの管理者が、そのユーザーのパスキーをすべて削除できます。

管理者が、対象のユーザー(会員を含む)が所属するブログか、その上の階層のブログの管理画面で、対象のユーザーの編集画面(会員は「会員」から開く)の「パスキー」の行の「パスキーをリセット」を押し、確認のメッセージで OK を押します。管理者本人の本人確認を求められたら、確認してからもう一度押します。そのあと、本人にパスワードでログインしてパスキーを登録し直すよう伝えます。

  • リセットすると、二段階認証の 2 段目にパスキーを使う設定も初期状態に戻ります。

  • リセットできるのは、操作しているブログの管理者が、そのブログか下の階層のブログに所属するユーザーに対してだけです。

  • 自分自身のパスキーはリセットできません(「パスキー設定」から削除します)。管理者自身が端末をなくしたときは、ほかの管理者に頼みます。

  • リカバリーコード(認証アプリを設定したときに発行)で二段階認証を解除した場合も、2 段目にパスキーを使う設定はオフになります。登録済みのパスキーは残ります。

よくある質問・つまずき

症状

原因と確かめ方

ログイン画面にパスキーのボタンが出ない

(1) http でアクセスしている。アドレスバーが https か確かめます。(2) 「ログイン設定」の「パスキーでの管理ログイン」「パスキーでのサインイン」が無効。(3) ブラウザがパスキーに対応していない。(4) 自作のテーマのサインイン画面に passkey ブロックが無い(テーマにパスキーのログインを組み込む)。(5) テーマで公開側の acms.js を読み込んでいない。ボタンは JavaScript が対応を確かめてから表示します

サインイン画面が 404 になる

「ログイン設定」の「一般サインイン機能」が無効です

「パスキーで認証できませんでした。」と出る

登録したときと違うホスト名(www の有無、別のドメインのブログ、エイリアスのドメイン)でアクセスしている、パスキーがサーバー側で削除・リセットされている、ログインが許されていないユーザー(一般サインイン権限・アカウントの状態)、などが考えられます。登録したときの URL で試し、ユーザーの状態を確かめます

ブラウザでパスキーを選ぶ画面を閉じた

何も起きません。もう一度ボタンを押します

「有効期限が切れました。もう一度お試しください」と出る

ボタンを押してから 5 分以上たちました。もう一度押します

「パスキーは利用できません」と出る

押したときに、サイトの設定でパスキーが無効になっていたか、https ではありません

「この認証器のパスキーはすでに登録されています。別のデバイスや認証器で登録してください。」と出る

この端末(認証器)のパスキーは、このユーザーにすでに登録されています

登録のボタンが出ない

「パスキーは現在無効になっています」「パスキーは https でのみ利用できます。」の表示を確かめます。表示が無ければ、ブラウザがパスキーに対応していません

何度か失敗したらログインできなくなった

「アカウントロック」の設定でロックしています。「アカウントロック時間」がたってから試します

登録したら、パスワードでログインしたときにパスキーを求められるようになった

パスキーを登録すると、二段階認証の 2 段目にパスキーを使う設定が有効になるためです。2 段目に使わないときは、二段階認証の設定でオフにします(パスキーを二段階認証と本人確認に使う)

サーバー側の記録は、管理画面の「監査ログ」で確かめられます(「パスキーが無効なため、認証しませんでした」「試行回数を超えているため、パスキー認証を中止しました」など)。