Sophos
Visualize Sophos endpoint agents and protected devices, map agents to devices and their respective owners, and monitor changes through queries and alerts.
- Installation
- Authorization
- Data Model
- Types
- Release Notes
Installation
You will need to create an API credential in the Sophos Central Admin console. See the Sophos Getting Started (Tenant) documentation for details.
Prerequisites
- A Sophos Central (Sophos Fusion) tenant account. This integration only accepts tenant credentials; partner and organization credentials are rejected.
- The person creating the API credential must hold the Super Admin role in Sophos Central. While the Sophos APIs are in Preview, all access runs at the Super Admin level.
Create the API credential
- Sign in to Sophos Central Admin at https://central.sophos.com/manage.
- Click Global Settings, then API Credentials.
- Click Add, supply a name and a description, then click Add.
- Copy the Client ID, then reveal and copy the Client Secret.
Keep the Client ID and Client Secret available for the next step.
Configuration in JupiterOne
To install the Sophos integration in JupiterOne, navigate to the Integrations tab in JupiterOne and select Sophos. Click New Instance to begin configuring your integration.
Creating an instance requires the following:
-
The Account Name used to identify the Sophos tenant account in JupiterOne.
-
An optional Description to help identify the integration instance.
-
A Polling Interval for how frequently data is refreshed. Leave this as
DISABLEDto trigger runs manually. -
Your Sophos Client ID to authenticate with the Sophos Central API.
-
Your Sophos Client Secret that pairs with the Client ID.
Click Create once all values are provided to finalize the integration.
Next steps
Now that your integration instance has been configured, it will begin running on the polling interval you provided, populating data within JupiterOne. Continue on to our Instance management guide to learn more about working with and editing integration instances.
Roles
RBAC roles that must be assigned to the integration principal.
Show Roles (1)
Super Admin
Endpoints
API endpoints that the integration makes requests to.
Show Endpoints (8)
https://api-{dataRegion}.central.sophos.com/common/v1/alertshttps://api-{dataRegion}.central.sophos.com/common/v1/directory/user-groupshttps://api-{dataRegion}.central.sophos.com/common/v1/directory/usershttps://api-{dataRegion}.central.sophos.com/common/v1/roleshttps://api-{dataRegion}.central.sophos.com/endpoint/v1/endpoint-groupshttps://api-{dataRegion}.central.sophos.com/endpoint/v1/endpointshttps://api-{dataRegion}.central.sophos.com/endpoint/v1/policieshttps://api.central.sophos.com/whoami/v1
Documentation Links
Links to provider documentation relevant to setup and configuration.
Show Documentation Links (9)
- https://developer.sophos.com/concepts/authentication/
- https://developer.sophos.com/getting-started-tenant/
- https://developer.sophos.com/reference/common-v1/alerts/get-alerts/
- https://developer.sophos.com/reference/common-v1/directory-management/list-tenant-user-groups/
- https://developer.sophos.com/reference/common-v1/directory-management/list-tenant-users/
- https://developer.sophos.com/reference/common-v1/tenant-role-management/list-tenant-roles/
- https://developer.sophos.com/reference/endpoint-v1/endpoint-groups-management/list-tenant-endpoint-groups/
- https://developer.sophos.com/reference/endpoint-v1/endpoints/list-endpoints-by-tenant-id/
- https://developer.sophos.com/reference/endpoint-v1/policy-management/get-policies/
Per-Step Breakdown
Detailed authorization requirements for each ingestion step.
Show all steps (7)
| Step | Roles | Endpoints |
|---|---|---|
| Fetch Alerts | Super Admin | https://api-{dataRegion}.central.sophos.com/common/v1/alerts |
| Fetch Endpoints | Super Admin | https://api-{dataRegion}.central.sophos.com/endpoint/v1/endpoints |
| Fetch Endpoints Groups | Super Admin | https://api-{dataRegion}.central.sophos.com/endpoint/v1/endpoint-groups |
| Fetch Policies | Super Admin | https://api-{dataRegion}.central.sophos.com/endpoint/v1/policies |
| Fetch Roles | Super Admin | https://api-{dataRegion}.central.sophos.com/common/v1/roles |
| Fetch User Groups | Super Admin | https://api-{dataRegion}.central.sophos.com/common/v1/directory/user-groups |
| Fetch Users | Super Admin | https://api-{dataRegion}.central.sophos.com/common/v1/directory/users |
Entities
The following entities are created:
| Resources | Entity _type | Entity _class |
|---|---|---|
| Alert | sophos_alert | Alert |
| Device | sophos_device | Device |
| Endpoint | sophos_endpoint | HostAgent |
| Endpoint Group | sophos_endpoint_group | Group |
| Policy | sophos_policy | ControlPolicy |
| Role | sophos_role | AccessRole |
| Sophos Account | sophos_account | Account |
| Sophos Common | sophos_common | Service |
| Sophos Endpoint Protection | sophos_endpoint_protection | Service |
| Sophos User | sophos_user | User |
| User Group | sophos_user_group | UserGroup |
Relationships
The following relationships are created:
Source Entity _type | Relationship _class | Target Entity _type |
|---|---|---|
sophos_account | HAS | sophos_common |
sophos_account | HAS | sophos_endpoint_protection |
sophos_alert | ASSIGNED | sophos_user |
sophos_alert | ASSIGNED | sophos_user_group |
sophos_alert | ASSIGNED | sophos_endpoint |
sophos_alert | ASSIGNED | sophos_endpoint_group |
sophos_common | HAS | sophos_role |
sophos_common | HAS | sophos_user_group |
sophos_endpoint | PROTECTS | sophos_device |
sophos_endpoint | IDENTIFIED | sophos_alert |
sophos_endpoint_group | HAS | sophos_endpoint |
sophos_endpoint_protection | HAS | sophos_endpoint |
sophos_user | HAS | sophos_endpoint |
sophos_user_group | HAS | sophos_user |
Sophos Account
sophos_account inherits from Account
| Property | Type | Description | Specifications |
|---|---|---|---|
id * | string | ||
idType * | string | const: tenant |
Sophos Alert
sophos_alert inherits from Alert
| Property | Type | Description | Specifications |
|---|---|---|---|
allowedActions * | array of strings | ||
category * | string | Any of: azureadSyncapplicationControlappReputationblockListedconnectivitycwgdencdownloadReputationendpointFirewallfencforensicSnapshotgeneralisolationmalwaremtrmobilespolicyprotectionpuaruntimeDetectionssecuritysmcsystemHealthuavuncategorizedupdatingutmvirtwirelessxgEmailztnaAuthenticationztnaGatewayztnaResource | |
createdAt | number | ||
description * | string | ||
groupKey * | string | ||
id * | string | ||
product | string | Any of: otherendpointservermobileencryptionemailGatewaywebGatewayphishThreatwirelessfirewallztna | |
raisedAt | string | Format: date-time | |
severity | string | Any of: highmediumlow | |
type | string |
Sophos Common
sophos_common inherits from Service
| Property | Type | Description | Specifications |
|---|---|---|---|
accountId * | string | ||
principal * | string |
Sophos Device
sophos_device inherits from Device
| Property | Type | Description | Specifications |
|---|---|---|---|
online | boolean | ||
platform | string | ||
tamperProtectionEnabled | boolean | ||
type | string |
Sophos Endpoint
sophos_endpoint inherits from HostAgent
| Property | Type | Description | Specifications |
|---|---|---|---|
displayName * | string | Uses the endpoint's hostname if available. Uses associated person's name or "viaLogin" property as a fall back | |
hostname * | string | ||
id * | string | ||
ipv4Addresses | array of strings | Format: ipv4 | |
ipv6Addresses | array of strings | Format: ipv6 | |
lastSeenOn * | number | ||
macAddresses | array of strings | ||
name * | string | Uses the endpoint's hostname if available. Uses associated person's name or "viaLogin" property as a fall back | |
online | boolean | ||
tamperProtectionEnabled | boolean | ||
type * | string | Any of: computerserversecurityVm |
Sophos Endpoint Group
sophos_endpoint_group inherits from Group
| Property | Type | Description | Specifications |
|---|---|---|---|
createdAt | number | ||
description | string | ||
id * | string | ||
name * | string | ||
type * | string | Any of: computerserver | |
updatedAt | number |
Sophos Endpoint Protection
sophos_endpoint_protection inherits from Service
| Property | Type | Description | Specifications |
|---|---|---|---|
accountId * | string | ||
principal * | string |
Sophos Policy
sophos_policy inherits from ControlPolicy
| Property | Type | Description | Specifications |
|---|---|---|---|
createdAt | number | ||
disableAt | number | When the policy should be turned off. | |
enabled * | boolean | ||
id * | string | ||
lockedByManagingAccount * | boolean | Whether the policy is managed by a partner or organization, 'true' mean yes. | |
name * | string | ||
priority * | number | ||
type * | string | Any of: threat-protectionperipheral-controlapplication-controldata-loss-preventionweb-controlagent-updatingwindows-firewalldevice-encryptionserver-threat-protectionserver-peripheral-controlserver-application-controlserver-web-controlserver-lockdownserver-data-loss-preventionserver-agent-updatingserver-windows-firewallserver-file-integrity-monitoringserver-linux-runtime-detection | |
updatedAt | number |
Sophos Role
sophos_role inherits from AccessRole
| Property | Type | Description | Specifications |
|---|---|---|---|
createdAt | number | ||
description | string | ||
id * | string | ||
name * | string | ||
permissionSets * | array of strings | ||
principalType * | string | Any of: userservice | |
systemRole * | boolean | Indicates that this role is a system role, not a custom user-defined role. True if type == 'predefined' | |
type * | string | Any of: predefinedcustom | |
updatedAt | number |
Sophos User
sophos_user inherits from User
| Property | Type | Description | Specifications |
|---|---|---|---|
createdAt | number | ||
domain | string | ||
exchangeLogin | string | ||
updatedAt | number |
Sophos User Group
sophos_user_group inherits from UserGroup
| Property | Type | Description | Specifications |
|---|---|---|---|
createdAt | number | ||
description | string | ||
domain | string | ||
id * | string | ||
name * | string | ||
source | string | Any of: customactiveDirectoryazureActiveDirectory | |
updatedAt | number |
Release Notes
- 2026-04-08 — Improved OS details display for Sophos endpoint entities to include OS name and build number.