> For the complete documentation index, see [llms.txt](https://docs.dropzone.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dropzone.ai/integrations/data/qradar_data.md).

# QRadar

{% hint style="info" %}
QRadar is an SIEM integration. SIEM integrations are used to perform analysis of any SIEM generated alerts, and/or to use generated data as part of investigation analysis.
{% endhint %}

Dropzone AI integrates with the [IBM QRadar](https://www.ibm.com/qradar) security SIEM. Many customers ingest other alert sources into QRadar (e.g. IDPs) and integrate Dropzone into QRadar rather than the source systems.

## Create an API Key

QRadar requires an API key to enable.

To obtain an API Key, do the following:

* In the upper bar in the QRadar Homepage, click "Admin"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2Fo7WGzfFC4Wo5GJr6JMy9%2Fqradar-integration-1.png?alt=media" alt=""><figcaption><p>Navigate to Admin</p></figcaption></figure>

* In the left hand bar, navigate to System Configuration > User Management

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FOdwdlmGmEouzYA8Rf0gA%2Fqradar-integration-2.png?alt=media" alt=""><figcaption><p>Navigate to User Management</p></figcaption></figure>

* Click on "Authorized Services"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2Ftu1GMSbIqf6Nnu6Iz9P3%2Fqradar-integration-3.png?alt=media" alt=""><figcaption><p>Click on "Authorized Services"</p></figcaption></figure>

* In the window that pops up, click "Add"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FBBhm9glosOsHtK1fdcGg%2Fqradar-integration-4.png?alt=media" alt=""><figcaption><p>Click "Add"</p></figcaption></figure>

* Under "Authorized Service Label," label the key something memorable, such as "dropzone\_ai"
* Select an Admin security profile
* Under "User Role, select "All"
* Under "Expiry Settings," assign an expiration date if you choose

{% hint style="info" %}
For conveniences sake, we recommend not assigning an expiration date for this API key, to prevent having to create a new one.
{% endhint %}

* Click "Save"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FBfYGy68iLmtIDzfTyTPM%2Fqradar-integration-5.png?alt=media" alt=""><figcaption><p>Fill out token details</p></figcaption></figure>

* Store the authorized service token in a safe location for use later in the Dropzone UI where it will be called "API-Key"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FMDipO47niTwnCSxuEWgi%2Fqradar-integration-6.png?alt=media" alt=""><figcaption><p>Copy the API-Key</p></figcaption></figure>

## Enable QRadar

To enable the Data Source integration, you will need the following information:

| Dropzone Field | Source                                                                       |
| -------------- | ---------------------------------------------------------------------------- |
| Server         | The same as your servername in your QRadar url, eg *myserver*/console/qradar |
| Port           | The standard html port, 443                                                  |
| API-Key        | The authorized service token value you generated earlier                     |

* Navigate to your Dropzone AI tenant home page e.g. https\://*mycompany*.dropzone.app
* In the left side bar, navigate to Platform Settings > Integrations

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FQKQGU2YK0KqsewZWvh0i%2Fui-integrations-dropdown.png?alt=media" alt=""><figcaption><p>Integrations Dropdown</p></figcaption></figure>

* Click "Library"

{% hint style="info" %}
If you have previously integrated this application, click "Configured"
{% endhint %}

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2Fx4O3FuRG5IqPwx5sFuHr%2Fapp_system_integrations_library.png?alt=media" alt=""><figcaption><p>Click Library</p></figcaption></figure>

* In the Search bar, search QRadar, then click "Configure"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FvSLwzNRI8TDV9xreW6wK%2Fapp_system_integrations_available_qradar.png?alt=media" alt=""><figcaption><p>The QRadar Tile</p></figcaption></figure>

* Under the Data Source header, if your QRadar integration is behind an [On-premise Dropzone Connector](https://docs.dropzone.ai/platform/settings/connector), select your connector from the dropdown
* Input the Server, Port, and API-Key
* Under "Ignored Log Sources," you may add [log sources](https://www.ibm.com/docs/en/dsm?topic=management-introduction-log-source) to ignore in Dropzone searches

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FfZeqhx2uo8wBTDAtQicj%2Fapp_system_integrations_available_qradar_config.png?alt=media" alt=""><figcaption><p>The QRadar Data Configuration (pt 1)</p></figcaption></figure>

* If you wish to help guide the AI's information gathering process, enable the [Query Guidance](https://docs.dropzone.ai/integrations/data) feature. Click "Add Item" and input your Condition and Instruction pairs

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FcYfD24VJsFX1ZjoP5UDb%2Fintegration-query-guidance.png?alt=media" alt=""><figcaption><p>The QRadar Data Configuration (pt 2)</p></figcaption></figure>

* If you wish to customize your query limits (overriding your default [limit controls](https://www.ibm.com/docs/en/qradar-on-cloud?topic=aggregation-flow-capacity-limits), in the QRadar Perfomance/Load Control section, check the box labeled "Enable"
* Input your desired
  * Max Concurrent Queries: the maximum number of queries you want to run at the same time in your QRadar instance
  * Query Wait Seconds: the number of seconds you want the server to wait to complete a search before returning information or a failure
  * Max Lookback Days: the longest length of time you want the AI to query data from
  * Max Result Rows: the maximum number of rows of data returned by any query
  * Max Query Retries: the number of times the AI can retry a query after a timeout or error

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2F3C7dJgeA8lUikThpFrEm%2Fapp_system_integrations_available_qradar_config_1.png?alt=media" alt=""><figcaption><p>The QRadar Data Configuration (pt 3)</p></figcaption></figure>

* Click "Test & Save" to finish

If you have any errors contact our Customer Success team.
