次の方法で共有


ネイティブ認証チャレンジの種類と機能

適用対象: 次の内容が外部テナントに適用されることを示す白いチェック マーク記号が付いた緑の円。 外部テナント (詳細)

ネイティブ認証では、次の 2 つの認証フローがサポートされます。

  • ワンタイム パスコード (OTP) を使用した電子メール
  • セルフサービス パスワード リセット (SSPR) をサポートする電子メールとパスワード

ネイティブ認証を使用してユーザーをサインインさせるクライアント アプリでは、どちらの認証フローも使用できます。 ネイティブ認証 API を正常に呼び出すには、アプリがサポートする認証フローと機能を宣言する必要があります。 ネイティブ認証 API を使用すると、クライアント アプリは定義済みの値を使用して、サポートされているチャレンジの種類と機能をアドバタイズできます。

チャレンジの種類

チャレンジの種類は、クライアント アプリがネイティブ認証 API に対してサポートする認証フローを宣言するための要求に含まれる定義済みの値です。

次の表に、サポートされているチャレンジの種類の値を示します。

チャレンジの種類 Description
パスワード このチャレンジの種類は、アプリがユーザーからのパスワード資格情報の収集をサポートしていることを示します。
oob このチャレンジの種類は、アプリケーションがセカンダリ チャネルを使用してユーザーに送信されるワンタイム パスワードまたはパスコード (OTP) コードの使用をサポートしていることを示します。 現時点では、この API は電子メールと SMS OTP のみをサポートしています。
リダイレクト このチャレンジの種類は、アプリケーションがブラウザー委任認証 (Web フォールバックとも呼ばれます) へのフォールバックをサポートしていることを示します。 すべてのネイティブ認証に準拠したアプリでは、この機能がサポートされている必要があります。 この要件は、アプリがネイティブ認証 API に対して行うすべての呼び出しで、このチャレンジの種類を含める必要があることを意味します。 クライアント アプリにこのチャレンジの種類を含めなければ、要求は失敗します。

ネイティブ認証で新しい認証方法がサポートされている場合は、新しい値が追加されます。

ネイティブ認証フローの課題タイプの値

次の表は、アプリがさまざまな認証フローに使用するチャレンジの種類の値をまとめたものです。

サインアップ フロー サインインの流れ SSPR
パスワードを含む電子メール oobパスワードリダイレクト oobパスワードリダイレクト oobリダイレクト
電子メール OTP oobリダイレクト oobリダイレクト 適用なし

重要な注意事項:

  • ネイティブ認証 API を直接使用するアプリでは、サポートされているチャレンジの種類を宣言するときに、リダイレクト チャレンジの種類を含める必要があります。
  • ネイティブ認証 SDK (Android、iOS、または JavaScript) を使用するアプリでは、SDK に自動的に 含まれるリダイレクト チャレンジの種類を含める必要はありません。

能力

クライアント アプリでは、チャレンジの種類に加えて、 機能の一覧を指定できます。 challenge_typeでは、アプリがサポートする認証方法を定義しますが、capabilitiesは、クライアント アプリが処理できる追加のフローと、ユーザーに提供できる UI エクスペリエンスを示します。

ネイティブ認証 API では、次の機能がサポートされています。

  • mfa_required: クライアント アプリが多要素認証 (MFA) フローを処理できることを示します。これには、ユーザーが必要に応じて MFA チャレンジを完了するための適切な UI の表示が含まれます。
  • registration_required: クライアントは強力な認証登録を処理できます。登録 API を呼び出し、UI を表示して、強力な認証方法の登録をユーザーに案内できます。

サポートされていない課題の種類と機能の挙動

次の表は、ネイティブ認証 API またはクライアント アプリが特定のチャレンジの種類または機能をサポートしていない場合の動作をまとめたものです。

Scenario 行動
クライアント アプリにサポートされていないチャレンジの種類が含まれている ネイティブ認証 API はエラーを返し、要求を無効として扱います。
クライアント アプリにサポートされていない機能が含まれている ネイティブ認証 API はエラーを返し、要求を無効として扱います。
クライアント アプリに必要なチャレンジの種類を含めできない アプリは、管理者によって構成されたチャレンジの種類をサポートしていません。 ネイティブ認証 API は 、Web フォールバックを開始します。
クライアント アプリに必要な機能を含めできない MFA または強力な認証登録が必要ない場合、アプリは通常機能します。 これらの機能が必要であってもサポートされていない場合、ネイティブ認証 API は Web フォールバック を開始して認証フローを完了します。