メインコンテンツへスキップ
Android SDK 向け Universal Components には、My Account API を使用して、登録、検証、一覧表示、削除の各フローを処理する Jetpack Compose のコンポーザブル AuthenticatorSettingsComponent が含まれています。 My Account API の認証方法管理機能を利用し、ユーザーの認証方法を管理するための完全な UI をレンダリングします。 AuthenticatorSettingsComponent を使用すれば、ナビゲーションの制御、エンドポイントの呼び出し、state の管理は不要です。
Android でサインイン方法と検証方法を表示する AuthenticatorSettingsComponent

設定要件

AuthenticatorSettingsComponent コンポーネントをレンダリングする前に、セルフサービスのアカウントセキュリティインターフェースを構築するに従って SDK をインストールし、Auth0 テナントを設定して、トークンプロバイダーを使用して SDK を初期化します。
AuthenticatorSettingsComponent コンポーネントは、初期化済みの SDK シングルトンから設定、トークンプロバイダー、パスキー設定を読み取ります。

サポート対象の認証要素

このコンポーネントは、Auth0 が My Account API でサポートするすべての認証要素に対応しています。各認証要素の画面には、コンポーネントで有効なテーマが適用されます。詳細については、スタイルとテーマをカスタマイズするを参照してください。

はじめに

任意のコンポーザブルに AuthenticatorSettingsComponent() を追加します。SDK が、登録、検証、管理の各画面間の内部ナビゲーションをすべて処理します。
LoginSecurityScreen.kt

パラメータ

AuthenticatorSettingsComponent() コンポーネントは、次の修飾子を受け取ります。

カスタマイズ

テーマはコンポーネント全体に適用され、個々の認証要素画面は有効なテーマを継承します。 トークンの全カタログとダークモードのパターンについては、スタイルとテーマをカスタマイズするをご覧ください。

高度な Compose NavHost 連携

AuthenticatorSettingsComponent は、配置されている場合は Compose’s NavHost に自動的に組み込まれるため、特別な設定は必要ありません。他のコンポーザブルと同様に使用できます。NavHost の destination として使用する場合、戻る操作はホスト’s NavController に委ねられます。
SDK は内部で、登録、検証、管理の各画面間のネストされたナビゲーションを独自に管理します。この内部グラフはアプリケーションの NavController から分離されているため、アプリケーションのルートと競合することはありません。

ローカリゼーション

ユーザー向けの文字列はすべて、SDK の values/strings.xml ファイルに定義されています。アプリケーションの values/strings.xml ファイルで同じキーを再定義することで、任意の文字列をオーバーライドできます。
リソース値は、ビルド時にSDKのデフォルト値を上書きします。 ローカライズしたコピーを配布するには、同じキーを使用した翻訳済みのvalues-<locale>/strings.xmlファイルを用意します。

制限事項

  • Android では、認証要素を単独で扱うコンポーネントは利用できません。すべての認証要素は Authentication Methods Management コンポーネント内でレンダリングされます。アプリケーションの別の部分から個別の認証要素を登録、検証、または削除するためのパブリック API はありません。
  • 単独の一覧表示/削除コンポーネントはありません。SDK には、登録済みの認証要素を一覧表示したり、コンポーネント外で削除したりするためのパブリックコンポーネントは含まれていません。包括的な管理機能を利用するには、Authentication Methods Management コンポーネントを使用してください。
  • post-login のパスキープロンプトはサポートされていません。サインイン直後にユーザーにパスキーの保存を促す機能 (設定画面とは別) は、この SDK ではサポートされていません。更新については、universal-components-android を確認してください。

詳細情報

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

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

スタイルとテーマをカスタマイズする

Auth0 のデザイントークンシステムを使用して、色、タイポグラフィ、間隔、角丸、サイズのトークンをオーバーライドします。