---
title: SecureWorks Taegis XDR
slug: authentication-guides/secureworks-taegis-xdr
docTags: 
createdAt: 2026-07-27T12:13:34.014Z
---

## Introduction

This guide tells you how to authenticate the **SecureWorks Taegis XDR** connector in Swimlane using **OAuth 2.0 Client Credentials**.

You will create an API Client in Taegis XDR, collect the required credentials, and configure the connector in Swimlane.

# Prerequisites

## SecureWorks Taegis XDR Access Requirements

You must have permissions to:

- Access the **SecureWorks Taegis XDR** portal.
- Create and manage API Clients.
- Access the Taegis GraphQL API.
- Manage OAuth applications.

# Required Credentials

During setup, you will collect:

- Host URL
- Client ID
- Client Secret
- (Optional) OAuth Scope

# SecureWorks Taegis XDR Setup

Take the following steps to create an API Client:

1. Log in to the **SecureWorks Taegis XDR** portal.
2. Navigate to **Administration** > **API Clients**.
3. Click **Create API Client**.
4. Enter a name and description for the API client.
5. Assign the required API permissions based on the actions you want the connector to perform.
6. Click **Create**.
7. Copy and securely save the **Client ID**.
8. Copy and securely save the **Client Secret**.

These values are used to authenticate the Swimlane connector.

Take the following steps to collect the Host URL:

1. Log in to your **SecureWorks Taegis XDR** tenant.
2. Copy the tenant URL from your browser.

Example:

https\://api.\<region>.taegis.secureworks.com

Use this value as the **url** during connector configuration.

## OAuth Scope

The Swimlane connector supports an optional **scope** parameter.
If your SecureWorks administrator specifies OAuth scopes for your API client, enter them in the connector configuration. Otherwise, leave this field blank.

# Connector Configuration in Swimlane

1. Log in to Turbine.
2. From the left-hand navigation pane, click **ORCHESTRATION** and click **Assets**.
3. Asset homepage opens.
4. Click the plus icon to open the **Configure your Connector Asset** window.
5. Select **SecureWorks Taegis XDR** from the Asset type list.
6. Fill in the Asset Settings and Asset Input as shown:

| **Field**          | **Description**                                       | **Required/Optional** |
| ------------------ | ----------------------------------------------------- | --------------------- |
| **url**            | SecureWorks Taegis XDR Host URL                       | Required              |
| **client\_id**     | OAuth Client ID                                       | Required              |
| **client\_secret** | OAuth Client Secret                                   | Required              |
| **scope**          | OAuth permission scopes (leave blank unless required) | Optional              |
| **verify\_ssl**    | Enable/Disable SSL Verification                       | Optional              |
| **http\_proxy**    | Optional proxy configuration                          | Optional              |

Fields with \* marks are required.

7. Click **Create**.

::Image[]{src="https://api.archbee.com/api/optimize/n8uUzk0MM4uC57-zlHNtY/EUaOHQS8qh095fyTex8ra_image.png" size="200" isUploading="false" width="800" height="408" darkWidth="800" darkHeight="408" showCaption="false"}

# Troubleshooting

## Authentication Failed (401 Unauthorized)

Verify that:

- The Client ID is correct.
- The Client Secret is correct.
- The API client has not been disabled.
- The Host URL points to the correct Taegis tenant.

## Permission Denied (403 Forbidden)

Verify that:

- The API client has sufficient permissions.
- The requested OAuth scopes are allowed.
- Your organization permits API access.

## Unable to Obtain OAuth Token

Verify that:

- The Client ID and Client Secret match.
- The OAuth client has not expired.
- The Host URL is correct.
- Network devices or proxies are not blocking outbound HTTPS requests.

## SSL Errors

If SSL verification fails:

- Verify that the Taegis XDR endpoint uses a trusted SSL certificate.
- Confirm that any corporate proxy is not intercepting SSL traffic.
- Disable **verify\_ssl** only for testing if permitted by your organization's security policy.

### Result

You have successfully authenticated the **SecureWorks Taegis XDR** connector in Swimlane.

### Sources

- SecureWorks Taegis XDR API Getting Started
  [https://docs.ctpx.secureworks.com/apis/using\_xdr\_apis/](https://docs.ctpx.secureworks.com/apis/using_xdr_apis/)
- SecureWorks Taegis XDR API Authentication Documentation
  [https://docs.ctpx.secureworks.com/apis/authentication/](https://docs.ctpx.secureworks.com/apis/authentication/)
- SecureWorks Taegis XDR GraphQL API Documentation
  [https://docs.ctpx.secureworks.com/apis/graphql/](https://docs.ctpx.secureworks.com/apis/graphql/)
- SecureWorks Taegis XDR API Reference
  [https://docs.ctpx.secureworks.com/apis/](https://docs.ctpx.secureworks.com/apis/)