Skip to main content
AuthenticatorSettingsComponent は、Auth0 パスキーの登録フローをレンダリングできます。 パスキー登録フローでは、説明画面、プラットフォーム認証器との WebAuthn 登録ハンドシェイク、認証器リスト内の登録済み認証要素のエントリがレンダリングされます。 パスキーは他の認証要素と異なり、Universal Components for Android SDK では設定できないアプリケーション側のプラットフォームエンタイトルメントが必要です。
Android で説明コンテンツと「パスキーを追加」ボタンを表示するパスキー登録画面

​
前提条件

Universal Components for Android SDK でパスキーのサポートを有効にするには、以下の準備が必要です。
  • Auth0 テナントでカスタムドメインを設定します。詳細については、カスタムドメインを参照してください。
  • Auth0 のデータベース接続でパスキーを有効にします。Auth0 テナントでパスキーを有効にする方法については、パスキーを参照してください。
  • Auth0 アプリケーションに Android アプリケーションのパッケージ名と SHA-256 署名フィンガープリントを登録します。詳細については、モバイルアプリケーション向け Native Passkeysを参照してください。
  • Android 用 Universal Components をインストールして設定します。Universal Components のインストール、Auth0 テナントの設定、SDK の初期化については、セルフサービスのアカウントセキュリティインターフェイスを構築するを参照してください。
  • Android のバージョンを確認します。Credential Manager のすべての機能を利用するには、Android 14 以降 (API 34 以降) が必要です。Android 11～13 (API 30～33) では、Play Services が最新のデバイスであれば、パスキーは Google Password Manager を通じて同期されます。

​
プラットフォームの設定

パスキーは、資格情報を Auth0 テナントのカスタムドメインに紐付けます。プラットフォームは Android Digital Asset Links を使用して、この紐付けを検証します。 AndroidX Credentials が解決されていることを確認する Universal Components for Android SDK は、androidx.credentials:credentials:1.5.0+ に推移的に依存しています。Credential Manager のエラーが発生する場合は、./gradlew app:dependencies で確認してください。
Google の Credential Manager ガイドと Digital Asset Links tester が、信頼できる情報源です。デバイスでテストする前に、assetlinks.json を検証してください。

​
SDK の制限事項

  • パスキーの登録は AuthenticatorSettingsComponent 内からのみ可能です。アプリケーション内の他の場所から、単独でパスキー登録を開始するための公開 Composable API はありません。ログイン後に表示する「パスキーを保存」アップセルプロンプトはサポートされていません。最新情報は universal-components-android で確認できます。
  • コンポーネントでパスキーを削除しても、OS の認証情報ストアからは削除されません。登録済みのパスキーは Auth0 アカウントから切り離されますが、ユーザーが OS レベルの認証情報マネージャーから削除するまで、秘密認証情報は Google Password Manager に残ります。
  • PasskeyEnableScreen composable は情報提供のみを目的としています。公開呼び出し可能ですが、静的な説明カードをレンダリングするだけで、onEnableClick コールバックの処理は利用者側で実装する必要があります。実際の登録ロジックはコンポーネント内部の PasskeyViewModel にあり、公開されていません。
  • 証明書利用は公開されていません。SDK では、証明書利用ポリシー (none / indirect / direct) を選択したり、認証器のトランスポートを列挙したりすることはできません。Auth0 テナントで設定された WebAuthn ポリシーが使用されます。

​
詳しく見る

認証方法の管理

AuthenticatorSettingsComponent のリファレンスと、サポート対象の認証要素の一覧をご確認ください。

セルフサービスのアカウントセキュリティインターフェースを構築する

SDK を初期化し、トークンプロバイダーを Auth0 テナントに接続します。