Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Connect the agent to the MID Web Server using TLS

Connect the agent to the MID Web Server to enable configuring mTLS on your MID Web Server and agent.

Before you begin

Ensure that you have installed the .pem file and set up the MID Web Server. For details, see Set up the MID Web Server with a .pem file.

Role required: agent_client_collector_admin

Procedure

  1. Add the labcacert.pem file to your agent host's truststore.

    sudo cp -a /<path>/<to>/labcacert.pem /etc/pki/ca-trust/source/anchors/; 
    sudo update-ca-trust extract 
    openssl verify /<path>/<to>/labcacert.pem
    

    The generated output is /<path>/labcacert.pem: OK

  2. Configure the acc.yml file to use TLS.

    1. Set the insecure-skip-tls-verify property to false.

    2. Set the backend-url property to use the MID Server's FQDN.

      backend-url="wss://<mid server fqdn>:<mid web server port>/ws/events"

  3. Restart the agent.

    systemctl restart acc;
    
  4. Verify in the logs that the agent is connected to the MID Server.

What to do next

Configure mTLS authentication for a MID Web Server.