🌙
 

Subscribe to the Taegis™ XDR Documentation RSS Feed at .

Learn more about RSS readers or RSS browser extensions.

Configured Connections

automation connections connectors

In Automation, a connector is the definition that defines how Secureworks® Taegis™ XDR communicates with external IT tools, allowing a playbook to execute API calls that are published by a vendor.

A connection is an instance of a connector that you configure. The connection provides the method that Secureworks® Taegis™ XDR uses to authenticate to an IT tool within your environment, as well as the URL it should authenticate to.

View Configured Connections

To view and manage your connections, select Automations from the left-hand side navigation of Secureworks® Taegis™ XDR and choose Connectors. The Connections tab displays a table of any connections that have already been configured.

Configured Connections

Configured Connections

Edit Configured Connections Columns

Adding Columns to the Configured Connections

Adding Columns to the Configured Connections

Hover over any column heading and select the menu icon to adjust columns and add or remove displayed columns. Drag the columns to adjust their width.

Tip

Secureworks recommends adding the Version column to your configured connections list.

View a Configured Connection’s Details

To view details of a configured connection, select its name from the Connections table.

Itemized Configured Connection Details

Itemized Configured Connection Details

Connection details include:

  1. Version — The current version of the connection, as well as a link to manage versions. See Connector Versions for more.
  2. Documentation — A link to the connector requirements. See Edit a Configured Connection for more.
  3. Copy Share Link — Copy a direct link to this connection.
  4. Actions — Actions you can take on a connection:
  5. Basic Info — Create Date, Modified Date, and Auth Type of the connection.
  6. Tags — Internal tags for grouping connections. See Tag a Configured Connection for more.
  7. Functions in Connection — A table of all the actions that the connection supports.
  8. Associated Playbooks — Links to playbooks that currently use the connection to execute.

Edit a Configured Connection

To edit a configured connection:

  1. Open the connection details page.

Note

Each connector has built-in documentation that outlines the requirements for the connector type. Select Documentation from a connector or configured connection in XDR to open this in a new tab.

  1. Select Edit. An edit side panel displays.
  2. Edit the connection’s details or options for authentication.
  3. If configuring an On-Premise connector, see Configure Automations Connector with On-Premise Data Collector.
  4. Select Save to complete the connection configuration.

Editing a Configured Connection

Editing a Configured Connection

Tag a Configured Connection

Use tags to group together like connections. To tag a connection:

  1. Open the connection details page.
  2. Under Tags, select + Add.
  3. Search for an existing tag to apply. If it doesn’t exist, type in the desired tag.
  4. Select a tag to apply it. You can add as many tags as needed.

Tagging a Connection

Tagging a Connection

To remove a tag, hover over it and select the X.

Removing a Tag from a Connection

Removing a Tag from a Connection

Export Configured Connections

To export a list of all configured connections as a CSV file:

  1. From the left-hand side navigation of Secureworks® Taegis™ XDR, select Automations > Connectors.
  2. Edit the columns to display the information you wish to export.
  3. Select Export. A CSV file downloads.

 

On this page: