🌙
 

Subscribe to the Taegis™ XDR Documentation RSS Feed at .

Learn more about RSS readers or RSS browser extensions.

Taegis Endpoint Agent for macOS Installation

integrations endpoints edr taegis agent secureworks


Prerequisites

Prior to installation, review requirements and follow prerequisite steps on Taegis™ XDR Endpoint Agent Information and Prerequisites.

Data Provided from Integration

  Alerts Auth DNS File Collection HTTP NIDS Netflow Process File Modification API Call Registry Scriptblock Management Persistence Thread Injection
Taegis macOS Endpoint Agent            

Installation

To install the Taegis Endpoint Agent for macOS using the UI, see UI Deployment.

To install the Taegis Endpoint Agent for macOS using MDMs, see MDM Deployment.

UI Deployment

  1. Open the .pkg file and the Secureworks Agent installer opens.

  2. Select Continue followed by Install and enter your password if prompted.

macOS Agent Install Wizard

macOS Agent Install Wizard

  1. The System Extensions Setup screen displays. Enter the registration key and server name copied during the prerequisite steps in the System Extensions Setup prompt and select Start.

Enter Registration Key & Registration Server

Enter Registration Key & Registration Server

  1. A message informing that background items have been added can be closed if desired.

Dismiss Background Items Message

Dismiss Background Items Message

  1. Two system messages display: System Extension Blocked and SecureworksTaegis Would Like to Filter Network Content. Select OK from System Extension Blocked each time it displays and select Allow from Filter Network Content.

Select OK and Allow

Select OK and Allow

  1. Step 2 of the System Extensions Setup screen displays and System Settings opens to Privacy & Security. Select Details from the message in Privacy & Security settings that reads Some system software requires your attention before it can be used.

Select Details to Enable Extensions

Select Details to Enable Extensions

  1. Enter password if prompted, select to enable the toggles for the three SecureworksTaegis.app items, and select OK.

Enable Extensions

Enable Extensions

Note

Screen Sharing disconnects when enabling the system extensions. If you are accessing your Mac via Screen Sharing during the installation, you may have to reconnect to the Screen Share session.

  1. Step 3 of the System Extensions Setup screen displays and System Settings opens to Full Disk Access. Select to enable the toggle for SecureworksTaegis.

Enable Full Disk Access

Enable Full Disk Access

  1. Choose Later if prompted to quit.

Choose Later

Choose Later

  1. Select to enable the toggles for Secureworks Taegis File Monitor and Secureworks Taegis Policy Mgmt.

Complete Full Disk Access

Complete Full Disk Access

  1. Close System Settings and then select Close from the System Extensions Setup screen.

  2. The Agent Status displays. If the Connection Status shows as Not Connected, select Register and re-enter the registration key and server name copied during the prerequisite steps.

Re-register Agent

Re-register Agent

  1. Close the installer and complete the following Validate Installation steps to ensure a successful installation.

Close Installer

Close Installer

MDM Deployment

Validate Installation

  1. Select the Taegis icon and select Open Secureworks Taegis.

Open Secureworks Taegis

Open Secureworks Taegis

  1. Confirm the following options are GREEN:

Confirm Agent Setup

Confirm Agent Setup

  1. Open Terminal, enter the following command, and verify that the device token file .device.tok is present in the output:
sudo ls -al "/Library/Application Support/secureworks/agent/"

Verify Device Token File

Verify Device Token File

  1. Open Terminal and enter the following command to check launch control to verify services are up and running:
sudo launchctl list | grep secureworks

Verify the following is present in the output:

Verify Services

Verify Services

Review Endpoint Agents Summary

Endpoint Agents Summary

Endpoint Agents Summary

As XDR processes endpoint telemetry, a list of endpoints is generated. Review these by navigating to Endpoint Agents → Summary from the left-hand side navigation in XDR. For more information, see Manage Endpoint Agents.

 

On this page: