ArcotID PKI キーバッグへのエレメントの追加

CA Strong Authentication Web Services Guide › 認証情報操作の実行 › ArcotID PKI キーバッグへのエレメントの追加

ArcotID PKI キーバッグへのエレメントの追加

ArcotID PKI は、オープン PKI キーおよび証明書を安全に格納するためにも使用できます。これらのキーは通常、さまざまなアプリケーションや操作で、電子メールの署名（S/MIME）、ドキュメントの署名、証明書ベースの認証（オープン PKI）などに使用されます。

オープン PKI キーおよび証明書が ArcotID PKI に格納される場所は、キーバッグまたはキーボールトと呼ばれます。

このセクションでは、キーおよび証明書を ArcotID PKI キーバッグに追加するために使用する必要がある Web サービスについて説明します。以下のトピックについて説明します。

リクエストメッセージの準備
Web サービスの起動
レスポンスメッセージの解釈

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

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

キーおよび証明書を ArcotID PKI キーバッグに追加するには、ArcotIDKeyBagAddElementsRequestMessage を使用します。このメッセージに含まれる要素を以下の表に示します。

要素	必須	説明
clientTxnId	いいえ	呼び出し元アプリケーションが含めることができる一意のトランザクション識別子を指定します。この識別子は、関連するトランザクションの追跡に役立ちます。
userName	はい	証明書を ArcotID PKI キーバッグに追加する必要があるユーザの一意の識別子を指定します。
orgName	いいえ	ユーザが属する組織の名前を指定します。
profileName	いいえ	認証情報のプロファイル名を指定します。渡さない場合は、組織のデフォルトプロファイルが使用されます。渡す場合は、指定したプロファイル名が組織レベルで利用可能である必要があります。
elementSelection	いいえ	以下の要素が含まれます。 selectCertEncoding このオプションを有効にすると、AuthMinder サーバはレスポンスで certEncoding を返します。 selectCertsDetails このオプションを有効にすると、AuthMinder サーバはレスポンスで certDetails を返します。
additionalInput	いいえ	AuthMinder サーバに送信する必要がある追加情報を、名前と値のペアで指定します。名前削除する無署名属性の名前を示します。値名前に対応する値を示します。
エレメント	いいえ	PKCS#12 ファイル要素を指定します。 certEncoding： PKCS#12 ファイルは base-64 エンコード形式です。 password： PKCS#12 ファイルのパスワード。

Web サービスの起動

キーおよび証明書を ArcotID PKI キーバッグに追加するには、ArcotIDKeyBagAddElements 操作を実装する必要があります。

（オプション） SOAP ヘッダまたは ArcotIDKeyBagAddElements 操作の additionalInput 要素に認証および許可の詳細を含めます。これらの詳細については、「Web サービスセキュリティの管理」の章を参照してください。
userName および orgName 要素を使用して、ArcotID PKI の無署名属性を追加するユーザの詳細を取得します。
elementSelection および elements 要素を使用して、証明書情報を取得します。
（オプション）プラグインを実装する場合は、additionalInput 要素タイプを呼び出して追加入力を指定します。
このタイプでは、追加情報を名前と値のペアとして設定します。
ArcotIDKeyBagAddElementsRequestMessage を使用して、前の手順で取得した詳細に従って入力メッセージを作成します。
ArcotWebFortIssuanceSvc サービスの ArcotIDKeyBagAddElements 操作を呼び出して、証明書を追加します。
この操作では、トランザクションの詳細を指定する ArcotIDKeyBagAddElementsResponseMessage のインスタンスが返されます。

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

成功したトランザクションでは、ArcotIDKeyBagAddElementsResponseMessage レスポンスメッセージに、以下の表で説明されている要素が返されます。これらの要素は 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：証明書に秘密キーが含まれているかどうかを示します。