メインコンテンツへスキップ
iOS SDK 用の Universal Components には、My Account API を使用して、登録、検証、一覧表示、削除に関するすべてのフローを処理する SwiftUI ビュー、MyAccountAuthMethodsView コンポーネントが含まれています。 My Account API の認証方法管理機能を利用して、ユーザーの認証方法を管理するための包括的な UI をレンダリングします。 MyAccountAuthMethodsView コンポーネントを使用すれば、ナビゲーションの制御、エンドポイントの呼び出し、state の管理を行う必要はありません。
サインイン方法と検証方法を表示する MyAccountAuthMethodsView コンポーネント

設定要件

MyAccountAuthMethodsView コンポーネントをレンダリングする前に、セルフサービスのアカウントセキュリティインターフェースを構築するに従って SDK をインストールし、Auth0 テナントを設定して、トークンプロバイダーで SDK を初期化してください。
MyAccountAuthMethodsView コンポーネントは、初期化された SDK から設定、トークンプロバイダー、パスキー設定を取得します。

サポート対象の認証要素

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

はじめに

通常は設定画面へのナビゲーションリンクの配下に、MyAccountAuthMethodsView コンポーネントをSwiftUIの階層内の任意の場所に追加します。
SettingsView.swift
Swift view はイニシャライザのパラメータを受け取りません。動作をカスタマイズするには、SwiftUI の view 修飾子と環境値を使用します。

パラメータ

MyAccountAuthMethodsView コンポーネントでは、次のモディファイア値と環境値を使用できます。

カスタマイズ

テーマはコンポーネント全体に適用され、各認証要素画面には現在のテーマが継承されます。 トークンの全カタログとダークモードのパターンについては、スタイルとテーマのカスタマイズを参照してください。

ホスト側のNavigationStackに埋め込む

デフォルトでは、MyAccountAuthMethodsViewコンポーネントが独自のNavigationStackを管理します。
アプリケーションですでにナビゲーションスタックを使用している場合、2つ目のスタックをネストすると、戻るボタンやスワイプで戻るジェスチャーが正しく機能しなくなります。代わりに、MyAccountAuthMethodsViewコンポーネントを既存のスタックに埋め込んでください。
埋め込みモードを使用するには、次の2つの要件を満たす必要があります。
  • MyAccountAuthMethodsView コンポーネントに .embeddedInNavigationStack() 修飾子を追加し、内部スタックが作成されないようにします。
  • 外側の NavigationStack に \.hostNavigationPath 修飾子を追加し、SDK がどのパスバインディングにプッシュするかを認識できるようにします。
SDK では、独自のルートに対して型安全なナビゲーションコントローラーが必要なアプリケーション向けに、Router ヘルパークラスも提供しています。SDK 内部のナビゲーションを制御するために使用する必要はありません。アプリケーションの画面にも同じパターンを適用したい場合にのみ使用してください。

ローカライゼーション

iOS 向け Universal Components には、ローカライズされた文字列は含まれていません。ユーザー向けの文言は英語です。 ローカライゼーションが連携の障壁となる場合は、ui-components-ios リポジトリで機能リクエストを送信してください。

制限事項

  • iOS では認証要素を単独で扱うコンポーネントは提供されません。すべての認証要素は 認証方法の管理 コンポーネント内にレンダリングされます。アプリケーション内の別の場所で、単一の認証要素を登録、検証、削除するためのパブリック API はありません。
  • 単独で使用できる一覧表示/削除コンポーネントはありません。SDK には、登録済みの認証要素を一覧表示したり、コンポーネント外で削除したりするためのパブリックコンポーネントは用意されていません。管理機能をすべて利用するには、認証方法の管理 コンポーネントを使用してください。

詳細

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

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

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

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