---
title: Sophos Central Cloud
description: Gain insights into Sophos alerts, events, audit events, detections, and cases.
breadcrumbs: Docs > Integrations > Sophos Central Cloud
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Sophos Central Cloud
Integration version1.1.0
{% callout %}
# Important note for users on the following Datadog sites: us2.ddog-gov.com

{% alert level="info" %}
To find out if this integration is available in your organization, see your [Datadog Integrations](https://app.datadoghq.com/integrations) page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email [support@ddog-gov.com](mailto:support@ddog-gov.com).
{% /alert %}

{% /callout %}
  Sophos Central Cloud - AlertsSophos Central Cloud - Events
## Overview{% #overview %}

[Sophos Central](https://www.sophos.com/en-us/products/sophos-central) is a unified, cloud-based management platform to monitor and secure your organization from threats. It's used by businesses of all sizes to consolidate the Sophos suite of solutions into a single management solution.

This integration ingests the following logs:

- Alert: Represents a notification or warning generated by Sophos Central Cloud in response to a security event or potential threat. Alerts are triggered based on predefined security policies, detection rules, or anomalous activities identified by the Sophos Central Cloud.
- Event: Represents a specific occurrence that is detected and recorded by Sophos Central Cloud. Events can include various security-related activities such as malware detection, unauthorized access attempts, system vulnerabilities, and other security events.
- Audit event: Represents an administrative action in Sophos Central, such as a sign-in, a policy or settings change, or an API credential change.
- Detection: Represents a Sophos extended detection and response (XDR) detection, raised from endpoint, network, email, cloud, or third-party data.
- Case: Represents a Sophos XDR case, an investigation that groups related detections. Each log is one version of the case, with the case's comments.

The Sophos Central Cloud integration seamlessly collects all the above listed logs, channeling them into Datadog for analysis. Leveraging the built-in logs pipeline, these logs are parsed and enriched, enabling effortless search and analysis. The integration provides insight into alerts and events through the out-of-the-box dashboards. Additionally, the integration enriches corresponding endpoint details along with alert and event logs through the **get_endpoint_details** flag.

## Setup{% #setup %}

### Prerequisites{% #prerequisites %}

- A Sophos Central tenant account.
- To collect detections and cases: a Sophos XDR, Sophos endpoint detection and response (EDR), or Sophos managed detection and response (MDR) license, with the tenant moved to the Sophos XDR platform. Sophos moves tenants on its own schedule. Detections and cases are not available until the move is complete.

### Generate API credentials in Sophos Central Cloud{% #generate-api-credentials-in-sophos-central-cloud %}

1. Log into your [**Sophos Central account**](https://cloud.sophos.com/manage/login).
1. From Sophos Central Admin, go to **My Products** > **General Settings** > **API Credentials Management**.
1. Click **Add Credential**.
1. Provide a credential name, select a role, add an optional description, and click the **Add** button. The role needs the `logs_reports:read` permission to collect audit events and read access to XDR data to collect detections and cases. The API credential summary page with the client ID is displayed. For details, see [Sophos's getting started guide](https://developer.sophos.com/getting-started-tenant).
1. Click **Show Client Secret** to display the **Client Secret**.

### Connect your Sophos Central Cloud account to Datadog{% #connect-your-sophos-central-cloud-account-to-datadog %}

1. Open the [Sophos Central Cloud integration tile](https://app.datadoghq.com/integrations/sophos-central-cloud) in Datadog and add your credentials:

| Parameters           | Description                                                                                                                            |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| Client ID            | The client ID from Sophos Central Cloud.                                                                                               |
| Client Secret        | The client secret from Sophos Central Cloud.                                                                                           |
| Get Endpoint Details | Keep the default value of "true" to collect endpoint details for Sophos Central Cloud Alert and Event Logs. Otherwise, set to "false". |

1. Click the **Save** button to save your settings.

### Validation{% #validation %}

In the [Log Explorer](https://app.datadoghq.com/logs?query=source%3Asophos-central-cloud), search for `source:sophos-central-cloud`. Logs appear within about 15 minutes of setup. The integration waits about 10 minutes after Sophos creates a detection before collecting it, so that it does not miss late-arriving detections.

## Troubleshooting{% #troubleshooting %}

- **No audit events**: Check that the API credential's role includes the `logs_reports:read` permission.
- **No detections or cases**: Check that the API credential's role can read XDR data, that the tenant has a Sophos XDR, EDR, or MDR license, and that Sophos has moved the tenant to the Sophos XDR platform.

## Data Collected{% #data-collected %}

### Logs{% #logs %}

The integration collects and forwards Sophos Central Cloud alert, event, audit event, detection, and case logs to Datadog. Each log type has its own `service` tag: `alert`, `event`, `audit`, `detection`, and `case`.

The integration collects detections of every severity, so detection log volume can be high on busy tenants.

The integration has these limitations:

- Detections are collected once, when Sophos creates them. Later changes to a detection, such as a status change, are not collected. Analyst follow-up appears in case logs.
- A case log is sent when the case's last-updated time changes. A comment that does not change that time is collected with the case's next update.
- A case log includes up to 500 comments. When a case has more, the log's `comments_truncated` attribute is `true`.

### Metrics{% #metrics %}

The Sophos Central Cloud integration does not include any metrics.

### Events{% #events %}

The Sophos Central Cloud integration does not include any events.

## Support{% #support %}

Need help? Contact [Datadog Support](https://docs.datadoghq.com/help/).
