---
title: Sophos Central
slug: authentication-guides/sophos-central
docTags: 
createdAt: 2026-03-11T05:38:02.809Z
---

# Introduction

This guide explains how to authenticate the Sophos Central connector in Swimlane using OAuth 2.0 Client Credentials. You will register an API client in Sophos Central, collect the required credentials, and configure the connector asset in Swimlane Turbine.

# Prerequisites

## Sophos Central Access Requirements

You must have Sophos Central administrator permissions to:

- Access Sophos Central Admin console
- Create and manage API credentials
- Retrieve tenant and region information
- Authorize API access for integrations

## Required Credentials

During setup you will collect:

- Sophos Central API Base URL (Data Region URL)
- Client ID
- Client Secret
- X‑Tenant‑ID (optional but recommended)
- Token URL

## Register a Sophos Central API Client

1. Log in to the Sophos Central Admin console at https\://central.sophos.com.
2. Navigate to Global Settings.
3. Open the API Credentials Management section.
4. Click Add Credential.
5. Provide a Name and Description for the API credential.
6. Assign the required access permissions for the integration.
7. Click Save to generate credentials.
8. Copy the Client ID and Client Secret.
9. Store the credentials securely.

## Retrieve Tenant Information

1. After creating API credentials, navigate to the Sophos Central dashboard.
2. Locate your Tenant ID from the Sophos Central environment.
3. Alternatively call the WhoAmI API endpoint to retrieve tenant details.
4. Copy the Tenant ID value for use in the Swimlane asset configuration.

## Determine the Sophos Data Region URL

Sophos Central uses regional API endpoints. The base API URL depends on the region where your Sophos Central tenant is hosted.

| **Region**    | **API URL Example**                       |
| ------------- | ----------------------------------------- |
| United States | <u>https\://api.central.sophos.com</u>    |
| Europe        | <u>https\://api-eu.central.sophos.com</u> |
| Australia     | <u>https\://api-au.central.sophos.com</u> |
| India         | <u>https\://api-in.central.sophos.com</u> |

# Connector Configuration in Swimlane

1. Log in to **Turbine.**
2. From the left navigation pane click **ORCHESTRATION** and select **Assets**.
3. Click the **Plus (+)** icon to create a new asset.
4. Select **Sophos Central** from the **Asset Type** list.
5. Fill in the **Asset Settings** and **Asset Input&#x20;**&#x66;ields as shown below.
6. Click **Create.**

| **Field**      | **Description**                                   | **Required** |
| -------------- | ------------------------------------------------- | ------------ |
| url            | Base API URL for the Sophos Central data region   |  Required    |
| client\_id     | Sophos Central API Client ID                      |  Required    |
| client\_secret | Sophos Central API Client Secret                  |  Required    |
| X-Tenant-ID    | Sophos tenant identifier                          |  Optional    |
| token\_url     | OAuth token endpoint for Sophos Central           |  Optional    |
| scope          | Optional OAuth permission scopes                  |  Optional    |
| verify\_ssl    | Enable or disable SSL verification                |  Optional    |
| http\_proxy    | Proxy configuration if API traffic requires proxy |  Optional    |

# Troubleshooting

- Ensure the Client ID and Client Secret are copied correctly from the Sophos Central console.
- Verify the API URL corresponds to the correct Sophos region.
- If authentication fails, regenerate the API credentials and update the Swimlane asset.
- Confirm the integration permissions assigned to the API credential allow the required API actions.
- Ensure outbound network access to Sophos Central API endpoints is allowed.
- If your environment uses a proxy, configure the http\_proxy parameter.

**Result**

You have successfully authenticated the Sophos Central connector in Swimlane.

**Sources**

- [https://developer.sophos.com/docs](https://developer.sophos.com/docs)
- [https://developer.sophos.com/docs/getting-started-with-apis](https://developer.sophos.com/docs/getting-started-with-apis)
- [https://developer.sophos.com/docs/common-api](https://developer.sophos.com/docs/common-api)