This article describes how to integrate Code42 with Cortex XSOAR (previously Demisto). Cortex XSOAR is a security orchestration, automation, and response (SOAR) solution. Using the Code42 content packs for Cortrex XSOAR, you can view and search Code42 data in Cortex XSOAR, manage employees on watchlists, and accomplish other tasks from Cortex XSOAR.
Depending on your use case, the free Code42 content pack may meet your needs. The Code42 Insider Threat Remediation paid content pack offers additional preset triggers to help streamline certain insider threat incident response processes.
Use the commands included in the free Code42 content pack to:
- Ingest alerts from Code42
- View and manage employees on watchlists
- Search file events and metadata
- Download files from Code42
- Manage Code42 users
- Create users
- Block or unblock users
- Deactivate or reactivate users
- Manage Code42 legal hold custodians
For full information, see the Code42 integration documentation within Cortex XSOAR.
Code42 Insider Threat Remediation
Use the Code42 Insider Threat Remediation paid content pack to to scale, standardize and automate certain insider threat incident response processes based on preset triggers within Cortex XSOAR:
- Search activity and automatically send to the data owner for review
- Automate generating departing employees from ticketing systems
- Automate attaching files from exposure-activity to ticketing systems
- Take actions on employees when activity is reported as suspicious, for example, block the user or add them to legal hold
The Code42 free content pack is required to use this paid content pack.
- To use the Code42 app for Cortex XSOAR, you must enable endpoint monitoring in the Code42 console. (Does not apply to Incydr Professional, Enterprise, and Horizon)
Create a user in Code42
Prepare a user account in your Code42 environment for configuring the Code42 app for Cortex XSOAR. This user account is used to authenticate and access data in your Code42 environment.
- Permissions: The Code42 app for Cortex XSOAR returns data based on the roles assigned to this user. To ensure that the user's rights are not too permissive, create a user with the lowest level of privilege necessary. Assign the roles in our use case for managing a security application integrated with Code42. After assigning roles, you should test to confirm that the user can access the right data.
- Licensing: As a best practice, create a user in your Code42 environment that is exclusively used to configure the Code42 app for Cortex XSOAR.
- Authentication: Your Code42 credentials must rely on local authentication. SSO or authentication through any third-party provider do not work.
Configure the Code42 app for Cortex XSOAR
- Sign in to your Cortex XSOAR environment.
- Select Settings.
- Select Integrations > Servers & Services.
- Search for Code42.
- From the Code42 row, click Add instance to create and configure a new integration instance. In the Code42 window:
- Enter a name for your integration instance.
- Select Fetches incidents.
- Enter the URL of your Code42 environment.
- Enter the credentials for the user you created.
- Select the Incident type to which you'd like to map Code42 alerts.
(Optional) Select the Code42 Security Alert incident type.
- (Optional) Select one or more alert severity levels to limit the Code42 alerts you'd like to ingest.
- Enter the First fetch time range to determine how far back to go to retrieve alerts.
- Enter the number of alerts to fetch and process per run.
- Check Include the list of files in returned incidents to include the file events associated with the alert.
- Select Test to validate the connection.
- Click Done.