Previous Topic: Setting Unsigned AttributesNext Topic: Adding Elements to ArcotID PKI Key Bag


Deleting Unsigned Attributes

This sections explains the Web service that must be used to delete the ArcotID PKI unsigned attributes. It walks you through following topics:

Note: This operation is applicable only for ArcotID PKI credential.

Preparing the Request Message

The DeleteArcotIDUnsignedAttributesRequestMessage is used to delete the unsigned attributes of the ArcotID PKI. It contains the elements listed in the following table.

Element

Mandatory

Description

clientTxnId

No

Specifies the unique transaction identifier that the calling application can include. This identifier helps in tracking the related transactions.

userName

Yes

Specifies the unique identifier of the user whose ArcotID PKI unsigned attributes have to be deleted.

orgName

No

Specifies the organization name to which the user belongs to.

unsignedAttributeNames

Yes

Specifies the ArcotID PKI unsigned attribute name.

additionalInput

No

Specifies the extra information that must be sent to AuthMinder Server in name-value pairs.

  • name
    Indicates the name of the unsigned attribute that you want to delete.
  • value
    Indicates the corresponding value for the name.

Invoking the Web Service

To delete the unsigned attributes for the ArcotID PKI of a user, you need to implement the DeleteArcotIDUnsignedAttributes operation.

  1. (Optional) Include the authentication and authorization details in the SOAP header or in the additionalInput element of the DeleteArcotIDUnsignedAttributes operation. See chapter, "Managing Web Services Security" for more information on these details.
  2. Use the userName and orgName elements to fetch the details of the user whose ArcotID PKI unsigned attributes you want to delete.
  3. Use the DeleteArcotIDUnsignedAttributes element to fetch the unsigned attributes that you want to delete.
  4. (Optional) If you are implementing a plug-in, then invoke the additionalInput element type to fill the additional input.

    This type provides the additional information that is set as a name-value pair.

  5. Use DeleteArcotIDUnsignedAttributesRequestMessage and construct the input message by using the details obtained in preceding steps.
  6. Invoke the DeleteArcotIDUnsignedAttributes operation of the ArcotWebFortIssuanceSvc service to delete the ArcotID PKI unsigned attributes.

    This operation returns an instance of the DeleteArcotIDUnsignedAttributesResponseMessage that specifies the transaction details.

Interpreting the Response Message

For successful transactions, the response message, DeleteArcotIDUnsignedAttributesResponseMessage returns the elements explained in the following table. These elements are included in the SOAP body. If there are any errors, then the Fault response is included in the SOAP body. See appendix, "Error Codes" for more information on the SOAP error messages.

Element

Description

message

A string that defines the status of the operation.

reasonCode

Unique code that is sent by AuthMinder Server if the operation fails.

responseCode

Unique code that is sent by AuthMinder Server if the operation fails.

transactionID

Unique identifier of the transaction.

additionalOutput

The output for the additionalInput that was passed to AuthMinder Server.