前のトピック: Q&A 設定の取得次のトピック: 無署名属性の削除


無署名属性の設定

このセクションでは、ArcotID PKI の無署名属性を設定するために使用する必要がある Web サービスについて説明します。 以下のトピックについて説明します。

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

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

ArcotID PKI の無署名属性を設定するには、SetArcotIDUnsignedAttributesRequestMessage を使用します。 このメッセージに含まれる要素を以下の表に示します。

要素

必須

説明

clientTxnId

いいえ

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

userName

はい

ArcotID PKI の無署名属性を定義する必要があるユーザの一意の識別子を指定します。

orgName

いいえ

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

unsignedAttributes

はい

ArcotID PKI の無署名属性を、名前と値のペアで指定します。

  • 名前
    作成する無署名属性の名前を示します。

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

additionalInput

いいえ

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

  • 名前
    サーバに渡す追加情報の名前を示します。

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

Web サービスの起動

ユーザの ArcotID PKI の無署名属性を設定するには、SetArcotIDUnsignedAttributes 操作を実装する必要があります。

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

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

  5. SetArcotIDUnsignedAttributesRequestMessage を使用して、前の手順で取得した詳細に従って入力メッセージを作成します。
  6. ArcotWebFortIssuanceSvc サービスの SetArcotIDUnsignedAttributes 操作を呼び出して、ArcotID PKI の無署名属性を設定します。

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

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

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

要素

説明

message

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

reasonCode

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

responseCode

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

transactionID

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

additionalOutput

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