前のトピック: パスワード認証次のトピック: 部分パスワード認証

CA Strong Authentication Web Services Guide › ユーザの認証 › パスワード認証 › 完全なパスワード認証

完全なパスワード認証

この方式では、セキュリティ アプリケーションは、ユーザに完全なパスワードの入力を求めます。 ユーザが入力したパスワードが正しい場合、認証は成功したと見なされます。

このセクションでは、完全なパスワード認証の実行に関する以下のトピックについて説明します。

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

ユーザが入力したパスワードを確認するには、VerifyPasswordRequestMessage を使用します。 以下の表に、このメッセージの要素のリストを示します。

要素

必須

説明

clientTxnId

いいえ

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

userName

はい

ユーザの一意の識別子。

orgName

いいえ

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

パスワード

はい

ユーザが入力したパスワード。

tokenType

いいえ

認証が成功した後に、AuthMinder サーバから受け取る認証トークンのタイプ。 詳細については、「認証トークンの検証」を参照してください。

challengeID

いいえ

AuthMinder サーバによって返されたチャレンジの一意の識別子。

注： 完全なパスワードの確認では、challengeID は必要ありません。

additionalInput/pairs

いいえ

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

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

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

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

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

Web サービスの起動

標準的なパスワード認証を実行する方法

  1. ユーザのパスワードを収集するためのロジックを実装します。
  2. （オプション） SOAP ヘッダまたは VerifyPassword 操作の additionalInput 要素に認証および許可の詳細を含めます。 これらの詳細については、「Web サービス セキュリティの管理」の章を参照してください。
  3. （オプション）プラグインを実装する場合は、additionalInput 要素タイプを呼び出して追加入力を指定します。
  4. VerifyPasswordRequestMessage を使用して、入力メッセージを作成します。
  5. ArcotWebFortAuthSvc サービスの VerifyPassword 操作を呼び出して、ユーザが入力したパスワードを確認します。 必要に応じて、tokenType 要素を使用して、認証が成功した後にユーザに返す必要があるトークンのタイプを指定できます。

    この操作では、トランザクションの詳細、認証情報の詳細、およびトークン情報を格納した VerifyPasswordResponseMessage が返されます。

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

成功したトランザクションでは、VerifyPasswordResponseMessage レスポンス メッセージに、「手順 2： ArcotID PKI 認証」の「署名済みチャレンジ確認レスポンス メッセージ」で説明されている要素が返されます。 これらの要素は SOAP本文に含まれます。 エラーがある場合、エラー レスポンスは SOAP 本文に含まれます。 SOAP エラー メッセージの詳細については、付録「エラー コード」を参照してください。