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
QRadar version: 7.2.8 --> 7.3.2.
QRadar user accounts:
- at least 1x account with "Admin" permissions to install / configure the TruSTAR add-on.
- must have these QRadar privileges:
- TruSTAR Application
- IP Right Click Menu Extension Capabilities
- must have these QRadar privileges:
- Non-Admin accounts for add-on users.
- Can:
- manually submit events / offenses.
- manually hunt.
- Cannot:
- alter TruSTAR add-on settings.
- Can:
Installation Options
2 options:
- from the IBM X-Force App Exchange
- download from FAQ: TruSTAR for IBM QRadar and install manually.
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.