Install: TruSTAR for IBM QRadar
This document explains how to install and configure the TruSTAR Workflow App for IBM QRadar.
Related Documents
QRadar Terms
- Event: The log of some particular action on a network device at a point in time. Examples of such actions can include an SSH login on a UNIX server, or a Firewall Deny logged by a perimeter firewall.
- Offense: A collection of related events. For example, an SSH login repeated on the same UNIX server over a short period of time can be defined as an offense.
- Reference Set: Data stored in a simple list format. In the TruSTAR integration, reference sets contain Indicators from TruSTAR. You can use this data in searches, filters, rule test conditions, and rule responses.
Requirements
The TruSTAR Workflow App works with IBM QRadar version 7.2.8 or higher.
Depending on the account permissions you have in QRadar, you can access different features of the TruSTAR App. The Admin account must have the following QRadar privileges:
- TruSTAR Application
- IP Right Click Menu Extension Capabilities
Admin users can configure the TruSTAR Workflow App, manually submit events or offenses, and hunt for information. Non-Admin users cannot alter the TruSTAR App but they can perform all other tasks.
Installation Options
You can either download the TruSTAR Workflow App from the IBM X-Force App Exchange or you can manually install it by downloading the bundle directly from TruSTAR. Manual installation is covered in the FAQ: TruSTAR for IBM QRadar.
Installing the App
To install the TruSTAR Workflow App for QRadar, follow these instructions.
- Navigate to the QRadar Admin tab.
- Click Extension Management.
- Click Add and select the TruSTAR App bundle.
- Click Install Immediately, then click OK to begin the installation.
You now see the TruSTAR Workflow App settings on the QRadar Admin page and GUI buttons for TruSTAR actions you can take.
Configuring the App
Before you begin using the TruSTAR App, you must first configure it using a QRadar Admin account.
Parameter | Required | Description |
QRadar Authorized Service Token | Yes | To retrieve this token:
|
TruSTAR Server URL | Yes | The TruSTAR URL from which data is collected by executing API calls. Set this parameter to https://station.trustar.co |
TruSTAR Access Key | Yes | Used to make API calls. Finding your API Key |
TruSTAR Secret Key | Yes | Used when making API calls. Finding your API Secret |
Enclave IDs for Pull (Hunt) | Yes | The TruSTAR Enclave ID(s) where you want to search for Indicator enrichment. If left blank, it will search all TruSTAR Enclaves you have access to.To specify multiple Enclaves, separate each Enclave ID with a comma and no spaces: Best Practice:
|
Enclave IDs for Submit | Yes | The TruSTAR Enclave IDs to submit events and offenses to.To submit data to multiple Enclaves, separate each Enclave ID with a comma and no spaces: |
Max Events per Offense | Yes | The number of events to process for a single offense. The maximum is 200 Events. |
Offense Exclusion Filter | No | The Offense sources to filter out when submitting Offenses to TruSTAR. To enter multiple values, separate each value with a comma; for example: 10.0.0.1,User Logout |
Event Exclusion Filter | No | The event types to filter out when submitting events to TruSTAR. To enter multiple values, separate each value with a comma; for example: eventA,eventB An event is anything triggered by a rule, for example, an SSH login from a UNIX server or a firewall rule being triggered. You can learn more about QRadar filters here. |
Enable Auto Submission | No | Automatically sends Offenses to TruSTAR. You can set these options:
|
IOC Feed | No | Automatically collects TruSTAR Indicators into QRadar reference sets. You can choose the interval between checks by setting the Poll Interval value. You can learn more about QRadar reference sets here. |
Enable/Disable Proxy | No | If you use a proxy, you must specify the following information:
|
Require Authentication for Proxy | No | If you have a proxy enabled and it requires authentication, then select this checkbox. You must provide a username and password for the proxy server. |
Best Practices
- Create an email account specifically for your QRadar integration (ex: soc_trustar_qradar_integration@customercompany.com).
- Create a user account in the TruSTAR Web App tied to that QRadar integration email address. You will need access to that email account so you can open the account verification email TruSTAR Station will send to it. Your Qradar instance will use this account’s API credentials.
- Check that the TruSTAR URL https://station.trustar.co is not blocked in your firewall or proxy rules.
- Check your TruSTAR API limits.