Enterprise Administration Guide › Implementing Shared Accounts › SAM Endpoint and Shared Account Creation › Create an Endpoint › SSH Device Connection Information › Customize an SSH Device XML File

Customize an SSH Device XML File

The SSH Network and Device XML file defines how SAM connects to an SSH Device or a Network Device endpoint, discovers user accounts, and changes privileged account passwords on the endpoint.CA ControlMinder provides several different SSH Device and Network Device XML files. These files contain the default settings that SAM uses to connect to the various types of SSH Device and Network Device endpoints.

If an SSH Device or Network Device endpoint uses an alternate method to change privileged account passwords on the endpoint, customize the Device XML file to specify the nondefault settings. For example, customize the SSH Device XML file to create an endpoint for a router, switch, or firewall that uses a nonstandard method to discover user accounts and change privileged account passwords.

Note: The Enterprise Management Server and the Distribution Servers each use local Device XML files to connect to an endpoint. If you customize the Device XML file on the Enterprise Management Server, verify that the Device XML file in all the Distribution Servers in your CA ControlMinder environment are also updated.

Follow these steps:

1. On CA ControlMinder Enterprise Management, locate the XML file that you want to customize. The files are located in the following directories:

   SSH Device:

   ACServerInstallDir/conf/override/sshdyn
   

   Network Device:

   ACServerInstallDir/conf/override/netdevicedyn
   

2. Duplicate the file that you want to customize and open the new file for editing.

   Note: Save the new file in the same directory.

3. Modify the parameters in the file to suit your enterprise requirements.

   Each <item> element in the file defines the parameters for a specific command. SAM uses these commands to get users and change passwords on the endpoint. You modify the <item> elements to define the commands that SAM sends to the endpoint. You can also modify the settings that SAM uses to connect to the endpoint.

4. Save and close the file.

   You have customized the Device XML file for the endpoint.

Note: For more information about the format of the SSH Device XML file, see the Reference Guide.

Note: If you are customizing the file with Chinese, Japanese, or Korean characters, save the file using UTF-8 encoding.

More information:

The SSH Device XML File