CrowdStrike
LAST UPDATED: 05/29/2024
Overview
CrowdStrike provides endpoint security, threat intelligence, and cyber attack response services. D3’s integration with CrowdStrike covers the major operations that are commonly used including quarantine endpoint, get process, execute command on single endpoint, execute batch command etc.
D3 SOAR is providing REST operations to function with CrowdStrike.
CrowdStrike is available for use in:
Known Limitations
All requests to the CrowdStrike API are subject to a rate limit. By default, the rate limit is 100 requests per second. If you exceed your rate limit, the response to any further request returns an HTTP 429: Too Many Requests error.
Please refer to the CrowdStrike's API documentation for more information.
Connection
To connect to CrowdStrike from D3 SOAR, please follow this part to collect the required information below:
Parameter | Description | Example |
Server URL | The server URL of the CrowdStrike API. | https://api.CrowdStrike.com |
Client ID | The client ID to authenticate the API connection. | acb9eb714b************75b76e66a9 |
Client Secret | The client secret to authenticate the API connection. | m132NkPjVva************I6sJ7UFC8LwGQdSetf |
API Version | The API version to use for the connection. | v1 |
Permission Requirements
Each endpoint in the CrowdStrike API requires a certain permission scope. The following are required scopes for the commands in this integration:
Command | Required Permission |
Apply Action By Quarantine File IDs | Write: Quarantined Files |
Apply Action By Query | Write: Quarantined Files |
Schedule Scan | Read Only: On-demand scans (ODS) + Write: On-demand scans (ODS) |
Delete IOCs | Write: IOC Manager APIs |
Download Files | Read only: Real time response |
Fetch Event | Read only: Detections + Incidents + Alerts |
Execute Batch Command | Read only: Real time response + Write: Real time response (admin) + Real time response |
Find Hosts | Read only: Hosts |
Find IOC IDs | Read only: IOC manager APIs |
Find IOC Observed Hosts | Read only: IOCs (Indicators of Compromise) + Hosts |
Find Process | Read only: IOCs (Indicators of Compromise) |
Get Behaviors For Incidents | Read: Incidents |
Get Detections For Incidents | Read Only: Detections + Incidents |
Get Endpoint Info by ID | Read only: IOC manager APIs |
Get Endpoint Info by IP | Read only: Hosts |
Get Host Vulnerabilities | Read only: Spotlight-vulnerabilities + Hosts |
Get IOCs | Read only: Hosts |
Get Process Detail | Read only: IOCs (Indicators of Compromise) |
Get Process Detail by IOC | Read only: IOCs (Indicators of Compromise) |
Get Scan Results | Read Only: On-demand scans (ODS) + Write: On-demand scans (ODS) |
Get Vulnerability Details | Read only: Spotlight-vulnerabilities |
Get Vulnerability Evaluation logics | Read only: Spotlight-vulnerabilities |
Isolate Host | Write: Hosts |
List Host Group Members | Read only: Hosts |
Find Host Groups | Find Host Groups |
List Quarantine Files | Read: Quarantined Files |
List RealTime Response Script | Write: Real time response (admin) |
List Scans | Read Only: On-demand scans (ODS) |
List Scheduled Scans | Read Only: On-demand scans (ODS) |
Search Users | Read only: Users |
List Vulnerabilities | Read only: Spotlight-vulnerabilities |
Quarantine Host by ID | Write: Hosts |
Quarantine Host by IP | Write: Hosts |
Refresh Session | Read only: Real time response |
Batch Refresh Session | Read only: Real time response |
Update Detections | Write: Detections |
Scan Hosts Adhoc | Read Only: On-demand scans (ODS) + Write: On-demand scans (ODS) |
Search Alerts | Read Only: Alerts |
Search Vulnerable Hosts By CVE | Read only: Spotlight-vulnerabilities |
Unquarantine Endpoint by ID | Write: Hosts |
Unquarantine Endpoint by IP | Write: Hosts |
Update Alerts | Read Only +Write: Alerts |
Update Incidents | Write: Incidents |
Update IOCs | Write: IOC manager APIs |
Upload IOCs | Write: IOC Manager APIs |
Upload Real Time Response Script | Write: Real time response (admin) |
Test Connection | Read only: Any API Scope |
As CrowdStrike is using role-based access control (RBAC), the API access token is generated based on a specific user account and the application. Therefore, the command permissions are inherited from the user account’s role. Users need to configure their user profile from the CrowdStrike console for each command in this integration.
Reader Note
Please refer to Users and Roles for details on configuring user profiles. You can also use the shortcut Ctrl + K (Windows) or Cmd + K (macOS) to bring up the search bar to find and access the Roles and permissions page.
Configuring CrowdStrike to Work with D3 SOAR
Log in to the CrowStrike portal (https://falcon.CrowdStrike.com/login/).
Use the shortcut Ctrl + K (Windows) or Cmd + K (macOS) to bring up the search bar. Use it to find and select API clients and keys.
On the API clients and keys page, click Add new API Client.
The Add new API client will appear. Input a Client Name and a description (optional). Select the scopes for the API client according to your use case. Click Add.
Reader Note
See Permission Requirements for more information on API scopes.
The API client created window will appear with a Client ID and Secret.
Reader Note
This is the only time you can view the Secret Key. Store it in a secure location for future reference.
(Optional) You can edit the permission scopes for the created API client by clicking the Edit icon under the Action column of the API client. An Edit API client window will appear for you to edit the permission scopes. Click Save to complete editing.
(Optional) You can reset the Secret Key by clicking the Reset Secret icon under the Action column of the API client. A Reset the secret window will appear asking you to confirm. Click Reset.
Configuring D3 SOAR to Work with CrowdStrike
Log in to D3 SOAR.
Find the CrowdStrike integration.
Navigate to Configuration on the top header menu.
Click on the Integration icon on the left sidebar.
Type CrowdStrike in the search box to find the integration, then click it to select it.
Click + New Connection, on the right side of the Connections section. A new connection window will appear.
Configure the following fields to create a connection to CrowdStrike.
Connection Name: The desired name for the connection.
Site: Specifies the site to use the integration connection. Use the drop-down menu to select the site. The Share to Internal Sites option enables all sites defined as internal sites to use the connection. Selecting a specific site will only enable that site to use the connection.
Recipient site for events from connections Shared to Internal Sites: This field appears if you selected Share to Internal Sites for Site to let you select the internal site to deploy the integration connection.
Agent Name (Optional): Specifies the proxy agent required to build the connection. Use the dropdown menu to select the proxy agent from a list of previously configured proxy agents.
Description (Optional): Add your desired description for the connection.
Configure User Permissions: Defines which users have access to the connection.
Active: Check the tick box to ensure the connection is available for use.
System: This section contains the parameters defined specifically for the integration. These parameters must be configured to create the integration connection.
1. Input the domain level Server URL. The default value is https://api.CrowdStrike.com.
2. Copy and input the Client ID from the CrowdStrike platform (refer to step 5 of Configuring CrowdStrike to Work with D3 SOAR).
3. Copy and input the Client Secret from the CrowdStrike platform (refer to step 5 of Configuring CrowdStrike to Work with D3 SOAR).
4. The default value of the API Version is v1. You can use the default value when creating connections. Please note that commands Get Vulnerability Details, Isolate Host, Quarantine Host by ID, Update Detection and Unquaratine Host by ID require API Version v2. Commands not in this list only accept API Version v1. Please change the value if you need to use hese commands.Enable Password Vault: An optional feature that allows users to take the stored credentials from their own password vault. Please refer to the password vault connection guide if needed.
Test the connection.
Click Test Connection to verify the account credentials and network connection. If the Test Connection Passed alert window appears, the test connection is successful. You will see Passed with a green checkmark appear beside the Test Connection button. If the test connection fails, please check your connection parameters and try again.
Click OK to close the alert window.
Click + Add to create and add the configured connection.
Configuring D3 Webhook with CrowdStrike
D3 SOAR Webhook Configuration
The example below demonstrates the process of creating a new Webhook in D3 SOAR and CrowdStrike
Log in to your D3 SOAR environment.
Navigate to Configuration.
Navigate to Integration > Search for “CrowdStrike”. Click “Fetch Event”.
Click Set up Webhook Keys. Check the Enable Webhook option to allow commands to be run from outside of D3.
Under Event Ingestion, Click +. Select the site for the webhook integration, then click Generate.
Reader Note
If you select Shared to All Internal Sites, D3 will ask you to select a more specific site when generating the Request URL, since a specific site destination is needed when generating links. Use the drop-down to select your desired site.
Copy the Request URL, Request Header Key and Value for configuring CrowdStrike in later steps.
CrowdStrike Configuration
Log in to the CrowdStrike environment.
Use the shortcut Ctrl + K (Windows) or Cmd + K (macOS) to bring up the search bar. Use it to find and select All apps.
You will be taken to the CrowdStrike Store. Under Plugins, click Webhook. You can also use the keyboard shortcut Ctrl + F (Windows) or Cmd + F (macOS) to quickly find “Webhook”.
Click Configure.
Input the required fields for the webhook configuration. Click Save Configuration and Close.
Commands
CrowdStrike includes the following executable commands for users to set up schedules or create playbook workflows. With the Test Command, you can execute these commands independently for playbook troubleshooting.
Integration API Note
For more information about the CrowdStrike API, please refer to the CrowdStrike API reference.
Reader Note
Certain permissions are required for each command. Please refer to the Permission Requirements and Configuring CrowdStrike to Work with D3 SOAR for details.
Note for Time-related parameters
The input format of time-related parameters may vary based on your account settings. As a result, the sample data provided in our commands is different from what you see. To set your preferred time format, follow these steps:
Navigate to Configuration > Application Settings. Select Date/Time Format.
Choose your desired date and time format.
After that, you will be able to view your preferred time format when configuring the DateTime input parameters for commands.
Apply Action By Quarantine File IDs
Applies the specified action on quarantine File(s) by file ID(s).
Reader Note
The parameter File IDs is required to run this command.
Run the List Quarantine Files command to obtain File IDs. File IDs can be found in the raw data at the path $.resources[*].id.
Input
Input Parameter | Required/Optional | Description | Example |
File IDs | Required | The quarantined file ID(s) to apply an action. The max file IDs count is 20. File IDs can be obtained using the List Quarantine Files command. | [ "6d0********aa7" ] |
Action | Required | The action to perform against the quarantined file(s). | Release |
Comment | Optional | The comment to list along with action taken. | good file |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Apply Action By Quarantine File IDs failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 400. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: Validation error. Failed to apply action by quarantine file IDs. |
Error Sample Data Apply Action By Quarantine File IDs failed. Status Code: 400. Error Message: Validation error. Failed to apply action by quarantine file IDs. |
Apply Action By Query
Applies the specified action on quarantine file(s) by query criteria. It is necessary to enter either Filter or SHA256s parameters, or both.
Input
Input Parameter | Required/Optional | Description | Example |
Filter | Optional | The FQL query specifying filter parameters. Special value '*' means to not filter on anything. Filter term criteria include: status, adversary_id, device.device_id, device.country, device.hostname, behaviors.behavior_id, behaviors.ioc_type, behaviors.ioc_value, behaviors.username, behaviors.tree_root_hash. Filter range criteria:, max_severity, max_confidence, first_behavior, last_behavior. For more information about the query syntax, please refer to Falcon Query Language (FQL). Please do NOT enter SHA256 into this parameter, and it is possible to use SHA256s parameter to filter for SHA256 hash values. | hostname:'L***-P**'+state:'unreleased' |
SHA256s | Optional | The SHA256 hash value(s) of the quarantined file(s) to apply action. | [ "115********aa7" ] |
Action | Required | The action to perform against the quarantined file(s). | Release |
Comment | Optional | The comment to list along with action taken. | Comment for the Action |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Apply Action By Query failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 400. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: Failed to apply action by query. |
Error Sample Data Apply Action By Query failed. Status Code: 400. Error Message: Failed to apply action by query. |
Schedule Scan
Schedules a scan for specified host groups. Scheduled scans are only available for host groups, and are not supported for individual hosts.
Reader Note
Input parameter Host Group IDs is required to run this command.
Run the Find Host Groups command to obtain Host Group IDs. Host Group IDs can be found in the raw data at the path $.resources[*].id.
Input
Input Parameter | Required/Optional | Description | Example |
Host Group IDs | Required | The IDs of the host groups so schedule a scan. Host Group IDs can be obtained using the Find Host Groups command. | [ "***" ] |
File Paths | Required | The file paths to scan. | [ "C:\\***" ] |
Scan Exclusions | Optional | The file paths to exclude from the scan. | [ "\\***\\***\\*" ] |
Max Duration | Optional | The maximum scan duration in hours. If this parameter is not defined, the scan duration is allowed to be indefinite. | 2 |
Pause Duration | Optional | The maximum pause duration in hours. If this parameter is not defined, the default pause duration is 2 hours. | 2 |
Description | Optional | The description for the scan. | test ODS Schedule scan Host0223b |
Quarantine | Required | The option to quarantine malicious files if they are found in the scan. | False |
CPU Priority | Optional | The allowed CPU utilization percentage for the scan. The default value is Up to 25% CPU utilization. | Up to 1% CPU utilization |
Machine Learning Detection Level | Optional | The detection level of cloud and sensor machine learning to employ. Note: The detection level must be at least as high as the prevention level. For example, if the detection level is set to Moderate, then the prevention level must be set to Moderate, Aggressive or Extra Aggressive. If this parameter is not defined, the default detection level is Moderate. | Cautious |
Machine Learning Prevention Level | Optional | The prevention level of cloud and sensor machine learning to employ. Note: The detection level must be at least as high as the prevention level. For example, if the detection level is set to Moderate, then the prevention level cannot be set to Aggressive or Extra Aggressive; it must be set to Moderate, Cautious or Disabled. If this parameter is not defined, the default prevention level is Moderate. | Cautious |
Max File Size | Optional | The maximum file size to scan in megabytes (MB). If this parameter is not defined, the default value is 60MB. The allowed maximum value is 60 MB. | 20 |
Scheduled Scan Start Time | Required | The start time of the scheduled scan. The scan will be set to run at the designated time, adjusted to the time zone of each individual host. | 2023-04-19 00:00 |
Scheduled Scan Interval | Optional | The frequency of the scheduled scan in days. For a one-time scan, set the value to 0. If this parameter is not defined, the scan will only run once. | 3 |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Schedule Scan failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: Host Group IDs not found. |
Error Sample Data Schedule Scan failed. Status Code: 404, Error Message: Host Group IDs not found. |
Delete IOCs
Permanently deletes the specified indicator(s) of compromise.
Reader Note
Input parameter IDs is required to run this command.
Run the Find IOC IDs command to obtain IDs. IOC IDs can be found in the raw data at the path $.resources.
Input
Input Parameter | Required/Optional | Description | Example |
IDs | Required | The IDs of the indicators of compromise (IOCs) to delete. IDs can be obtained using the Find IOC IDs command. | ["***", "***"] |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Delete IOCs failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: No resource found with ID 5ec6****4a69****284b. |
Error Sample Data Delete IOCs failed. Status Code: 404, Error Message: 'No resource found with ID 5ec6****4a69****284b. |
Download Files
Retrieves files from a specific host ID and file paths. The files are compressed as a 7z file and with the unzip password set as "infected."
Reader Note
Host IDs and File Paths are required parameters to run this command.
Run the Find Hosts command to obtain Host ID. Host IDs can be found in the raw data at the path $.resources.
Please note that both the input Host ID and File Paths must match. If you don't have a matching pair of values to input, you can use the Fetch Event command to obtain the necessary pair of values.
Input
Input Parameter | Required/Optional | Description | Example |
Host ID | Required | The ID of the host to retrieve files. Host IDs can be obtained using the Find Hosts command. | |
File Paths | Required | The file path to download files. | ["c:\\***\\***.***"] |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Download Files failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: host not found. |
Error Sample Data Download Files failed. Status Code: 404, Error Message: host not found. |
Fetch Event
Returns event(s) from the platform based on specified criteria. Please refer to Falcon Query Language (FQL) for more information about the search syntax.
Reader Note
Key differences between the Search Condition and Filter input parameters:
Search Condition is used to search for keywords across all metadata fields. It can only be used for detection-type events. Any event containing the search keyword in any field will be returned. No “AND” operators are valid for inputs in this parameter. Any input operator will be treated as an “OR” operator for the search condition. For example, the input value AA-BBB-123456 will result in searching for the keywords “AA” or “BBB” or “123456”.
A space operator is suggested rather than other operators to separate different search conditions. Therefore, the above example AA-BBB-123456 is suggested to input as AA BBB 123456.
The dot (.) operator will not be ignored like operators. For example, external_ip (1.1.1.1) and local_ip (2.2.2.2) can be searched with the "." value.
Filter allows you to define the search query. It can be used for both detection-type and incident-type events. Refer to Falcon Query Language (FQL) from Crowstrike’s documentation for more information about the syntax.
The basic syntax is: property_name:<operator>‘<value>’. The <operator> is optional to input.
For example, to search the hostname AA-BBB-123456 that does not have a local IP of 1.1.1.1, the filter expression would be device.hostname:‘AA-BBB-123456’+device.local_ip:!‘1.1.1.1’.
More complex expressions can be created by surrounding the expression with rounded brackets.
For example, to search for events with the host name AA-BBB-123456 and without a local IP of 1.1.1.1, or with a behavior_id of 1234, the filter expression would be (device.hostname:‘AA-BBB-123456’+ device.local_ip:!‘1.1.1.1’),behaviors.behavior_id:‘1234’
The following are commonly used operators and their associated meanings:
+ = and
, = or
! = not equal to
Input
Input Parameter | Required/Optional | Description | Example |
Start Time | Optional | The start time of the time range to fetch events in UTC time format, based on the specified query time type. | 2022-10-01 00:00 |
End Time | Optional | The end time of the time range to fetch events in UTC time format, based on the specified query time type. | 2022-10-06 00:00 |
Event Type | Optional | The types of events to retrieve. The available event types are Detection, Incident and Alert. If no event type is specified, the default value is Detection. | Incident |
Query Time Type | Optional | The time field to filter retrieved events, based on the selected value for the Event Type parameter. If the event type is Detection, the options available are First Behaviour Time, Last Behaviour Time, and Updated Time. If no option is specified, the default time field used for Detection is Last Behaviour Time. If the event type is Incident, the options available are Start Time Updated Time and Last Activity Time. If no option is specified, the default time field used for Incident is Last Activity Time. If the event type is Alert, the options available are Created Time, and Updated Time. If no option is specified, the default time field used for Alert is Updated Time. | First Behavior Time |
Number of Event(s) Fetched | Optional | The maximum number of the most recent events to fetch. The valid input value is an integer between 1 and 500. If the input value is not within the valid range or not specified, all events that match the search conditions will be returned. | 10 |
Search Condition | Optional | The condition to perform a full text search across all metadata fields. This parameter is valid when the selected event type is Detection. | T1059.001 |
Filter | Optional | The query to filter results. For more information about the query syntax, please see Falcon Query Language (FQL). This filter is applicable for all the event types: Detection, Incident and Alert. To search for alerts from a specific product (e.g. epp, idp, ods, mobile), use product:'product' as a filter. For example, this filter "product:'epp' + status:['new']" will return all alerts from product endpoint protection with the ‘New’ status. | assigned_to_name:'Admin'+status:'20' |
Tolerance Scope | Optional | The tolerance scope (in minutes) for the query to fetch events between the specified start and end time to avoid event loss or fetch failure. The events will be fetched between {Start Time - Tolerance Scope, End Time}. | 5 |
Output
Fetch Event Field Mapping
Please note that Fetch Event commands require event field mapping. Field mapping plays a key role in the data normalization process part of the event pipeline. Field mapping converts the original data fields from the different providers to the D3 fields which are standardized by the D3 Model. Please refer to Event and Incident Intake Field Mapping for details.
If you require a custom field mapping, click + Add Field to add a custom field mapping. You may also remove built-in field mappings by clicking x. Please note that two underscore characters will automatically prefix the defined Field Name as the System Name for a custom field mapping. Additionally, if an input Field Name contains any spaces, they will automatically be replaced with underscores for the corresponding System Name.
The CrowdStrike integration in D3 SOAR has some pre-configured field mappings for the Detection-related events, Incident-related events and Alert-related events, which correspond to the Default Event Source, Event Mapping for Incidents and Event Mapping for Alerts mappings:
Default Event Source
Configures the field mapping which are specific to the Detection-related events. If a source field in the field mapping is not found, the corresponding field mapping will be ignored. The default event source has a “Main Event JSON Path” (i.e. $.resources) that is used to extract a batch of events from the response raw data. Click Edit Event Source to view the “Main Event JSON Path”.Main Event JSON Path: $.resources
The Main Event JSON Path determines the root path where the system starts parsing raw response data into D3 event data. The JSON path begins with $, representing the root element. The path is formed by appending a sequence of child elements to $, each separated by a dot (.). Square brackets with nested quotation marks ([‘...’]) should be used to separate child elements in JSON arrays.For example, the root node of a JSON Path is resources. The child node denoting the Event Time field would be created_timestamp. Putting it together, the JSON Path expression to extract the Event Time is $.resources.created_timestamp.
Event Source for Incidents
Configures the additional field mapping for the fields which are specific to events categorized as Incidents-related. In the response raw data, the event source Search String will be {eventType}=incident. Click Edit Event Source to view the Search String.
Note: The Event Source for Incidents field mapping will be applied in addition to the Default Event Source field mapping for Incidents-related events.
Event Source for Alerts
Configures the additional field mapping for the fields which are specific to events categorized as alert-related. In the response raw data, the event source Search String will be {eventType}=alert. Click Edit Event Source to view the Search String.
Note: The Event Source for alerts field mapping will be applied in addition to the Default Event Source field mapping for Alerts-related events.
The pre-configured field mappings are detailed below:
Field Name | Source Field |
Default Event Source (Main Event JSON Path: $.resource) | |
Event Time | .created_timestamp |
Hostname | .device.hostname |
Destination IP address | .device.external_ip |
Source IP address | .device.local_ip |
Filename | .behaviors[*].filename |
Tactics | .behaviors[*].tactic |
Tactic ID | .behaviors[*].tactic_id |
Techniques | .behaviors[*].technique |
Technique ID | .behaviors[*].technique_id |
IOC Type | .behaviors[*].ioc_type |
IOC Value | .behaviors[*].ioc_value |
IOC Source | .behaviors[*].ioc_source |
Username | .behaviors[*].user_name |
User ID | .behaviors[*].user_id |
Severity Score | .behaviors[*].severity |
SHA256 | .behaviors[*].sha256 |
MD5 | .behaviors[*].md5 |
Severity | .max_severity_displayname |
Process ID | .behaviors_processed |
Status | .status |
UTCEventTime | .created_timestamp |
UpdateTime | .date_updated |
Start Time | .first_behavior |
Last Behavior Time | .last_behavior |
Device ID | .device.device_id |
Filepath | .behaviors[*].filepath |
Sub Event | .behaviors |
Event Type | .behaviorType |
Webhook URL | .webhookURL |
Webhook Extrainfo | .webhookExtraInfo |
Description | .description |
Document ID | .detection_id |
Process command line | .behaviors[*].cmdline |
Process command line | .behaviors[*].cmdline |
Parent process ID | .behaviors[*].parent_details.parent_process_graph_id |
Parent Process Commandline | .behaviors[*].parent_details.parent_cmdline |
Parent Process Hash SHA256 | .behaviors[*].parent_details.parent_sha256 |
Parent Process Hash MD5 | .behaviors[*].parent_details.parent_md5 |
Event Source for Incidents (Search String: {eventType}="incident") The search string format is {jsonpath}=value. If the value of the eventType key is incident in the event object under raw data, then the incident-related events will use the field mapping below. | |
Event code | .incident_id |
Tactics | .tactics |
Techniques | .techniques |
Incident Name | .name |
Description | .description |
Status | .status |
Fine Score | .fine_score |
State | .state |
Incident Type | .incident_type |
Tag | .tags |
Username | .users |
Event Time | .created |
Hostname | .hosts[*].hostname |
Destination IP address | .hosts[*].external_ip |
UpdateTime | .modified_timestamp |
Start Time | .start |
Last Behavior Time | .end |
Device ID | .host[*].device_id |
Objectives | .host[*].objectives |
Detection IDs | .detections[*].detection_id |
Filename | .detections[*].behaviors[*].filename |
Filepath | .detections[*].behaviors[*].filepath |
SHA256 | .detections[*].behaviors[*].sha256 |
MD5 | .detections[*].behaviors[*].md5 |
Sub Event | .detections |
Webhook URL | .webhookURL |
Webhook Extrainfo | .webhookExtraInfo |
Event Source for Alerts (Search String: {eventType}="alert") The search string format is {jsonpath}=value. If the value of the eventType key is alert in the event object under raw data, then the alert-related events will use the field mapping below. | |
Accessed File Names | .files_accessed[*].filename |
Accessed File Paths | .files_accessed[*].filepath |
Activity ID | .activity_id |
Confidence | .confidence |
Data Domains | .data_domains |
Device Groups | .device.groups |
Device Last Seen Time | .device.last_seen |
Device Public IP Address | .device.external_ip |
Event Internal Name | .name |
Falcon Host Link | .falcon_host_link |
File Access Timestamps | .files_accessed[*].timestamp |
Grandparent Local Process ID | .grandparent_details.local_process_id |
Grandparent Process CommandLine | .grandparent_details.cmdline |
Grandparent Process File Hash MD5 | .grandparent_details.md5 |
Grandparent Process File Hash SH256 | .grandparent_details.sha256 |
Grandparent Process File Path | .grandparent_details.filepath |
Grandparent Process ID | .grandparent_details.process_id |
Grandparent Process Name | .grandparent_details.filename |
Grandparent Process Time | .grandparent_details.timestamp |
Grandparent Process User | .grandparent_details.user_name |
Incident End Time | .incident.end |
Incident ID | .incident.id |
Incident Score | .incident.score |
Incident Start Time | .incident.start |
Last Behavior Time | .end_time |
Location Country Code | .location_country_code |
Location Latitude | .location_latitude |
Location Longitude | .location_longitude |
Objective | .objective |
Parent Local Process ID | .parent_details.local_process_id |
Parent Process File Hash MD5 | .parent_details.md5 |
Parent Process File Hash SH256 | .parent_details.sha256 |
Parent Process Time | .parent_details.timestamp |
Parent Process User | .parent_details.user_name |
Pattern Disposition Description | .pattern_disposition_description |
Pattern ID | .pattern_id |
Platform | .platform |
Process End Time | .process_end_time |
Process Start Time | .process_start_time |
Product | .product |
Scenario | .scenario |
Source Account Azure ID | .source_account_azure_id |
Source Account Domain | .source_account_domain |
Source Account ID | .source_account_object_sid |
Source Account Okta ID | .source_account_okta_id |
SSO Application URI | .sso_application_uri |
Tactic ID | .tactic_id |
Technique ID | .technique_id |
UpdateTime | .updated_timestamp |
User Principal Name | .user_principal |
UTCEventTime | .timestamp |
Webhook Extrainfo | .webhookExtraInfo |
Webhook URL | .webhookURL |
Device IP address | .device.local_ip |
Device MAC address | .device.mac_address |
Device product name | .device.system_product_name |
Event code | .id |
Event name | .display_name |
Event Type | .type |
File Hash MD5 | .md5 |
File Hash SHA1 | .sha1 |
File Hash SHA256 | .sha256 |
Filename | .filename |
Filepath | .filepath |
Start Time | .timestamp |
Operating system | .device.os_version |
Parent process commandline | .parent_details.cmdline |
Parent process image path | .parent_details.filepath |
Parent process ID | .parent_details.process_id |
Parent process name | .parent_details.filename |
Process command line | .cmdline |
Process ID | .local_process_id |
Severity | .severity_name |
Source Device | .source_endpoint_host_name |
Source Device IP address | .source_endpoint_ip_address |
Source Product | .source_products |
Source username | .source_account_name |
Tactics | .tactic |
Techniques | .technique |
Username | .user_name |
READER NOTE
The Unique Event Key field mapping is used to prevent duplicate event ingestions. D3 SOAR checks whether the value of a selected JSON path matches any Unique Event Key of previously ingested events. If a match is found, the event will be dismissed. If no match is found, an event will be created. However, if no Unique Event Key is mapped, the hash value from the event pending ingestion will be used to check for any matches with existing events. If no match is found, the event will be created.
Unlike most other D3 SOAR integrations, the CrowdStrike integration’s Fetch Event command’s Default Event Source mapping does not include a Unique Event Key to fetch the same target (i.e. Detection, Incident and Alert) with multiple updates.
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Fetch Event failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 400. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: Invalid filter expression supplied. |
Error Sample Data Find Hosts failed. Status Code: 400. Error Message: Invalid filter expression supplied. |
Execute Batch Command
Batch executes RealTime Response administrator commands, with the queue offline feature enabled across all the hosts.
Reader Note
The parameter Host IDs is required to run this command.
Run the Find Hosts command to obtain Host ID. Host IDs can be found in the raw data, at the path $.resources.
Input
Input Parameter | Required/Optional | Description | Example |
Endpoint IDs | Required | The IDs of the endpoints to batch execute commands. You can obtain Endpoint IDs using the Find Hosts command. | [ "***", "***"] |
Command Strings | Required | The commands to batch execute on the specified hosts. Each line contains a base command. The supported base commands are: cat, cd, clear, cp, encrypt, env, eventlog, filehash, get, getsid, help, history, ipconfig, kill, ls, map, memdump, mkdir, mount, mv, netstat, ps, put, reg query, reg set, reg delete, reg load, reg unload, restart, rm, run, runscript, shutdown, unmap, update history, update install, update list, update query, xmemdump, and zip. | mkdir c:\\*** |
Duration Minutes | Optional | The duration of the command run time until completion, measured in minutes. Default is 10 minutes. | 60 |
Refresh Session | Optional | The option to refresh the session when set to True. Default is False. | False |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Execute Batch Command failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error message: resource not found. |
Error Sample Data Execute Batch Command failed. Status Code: 404, Error Message: resource not found. |
Find Hosts
Retrieves host information according to the specified field name and value.
Reader Note
If no parameter has been filled, all the hosts that can be retrieved will be returned.
Value is an optional parameter to run this command.
You should already have your desired value on hand to run this command. If you don’t, you may use the Fetch Event command with defined filters to retrieve the desired value. The value can be found in the raw data.
Please note that the input Field Name and Value must match. Otherwise, the command will run successfully with no returned results.
The screenshot below provides examples of some field names and values by running the Fetch Event command:
Input
Input Parameter | Required/Optional | Description | Example |
Field Name | Optional | The name of the field (e.g. local_ip or hostname) to retrieve. The hostname is not case-sensitive. For the available field names, see https://falcon.CrowdStrike.com/documentation/84/host-and-host-group-management-apis#Appendix-A-Device-filters. | local_ip |
Values | Optional | The list of values corresponds to the specified field name. This parameter will be omitted when the Field Name parameter is not defined. | [ "1.1.1.1.10", "2.2.2.2.104" ] |
Limit | Optional | The maximum number of records to return. The parameter need to be in range [1-5000]. The default value is 100. | 101 |
Offset | Optional | The zero-based position of the first record to return. The default value is 0. | 0 |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Find Hosts failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 400. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: Invalid filter expression supplied. |
Error Sample Data Find Hosts failed. Status Code: 400, Error Message: Invalid filter expression supplied. |
Find IOC IDs
Finds the IDs of the specified indicator entities.
Reader Note
At least one of the parameters needs to be filled, otherwise, errors will be returned.
Value is an optional parameter to run this command.
Ensure that the input value is already present in the CrowdStrike system. Random values are not supported.
You should already have your desired value on hand to run this command. If you don’t, you may use the Fetch Event command with defined filters to retrieve the desired value. The value can be found in the raw data.
Please note that in order to get IOC IDs, if you choose to input all parameters, please make sure the Type, Action and Severity you input match the value. Otherwise, you will receive success with no result.
Please note that if your search inputs do not exist, you will receive success with no result.
Input
Input Parameter | Required/Optional | Description | Example |
Type | Optional | The indicator type of the entity. | SHA256 |
Value | Optional | The string value of the IOCs. | abc.com |
Action | Optional | The action to take when a host observes the custom IOC. The following are accepted inputs:
| Detect |
Severity | Optional | The severity level to apply to this indicator. This field is required when the selected action is Prevent or Detect. It is optional for No Action. | High |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Find IOC IDs failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 401. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: Access denied, invalid bearer token. |
Error Sample Data Find IOC IDs failed. Status Code: 401, Error Message: Access denied, invalid bearer token. |
Find IOC Observed Hosts
Finds hosts associated with observed custom IOC(s) in CrowdStrike.
Reader Note
IOCs and IOC type are required parameters to run this command.
You should already have your desired IOC and IOC type on hand to run this command. If you don’t, you may use the Fetch Event command with defined filters to retrieve the desired IOC and IOC type. The values can be found in the raw data.
Please note that both the input IOC and IOC Type must match. Otherwise, the command will run successfully with no returned results.
The screenshot below provides examples of some IOCs and IOC Types:
Input
Input Parameter | Required/Optional | Description | Example |
IOCs | Required | The value of the IOC to search. | [ "***" ] |
IOC Type | Required | The IOC type to search. The available IOC types are SHA256, SHA1, MD5, Domain, IPV4, IPV6 and Ignored. | SHA256 |
Output
Error Handling
If the Return Data is Partially Successful or Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Find IOC Observed Host failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: Resource not found. |
Error Sample Data Find IOC Observed Host failed. Status Code: 404, Error Message: Resource not found. |
Find Process
Queries processes and returns info associated with the specified IOC on a host.
Reader Note
IOC, IOC Type, and Host ID are required parameters to run this command.
You should already have your desired IOC and IOC Type on hand to run this command. If you don’t, you may use the Fetch Event command with defined filters to retrieve the desired IOC and IOC Type. The values can be found in the raw data.
Run the Find Hosts command to obtain Host ID. Host IDs can be found in the raw data at the path $.resources.
Please note that the input IOC, IOC Type and Host ID must match. Otherwise, the command will run successfully with no returned results.
If the input IOC does not have a process, the error message "404 resource not found" will return.
Here is an example of obtaining IOCs, IOC Types=Sha256 and Host ID:
Input
Input Parameter | Required/Optional | Description | Example |
IOC | Required | The value of the IOC to search. | *** |
IOC Type | Required | The IOC type to search. The available IOC types are SHA256, MD5, Domain, IPV4, and IPV6. | SHA256 |
Endpoint ID | Required | The ID of the endpoint to search processes from. Endpoint IDs can be obtained using the Find Hosts command. | *** |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Find Process failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: Resource not found. |
Error Sample Data Find Process failed. Status Code: 404, Error Message: Resource not found. |
Get Behaviors For Incidents
Retrieves behavioral information from the specified incident(s) in CrowdStrike.
READER NOTE
The parameter Incident IDs is required to run this command.
You should already have your desired Incident IDs on hand to run this command. If you don’t, you may use the Fetch Event command with defined filters to retrieve the desired Incident IDs. The Incident IDs can be found in the raw data at the path $.resources[*].incident_id.
Input
Input Parameter | Required/Optional | Description | Example |
Incident IDs | Required | The ID(s) of the incident(s) to retrieve detection information. | ["inc:4fc3********7e4", "inc:f00********524"] |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Get Behaviors For Incidents failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 400. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: Request failed when getting behaviours detail. |
Error Sample Data Get Behaviors For Incidents failed. Status Code: 400. Error Message: Request failed when getting behaviours detail. |
Get Detections For Incidents
Retrieves detection information from the specified incident(s) in CrowdStrike.
Reader Note
The parameter Incident IDs is required to run this command.
You should already have your desired Incident IDs on hand to run this command. If you don’t, you may use the Fetch Event command with defined filters to retrieve the desired Incident IDs. The Incident IDs can be found in the raw data at the path $.resources[*].incident_id.
Input
Input Parameter | Required/Optional | Description | Example |
Incident IDs | Required | The ID(s) of the incident(s) to retrieve detection information. | ["inc:***:***", "inc:***:***"] |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Get Detections For Incidents failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404 |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Message: Incident ID Not Found. |
Error Sample Data Get Detections For Incidents failed. Status Code: 404. Message: Incident ID Not Found. |
Get Endpoint Info by ID
Returns endpoint details of the given endpoint ID in CrowdStrike. Note: CrowdStrike is planning to deprecate version 1 of the API on or after February 9, 2023. It is recommended to use API version 2 to run this command.
Reader Note
The parameter Endpoint IDs is required to run this command.
Run the Find Hosts command to obtain Endpoint IDs. Endpoint IDs can be found in the raw data at the path $.resources.
Input
Input Parameter | Required/Optional | Description | Example |
Endpoint IDs | Required | The IDs of the endpoints to retrieve details. Endpoint IDs can be obtained using the Find Hosts command. | [ “***” ] |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Get Endpoint Info by ID failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: No matching host found for ID a58****4789****615 |
Error Sample Data Get Endpoint Info by ID failed. Status Code: 404, Error Message: No matching host found for ID a58****4789****615. |
Get Endpoint Info by IP
Returns endpoint details of the given endpoint IP in CrowdStrike. Note: CrowdStrike is planning to deprecate version 1 of the API on or after February 9, 2023. It is recommended to use API version 2 to run this command.
Reader Note
The parameter Endpoint IPs is required to run this command.
You should already have your desired Endpoint IPs on hand to run this command. If you don’t, you may use the Fetch Event command with defined filters to obtain Endpoint IPs. The values can be found in the raw data, under the "local_ip" key.
Input
Input Parameter | Required/Optional | Description | Example |
Endpoint IPs | Required | The IPs of the endpoints to retrieve details. Endpoint IPs can be obtained using the Fetch Event command. | ["1.2.3.4"] |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Get Endpoint Info by IP failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: Cannot get host by given host IP. |
Error Sample Data Get Endpoint Info by IP failed. Status Code: 404. Error Message: Cannot get host by given host IP. |
Get Host Vulnerabilities
Retrieves host vulnerabilities by searching for any vulnerabilities associated with the specified host(s). Note: At least one parameter must be defined.
Reader Note
Host Names Or IPs, Host Group Names and Host Tags are optional parameters to run this command.
Please note that at least one of the parameters needs to be defined.
You should already have your desired Host Names or IPs on hand if you want to define the Host Names Or IPs parameter. If you don’t, you may use the Fetch Event command with defined filters to obtain the Host Names or IPs. Host Names can be found in the returned raw data, under the "hostname" key. Host IPs can be found in the returned raw data, under the "local_ip" key.
Run Find Host Groups command to obtain Host Group Names. Host Group Names can be found from the raw data at the path $.resources[*].name.
Run the Get Endpoint Info By IP or Get Endpoint Info By ID commands to obtain the Host Tags. Host Tags can be found in the returned raw data if there are any tags available, under the "tags" key.
Input
Input Parameter | Required/Optional | Description | Example |
Host Names Or IPs | Optional | The internal IP addresses of names of the hosts to retrieve associated vulnerabilities. | [ "1.2.3.4" ] |
Host Group Names | Optional | The names of the host groups to retrieve associated vulnerabilities. Host Group Names can be obtained using the Find Host Groups command. | ["group1", "group2"] |
Host Platform | Optional | The operating system platform of the hosts to retrieve associated vulnerabilities. | Linux |
Host Tags | Optional | The tags of the hosts to retrieve associated vulnerabilities. Host tags can be obtained using the Get Endpoint Info By IP or Get Endpoint Info By ID commands. Note: Host tags are case-sensitive. | [ "tag1/tag2" ] |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Get Host Vulnerabilities failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 400. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: Invalid hostNamesOrIPs. |
Error Sample Data Get Host Vulnerabilities failed. Status Code: 400. Error Message: Invalid hostNamesOrIPs. |
Get IOCs
Returns detailed info of the specified indicator(s).
Reader Note
The input parameter IDs is a required parameter to run this command.
Run the Find IOC IDs command to obtain IDs. IDs can be found in the raw data at the path $.resources.
Input
Input Parameter | Required/Optional | Description | Example |
IDs | Required | The ID(s) of the indicator(s) to retrieve details. Indicator IDs can be obtained using the Find IOC IDs command. | [“***” ] |
Output
Error Handling
If the Return Data is Partially Successful or Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Get IOCs failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: No resource found with ID ***. |
Error Sample Data Get IOCs failed. Status Code: 404 Error Message: No resource found with ID ***. |
Get Process Detail
Returns details of the specified process(es) in CrowdStrike.
Reader Note
Process ID is a Required parameter to run this command.
Run the Find Process command to obtain Process ID. Process IDs can be found in the raw data at the path $.resources.
Input
Input Parameter | Required/Optional | Description | Example |
Process ID | Required | The IDs of the processes to retrieve details. Process IDs can be obtained using the Find Process command. | ["pid:***:***", "pid:***:***"] |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Get Process Detail failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: Resource not found. |
Error Sample Data Get Process Detail failed. Status Code: 404 Error Message: Resource not found. |
Get Process Detail by IOC
Returns process details of the specified IOC in CrowdStrike.
Reader Note
IOC, IOC Type and Host IDs are required parameters to run this command.
You should already have your desired IOC and IOC type on hand to run this command. If you don’t, you may use the Fetch Event command with defined filters to retrieve the desired IOC and IOC type. The values can be found in the returned raw data.
Run the Find Hosts command to obtain Host IDs. Host IDs can be found in the raw data at the path $.resources.
Here are some examples of IOCs and IOC Types:
Input
Input Parameter | Required/Optional | Description | Example |
IOC | Required | The value of the IOC to retrieve process details. | *** |
IOC Type | Required | The IOC type of the specified value. The available IOC types are SHA256, MD5, Domain, IPV4, and IPV6. | SHA256 |
Endpoint ID | Required | The ID of the endpoint to retrieve process details. Endpoint IDs can be obtained using the Find Hosts command. | *** |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Get Process Detail by IOC failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: Resource not found. |
Error Sample Data Get Process Detail by IOC failed. Status Code: 404. Error Message: Resource not found. |
Get Scan Results
Retrieves details about the specified scans (one-time ad hoc scan and scheduled scan), including the details about malicious files found during the scan.
Reader Note
Input parameter Scan IDs is Required to run this command.
Run the List Scans command to obtain Scan IDs. Scan IDs can be found in the raw data at the path $.resources.
Input
Input Parameter | Required/Optional | Description | Example |
Scan IDs | Required | The IDs of the scans to retrieve results. Scan IDs can be obtained using the List Scans command. | [ "***" ] |
Output
Error Handling
If the Return Data is Partially Successful or Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Get Scan Results failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Message: Scan ID Not Found. |
Error Sample Data Get Scan Results failed. Status Code: 404. Message: Scan ID Not Found. |
Get Vulnerability Details
Retrieves vulnerability details for the specified vulnerability IDs.
Reader Note
Input parameter Vulnerability IDs is Required to run this command.
Run the List Vulnerabilities or Get Host Vulnerabilities commands to obtain Vulnerability IDs. Vulnerability IDs can be found in the raw data at the path $.resources[*].id.
This command requires API Version v2 for the connection when running the command. If the API Version is configured to v1, you will not be able to find the connection to run this command. Please refer to Step 3h 4 of Configuring D3 SOAR to Work with CrowdStrike on changing the API Version in your connection.
Input
Input Parameter | Required/Optional | Description | Example |
Vulnerability IDs | Required | The IDs of the vulnerabilities to retrieve details. Vulnerability IDs can be obtained using the List Vulnerabilities or Get Host Vulnerabilities commands. You can enter a maximum of 400 Vulnerability IDs. | [ "***" ] |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Get Vulnerability Details failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 400. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Message: Invalid vulnerability id. |
Error Sample Data Get Vulnerability Details failed. Status Code: 400. Message: Invalid vulnerability id. |
Get Vulnerability Evaluation Logics
Retrieves details on evaluation logic for products related to a vulnerability.
Reader Note
Input parameter Host IDs is required to run this command.
Host IDs must be obtained using the List Vulnerabilities or Search Vulnerable Hosts By CVE commands. This ensures that vulnerable hosts in your environment are used for this particular command.
Run the List Vulnerabilities or Search Vulnerable Hosts By CVE command to obtain Host IDs. Host IDs can be found in the raw data in the List Vulnerabilities command at the path $.resources[*].id or in the Search Vulnerable Hosts By CVE command at the path $.resources[*].aid.
Input
Input Parameter | Required/Optional | Description | Example |
Host IDs | Optional | The IDs of the hosts to retrieve vulnerability evaluation logics. Host IDs can be obtained using the List Vulnerabilities or Search Vulnerable Hosts By CVE commands. | [ "***" ] |
Updated From | Optional | The timestamp to filter vulnerability evaluation logics that are updated at or after this time. | 2023-04-20 00:00 |
Updated Before | Optional | The timestamp to filter vulnerability evaluation logics that are updated at or before this time. If this parameter is not defined, the default value is the current time. | 2023-04-21 00:00 |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Get Vulnerability Evaluation Logics failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 400. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Message: access denied, authorization failed. |
Error Sample Data Get Vulnerability Evaluation Logics failed. Status Code: 400. Message: access denied, authorization failed. |
Isolate Host
Quarantines hosts in CrowdStrike.
Reader Note
The parameter Host IDs is required to run this command.
Run the Find Hosts command to obtain Host IDs. Host IDs can be found in the raw data at the path $.resources.
This command requires API Version v2 for the connection when running the command. If the API Version is configured to v1, you will not be able to find the connection to run this command. Please refer to Step 3h 4 of Configuring D3 SOAR to Work with CrowdStrike on changing the API Version in your connection.
Note: A host cannot be isolated twice. Otherwise, the error message “Device ____ is not eligible to perform containment action” will be returned.
Input
Input Parameter | Required/Optional | Description | Example |
Host IDs | Required | The IDs of the hosts to isolate. Host IDs can be obtained using the Find Hosts command. | ["***"] |
Output
Error Handling
If the Return Data is Partially Successful or Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Isolate Host failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: No matching host found for ID b2443tg****hbha****nh34c. |
Error Sample Data Isolate Host failed. Status Code: 404 Error Message: No matching host found for ID b2443tg****hbha****nh34c. |
List Host Group Members
Retrieves members from the specified host group.
Reader Note
Host Group ID is an optional parameter to run this command.
Run Find Host Groups command to obtain the Host Group ID. Host Group IDs can be found in the raw data at the path $.resources[*].id.
Input
Input Parameter | Required/Optional | Description | Example |
Host Group ID | Optional | The ID of the host group to retrieve group members. Host Group IDs can be obtained using the Find Host Groups command. | *** |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | List Host Group Members failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Message: Host Group ID Not Found. |
Error Sample Data List Host Group Members failed. Status Code: 404. Message: Host Group ID Not Found. |
Find Host Groups
Retrieves information about a host group, including its members, based on the provided name(s) of the host group(s).
Input
Input Parameter | Required/Optional | Description | Example |
Host Group Names | Optional | The names of the host groups to retrieve. If this parameter is not defined, all host groups will be returned. | ["group1", "group2"] |
Output
Error Handling
If the Return Data is Partially Successful or Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Find Host Groups failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Message: Host Group Names Not Found. |
Error Sample Data Find Host Groups failed. Status Code: 404. Message: Host Group Names Not Found. |
List Quarantine Files
Retrieves quarantine file metadata that matches the provided filter criteria.
Input
Input Parameter | Required/Optional | Description | Example |
Filter | Optional | The FQL query specifying the filter parameters. Special value '*' means to not filter on anything. Filter term criteria: status, adversary_id, device.device_id, device.country, device.hostname, behaviors.behavior_id, behaviors.ioc_type, behaviors.ioc_value, behaviors.username, behaviors.tree_root_hash. Filter range criteria:, max_severity, max_confidence, first_behavior, last_behavior. Please refer to https://falcon.CrowdStrike.com/documentation/45/falcon-query-language-fql for more information about the query syntax. | hostname:'LA***C2' + state:'quarantined' |
Query | Optional | The match phrase_prefix query criteria; included fields: _all (all filter string fields), sha256, state, paths.path, paths.state, hostname, username, date_updated, date_created. To query a specific quarantined file hash, input the SHA256 hash value with this parameter. | 115********aa7 |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | List Quarantine Files failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 400. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: Failed to get quarantined file IDs. |
Error Sample Data List Quarantine Files failed. Status Code: 400. Error Message: Failed to get quarantined file IDs. |
List Real Time Response Script
Returns a comprehensive list of all custom scripts available to the user that can be executed through the Execute Batch Command.
Input
N/A
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | List RealTime Response Script failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 400. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: Failed to generate access token for clientID |
Error Sample Data List RealTime Response Script failed. Status Code: 400. Error Message: Failed to generate access token for clientID. |
List Scans
Retrieves the IDs of your on-demand scans. These IDs can be used to retrieve scans.
Input
Input Parameter | Required /Optional | Description | Example |
Status | Optional | The status to filter the returned scans. If this parameter is not defined. If this parameter is not defined, scans with any status will be returned. | Completed |
Minimum Severity | Optional | The minimum severity level to filter the returned scans. A valid input value is an integer between 0 and 100. If this parameter is not specified, scans with any severity will be returned. | 50 |
Scan Type | Optional | The scan type (i.e., Ad Hoc Scan or Scheduled Scan) to filter the returned scans. If this parameter is not specified, scans categorized under either scan types will be returned. | Scheduled |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | List Scans failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 403. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Message: access denied, authorization failed. |
Error Sample Data List Scans failed. Status Code: 403. Message: access denied, authorization failed. |
List Scheduled Scans
Retrieves a list of scheduled scans and their details. To retrieve scan results, use the Get Scan Result command.
Input
Input Parameter | Required /Optional | Description | Example |
Description | Optional | The scan description to filter the returned scheduled scans. If the Scheduled Scan IDs parameter is defined, this parameter will be omitted. | test OdS Schedule scan Host0223b |
Scheduled Scan IDs | Optional | The IDs of the scheduled scans to return. If this parameter is defined, the Description parameter will be omitted. | [ "***" ] |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | List Scheduled Scans failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Message: Scheduled Scan IDs Not Found. |
Error Sample Data List Scheduled Scans failed. Status Code: 404. Message: Scheduled Scan IDs Not Found. |
Search Users
Retrieves user information from CrowdStrike.
Input
Input Parameter | Required/Optional | Description | Example |
User Email Addresses | Optional | The email addresses of the users to retrieve information. | ["test@example.com", "test2@example.com"] |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Search Users failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Message: Email Not Found. |
Error Sample Data Search Users failed. Status Code: 404. Message: Email Not Found. |
List Vulnerabilities
Searches and returns vulnerability instance data, which includes details on remediation, host, and CVE. Results are returned based on the specified filter criteria.
Input
Input Parameter | Required /Optional | Description | Example |
Filter | Optional | The filter condition defined in Falcon Query Language (FQL). For more information about the FQL syntax, see https://falcon.CrowdStrike.com/documentation/45/falcon-query-language-fql. If this parameter is not defined, the 100 most recently created vulnerabilities with an "Open" status will be returned. | cve.severity: ['CRITICAL','HIGH'] + status: 'open' |
Limit | Optional | The maximum number (between 1 and 5000) of vulnerabilities to return. The default value is 100. | 10 |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | List Vulnerabilities failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 400. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Message: invalid input data. |
Error Sample Data List Vulnerabilities failed. Status Code: 400. Message: invalid input data. |
Quarantine Endpoint by ID
Quarantines endpoints by endpoint ID in CrowdStrike.
Reader Note
The parameter Endpoint IDs is required to run this command.
Run the Find Hosts command to obtain Endpoint IDs. Endpoint IDs can be found in the raw data at the path $.resources.
This command required API Version v2 for the connection when running the command. If the API Version is configured to v1, you will not be able to find the connection to run this command. Please refer to Step 3h 4 of Configuring D3 SOAR to Work with CrowdStrike on changing the API Version in your connection.
Note: If you have already isolated your input endpoint using the Isolate Host command, you will not be able to quarantine that host with this command.
Input
Input Parameter | Required/Optional | Description | Example |
Endpoint IDs | Required | The IDs of the endpoints to quarantine. Endpoint IDs can be obtained using the Find Hosts command. | ["***"] |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Quarantine Endpoint by ID failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: No matching host found for ID ***. |
Error Sample Data Quarantine Endpoint by ID failed. Status Code: 404 Error Message: No matching host found for ID ***. |
Quarantine Endpoint by IP
Quarantines endpoints by endpoint IP in CrowdStrike.
Reader Note
The parameter Endpoint IPs is required to run this command.
You should already have your desired endpoint IPs on hand to run this command. If you don’t, you may use the Fetch Event command with defined filters to obtain Endpoint IPs. The values can be found in the raw data under the "local_ip" key.
Input
Input Parameter | Required /Optional | Description | Example |
Endpoint IPs | Required | The IP addresses of the endpoints to quarantine. | ["1.1.1.1"] |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Quarantine Endpoint by IP failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: Host IP Not Found. |
Error Sample Data Quarantine Endpoint by IP failed. Status Code: 404. Error Message: Host IP Not Found. |
Refresh Session
Refreshes a session timeout on a specified host.
Reader Note
Host ID is a required parameter to run this command.
Run the Find Hosts command to obtain Host IDs. Host IDs can be found in the raw data at the path $.resources.
Input
Input Parameter | Required/Optional | Description | Example |
Host ID | Required | The ID of the host agent to refresh its RTR (Real Time Response) session. This action will retrieve the existing session for the user who is calling on this particular host. Host IDs can be obtained using the Find Hosts command. | *** |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Refresh Session failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: Host ID Not Found. |
Error Sample Data Refresh Session failed. Status Code: 404. Error Message: Host ID Not Found. |
Batch Refresh Session
Batch refreshes a Real-Time Response (RTR) session on multiple hosts. Without refreshing, RTR sessions will expire within 10 minutes.
Reader Note
Batch ID is a required parameter to run this command.
Run the Execute Batch Command to obtain Batch ID. Batch IDs can be found in the raw data at the path $.batch_id.
Input
Input Parameter | Required /Optional | Description | Example |
Batch ID | Required | The ID of the RTR batch to refresh. Batch IDs can be obtained using the Execute Batch Command. | ***-***-***-***-*** |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Batch Refresh Session failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: Batch ID Not Found. |
Error Sample Data Batch Refresh Session failed. Status Code: 404. Error Message: Batch ID Not Found. |
Update Detections
Updates the status, assignee, and comment of the specified detection(s).
Reader Note
The parameter Detection IDs is required to run this command.
Run the Fetch Event command with the Event Type parameter set to Detection to obtain Detection IDs. Detection IDs can be found in the raw data, under the "detection_id" key.
This command requires API Version v2 for the connection when running the command. If the API Version is configured v1, you will not be able to find the connection to run this command. Please refer to Step 3h 4 of Configuring D3 SOAR to Work with CrowdStrike on changing the API Version in your connection.
Input
Input Parameter | Required/Optional | Description | Example |
Detection IDs | Required | The IDs of the detections to resolve. Detection IDs can be obtained using the Fetch Event command. | ["ldt:***:***"] |
Status | Required | The updated status of the specified detections. The available statuses are New, In Progress, True Positive, False Positive, Closed, Reopened and Ignored. | In Progress |
Comment | Optional | The comment to add to the detection. Comments provide context or notes to other Falcon users who view the detection. Additionally, it is possible to have multiple comments added to a detection over time. | testComment0207b |
Assignee | Optional | The email address of the detection's assigned user. | test@example.com |
Output
Error Handling
If the Return Data is Partially Successful or Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Resolve Detection failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: Detection with ID 'ldt:272***191' not found. |
Error Sample Data Resolve Detection failed. Status Code: 404. Error Message: Detection with ID 'ldt:272***191' not found. |
Scan Hosts Adhoc
Initiates an ad hoc scan on the specified hosts or host groups.
Reader Note
The parameter Host Group IDs is required to run this command.
Run the Find Host Groups command to obtain the Host Group ID. Host Group IDs can be found in the raw data at the path $.resources[*].id.
The parameter Host IDs is optional to run this command.
Run the Find Hosts command to obtain Host IDs. Host IDs can be found in the raw data at the path $.resources.
Input
Input Parameter | Required/Optional | Description | Example |
Host IDs | Optional | The IDs of the hosts to scan. Host IDs can be obtained using the Find Hosts command. Note: At least one of the Host ID or Host Group ID parameters must be defined. | [ "***" ] |
Host Group IDs | Required | The IDs of the host groups to scan. Host IDs can be obtained using the Find Host Groups command. | [ "***" ] |
File Paths | Required | The file paths to scan. | [ "C:\\Windows" ] |
Scan Exclusions | Optional | The file paths to exclude from the scan. | [ "\\Windows\\***\\*" ] |
Max Duration | Optional | The maximum scan duration value in hours. If this parameter is not defined, there will be no limit on the duration of the scan. | 2 |
Pause Duration | Optional | The maximum allowed scan pause duration in hours. If this parameter is not defined, the default pause duration is two hours. | 2 |
Description | Optional | The description for the scan. | test *** |
Quarantine | Required | The option to quarantine malicious files if found. | False |
CPU Priority | Optional | The percentage of CPU utilization to allocate for the scan. The default CPU utilization for the scan is up to 25%. | Up to 1% CPU utilization |
Machine Learning Detection Level | Optional | The detection level of cloud and sensor machine learning to enable. The detection level must be greater or equal to the associated prevention level. If the prevention level is set to Moderate, then the detection level must be Moderate, Aggressive, or Extra Aggressive, and cannot be set to Cautious. If this parameter is not defined, the default detection level is Moderate. | Cautious |
Machine Learning Prevention Level | Optional | The prevention level of cloud and sensor machine learning to employ. Note: The detection level must be at least as high as the prevention level. For example, if the detection level is set to Moderate, then the prevention level cannot be set to Aggressive or Extra Aggressive; it must be set to Moderate, Cautious or Disabled. If this parameter is not defined, the default prevention level is Moderate. | Cautious |
Max File Size | Optional | The maximum file size (in MB) to scan. If this parameter is not defined, the default value is 60 MB. | 20 |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Scan Hosts Adhoc failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Message: Host Group ID Not Found. |
Error Sample Data Scan Hosts Adhoc failed. Status Code: 404. Message: Host Group ID Not Found. |
Search Alerts
Retrieves comprehensive data from the alerts matching the specified search conditions.
Input
Input Parameter | Required /Optional | Description | Example |
Filter | Required | The filter condition defined in Falcon Query Language (FQL). For more information about the FQL syntax, see https://falcon.CrowdStrike.com/documentation/45/falcon-query-language-fql. If this parameter is not defined, all alerts will be returned. | product:'epp' + status:['new'] + severity:>=50 |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Search Alerts failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 403. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Message: Invalid Filter. |
Error Sample Data Search Alerts failed. Status Code: 403. Message: Invalid Filter. |
Search Vulnerable Hosts By CVE
Searches vulnerable hosts in your environment by CVE IDs or CVE Severity.
Reader Note
The parameter CVE IDs is required to run this command.
Run the List Vulnerabilities command to obtain the CVE IDs. CVE IDs can be found in the raw data at the path $.resources[*].cve.id.
Input
Input Parameter | Required/Optional | Description | Example |
CVE IDs | Optional | The CVE IDs of the vulnerabilities present in the hosts to filter results. CVE IDs can be obtained using the List Vulnerabilities command. | [ "CVE-2023-***" ] |
Minimum CVE Severity | Optional | The minimum CVE severity level to filter the returned hosts within your environment. For example, if this parameter is set to MEDIUM, the search results will include hosts with MEDIUM, HIGH or CRITICAL CVE vulnerabilities. Choosing UNKNOWN will return only hosts with UNKNOWN severity, while selecting NONE will only return hosts with NONE severity. Note: If you define the CVE IDs parameter, this parameter will be ignored. If neither the CVE IDs nor the Minimum CVE Severity parameters are specified, the search results will include all hosts with vulnerabilities of HIGH CVE severity levels and above (including HIGH, CRITICAL). | CRITICAL |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Search Vulnerable Hosts By CVE failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Message: CVE IDs Not Found. |
Error Sample Data Search Vulnerable Hosts By CVE failed. Status Code: 404. Message: CVE IDs Not Found. |
Unquarantine Endpoint by ID
Unquarantines endpoints by endpoint ID in CrowdStrike.
Reader Note
The parameter Host IDs is required to run this command.
Run the Find Hosts command to obtain endpoint IDs. Endpoint IDs can be found in the raw data at the path $.resources.
This command requires API Version v2 for the connection when running the command. If the API Version is configured to v1, you will not be able to find the connection to run this command. Please refer to Step 3h 4 of Configuring D3 SOAR to Work with CrowdStrike on changing the API Version in your connection.
Note: The input Endpoint ID must be quarantined before running this command.
Input
Input Parameter | Required/Optional | Description | Example |
Endpoint IDs | Required | The IDs of the endpoints to unquarantine. Endpoint IDs can be obtained using the Find Hosts command. | ["***"] |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Unquarantine Endpoint by ID failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: No matching host found for ID ***. |
Error Sample Data Unquarantine Endpoint by ID failed. Status Code: 404 Error Message: No matching host found for ID ***. |
Unquarantine Endpoint by IP
Unquarantines endpoints by IP in CrowdStrike.
Reader Note
The parameter Endpoint IPs is required to run this command.
You should already have your desired Endpoint IPs on hand to run this command. If you don’t, you may use the Fetch Event command with defined filters to obtain Endpoint IPs. The values can be found in the raw data under the "local_ip" key.
Input
Input Parameter | Required /Optional | Description | Example |
Endpoint IPs | Required | The IPs of the endpoints to unquarantine. | ["1.1.1.1"] |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Unquarantine Endpoint by IP failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: Host IPs Not Found. |
Error Sample Data Unquarantine Endpoint by IP failed. Status code: 404. Error Message: Host IPs Not Found. |
Update Alerts
Updates alerts (status, assignee, tags, and comments) in CrowdStrike.
Reader Note
Input parameter Alert IDs is required to run this command.
Run the Search Scan command to obtain Alert IDs. Alert IDs can be found in the raw data at the path $.resources[*].id.
Input
Input Parameter | Required/Optional | Description | Example |
Alert IDs | Required | The IDs of the alerts to update. Alert IDs can be obtained using the Search Alerts command. | ["***:ods:***:***"] |
Status | Optional | The updated status of the alerts. | In Progress |
Comment | Optional | The comment to add to the alerts. | testAlertComment0208a |
Assignee | Optional | The email address of the alert's assignee user. | test@example.com |
Add Tag | Optional | The tag value to add to the alerts. | Malicious1_tag |
Remove Tag | Optional | The tags to remove from the alerts. | Suspicious1_tag |
Output
Error Handling
If the Return Data is Partially Successful or Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Update Alerts failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Message: Alert ID Not Found. |
Error Sample Data Update Alerts failed. Status Code: 404. Message: Alert ID Not Found. |
Update Incidents
Updates various fields of the specified incident(s) in CrowdStrike. You can also update the status of detections associated with the specified incident(s).
Reader Note
Input parameter Incident IDs is required to run this command.
You should already have your desired Incident IDs on hand to run this command. If you don’t, you may use the Fetch Event command with defined Event Type set to Incident to retrieve the desired Incident IDs. Incident IDs can be found in the raw data at the path $.resources[*].incident_id.
Input
Input Parameter | Required/Optional | Description | Example |
Incident IDs | Required | The IDs of the incidents to update. Incident IDs can be obtained using the Fetch Event command with the Event Type parameter set to Incident. | ["inc:***:***"] |
Status | Optional | The updated status of the incidents. | In Progress |
Comment | Optional | The comment to add to the incidents. | testComment0206abc |
Assignee | Optional | The email address of the incidents' assignee user. | test@example.com |
Description | Optional | The updated description for the incidents. | Test Incident Description 0207 |
Incident Name | Optional | The updated name for the incidents. | NEW INC NAME |
Add Tag | Optional | The tag value to add to the incidents. | Malicious_tag |
Delete Tag | Optional | The tags to remove from the incidents. | Suspicious_tag |
Update Detections | Optional | The option to update the status of the detections associated with the specified incidents, when set to True. If this parameter is set to False, no changes will be made to any involved detections. The default option is False when this parameter is not defined. | True |
Overwrite Detections | Optional | The option to overwrite the status of detections associated with the specified incidents. When set to True, any action values provided in the Status parameter will be applied to the respective Status parameters of all involved detections. If set to False, action values in the Status parameter will only be applied to status parameters of involved detections that have a status of "New." The default value is False when this parameter is not defined. Note: This parameter is only valid when the Update Detections parameter is set to True. | True |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Update Incidents failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Message: Incident ID Not Found. |
Error Sample Data Update Incidents failed. Status Code: 404. Message: Incident ID Not Found. |
Update IOCs
Updates indicators of compromise by IOC ID in CrowdStrike.
Reader Note
Input parameter IDs is required to run this command.
Run the Find IOC IDs command to obtain IDs. IOC IDs can be found in the raw data at the path $.resources.
Input
Input Parameter | Required/Optional | Description | Example |
IDs | Required | The IDs of the indicators to update. Indicator IDs can be obtained using the Find IOC IDs command. | [ "***" ] |
Source | Optional | The originating source of the indicator. This can be used to track where the indicator was defined. A maximum of 256 characters are accepted. | Test Source |
Action | Optional | The action to take when a host observes the custom IOC. The following are accepted inputs:
| Detect |
Severity | Optional | The severity level to apply to this indicator. This field is required to prevent and detect actions. It is optional if the selected action is No Action. | High |
Description | Optional | The descriptive label for the indicator. | Test IOC |
Expiration | Optional | The expiry date of the indicator, after which it will become inactive. Once expired, the indicator's action will be set to No Action, but it will still be visible in your list of custom IOCs. | 2023-04-21 00:00 |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Update IOCs failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 404. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: 'No resource found with ID 5ec6****4a69****284b. |
Error Sample Data Update IOCs failed. Status Code: 404. Error Message: 'No resource found with ID 5ec6****4a69****284b. |
Upload IOCs
Uploads one or more custom indicators of compromise to CrowdStrike.
Input
Input Parameter | Required /Optional | Description | Example |
Type | Required | The indicator type of the entities to upload. | SHA256 |
Values | Required | The string value of the IOCs to upload. | [ "***" ] |
Action | Required | The action to take when a host observes the custom IOC. If not specified, the default action is No Action. The following are accepted inputs:
| Detect |
Severity | Required | The severity level to apply to this indicator. This field is required when the selected action is Prevent or Detect. It is optional for No Action. | High |
Description | Optional | The descriptive label for the indicators. | Test IOC |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Upload IOCs failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 400. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: Duplicate type: 'domain' and value: 'bexample1023.com' combination. |
Error Sample Data Upload IOCs failed. Status Code: 400. Error Message: Duplicate type: 'domain' and value: 'bexample1023.com' combination. |
Upload Real Time Response Script
Uploads a PowerShell script to CrowdStrike cloud for a future "runscript" command.
Input
Input Parameter | Required/Optional | Description | Example |
File Name | Required | The name of the file to upload. | test1.ps1 |
Script | Required | The PowerShell script to upload. | get-childitem |
Permission Type | Required | The permission type for the custom script. The available permission types are Private, Group, and Public. | Group |
Description | Optional | The description of the file to upload. | test818 get child item |
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Upload Real Time Response Script failed. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 400. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Error Message: File with the given name already exists. |
Error Sample Data Upload Real Time Response Script failed. Status code: 400. Error message: File with the given name already exists. |
Test Connection
Allows you to perform a health check on an integration connection. You can schedule a periodic health check by selecting Connection Health Check when editing an integration connection.
Input
N/A
Output
Error Handling
If the Return Data is Failed, an Error tab will appear in the Test Result window.
The error tab contains the details responded from D3 SOAR or third-party API calls, including Failure Indicator, Status Code, and Message. This can help you locate the root cause of a command failure.
Parts in Error | Description | Example |
Failure Indicator | Indicates the command failure that happened at a specific input and/or API call. | Test Connection failed. Failed to check the connector. |
Status Code | The response code issued by the third-party API server or the D3 SOAR system that can be used to locate the corresponding error category. For example, if the returned status code is 401, the selected connection is unauthorized to run the command. The user or system support would need to check the permission setting in the CrowdStrike portal. Refer to the HTTP Status Code Registry for details. | Status Code: 400. |
Message | The raw data or captured key error message from the integration API server about the API request failure. | Message: The remote name could not be resolved: 'api.crowdst'. |
Error Sample Data Test Connection failed. Failed to check the connector. Status Code: 400. Message: The remote name could not be resolved: 'api.crowdst'. |
Deprecated Commands
Deprecated commands are only supported on existing connections configured by current clients. It is recommended for these clients to contact D3's support team to assess the feasibility of migrating these deprecated commands to their respective new versions. For this integration, the Execute Command On Single Endpoint command has been deprecated.
Use Case
Searching for Hashes using the Fetch Event Command
This use case demonstrates how you can search for MD5 and SHA 256 hashes in CrowdStrike using D3 SOAR's Fetch Event command.
To directly search for MD5 and SHA 256 hashes from CrowdStrike, navigate to Investigate and select Hashes. However, since there is no API available to perform this search externally, D3 SOAR's Fetch Event command can be used. Set the event type to Detections and enter the hash value as the filter parameter. You may also specify a time range. Running the command will return the device ID(s) corresponding to the hash.
To obtain detailed information about a specific process by the custom IOC of the hash value, use the Get Process Details By IOC command. Input the hash value as the IOC parameter, select SHA 256 or MD5 as the IOC type, and use the device ID obtained earlier as the host ID. Running the command will return the desired process details.
Note: The device must be turned on and operational for these commands to work. You can use the Get Host Info by ID command to check the last heartbeat.