前のトピック: パスワード タイプの認証情報の検証次のトピック: PAM の取得


認証トークンの検証

AuthMinder の認証 Web サービスは、エンド ユーザの認証が正常に終了した後で該当エンド ユーザに適切なトークンを提供します。 このトークンが AuthMinder サーバに提示され、ユーザが認証されている点、保護されているリソースに該当ユーザがアクセス可能である点が証されます。

認証 Web サービスを使用して、認証後にトークンを返す必要があるかどうかを指定できます。 また、認証後に返す必要のあるトークンのタイプも指定できます。 tokenType 要素では、戻すトークンのタイプとして、以下のタイプのトークンを指定できます。

AuthMinder サーバは、ユーザに対して発行されるネイティブ トークンおよびワンタイム トークンのみを検証できます。 認証トークンをSSO (シングル サインオン)で使用する場合は、そのトークンを検証する必要があります。この場合、ユーザを一度のみ認証し、複数のリソースの利用を同じ認証トークンを使用して許可します。

このセクションでは、認証トークンの確認に関する以下のトピックについて説明します。

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

AuthMinder サーバによって返された認証トークンを確認するには、VerifyAuthTokenRequestMessage を使用します。 以下の表に、このメッセージの要素のリストを示します。

要素

必須

説明

clientTxnId

いいえ

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

トークン(token)

いいえ

成功した認証の後にユーザに返される認証トークン。

additionalInput/pairs

いいえ

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

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

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

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

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

Web サービスの起動

トークンが有効かどうかを検証する方法

  1. オプション) SOAP ヘッダまたは VerifyAuthToken 操作の additionalInput 要素に認証および許可の詳細を含めます。 これらの詳細については、「Web サービス セキュリティの管理」の章を参照してください。
  2. オプション)プラグインを実装する場合は、additionalInput 要素タイプを呼び出して追加入力を指定します。
  3. VerifyAuthTokenRequestMessage を使用して、入力メッセージを作成します。
  4. ArcotWebFortAuthSvc サービスの VerifyAuthToken 操作を呼び出して、ユーザのトークンを確認します。

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

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

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

Method

説明

userName

認証トークンを所有しているユーザの名前。

orgName

ユーザが属する組織。

transactionDetails

以下のトランザクションの詳細が含まれます。

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