Previous Topic: Fetching User Details Using AccountsNext Topic: Setting the Personal Assurance Message

CA Strong Authentication Web Services Guide › Managing Users and Accounts › Performing User Account Operations › Deleting User Accounts

Deleting User Accounts

You must use the deleteUserAccount operation to delete accounts for the users. This section walks you through the following topics for deleting user accounts:

Preparing the Request Message

The following table lists the elements of the deleteUserAccountRequest message:

Element

Mandatory

Description

accountType

Yes

The attribute that qualifies the account ID and provides additional context about the usage of the account ID.

clientTxId

No

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

Invoking the Web Service

To delete user accounts:

  1. (Optional) Include the authentication and authorization details in the header of the deleteUserAccount operation. See chapter, "Managing Web Services Security" for more information on the header elements.
  2. Use the deleteUserAccountRequest elements to collect the user details, as listed in the preceding table.
  3. Use the deleteUserAccountRequest message and construct the input message by using the details obtained in preceding step.
  4. Invoke the deleteUserAccount operation of the ArcotUserRegistrySvc service to delete accounts for the user.

    This operation returns the deleteUserAccountResponse message that includes the transaction identifier, authentication token, and user account details. See the following section for more information on the response message.

Interpreting the Response Message

The response message, deleteUserAccountResponse, returns the transaction identifier and the authentication token in the SOAP envelope header. These elements are explained in the following table. The SOAP body returns a success message if the operation was performed successfully. If there are any errors, then the Fault response is returned. See appendix, "Error Codes" for more information on the SOAP error messages.

Element

Description

udsTransactionID

The unique identifier of the transaction that is performed using UDS.

authToken

The authentication token that is returned if the credential verification to access Web services was successful. This token eliminates the need for you to present the authentication credential for successive access to the Web services.

By default, the authentication token is valid for one day, after which you need to authenticate again.