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.
Note: This procedure includes commands for both CentOS 7/Linux and Windows Server environments. Select the commands relevant for your host operating system. If working with another Linux distribution, adapt the commands as needed for your specific OS.
Role required: agent_client_collector_admin
Procedure
-
In a Linux environment:
-
Add the
labcacert.pemfile to your agent host's trust store.Shellsudo cp -a /<path>/<to>/labcacert.pem /etc/pki/ca-trust/source/anchors/;sudo update-ca-trust extractopenssl verify /<path>/<to>/labcacert.pemThe generated output is:
/<path>/labcacert.pem: OK -
Configure the
acc.ymlfile to use TLS.- Set the insecure-skip-tls-verify property to
false. - Set the backend-url property to use the MID Server's FQDN.
Textbackend-url="wss://<mid server fqdn>:<mid web server port>/ws/events" - Set the insecure-skip-tls-verify property to
-
Restart the agent.
Textsystemctl restart acc; -
Verify in the logs that the agent is connected to the MID Server.
-
-
In a Windows environment:
-
Add the
labcacert.pemfile to your agent host's trust store by importing it into the Windows Certificate Store.Textcertutil -addstore -f "Root" <path>\labcacert.pemopenssl verify -CAfile <path>\labcacert.pem <path>\labcacert.pemThe generated output is:
<path>\labcacert.pem: OK -
Configure the
acc.ymlfile (C:\ProgramData\servicenow\agent-client-collector\config\acc.yml) to use TLS.-
Set the insecure-skip-tls-verify property to
false. -
Set the backend-url property to use the MID Server's FQDN:
Textbackend-url: - "wss://<mid server fqdn>:<mid web server port>/ws/events"
-
-
Restart the agent using one of the following methods:
-
Command line:
Textnet stop AgentClientCollectornet start AgentClientCollector -
Services app: Select and hold the Agent Client Collector entry and select Restart.
-
-
Verify in the logs that the agent is connected to the MID Server.
Logs are located at:
C:\ProgramData\ServiceNow\agent-client-collector\log\acc.log(or the location set by the log-file configuration parameter).
-
What to do next
---
title: Connect the agent to the MID Web Server using TLS
description: Connect the agent to the MID Web Server to enable configuring mTLS on your MID Web Server and agent.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/it-operations-management/event-management/agent-mid-connect.html
release: brazil
product: Event Management
classification: event-management
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [MID Web Server and agent mTLS Authentication, Configure the MID Web Server extension, MID Web Server, Event Management setup, Configure, Event Management, ITOM AIOps, IT Operations Management]
---
# 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](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/it-operations-management/event-management/set-mid-web-server.md).
**Note:** This procedure includes commands for both CentOS 7/Linux and Windows Server environments. Select the commands relevant for your host operating system. If working with another Linux distribution, adapt the commands as needed for your specific OS.
Role required: agent\_client\_collector\_admin
## Procedure
1. In a Linux environment:
1. Add the `labcacert.pem` file to your agent host's trust store.
```
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.
2. In a Windows environment:
1. Add the `labcacert.pem` file to your agent host's trust store by importing it into the Windows Certificate Store.
```
certutil -addstore -f "Root" <path>\labcacert.pem
openssl verify -CAfile <path>\labcacert.pem <path>\labcacert.pem
```
The generated output is: `<path>\labcacert.pem: OK`
2. Configure the `acc.yml` file \(`C:\ProgramData\servicenow\agent-client-collector\config\acc.yml`\) 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 using one of the following methods:
- Command line:
```
net stop AgentClientCollector
net start AgentClientCollector
```
- Services app: Select and hold the **Agent Client Collector** entry and select **Restart**.
4. Verify in the logs that the agent is connected to the MID Server.
Logs are located at: `C:\ProgramData\ServiceNow\agent-client-collector\log\acc.log` \(or the location set by the **log-file** configuration parameter\).
## What to do next
[Configure mTLS authentication for a MID Web Server](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/it-operations-management/event-management/configure-mid-web-server-extension-mTLS.md).
| title | Connect the agent to the MID Web Server using TLS |
| description | Connect the agent to the MID Web Server to enable configuring mTLS on your MID Web Server and agent. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/it-operations-management/event-management/agent-mid-connect.html |
| release | brazil |
| product | Event Management |
| classification | event-management |
| topic_type | task |
| last_updated | 2026-09-10 |
| reading_time_minutes | 1 |
| breadcrumb | MID Web Server and agent mTLS AuthenticationConfigure the MID Web Server extensionMID Web ServerEvent Management setupConfigureEvent ManagementITOM AIOpsIT Operations Management |