前のトピック: ArcotID PKI 認証次のトピック: 手順 2: ArcotID PKI 認証


手順 1: ArcotID PKI のダウンロード

ArcotID PKI 認証の実行に際しては、ユーザの ArcotID PKI が、認証リクエストの送信元システムに存在することが前提となります。 ArcotID PKI が存在しない場合は、システムにダウンロードする必要があります。 そのような場合、ArcotID PKI のダウンロード前に、ユーザは 2 次認証を実行する必要があります。

ArcotWebFortAuthSvc では、ユーザの ArcotID PKI をダウンロードするための要素が含まれる GetArcotID 操作が提供されています。

このセクションでは、ユーザの ArcotID PKI のダウンロードに関する以下のトピックについて説明します。

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

ArcotID PKI のダウンロード リクエストを AuthMinder サーバに送信するには、GetArcotIDRequestMessage を使用します。 以下の表に、このメッセージの要素のリストを示します。

要素

必須

説明

clientTxnId

いいえ

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

userName

はい

ArcotID PKI をダウンロードする必要があるユーザの一意の識別子。

orgName

いいえ

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

additionalInput/pairs

いいえ

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

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

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

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

    注: additionalInput 要素はリクエスト メッセージの最後で使用できます。 これらの要素は複数追加できます。

Web サービスの起動

ArcotID PKI をダウンロードする方法

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

    この操作では、ユーザの ArcotID PKI およびトランザクションの詳細を含む GetArcotIDResponseMessage のインスタンスが返されます。 詳細については、GetArcotIDResponseMessage レスポンス メッセージが返す要素に関する情報を含む表を参照してください。

  5. ユーザの ArcotID PKI が HTML または JSP (Java Server Page)に設定されます。
  6. ImportArcotID クライアント側 API を呼び出して、アプリケーションからエンド ユーザ システムに ArcotID PKI をダウンロードします。

注: ImportArcotID 関数の詳細については、「CA ArcotID クライアント リファレンス ガイド」を参照してください。 ArcotID PKI クライアントでは、JavaScript プログラミング言語での SDK が提供されています。

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

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

要素

説明

arcotID

ユーザの ArcotID PKI (base-64 エンコード形式)。

transactionDetails

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

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