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
-
Deploy an Agent to the Kubernetes cluster, as described in Deploying Agents Using a Helm Chart.
-
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.
-
Get your organization certificate authority (CA) to sign the CSR that you created in the previous step.
-
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
-
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
-
Run the following config server:agent::ping command to verify that the Agent is available:
ctm config server:agent::ping <server> <agent>
-
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
