前のトピック: カスタム属性のリセット次のトピック: 無署名属性の設定


Q&A 設定の取得

Q&A 認証用にユーザが設定する必要がある質問の数は、組織ごとに異なる場合があります。 このセクションでは、Web サービスを使用して、各組織に対して設定されている質問を取得する方法について説明します。 この章では、以下の内容について説明します。

リクエスト メッセージの準備

ユーザが設定する必要がある質問の数を取得するには、FetchQnAConfigurationRequestMessage を使用します。 このメッセージに含まれる要素を以下の表に示します。

要素

必須

説明

clientTxnId

いいえ

呼び出し元アプリケーションが含めることができる一意のトランザクション識別子を指定します。 この識別子は、関連するトランザクションの追跡に役立ちます。

orgName

いいえ

ユーザが属する組織の名前を指定します。

profileName

いいえ

認証情報のプロファイル名を指定します。 渡さない場合は、組織のデフォルト プロファイルが使用されます。

fetchQuestions

いいえ

ユーザの質問を取得するかどうかを指定します。 指定可能な値は以下のとおりです。

  • 0: 質問を取得しない場合。
  • 1: 質問を取得する場合。

additionalInput/pairs

いいえ

AuthMinder の additionalInput 要素を使用すると、追加情報を指定して AuthMinder の認証機能を拡張したい場合に、追加入力を設定できます。 その場合、名前と値のペアで追加情報を設定する必要があります。

  • name (作成するキー ペアの名前)
  • value (名前に対応する値)

    注: これらの要素は複数追加できます。

事前定義済みの追加入力パラメータの一部を以下に示します。

  • AR_WF_LOCALE_ID
    呼び出し元アプリケーションにメッセージを返す際に AuthMinder で使用するロケールを指定します。
  • AR_WF_CALLER_ID
    トランザクションの追跡に役立ちます。 この情報は、セッション ID またはクライアント トランザクション ID (clientTxnId)を使用して指定できます。

Web サービスの起動

Q&A 設定を取得するには、以下の手順に従います。

  1. オプション) SOAP ヘッダまたは FetchQnAConfiguration 操作の additionalInput 要素に認証および許可の詳細を含めます。 これらの詳細については、「Web サービス セキュリティの管理」の章を参照してください。
  2. orgName 要素を使用して、組織に対して設定されている Q&A の詳細を取得します。
  3. オプション)プラグインを実装する場合は、additionalInput 要素タイプを呼び出して追加入力を指定します。

    このタイプでは、追加情報を名前と値のペアとして設定します。

  4. FetchQnAConfigurationRequestMessage を使用して、前の手順で取得した詳細に従って入力メッセージを作成します。
  5. ArcotWebFortIssuanceSvc サービスの FetchQnAConfiguration 操作を呼び出して、質問の数を取得します。

    この操作では、認証情報およびトランザクションの詳細を含む FetchQnAConfigurationResponseMessage のインスタンスが返されます。

レスポンス メッセージの解釈

成功したトランザクションでは、FetchQnAConfigurationResponseMessage レスポンス メッセージに、以下の表で説明されている要素が返されます。 これらの要素は SOAP本文に含まれます。 エラーがある場合、エラー レスポンスは SOAP 本文に含まれます。 SOAP エラー メッセージの詳細については、「エラー コード」を参照してください。

要素

説明

orgName

ユーザが属する組織の名前。

profileName

認証情報のプロファイル名。

minQuestions

ユーザが設定する必要がある質問の数。

maxQuestions

ユーザが設定できる質問の最大数。

questions

ユーザを認証するための質問。

注: 入力で fetchQuestions フラグが有効になっている場合に質問が返されます。

transactionDetails

トランザクションの詳細には以下の項目があります。

  • message
    操作のステータスを定義する文字列。
  • reasonCode
    操作の失敗時に AuthMinder サーバが送信する一意のコード。
  • responseCode
    操作の失敗時に AuthMinder サーバが送信する一意のコード。
  • transactionID
    トランザクションの一意の識別子。
  • additionalOutput
    AuthMinder サーバに渡された additionalInput に対する出力。