SentinelOne agent sync
Airgate reads the agents from your SentinelOne management console and writes their state (agent found, infected, active threats, network quarantine…) to the matching device records. Access policies can then admit only devices with a clean SentinelOne agent.
How it works
Section titled “How it works”- Airgate pages through
GET /web/api/v2.1/agents(1,000 agents per page) withAuthorization: ApiToken <token>, every sync interval (default every hour). - Matching by MAC. Each agent is written to the device records of the
MAC addresses of its network interfaces. Interfaces that never sign in to
the network are skipped by name: macOS AirDrop and low-latency WLAN
(
awdl,llw), VPN tunnels (utun,tun,tap,wg,ipsec,ppp), bridges, hypervisor and container adapters (vmnet,vnic,docker,veth,virbr,vEthernet, VirtualBox, VMware, Hyper-V), Bluetooth, Wi-Fi Direct (“Local Area Connection*”, “Microsoft Wi-Fi Direct”), Teredo, ISATAP and loopback. An agent with no other interface keeps them all. - With Intune device-ID matching, the SentinelOne facts of an Intune device (found by its hardware MACs or its serial number) are added to EAP-TLS sign-ins even when the device uses a private Wi-Fi address.
- Agents removed from SentinelOne get
SentinelOne System Found = false. Decommissioned agents are synced too, withSentinelOne Is Decommissioned = true. - The attribute names match the ClearPass SentinelOne extension, so migrated policies keep working.
Before you begin
Section titled “Before you begin”- A SentinelOne console role that can create service users or API tokens.
- An Airgate administrator with
admin:write. - Airgate reaches your SentinelOne console URL over HTTPS.
Step 1: Create an API token in SentinelOne
Section titled “Step 1: Create an API token in SentinelOne”-
In the SentinelOne console, open Settings › Users › Service Users and create a service user with the Viewer role on the account or the sites to sync. Generate its API token.
A console user also works: My User › Options › Generate API token. The token then has that user’s access.
-
Copy the token (it is shown once) and note its expiry. User tokens expire after 6 months by default.
Step 2: Connect SentinelOne in Airgate
Section titled “Step 2: Connect SentinelOne in Airgate”-
Open Integrations › SentinelOne.
-
In Connect SentinelOne, enter:
Field Value Management console URL The address you open the console with, for example https://usea1-contoso.sentinelone.netAPI token the token from Step 1 (stored encrypted) Sync agents on, with the interval (Every 15 minutes to Once a day) -
Select Connect, then Test connection. A success shows “SentinelOne management API reachable (N agents)”.
-
Select Sync now to sync immediately; it starts within 30 seconds.
Limit the agents (optional)
Section titled “Limit the agents (optional)”To sync only some sites or skip decommissioned agents, add the key
agent_filter to the context server’s config through the API
(GET, then PUT /api/v1/t/contoso/context-servers/{id} with the same
object and the added key). The value is added to the agents query, for
example:
"config": { "mdm_sync": true, "sync_interval_min": 60, "agent_filter": "siteIds=225494730938493804&isDecommissioned=false"}The console has no field for it; the connection page keeps the key when you save.
Step 3: Use SentinelOne in access policies
Section titled “Step 3: Use SentinelOne in access policies”In Access › Access policies, the rule conditions SentinelOne agent (Installed (found in SentinelOne) / Not found) and SentinelOne threats (None (clean) / Infected) read the synced attributes:
| Order | Rule | When | Then |
|---|---|---|---|
| 1 | Clean agent |
SentinelOne agent Installed and SentinelOne threats None (clean) | Allow, corporate VLAN |
| 2 | Infected |
SentinelOne threats Infected | Allow, quarantine VLAN |
| Default | Deny |
More examples on the integration page: SentinelOne Active Threats GREATER_THAN 0 → quarantine; SentinelOne Network Status EQUALS disconnected (network quarantine in SentinelOne) → deny.
Attributes written
Section titled “Attributes written”| Attribute | Value |
|---|---|
SentinelOne System Found |
true while the agent is in SentinelOne, false once removed |
SentinelOne Infected |
true / false |
SentinelOne Active Threats |
number of unresolved threats |
SentinelOne Network Status |
connected, disconnected (network quarantine) |
SentinelOne Network Quarantine Enabled |
true / false |
SentinelOne Is Active, SentinelOne Is Up to Date |
true / false |
SentinelOne Is Decommissioned, SentinelOne Is Uninstalled |
true / false |
SentinelOne Mitigation Mode |
protect, detect |
SentinelOne Site Name, SentinelOne Group Name, SentinelOne Account Name |
organisation in SentinelOne |
SentinelOne Computer Name, SentinelOne Domain, SentinelOne OS Name, SentinelOne Agent Version, SentinelOne Serial Number, SentinelOne Last Logged in User Name |
inventory |
SentinelOne IPv4 Addresses, SentinelOne IPv6 Addresses, SentinelOne Locations |
comma-separated lists |
SentinelOne Last Active Date, SentinelOne Updated At |
change on every check-in; a change in them alone does not rewrite the device |
About 60 attributes are written in total, named SentinelOne <field> after
the agent fields of the v2.1 API.
Verify
Section titled “Verify”- The status tiles show Agents synced, Last sync, Next sync and Connection OK.
- Agents from SentinelOne lists the agents with Threats, Network, OS, Site / group and Agent.
- Devices › Devices › a MAC › Attributes: the
SentinelOne …attributes.
Troubleshooting
Section titled “Troubleshooting”| Symptom | Cause | Fix |
|---|---|---|
The last sync failed: sentinelone /web/api/v2.1/agents HTTP 401: … |
The token expired or was revoked. | Generate a new token and paste it in API token. |
HTTP 403 |
The user has no access to the sites. | Give the service user the Viewer role on the account or sites. |
config.agent_filter: … |
The filter is not a valid query string. | Use name=value&name=value. |
| Sign-in log: Denied: sentinelOne agent check failed, fact “not found in SentinelOne” | No agent reports the device’s MAC (agent missing, or a private Wi-Fi address). | Install or re-register the agent, then Sync now; for private addresses use Intune device-ID matching. |
| Sign-in log: Denied: sentinelOne threats check failed | The agent reports a threat. | Resolve the threat in SentinelOne, then Sync now. |
| One laptop appears as several devices | An interface name Airgate does not recognise as virtual. | Report the interface name to Airowire support. |