前のトピック: ArcotID PKI キー バッグへのエレメントの追加次のトピック: ArcotID PKI キー バッグ エレメントの削除


ArcotID PKI キー バッグ エレメントの取得

このセクションでは、キー バッグに格納されている証明書の詳細の取得に関する以下のトピックについて説明します。

注: この操作は ArcotID PKI 認証情報にのみ適用されます。

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

ArcotID PKI キー バッグに格納されているキーおよび証明書の詳細を取得するには、ArcotIDKeyBagGetElementsRequestMessage を使用します。 このメッセージに含まれる要素を以下の表に示します。

要素

必須

説明

clientTxnId

いいえ

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

userName

はい

ArcotID PKI キー バッグの要素を取得する必要があるユーザの一意の識別子を指定します。

orgName

いいえ

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

profileName

いいえ

認証情報のプロファイル名を指定します。 渡さない場合は、組織のデフォルト プロファイルが使用されます。 渡す場合は、指定したプロファイル名が組織レベルで利用可能である必要があります。

elementSelection

いいえ

以下の要素が含まれます。

  • selectCertEncoding
    このオプションを有効にすると、AuthMinder サーバはレスポンスで certEncoding を返します。
  • selectCertsDetails
    このオプションを有効にすると、AuthMinder サーバはレスポンスで certDetails を返します。

additionalInput

いいえ

AuthMinder サーバに送信する必要がある追加情報を、名前と値のペアで指定します。

  • 名前
    削除する無署名属性の名前を示します。

  • 名前に対応する値を示します。

Web サービスの起動

ArcotID PKI キー バッグに格納されているキーおよび証明書を取得するには、ArcotIDKeyBagGetElements 操作を実装する必要があります。

  1. オプション) SOAP ヘッダまたは ArcotIDKeyBagGetElements 操作の additionalInput 要素に認証および許可の詳細を含めます。 これらの詳細については、「Web サービス セキュリティの管理」の章を参照してください。
  2. userName および orgName 要素を使用して、ArcotID PKI の無署名属性を削除するユーザの詳細を取得します。
  3. elementSelection 要素を使用して、取得する証明書の要素を識別します。
  4. オプション)プラグインを実装する場合は、additionalInput 要素タイプを呼び出して追加入力を指定します。

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

  5. ArcotIDKeyBagGetElementsRequestMessage を使用して、前の手順で取得した詳細に従って入力メッセージを作成します。
  6. ArcotWebFortIssuanceSvc サービスの ArcotIDKeyBagGetElements 操作を呼び出して、証明書を追加します。

    この操作では、トランザクションの詳細を指定する ArcotIDKeyBagGetElementsResponseMessage のインスタンスが返されます。

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

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

要素

説明

transactionDetails/message

操作のステータスを定義する文字列。

transactionDetails/reasonCode

操作の失敗時に AuthMinder サーバが送信する一意のコード。

transactionDetails/responseCode

操作の失敗時に AuthMinder サーバが送信する一意のコード。

transactionDetails/transactionID

トランザクションの一意の識別子。

transactionDetails/additionalOutput

AuthMinder サーバに渡された additionalInput に対する出力。

certificates/certEncoding

入力で要求されたエンコーディングの詳細。

certificates/certsDetails

以下の証明書の詳細が含まれます。

  • elementId: 無署名属性を示す識別子。
  • issuerName: 証明書を発行した発行者の名前。
  • serialNumber: 証明書のシリアル番号。
  • certSubject: 証明書のサブジェクト。
  • certValidFrom: 証明書の発効日。
  • certValidTo: 証明書の失効日。
  • hasPrivatekey: 証明書に秘密キーが含まれているかどうかを示します。