> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neoagent.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecting ConnectSecure to Neo

> Copy your ConnectSecure pod's address, tenant name and a user's API key, save them in Neo, and turn ConnectSecure on per agent

You connect ConnectSecure once at the MSP level. One API key reaches every company in your ConnectSecure tenant.

## 1. Collect four values in ConnectSecure

**1. Copy the API address**

Sign in to ConnectSecure, open **Profile**, then **API Documentation**, and copy the address it opens, such as `https://pod106.myconnectsecure.com`. That is your pod. The portal you sign in to (`portal.myconnectsecure.com`) is not the API.

**2. Note the tenant**

The tenant is the name you sign in to the ConnectSecure portal with.

**3. Create the API key**

Open **Global**, then **Settings**, then **Users**. Choose the user Neo acts as, open its menu (the three dots), and choose **API Key**. Copy the **Client ID** and **Client Secret**. Neo acts with that user's role, so give it a role that can see every company you want Neo to work with.

## 2. Add them in Neo

**1. Open Integrations**

In the Neo Dashboard, open **Integrations** and find the ConnectSecure card, under Vulnerability & Attack Surface.

**2. Save the values**

Enter the **API URL**, **Tenant**, **Client ID** and **Client Secret**, and click **Save**. Neo signs in to ConnectSecure and lists one company before saving, so a wrong value is reported straight away.

Neo then lists your companies and maps them to your PSA companies on the **Organization Mapping** tab.

ConnectSecure allows 300 API calls a minute and 2,000 an hour for your tenant. Neo keeps its own calls to 30 a minute, so your other tools keep their share.

## 3. Turn ConnectSecure on per agent

Open the agent, go to the **Tools & Settings** tab, and configure the ConnectSecure block under **Tools & Integrations**. Pick a profile, or set each area:

| Area | Access levels you can pick | Notes |
| - | - | - |
| **Companies** | Disabled, Read Only, Read/Write | Deleting a company always asks. |
| **Assets and Agents** | Disabled, Read Only, Read/Write | Needed to find a device by name or IP. Updating an asset always asks. |
| **Vulnerabilities and Suppressions** | Disabled, Read Only, Read/Write | Needed for vulnerabilities, missing patches and fixes. Helpdesk and IT Admin ask a technician before a suppression. |
| **Scans and Patching** | Disabled, Read Only, Read/Write | Helpdesk asks a technician before a scan or a patch. Changing a scheduled scan always asks. |
| **Compliance and Reports** | Disabled, Read Only, Read/Write | Creating a ConnectSecure report runs without approval on Helpdesk. |
| **Settings and Integrations** | Disabled, Read Only, Read/Write | IT Admin asks a technician before a change. A scan credential, the discovery settings, which credential a probe uses where, and a PSA integration's credential or rule always ask. |

See [ConnectSecure API](https://docs.neoagent.io/agents/tools/security/connectsecure-api.md) for what the agent can do.

## Set up an agent

Ask your Neo Support Agent for the agent you need, for example: "Set up a triggered agent for tickets about a device. It finds the device in ConnectSecure and adds its critical and high vulnerabilities, missing patches and fixes to the ticket as an internal note." For new critical findings, ask for the **ConnectSecure Vulnerability Tickets** template.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.