Skip to main content
You connect iboss once for each client that uses it. Each connection takes the client’s iboss cloud API host and an API key from the client’s own iboss account.

1. Create the API key in iboss

1

Open the client's account

Sign in to the iboss admin console and open the client’s account (from your MSSP console, open that customer). An API key belongs to the account it is created in.
2

Add an API key

Type “system administrators” into the console’s search bar, open System Administrator Management, go to the API Keys tab and click Add API Key. Give it a prefix such as neo-agent and an expiry date (at most five years).
3

Choose its RBAC group

The key’s RBAC group decides what Neo can read and change in this account. The Default RBAC Group gives full administrative access; for less, create an RBAC group with the areas your agents need (for example web reporting and policy layers).
4

Allow Neo's IP addresses

Under Source IP Login Restrictions, add each address on the IP Whitelisting page as a CIDR ending in /32, and press Enter after each. iboss refuses every request from an address that is not on this list.
5

Copy the key

Save the key and copy its full value, which ends with the account number.
Neo stops working for this client when the key expires, is disabled or is removed. Before the expiry date, extend it in iboss or save a new key in Neo. Neo’s agents never rotate the key.

2. Add the key in Neo

1

Open Integrations

In the Neo Dashboard, open Integrations → iboss, under Security.
2

Pick the client

In Customer, choose the client this iboss account belongs to. The client must be on your Companies tab. For a second client, click Add customer.
3

Enter the host and paste the key

Enter the Cloud API Host, api.ibosscloud.com for most accounts, paste the API Key, and click Save settings. Neo checks the key against iboss before saving, so a wrong key, or a missing IP address on the key, is rejected straight away.

3. Turn iboss on per agent

1

Open the agent's integrations

Open the agent in the Neo Dashboard and go to its Integrations tab, or ask your Neo Support Agent to add iboss to it.
2

Pick an access profile

Under iboss, pick an access profile, or set each permission group by hand.
For temporary exceptions, give the agent the Trigger or Schedule Workflow tool: it schedules its own run to remove the entry when the time is up.