前のトピック: Q&A 設定の取得次のトピック: ArcotID PKI キー バッグ エレメントの取得


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

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

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

エレメントを ArcotID PKI キー バッグに追加するには、ArcotIDKBMIssuance インターフェースに addElements() メソッドを実装する必要があります。

  1. ArcotIDKeyBagElementSelection クラスおよび ArcotIDKeyBagElementSet クラスを使用して、キー バッグに追加する必要があるエレメントを取得します。
  2. オプション) プラグインを実装する場合は、AdditionalInput クラスの setAdditionalInput() メソッドを呼び出して、AdditionalInput に情報を格納します。

    このクラスでは、補足情報を名前-値のペアとして設定します。 詳細については、「追加入力の準備」を参照してください。

  3. ArcotIDKBMIssuance インターフェースの addElements() メソッドを呼び出して、エレメントを ArcotID PKI キー バッグに追加します。

    このメソッドは、トランザクション ID、メッセージ、応答コード、および理由コードを指定する、TransactionDetails インターフェースのインスタンスを返します。

エラー処理

発行 API のメソッドを実行中にエラーが発生した場合は、例外が返されます。 com.arcot.webfort.issuance.api.exception パッケージおよび com.arcot.webfort.common.api.exception パッケージにこれらの例外が含まれます。 例外クラスの詳細については、「発行例外」および「共通例外」を参照してください。

例外がスローされない場合は、処理は正常に終了しています。戻り値のオブジェクトを参照して結果を処理できます。 エラーが不在だからといって、リクエストが正常に処理されたとは限りません。