The Polarity CrowdStrike integration searches detections for MD5, SHA256 and MS windows executable filenames (EXE, DLL). The integration searches both IoCs and the triggering process hashes for detections. The integration also searches device information based on SHA256 and MD5 hashes.
Before using the Polarity CrowdStrike Integration you will need to create a Client ID and Client Secret to connect to CrowdStrike with. The following steps will guide you through the process:
- Log onto the CrowdStrike Falcon console.
- Go to
Support > API Client and Keys. - Click
Add New API Client. - A dialog will appear, enter the name of the integration (e.g.
Polarity) and a description (optional). - Polarity will need the following permissions:
| Scope | Permission | Description |
|---|---|---|
| Detections | Read | Required to search detections |
| Hosts | Read, Write | Read access is required to search hosts by IP Address. Write permission is required if the "Allow Containment Status Change" option is checked |
| IOC Manager APIs | Read | Required if the "Search CrowdStrike IOCs" option is enabled |
- Click
Add. Record the Client ID and Client Secret (Client secret will only be shown once for security purpose, so make sure to store it in a secure place).
Use the Client ID and Client Secret that you recorded previously to fill out the integration options. You are now ready to use the Polarity integration with Crowdstrike!
Device lookup is supported by IP on both internal and external IP addresses
IOC lookups are supported for IP, MD5, SHA256 and domain entity types.
Detection lookups are supported for IP, MD5, and SHA256 entity types
The REST API URL for your CrowdStrike instance which should include the schema (i.e., http, https) and port if required. Defaults to https://api.crowdstrike.com.
The Client ID to use to connect to CrowdStrike.
The secret associated with the Client ID. At a minimum, the API key must have 'Read' access to the 'Detections' scope.
The minimum severity level required for Detections or IOCs to be displayed. Defaults to Low.
Detection statuses you would like to return results for. Defaults to True Positive, In Progress and New.
If checked, the integration will search IOCs detected in your environment. IOCs (indicators of compromise) are artifacts that include SHA256, MD5 or domain values. The provided API key must have 'Read' access to the 'IOC Manager APIs' scope for this option to work.
If checked, users will be able to change the Containment Status of Devices via the integration. The provided API key must have 'Read' and 'Write' access to the 'Hosts' scope for this option to work.
Maximum number of concurrent search requests (defaults to 20). Integration must be restarted after changing this option.
Minimum amount of time in milliseconds between each entity search (defaults to 100). Integration must be restarted after changing this option.
Polarity is a memory-augmentation platform that improves and accelerates analyst decision making. For more information about the Polarity platform please see:
