Updating Endpoint Password and Description using TEWS Web Services

Products

• CA Identity Suite

Issue/Introduction

This article provides guidance on updating the password and other fields, such as the description, for an Active Directory endpoint using TEWS (Broadcom Symantec Identity Manager Web Services). The examples below demonstrate how to modify these fields by enabling the web services task named "Modify Active Directory Endpoint."

Environment

Identity Suite 14.5 sp1

Cause

• Ensure that the web services task "Modify Active Directory Endpoint" is enabled.
• You must have administrative credentials or scope permission in the task to perform these operations.

Resolution

SOAP Request Examples

Example 1: Update Description Field

To update the description field of an Active Directory endpoint, use the following SOAP request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wsdl="http://tews6/wsdl">
   <soapenv:Header/>
   <soapenv:Body>
      <wsdl:TaskContext>
         <wsdl:admin_id>imadmin</wsdl:admin_id>
         <wsdl:admin_password><my password for imadmin></wsdl:admin_password>
      </wsdl:TaskContext>
      <wsdl:ModifyActiveDirectoryEndpoint>
         <wsdl:ModifyActiveDirectoryEndpointSearch>
             <wsdl:Subject index="?">
               <wsdl:UniqueName>EndPoint=test_ad,Namespace=ActiveDirectory,Domain=im,Server=Server</wsdl:UniqueName>
            </wsdl:Subject>
         </wsdl:ModifyActiveDirectoryEndpointSearch>
         <wsdl:ModifyActiveDirectoryEndpointActiveDirectoryEndpointEndpointTab>
            <wsdl:description>new_value</wsdl:description>
         </wsdl:ModifyActiveDirectoryEndpointActiveDirectoryEndpointEndpointTab>
      </wsdl:ModifyActiveDirectoryEndpoint>
   </soapenv:Body>
</soapenv:Envelope>

Example 2: Update Password and Description Fields

To update both the password and the description fields, use the following SOAP request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wsdl="http://tews6/wsdl">
   <soapenv:Header/>
   <soapenv:Body>
      <wsdl:TaskContext>
         <wsdl:admin_id>imadmin</wsdl:admin_id>
         <wsdl:admin_password><my password for imadmin></wsdl:admin_password>
      </wsdl:TaskContext>
      <wsdl:ModifyActiveDirectoryEndpoint>
         <wsdl:ModifyActiveDirectoryEndpointSearch>
             <wsdl:Subject index="?">
               <wsdl:UniqueName>EndPoint=test_ad,Namespace=ActiveDirectory,Domain=im,Server=Server</wsdl:UniqueName>
            </wsdl:Subject>
         </wsdl:ModifyActiveDirectoryEndpointSearch>
         <wsdl:ModifyActiveDirectoryEndpointActiveDirectoryEndpointEndpointTab>
            <wsdl:description>new_value</wsdl:description>
            <wsdl:authPassword>new_password</wsdl:authPassword>
            <wsdl:_BAR_authPasswordconfirmation_BAR_>new_password</wsdl:_BAR_authPasswordconfirmation_BAR_>
         </wsdl:ModifyActiveDirectoryEndpointActiveDirectoryEndpointEndpointTab>
      </wsdl:ModifyActiveDirectoryEndpoint>
   </soapenv:Body>
</soapenv:Envelope>

Additional Information

Notes

• Replace <my password for imadmin> with the actual password for the imadmin account.
• Replace new_value with the desired description.
• Replace new_password with the desired new password.

By following these examples, you can successfully update the endpoint's description and password using TEWS web services. Ensure all credentials and endpoint details are correctly configured before executing these SOAP requests.