Skip to main content
WebAuthn の概要と、Auth0 における セキュリティキー および Device Biometrics の実装については、FIDO Authentication with WebAuthn をご覧ください。

利用可否は Auth0 のプランによって異なります

この機能を利用できるかどうかは、ログイン実装の内容と、Auth0 のプランまたはカスタム契約の両方によって異なります。詳しくは、Pricing をご覧ください。
カスタムドメインを設定する必要がある場合は、本番環境で WebAuthn を展開する前に設定してください。カスタムドメインを設定または変更すると、以前に登録したユーザーは認証できなくなります。ユーザーの認証に使用するドメインは、Relying Party 設定で指定できます。

Auth0 Dashboard を使用する

  1. Dashboard > Security > Multi-factor Auth に移動し、WebAuthn with セキュリティキー を有効にします。
  2. User Verification の扱い方を設定します。セキュリティキー の場合、一般的な User Verification のプロンプトでは、WebAuthn チャレンジを完了するためにユーザーに PIN の入力を求めます。
    1. Never: ユーザーに PIN の入力を求めることはありません。これはデフォルト値であり、MFA で セキュリティキー を使用する場合は通常これで十分です。ユーザーはすでにパスワードを入力しているため、一定の本人確認はすでに行われています。
    2. If supported: ユーザーがそのキーにすでに PIN を設定している場合は、PIN の入力を求められます。
    3. Required: PIN がまだ設定されていない場合は設定を求められ、以後は毎回入力を求められます。これは最も高いセキュリティを提供するオプションです。一部のブラウザーではこれが正しく実装されていないため (たとえば iOS の Brave) 、認証が失敗し、Auth0 はユーザーに別のブラウザーを使用するよう求めます。
User Verification をサポートしているのは、FIDO-2 準拠の セキュリティキー のみであることに注意してください。FIDO-1 キーも WebAuthn に使用できますが、User Verification を Required に設定した場合は使用できません。

Relying Party を設定する

WebAuthn は、資格情報をブラウザーのオリジンにひも付けることで、フィッシングを防ぎます。ユーザーは、登録していないサイトで WebAuthn を使用することもできません。 資格情報がオリジンにひも付けられるため、を設定したり変更したりすると、変更前に登録されたユーザーは認証できなくなります。 WebAuthn では、ユーザーの認証に使用するドメインを指定できる Relying Party ID 属性 が定義されています。これは、ブラウザーのオリジンに対応する登録可能な任意のドメインサフィックスに設定できます。たとえば、カスタムドメインが login.example.com の場合、 ID を example.com に設定できます。これにより、ユーザーは WebAuthn の資格情報を使って example.com 配下の任意のドメインで認証できます。 Auth0 では、カスタムドメインが設定されている場合にのみ Relying Party ID を指定できます。カスタムドメインを変更した場合は、Relying Party ID も更新する必要があります。

デバイスのサポート

セキュリティキーを使用するには、ブラウザーでJavaScriptが有効になっており、WebAuthnに対応している必要があります。これらの条件を満たしていない場合、Auth0ではセキュリティキーの登録や、セキュリティキーを使った認証のオプションは表示されません。その場合、Auth0は別の認証要素、または (ほかの認証要素を登録していない場合は) リカバリーコードでの確認を求めます。 主要なブラウザーやオペレーティングシステムの最新バージョンは、WebAuthn with Security Keysに対応しています。詳しくは、webauthn.me の browser support セクションをご覧ください。

制限事項

  • MFA API を使用すると、WebAuthn の登録情報を一覧表示したり削除したりできますが、新規登録はできません。

詳細はこちら