Setting Up SSL/TLS Communication with an Agent

This procedure describes how to set up SSL/TLS communication with an Agent that is deployed in a Kubernetes cluster. You must perform this procedure with Control-M Automation API commands.

You can also perform this procedure to update the Agent certificate.

Before You Begin

  • Verify that your computer contains the Certificate Authority (CA) that signs Agent certificate requests.

    This CA must be the same one that signs certificate requests from Control-M/Server, as described in Generating a Signed Certificate.

  • To run Control-M Automation API commands on the same computer, verify that you have set up Control-M Automation CLI, as described in Control-M Automation API Installation.

Begin

  1. Deploy an Agent to the Kubernetes cluster, as described in Deploying Agents Using a Helm Chart.

  2. Run the following config server:agent:csr::create command to create a Certificate Signing Request (CSR) for the deployed Agent:

    ctm config server:agent:csr::create <server> <agent> -f <configuration file>

    where the configuration file contains the following parameters:

    Copy
    {  
       "organization": "example_organization",  
       "organizationUnit": "example_unit",  
       "cityLocality": "example_city",  
       "stateProvince": "example_state",  
       "country": "CO",  
       "emailAddress": "[email protected]"
    }

    The CSR file is created in PEM format.

  3. Get your organization certificate authority (CA) to sign the CSR that you created in the previous step.

  4. Run the following config server:agent:crt::deploy command to deploy the signed certificate to the Agent:

    ctm config server:agent:crt::deploy <server> <agent> <crt_filepath> <ca_chain_filepath>

    ctm config server:agent:crt::deploy Server1 Agent1 /path/signed_cert.pem /path/ca_chain.pem

  5. Run the following config item::recycle command to recycle the Agent:

    ctm config item::recycle CTMS:Agent:<server>:<agent>

    ctm config item::recycle CTMS:Agent:Server1:Agent1

  6. Run the following config server:agent::ping command to verify that the Agent is available:

    ctm config server:agent::ping <server> <agent>

  7. Run the following config server:agent::update command to enable SSL/TLS communication between Control-M/Server and the Agent:

    ctm config server:agent::update <server> <agent> sslState Enabled