Skip to content

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.

  • Airgate pages through GET /web/api/v2.1/agents (1,000 agents per page) with Authorization: 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, with SentinelOne Is Decommissioned = true.
  • The attribute names match the ClearPass SentinelOne extension, so migrated policies keep working.
  • 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”
  1. 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.

  2. Copy the token (it is shown once) and note its expiry. User tokens expire after 6 months by default.

  1. Open Integrations › SentinelOne.

  2. In Connect SentinelOne, enter:

    Field Value
    Management console URL The address you open the console with, for example https://usea1-contoso.sentinelone.net
    API token the token from Step 1 (stored encrypted)
    Sync agents on, with the interval (Every 15 minutes to Once a day)
  3. Select Connect, then Test connection. A success shows “SentinelOne management API reachable (N agents)”.

  4. Select Sync now to sync immediately; it starts within 30 seconds.

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.

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.

  • 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.
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.
© 2026 Airowire Networks Pvt. Ltd. Airgate is a product of Airowire.Product · Release notes · Security