Previous Topic: Interpreting the Response MessageNext Topic: Fetching Configurations


Updating Configurations

The update operation enables you to update the following:

This section walks you through the following topics for updating configurations:

Note: After you update configurations, you must refresh the system cache for the changes to take effect. See "Refreshing the Organization Cache" for more information on how to refresh the system cache.

Preparing the Request Message

The UpdateRequest message is used to update configurations in the AuthMinder database. All the createRequest elements listed in the tables in Credential Profiles and Authentication Policies can be updated using the update operation. For information about each element, refer to the tables in Credential Profiles and Authentication Policies.

Invoking the Web Service

To update configurations:

  1. (Optional) Include the authentication and authorization details in the SOAP header or in the additionalInput element of the update operation. See chapter, "Managing Web Services Security" for more information on these details.
  2. Use the UpateRequest elements to update the configuration information.
  3. Use UpateRequest message and construct the input message by using the details obtained in the preceding step.
  4. Invoke the update operation of the ArcotWebFortAdminSvc service to update the configuration.

    This operation returns updateResponse message that includes the transaction identifier, message, reason code, and response code. Refer to the next section for more information on the response message.

Interpreting the Response Message

For successful transactions, the response message, updateResponse 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

Indicates the status of the transaction.

reasonCode

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

responseCode

Response code returned by the AuthMinder Server in case of errors.

transactionID

The unique identifier of the transaction.

additionalOutput

The values returned for the additional input.