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:

D3 SOAR	V12.7.83.0+
Category	Endpoint Protection
Deployment Options	Option II, Option IV

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.
1. Navigate to Configuration on the top header menu.
2. Click on the Integration icon on the left sidebar.
3. Type CrowdStrike in the search box to find the integration, then click it to select it.
4. 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.
1. Connection Name: The desired name for the connection.
2. 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.
3. 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.
4. 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.
5. Description (Optional): Add your desired description for the connection.
6. Configure User Permissions: Defines which users have access to the connection.
7. Active: Check the tick box to ensure the connection is available for use.
8. 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.
9. 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.
1. 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.
2. Click OK to close the alert window.
3. 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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.717938972,
        "writes": {
            "resources_affected": 1
        },
        "powered_by": "quarantine",
        "trace_id": "c98********5d3"
    }
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

resources_affected

1

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.733302863,
        "writes": {
            "resources_affected": 1
        },
        "powered_by": "quarantine",
        "trace_id": "3a5********432"
    }
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.466799085,
        "powered_by": "***",
        "trace_id": "***-***-***-***-***"
    },
    "resources": [
        {
            "id": "***",
            "cid": "***",
            "description": "test ODS Schedule scan Host0223b",
            "file_paths": [
                "C:\\***"
            ],
            "scan_exclusions": [
                "\\***\\***\\*"
            ],
            "initiated_from": "cloud_scheduled",
            "cpu_priority": 2,
            "preemption_priority": 15,
            "status": "scheduled",
            "host_groups": [
                "***"
            ],
            "pause_duration": 2,
            "max_duration": 0,
            "max_file_size": 20,
            "sensor_ml_level_detection": 2,
            "sensor_ml_level_prevention": 2,
            "cloud_ml_level_detection": 2,
            "cloud_ml_level_prevention": 2,
            "policy_setting": [
                ***,
                ***,
                ***,
                ***,
                ***
            ],
            "schedule": {
                "start_timestamp": "2023-02-23T23:00",
                "interval": 3
            },
            "created_on": "2023-02-23T23:52:03.432820479Z",
            "created_by": "acb********6a9",
            "last_updated": "2023-02-23T23:52:03.432820479Z",
            "deleted": false
        }
    ]
}

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "ScanID": [
        "***"
    ],
    "Status": [
        "scheduled"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

[
    {
        "meta": {
            "query_time": 0.190073904,
            "powered_by": "ioc-manager",
            "trace_id": "***-***-***-***-***"
        },
        "errors": null,
        "resources": [
            "***"
        ]
    },
    {
        "meta": {
            "query_time": 0.155339801,
            "powered_by": "ioc-manager",
            "trace_id": "***-***-***-***-***"
        },
        "errors": null,
        "resources": [
            "***"
        ]
    }
]

Context Data

The data extracted from Raw Data converted into JSON format. Context Data may be identical to Raw Data in some cases.

D3 customizes the Context Data by retrieving the data from the $.resources path in the JSON data returned by the API, and re-labels resources as "resourceid" to denote the removed IOCs.

It is recommended to refer to the Raw Data instead of Context Data, since it contains the complete API response data. D3 will deprecate Context Data in the future, and playbook tasks using Context Data will be replaced with Raw Data.

SAMPLE DATA

CODE

[
    {
        "resourceid": "***"
    },
    {
        "resourceid": "***"
    }
]

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "IDs": [
        "***",
        "***"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

RESOURCEID
***
***

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

[
    {
        "fileId": "***",
        "fileName": "***.***.7z",
        "md5": "***",
        "sha1": "***",
        "sha256": "***"
    }
]

Context Data

The data extracted from Raw Data converted into JSON format. Context Data may be identical to Raw Data in some cases.

It is recommended to refer to the Raw Data instead of Context Data, since it contains the complete API response data. D3 will deprecate Context Data in the future, and playbook tasks using Context Data will be replaced with Raw Data.

SAMPLE DATA

CODE

[
    {
        "fileId": "***",
        "fileName": "***.***.7z",
        "md5": "***",
        "sha1": "***",
        "sha256": "***"
    }
]

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "fileIds": [
        ***
    ],
    "md5s": [
        "***"
    ],
    "sha1s": [
        "***"
    ],
    "sha256s": [
        "***"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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

Raw Data

The primary response data from the API request.

The returned raw data will display three different datasets based on the event types (Detection, Incident, and Alert).

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.008476027,
        "powered_by": "legacy-detects",
        "trace_id": "***-***-***-***-***"
    },
    "resources": [
        {
            "webhookURL": "WEBHOOKURL",
            "webhookExtraInfo": "WEBHOOKEXTRAINFO",
            "eventType": "detection",
            "cid": "***",
            "created_timestamp": "2022-08-08T11:13:14.814887666Z",
            "detection_id": "ldt:***:***",
            "device": {
                "device_id": "***",
                "cid": "***",
                "agent_load_flags": "1",
                "agent_local_time": "2022-03-10T11:37:12.702Z",
                "agent_version": "6.27.14105.0",
                "bios_manufacturer": "Phoenix Technologies LTD",
                "bios_version": "6.00",
                "config_id_base": "***",
                "config_id_build": "***",
                "config_id_platform": "3",
                "external_ip": "1.1.1.1",
                "hostname": "DC",
                "first_seen": "2021-08-30T21:17:28Z",
                "last_seen": "2022-08-08T10:40:59Z",
                "local_ip": "192.168.88.110",
                "mac_address": "00-00-00-a0-b0-c0",
                "machine_domain": "***.***",
                "major_version": "10",
                "minor_version": "0",
                "os_version": "Windows Server 2016",
                "ou": [
                    "Domain Controllers"
                ],
                "platform_id": "0",
                "platform_name": "***",
                "product_type": "2",
                "product_type_desc": "Domain Controller",
                "site_name": "***",
                "status": "normal",
                "system_manufacturer": "VMware, Inc.",
                "system_product_name": "VMware Virtual Platform",
                "groups": [
                    "***"
                ],
                "modified_timestamp": "2022-08-08T10:42:26Z"
            },
            "behaviors": [
                {
                    "device_id": "***",
                    "timestamp": "2022-08-08T11:13:07Z",
                    "template_instance_id": "***",
                    "behavior_id": "***",
                    "filename": "***.exe",
                    "filepath": "\\Device\\***\\***\\***\\***\\v1.0\\***.exe",
                    "alleged_filetype": "exe",
                    "cmdline": "***.exe -***hidden c:\\***~1\\***\\***.ps1",
                    "scenario": "attacker_methodology",
                    "objective": "Follow Through",
                    "tactic": "Execution",
                    "tactic_id": "***",
                    "technique": "PowerShell",
                    "technique_id": "***",
                    "display_name": "***",
                    "description": "A PowerShell script launched that shares characteristics with known PowerShell exploit kits. The script might connect to remote command and control. Decode and review the script.",
                    "severity": 70,
                    "confidence": 80,
                    "ioc_type": "hash_sha256",
                    "ioc_value": "***",
                    "ioc_source": "script_control",
                    "ioc_description": "\\??\\C:\\***\\***\\***\\v1.0\\***\\***\\***.psd1",
                    "user_name": "***$",
                    "user_id": "S***",
                    "control_graph_id": "ctg:***:42970011308",
                    "triggering_process_graph_id": "pid:***:***",
                    "sha256": "***",
                    "md5": "N/A",
                    "parent_details": {
                        "parent_sha256": "",
                        "parent_md5": "",
                        "parent_cmdline": "",
                        "parent_process_graph_id": ""
                    },
                    "pattern_disposition": ***,
                    "pattern_disposition_details": {
                        "indicator": false,
                        "detect": false,
                        "inddet_mask": false,
                        "sensor_only": false,
                        "rooting": false,
                        "kill_process": false,
                        "kill_subprocess": false,
                        "quarantine_machine": false,
                        "quarantine_file": false,
                        "policy_disabled": true,
                        "kill_parent": false,
                        "operation_blocked": true,
                        "process_blocked": false,
                        "registry_operation_blocked": false,
                        "critical_process_disabled": false,
                        "bootup_safeguard_enabled": false,
                        "fs_operation_blocked": false,
                        "handle_operation_downgraded": false,
                        "kill_action_failed": false,
                        "blocking_unsupported_or_disabled": false,
                        "suspend_process": false,
                        "suspend_parent": false
                    }
                },
                {
                    "device_id": "***",
                    "timestamp": "2022-08-08T11:13:07Z",
                    "template_instance_id": "***",
                    "behavior_id": "***",
                    "filename": "***.exe",
                    "filepath": "\\Device\\***\\***\\***\\***\\v1.0\\***.exe",
                    "alleged_filetype": "exe",
                    "cmdline": "***.exe -***hidden c:\\***~1\\***\\***.ps1",
                    "scenario": "attacker_methodology",
                    "objective": "Follow Through",
                    "tactic": "Execution",
                    "tactic_id": "***",
                    "technique": "PowerShell",
                    "technique_id": "***",
                    "display_name": "***",
                    "description": "A PowerShell script launched that shares characteristics with known PowerShell exploit kits. The script might connect to remote command and control. Decode and review the script.",
                    "severity": 70,
                    "confidence": 80,
                    "ioc_type": "hash_sha256",
                    "ioc_value": "***",
                    "ioc_source": "script_control",
                    "ioc_description": "\\??\\C:\\***\\***\\***\\v1.0\\***\\***\\***.psd1",
                    "user_name": "***$",
                    "user_id": "****",
                    "control_graph_id": "ctg:***:***",
                    "triggering_process_graph_id": "pid:***:***",
                    "sha256": "***",
                    "md5": "N/A",
                    "parent_details": {
                        "parent_sha256": "",
                        "parent_md5": "",
                        "parent_cmdline": "",
                        "parent_process_graph_id": ""
                    },
                    "pattern_disposition": ***,
                    "pattern_disposition_details": {
                        "indicator": false,
                        "detect": false,
                        "inddet_mask": false,
                        "sensor_only": false,
                        "rooting": false,
                        "kill_process": false,
                        "kill_subprocess": false,
                        "quarantine_machine": false,
                        "quarantine_file": false,
                        "policy_disabled": true,
                        "kill_parent": false,
                        "operation_blocked": true,
                        "process_blocked": false,
                        "registry_operation_blocked": false,
                        "critical_process_disabled": false,
                        "bootup_safeguard_enabled": false,
                        "fs_operation_blocked": false,
                        "handle_operation_downgraded": false,
                        "kill_action_failed": false,
                        "blocking_unsupported_or_disabled": false,
                        "suspend_process": false,
                        "suspend_parent": false
                    }
                }
            ],
            "email_sent": true,
            "first_behavior": "2022-08-08T11:13:07Z",
            "last_behavior": "2022-08-08T11:13:07Z",
            "max_confidence": 80,
            "max_severity": 70,
            "max_severity_displayname": "High",
            "show_in_ui": true,
            "status": "new",
            "hostinfo": {
                "active_directory_dn_display": [
                    "Domain Controllers"
                ],
                "domain": ""
            },
            "seconds_to_triaged": 0,
            "seconds_to_resolved": 0,
            "behaviors_processed": [
                "pid:***:***"
            ],
            "date_updated": "2022-08-08T11:13:19Z"
        }
    ],
    "errors": []
}

Return Data

Indicates one of the possible command execution states: Successful, Successful with No Event Data, or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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:\\* runscript -CloudFile='*.ps1' -CommandLine='-Verbose true' -Timeout=180
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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

[
    {
        "meta": {
            "query_time": 1.619005174,
            "powered_by": "empower-api",
            "trace_id": "***-***-***-***-***"
        },
        "combined": {
            "resources": {
                "***": {
                    "session_id": "***-***-***-***-***",
                    "task_id": "***-***-***-***-***",
                    "complete": true,
                    "stdout": "",
                    "stderr": "An item with the specified name C:\\***already exists.",
                    "base_command": "mkdir",
                    "aid": "***",
                    "errors": [],
                    "query_time": 1.617471102,
                    "offline_queued": false,
                    "host_id": "***"
                },
                "***": {
                    "session_id": "***-***-***-***-***",
                    "task_id": "***-***-***-***-***",
                    "complete": true,
                    "stdout": "",
                    "stderr": "An item with the specified name C:\\***already exists.",
                    "base_command": "mkdir",
                    "aid": "***",
                    "errors": [],
                    "query_time": 0.940766675,
                    "offline_queued": false,
                    "host_id": "***"
                }
            }
        },
        "errors": []
    }
]

Context Data

The data extracted from Raw Data converted into JSON format. Context Data may be identical to Raw Data in some cases.

D3 customizes the Context Data by extracting the data from path $.combined.resources[*] in the API returned JSON.

It is recommended to refer to the Raw Data instead of Context Data, since it contains the complete API response data. D3 will deprecate Context Data in the future, and playbook tasks using Context Data will be replaced with Raw Data.

SAMPLE DATA

CODE

[
    {
        "session_id": "***-***-***-***-***",
        "task_id": "***-***-***-***-***",
        "complete": true,
        "stdout": "",
        "stderr": "An item with the specified name C:\\*already exists.",
        "base_command": "mkdir",
        "aid": "***",
        "errors": [],
        "query_time": 1.617471102,
        "offline_queued": false,
        "host_id": "***"
    },
    {
        "session_id": "***-***-***-***-***",
        "task_id": "***-***-***-***-***",
        "complete": true,
        "stdout": "",
        "stderr": "An item with the specified name C:\\*already exists.",
        "base_command": "mkdir",
        "aid": "***",
        "errors": [],
        "query_time": 0.940766675,
        "offline_queued": false,
        "host_id": "***"
    }
]

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "Aids": [
        "***",
        "***"
    ],
    "SessionIds": [
        "***-***-***-***-***",
        "***-***-***-***-***"
    ],
    "TaskIds": [
        "***-***-***-***-***",
        "***-***-***-***-***"
    ],
    "Completes": [
        true,
        true
    ],
    "Stdouts": [
        "",
        ""
    ],
    "Stderrs": [
        "An item with the specified name C:\\test006 already exists.",
        "An item with the specified name C:\\test006 already exists."
    ],
    "BaseCommands": [
        "mkdir",
        "mkdir"
    ],
    "QueryTimes": [
        1,
        0
    ],
    "OfflineQueueds": [
        false,
        false
    ],
    "BatchId": "***-***-***-***-***"
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

SESSION_ID	TASK_ID	COMPLETE	STDOUT	STDERR	BASE_COMMAND	AID	ERRORS	QUERY_TIME	OFFLINE_QUEUED	HOST_ID
*----**	*----**	True		An item with the specified name C:\*already exists.	mkdir	***	[]	1.617471102	False	***
*----**	*----**	True		An item with the specified name C:\*already exists.	mkdir	***	[]	0.940766675	False	***

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

[
    {
        "local_ip": "1.1.1.1.10",
        "Resources": [
            "***"
        ]
    }
]

Context Data

The data extracted from Raw Data converted into JSON format. Context Data may be identical to Raw Data in some cases.

It is recommended to refer to the Raw Data instead of Context Data, since it contains the complete API response data. D3 will deprecate Context Data in the future, and playbook tasks using Context Data will be replaced with Raw Data.

SAMPLE DATA

CODE

[
    {
        "local_ip": "1.1.1.1.10",
        "Resources": [
            "***"
        ]
    }
]

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "device_id": [
        "***"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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: No action: Saves the indicator for future use, but takes no action. No severity required. Detect: Enables detections for the indicator at the selected severity. Allow: Applies to hashes only. Allows the indicator and does not detect it. Severity does not apply and should not be provided. Prevent No UI: Applies to hashes only. Blocks and detects the indicator, but hides it from Activity > Detections. Has a default severity value. Prevent: Applies to hashes only. Blocks the indicator and shows it as a detection at the selected severity.	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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.016167869,
        "pagination": {
            "limit": 100,
            "total": 1,
            "offset": 1,
            "after": "***=="
        },
        "powered_by": "ioc-manager",
        "trace_id": "***-***-***-***-***"
    },
    "errors": null,
    "resources": [
        "***"
    ]
}

Context Data

The data extracted from Raw Data converted into JSON format. Context Data may be identical to Raw Data in some cases.

D3 customizes the Context Data by extracting the data from path $.resources in API returned JSON. and rename the resources to "resourceid" to indicate the returned IOC IDs.

It is recommended to refer to the Raw Data instead of Context Data, since it contains the complete API response data. D3 will deprecate Context Data in the future, and playbook tasks using Context Data will be replaced with Raw Data.

SAMPLE DATA

CODE

[
    {
        "resourceid": "***"
    }
]

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "IDs": [
        "***"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

RESOURCEID
***

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

[
    {
        "meta": {
            "query_time": 0.02918907,
            "pagination": {
                "offset": "",
                "limit": 100
            },
            "trace_id": "***-***-***-***-***",
            "entity": "/devices/entities/devices/v1{?ids*}"
        },
        "resources": [
            "***",
            "***"
        ],
        "errors": []
    },
    {
        "meta": {
            "query_time": 0.071572687,
            "pagination": {
                "offset": "",
                "limit": 100
            },
            "trace_id": "***-***-***-***-***",
            "entity": "/devices/entities/devices/v1{?ids*}"
        },
        "resources": [
            "***",
            "***",
            "***",
            "***",
            "***"
        ],
        "errors": []
    }
]

Context Data

The data extracted from Raw Data converted into JSON format. Context Data may be identical to Raw Data in some cases.

D3 customizes the Context Data by extracting the data from path $.resources in API returned JSON. and rename the resources to "hostid" to indicate the returned hosts.

It is recommended to refer to the Raw Data instead of Context Data, since it contains the complete API response data. D3 will deprecate Context Data in the future, and playbook tasks using Context Data will be replaced with Raw Data.

SAMPLE DATA

CODE

[
    {
        "hostid": "***"
    },
    {
        "hostid": "***"
    },
    {
        "hostid": "***"
    },
    {
        "hostid": "***"
    },
    {
        "hostid": "***"
    },
    {
        "hostid": "***"
    },
    {
        "hostid": "***"
    }
]

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "hostIDs": [
        "***",
        "***",
        "***",
        "***",
        "***",
        "***",
        "***"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful, Partially Successful, or Failed.

The Partially Successful state only occurs when a command’s input accepts an array of items (e.g. an array of IP addresses) and one or more items within the array return an error from the API request.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.136152482,
        "pagination": {
            "offset": "",
            "limit": 100
        },
        "trace_id": "***-***-***-***-***",
        "entity": "/threatgraph/entities/processes/v1{?ids*}"
    },
    "resources": [
        "pid:***:***",
        "pid:***:***",
        "pid:***:***",
        "pid:***:***",
        "pid:***:***",
        "pid:***:***",
        "pid:***:***",
        "pid:***:***",
        "pid:***:***",
        "pid:***:***"
    ],
    "errors": []
}

Context Data

The data extracted from Raw Data converted into JSON format. Context Data may be identical to Raw Data in some cases.

For this command, the context data has been designed to output "endpointId", "processid" and "pid" fields extracted from the raw data response.

It is recommended to refer to the Raw Data instead of Context Data, since it contains the complete API response data. D3 will deprecate Context Data in the future, and playbook tasks using Context Data will be replaced with Raw Data.

SAMPLE DATA

CODE

[
    {
        "endpointId": "***",
        "processid": "***",
        "pid": "pid:***:***"
    },
    {
        "endpointId": "***",
        "processid": "***",
        "pid": "pid:***:***"
    },
    {
        "endpointId": "***",
        "processid": "***",
        "pid": "pid:***:***"
    },
    {
        "endpointId": "***",
        "processid": "***",
        "pid": "pid:***:***"
    },
    {
        "endpointId": "***",
        "processid": "***",
        "pid": "pid:***:***"
    },
    {
        "endpointId": "***",
        "processid": "***",
        "pid": "pid:***:***"
    },
    {
        "endpointId": "***",
        "processid": "***",
        "pid": "pid:***:***"
    },
    {
        "endpointId": "***",
        "processid": "***",
        "pid": "pid:***:***"
    },
    {
        "endpointId": "***",
        "processid": "***",
        "pid": "pid:***:***"
    },
    {
        "endpointId": "***",
        "processid": "***",
        "pid": "pid:***:***"
    }
]

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "results": [
      {
          "endpointId": "***",
          "processid": "***",
          "pid": "pid:***:***"
      },
      {
          "endpointId": "***",
          "processid": "***",
          "pid": "pid:***:***"
      },
      {
          "endpointId": "***",
          "processid": "***",
          "pid": "pid:***:***"
      },
      {
          "endpointId": "***",
          "processid": "***",
          "pid": "pid:***:***"
      },
      {
          "endpointId": "***",
          "processid": "***",
          "pid": "pid:***:***"
      },
      {
          "endpointId": "***",
          "processid": "***",
          "pid": "pid:***:***"
      },
      {
          "endpointId": "***",
          "processid": "***",
          "pid": "pid:***:***"
      },
      {
          "endpointId": "***",
          "processid": "***",
          "pid": "pid:***:***"
      },
      {
          "endpointId": "***",
          "processid": "***",
          "pid": "pid:***:***"
      },
      {
          "endpointId": "***",
          "processid": "***",
          "pid": "pid:***:***"
      }
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

ENDPOINTID	PROCESSID	PID
***	***	pid:*:*
***	***	pid:*:*
***	***	pid:*:*
***	***	pid:*:*
***	***	pid:*:*
***	***	pid:*:*
***	***	pid:*:*
***	***	pid:*:*
***	***	pid:*:*
***	***	pid:*:*

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.004862986,
        "powered_by": "incident-api",
        "trace_id": "60b********b3c"
    },
    "resources": [
        {
            "behavior_id": "ind:6d0********672",
            "cid": "914********788",
            "aid": "6d0********294",
            "incident_id": "inc:6d0********294:6703afe805a94320a0f33d44a3d42491",
            "incident_ids": [
                "inc:6d0********294:6703afe805a94320a0f33d44a3d42491"
            ],
            "pattern_id": 364,
            "template_instance_id": 0,
            "timestamp": "2023-12-28T01:20:28.388Z",
            "cmdline": "\"psexec.exe\" \\\\LA***C2 -u D3LAB1\\Administrator -p D3security! -cvi -d C:\\Windows\\commander.exe",
            "filepath": "\\Device\\********\\Windows\\psexec.exe",
            "domain": "D3LAB1",
            "pattern_disposition": 0,
            "pattern_disposition_details": {
                "indicator": false,
                "detect": false,
                "inddet_mask": false,
                "sensor_only": false,
                "rooting": false,
                "kill_process": false,
                "kill_subprocess": false,
                "quarantine_machine": false,
                "quarantine_file": false,
                "policy_disabled": false,
                "kill_parent": false,
                "operation_blocked": false,
                "process_blocked": false,
                "registry_operation_blocked": false,
                "critical_process_disabled": false,
                "bootup_safeguard_enabled": false,
                "fs_operation_blocked": false,
                "handle_operation_downgraded": false,
                "kill_action_failed": false,
                "blocking_unsupported_or_disabled": false,
                "suspend_process": false,
                "suspend_parent": false
            },
            "sha256": "08c6e20b1785d4ec4e3f9956931d992377963580b4b2c6579fd9930e08882b1c",
            "user_name": "Administrator",
            "tactic": "Privilege Escalation",
            "tactic_id": "TA0004",
            "technique": "Access Token Manipulation",
            "technique_id": "T1134",
            "display_name": "UserTokenImpersonation",
            "objective": "Gain Access",
            "compound_tto": "GainAccess__PrivilegeEscalation__AccessTokenManipulation__0__0__0__0"
        }
    ],
    "errors": []
}

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "IncidentIDs": [
        "***"
    ],
    "BehaviorIDs": [
        "***"
    ],
    "CommandLines": [
        "\"psexec.exe\" \\\\LA***C2 -u D3LAB1\\Administrator -p D3security! -cvi -d C:\\Windows\\commander.exe"
    ],
    "TacticIDs": [
        "***"
    ],
    "TechniqueIDs": [
        "T1134"
    ],
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.009095881,
        "powered_by": "legacy-detects",
        "trace_id": "***-***-***-***-***"
    },
    "resources": [
        {
            "cid": "***",
            "created_timestamp": "2022-06-29T09:05:18.301370314Z",
            "detection_id": "ldt:***:***",
            "behavior_id": "ind:***:***-***-***",
            "incident_id": "inc:***:***",
            "device": {
                "device_id": "***",
                "cid": "***",
                "agent_load_flags": "1",
                "agent_local_time": "2022-06-24T02:38:15.034Z",
                "agent_version": "6.39.15316.0",
                "bios_manufacturer": "Microsoft Corporation",
                "bios_version": "Hyper-V UEFI Release v4.1",
                "config_id_base": "***",
                "config_id_build": "***",
                "config_id_platform": "3",
                "external_ip": "1.1.1.1",
                "hostname": "***",
                "first_seen": "2022-06-13T14:51:53Z",
                "last_seen": "2022-06-29T08:56:52Z",
                "local_ip": "1.1.1.1",
                "mac_address": "00-********-d0",
                "major_version": "10",
                "minor_version": "0",
                "os_version": "Windows 10",
                "platform_id": "0",
                "platform_name": "Windows",
                "product_type": "1",
                "product_type_desc": "Workstation",
                "status": "normal",
                "system_manufacturer": "Microsoft Corporation",
                "system_product_name": "Virtual Machine",
                "groups": [
                    "***"
                ],
                "modified_timestamp": "2022-06-29T08:58:05Z",
                "instance_id": "***-***-***-***-***",
                "service_provider": "AZURE",
                "service_provider_account_id": "***-***-***-***-***"
            },
            "behaviors": [
                {
                    "device_id": "***",
                    "timestamp": "2022-06-29T09:05:05Z",
                    "template_instance_id": "***",
                    "behavior_id": "***",
                    "filename": "***.exe",
                    "filepath": "\\Device\\***\\Windows\\***\\***.exe",
                    "alleged_filetype": "exe",
                    "cmdline": "ipconfig",
                    "scenario": "suspicious_activity",
                    "objective": "Keep Access",
                    "tactic": "Persistence",
                    "tactic_id": "***",
                    "technique": "Web Shell",
                    "technique_id": "***",
                    "display_name": "Webshell",
                    "description": "A command launched with indications of web shell activity. Review the process tree.",
                    "severity": 70,
                    "confidence": 80,
                    "ioc_type": "",
                    "ioc_value": "",
                    "ioc_source": "",
                    "ioc_description": "",
                    "user_name": "cyber****$",
                    "user_id": "S-1-5-18",
                    "control_graph_id": "ctg:***:***",
                    "triggering_process_graph_id": "pid:***:***",
                    "sha256": "***",
                    "md5": "***",
                    "parent_details": {
                        "parent_sha256": "***",
                        "parent_md5": "***",
                        "parent_cmdline": "\"C:\\Windows\\***\\cmd.exe\" /c ipconfig",
                        "parent_process_graph_id": "pid:***:***"
                    },
                    "pattern_disposition": 0,
                    "pattern_disposition_details": {
                        "indicator": false,
                        "detect": false,
                        "inddet_mask": false,
                        "sensor_only": false,
                        "rooting": false,
                        "kill_process": false,
                        "kill_subprocess": false,
                        "quarantine_machine": false,
                        "quarantine_file": false,
                        "policy_disabled": false,
                        "kill_parent": false,
                        "operation_blocked": false,
                        "process_blocked": false,
                        "registry_operation_blocked": false,
                        "critical_process_disabled": false,
                        "bootup_safeguard_enabled": false,
                        "fs_operation_blocked": false,
                        "handle_operation_downgraded": false,
                        "kill_action_failed": false,
                        "blocking_unsupported_or_disabled": false,
                        "suspend_process": false,
                        "suspend_parent": false
                    }
                }
            ],
            "email_sent": true,
            "first_behavior": "2022-06-29T09:05:05Z",
            "last_behavior": "2022-06-29T09:05:05Z",
            "max_confidence": 80,
            "max_severity": 70,
            "max_severity_displayname": "High",
            "show_in_ui": true,
            "status": "new",
            "hostinfo": {
                "domain": ""
            },
            "seconds_to_triaged": 0,
            "seconds_to_resolved": 0,
            "behaviors_processed": [
                "pid:***:***:***"
            ],
            "date_updated": "2022-06-29T09:05:24Z"
        }
    ],
    "errors": []
}

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "IncidentIDs": [
        "inc:***:***"
    ],
    "BehaviorIDs": [
        "ind:***:***-***-***"
    ],
    "DetectionIDs": [
        "ldt:***:***"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.059883231,
        "powered_by": "device-api",
        "trace_id": "***-***-***-***-***"
    },
    "resources": [
        {
            "device_id": "***",
            "cid": "***",
            "agent_load_flags": "1",
            "agent_local_time": "2020-02-11T12:20:16.326Z",
            "agent_version": "5.19.10102.0",
            "bios_manufacturer": "AMI",
            "bios_version": "F.30",
            "build_number": "***",
            "config_id_base": "***",
            "config_id_build": "***",
            "config_id_platform": "3",
            "external_ip": "1.1.1.1",
            "mac_address": "00-00-a0-0b-00-cd",
            "hostname": "YA****UO",
            "first_seen": "2019-10-11T17:58:37Z",
            "last_seen": "2020-02-12T22:34:03Z",
            "local_ip": "1.1.1.1",
            "machine_domain": "***.van",
            "major_version": "10",
            "minor_version": "0",
            "os_version": "Windows Server 2016",
            "platform_id": "0",
            "platform_name": "Windows",
            "policies": [
                {
                    "policy_type": "prevention",
                    "policy_id": "***",
                    "applied": true,
                    "settings_hash": "***",
                    "assigned_date": "2019-10-23T17:46:41.522864925Z",
                    "applied_date": "2019-10-23T17:48:48.097155536Z",
                    "rule_groups": []
                }
            ],
            "device_policies": {
                "prevention": {
                    "policy_type": "prevention",
                    "policy_id": "***",
                    "applied": true,
                    "settings_hash": "***",
                    "assigned_date": "2019-10-23T17:46:41.522864925Z",
                    "applied_date": "2019-10-23T17:48:48.097155536Z",
                    "rule_groups": []
                },
                "sensor_update": {
                    "policy_type": "sensor-update",
                    "policy_id": "***",
                    "applied": true,
                    "settings_hash": ";2",
                    "assigned_date": "2019-10-11T19:00:34.442958221Z",
                    "applied_date": "2019-10-11T19:01:41.847280357Z",
                    "uninstall_protection": "***"
                },
                "device_control": {
                    "policy_type": "device-control",
                    "policy_id": "***",
                    "applied": true,
                    "assigned_date": "2020-01-13T01:17:37.341238739Z",
                    "applied_date": "2020-01-13T01:21:21.754574875Z"
                },
                "global_config": {
                    "policy_type": "globalconfig",
                    "policy_id": "***",
                    "applied": true,
                    "settings_hash": "***",
                    "assigned_date": "2020-01-22T00:17:41.370431801Z",
                    "applied_date": "2020-01-22T00:19:03.955924394Z"
                },
                "remote_response": {
                    "policy_type": "***",
                    "policy_id": "***",
                    "applied": true,
                    "settings_hash": "***",
                    "assigned_date": "2019-10-23T17:46:41.522857135Z",
                    "applied_date": "2019-10-23T17:48:48.14101215Z"
                }
            },
            "groups": [
                "***"
            ],
            "group_hash": "***",
            "product_type": "3",
            "product_type_desc": "Server",
            "provision_status": "Provisioned",
            "service_pack_major": "0",
            "service_pack_minor": "0",
            "pointer_size": "8",
            "site_name": "Default-First-Site-Name",
            "status": "containment_pending",
            "system_manufacturer": "HP",
            "system_product_name": "***",
            "modified_timestamp": "2020-02-12T22:38:53Z",
            "slow_changing_modified_timestamp": "2020-02-12T22:38:53Z",
            "meta": {
                "version": "***"
            },
            "FalconHostLink": "https://falcon.CrowdStrike.com/hosts/hosts/host/***"
        },
        {
            "device_id": "***",
            "cid": "***",
            "agent_load_flags": "1",
            "agent_local_time": "2020-01-14T11:19:12.307Z",
            "agent_version": "5.23.10503.0",
            "bios_manufacturer": "AMI",
            "bios_version": "F.01",
            "build_number": "***",
            "config_id_base": "***",
            "config_id_build": "***",
            "config_id_platform": "3",
            "external_ip": "2.2.2.2",
            "mac_address": "00-ff-eb-60-06-a2",
            "hostname": "TI***-PC",
            "first_seen": "2019-12-10T20:14:10Z",
            "last_seen": "2020-02-12T22:23:54Z",
            "local_ip": "1.2.3.4",
            "major_version": "10",
            "minor_version": "0",
            "os_version": "Windows 10",
            "platform_id": "0",
            "platform_name": "Windows",
            "policies": [
                {
                    "policy_type": "prevention",
                    "policy_id": "***",
                    "applied": true,
                    "settings_hash": "***",
                    "assigned_date": "2019-12-26T20:26:12.979888018Z",
                    "applied_date": "2019-12-26T20:27:20.165530491Z",
                    "rule_groups": []
                }
            ],
            "device_policies": {
                "prevention": {
                    "policy_type": "prevention",
                    "policy_id": "***",
                    "applied": true,
                    "settings_hash": "***",
                    "assigned_date": "2019-12-26T20:26:12.979888018Z",
                    "applied_date": "2019-12-26T20:27:20.165530491Z",
                    "rule_groups": []
                },
                "sensor_update": {
                    "policy_type": "sensor-update",
                    "policy_id": "***",
                    "applied": true,
                    "settings_hash": ";2",
                    "assigned_date": "2019-12-10T20:25:57.241281268Z",
                    "applied_date": "2019-12-10T20:27:26.543240392Z",
                    "uninstall_protection": "***"
                },
                "device_control": {
                    "policy_type": "device-control",
                    "policy_id": "***",
                    "applied": true,
                    "assigned_date": "2019-12-11T07:13:54.410475133Z",
                    "applied_date": "2019-12-11T07:22:26.504632776Z"
                },
                "global_config": {
                    "policy_type": "globalconfig",
                    "policy_id": "***",
                    "applied": true,
                    "settings_hash": "***",
                    "assigned_date": "2020-01-22T00:09:03.301729022Z",
                    "applied_date": "2020-01-22T00:10:11.989289673Z"
                },
                "remote_response": {
                    "policy_type": "remote-response",
                    "policy_id": "***",
                    "applied": true,
                    "settings_hash": "***",
                    "assigned_date": "2019-12-10T20:15:32.797382388Z",
                    "applied_date": "2019-12-10T20:16:38.131865366Z"
                }
            },
            "groups": [],
            "group_hash": "***",
            "product_type": "1",
            "product_type_desc": "Workstation",
            "provision_status": "Provisioned",
            "service_pack_major": "0",
            "service_pack_minor": "0",
            "pointer_size": "8",
            "status": "normal",
            "system_manufacturer": "HP",
            "system_product_name": "***",
            "modified_timestamp": "2020-02-12T22:25:19Z",
            "slow_changing_modified_timestamp": "2020-02-12T21:51:55Z",
            "meta": {
                "version": "***"
            },
            "FalconHostLink": "https://falcon.CrowdStrike.com/hosts/hosts/host/***"
        }
    ],
    "errors": []
}

Context Data

The data extracted from Raw Data converted into JSON format. Context Data may be identical to Raw Data in some cases.

D3 customizes the Context Data by extracting the data from path $.resources in API returned JSON.

It is recommended to refer to the Raw Data instead of Context Data, since it contains the complete API response data. D3 will deprecate Context Data in the future, and playbook tasks using Context Data will be replaced with Raw Data.

SAMPLE DATA

CODE

[
    {
        "device_id": "***",
        "cid": "***",
        "FalconHostLink": "https://falcon.CrowdStrike.com/hosts/hosts/host/***",
        "hostname": "***",
        "local_ip": "1.1.1.1",
        "machine_domain": "***.van",
        "os_version": "Windows Server 2016",
        "system_product_name": "***"
    },
    {
        "device_id": "***",
        "cid": "***",
        "FalconHostLink": "https://falcon.CrowdStrike.com/hosts/hosts/host/***",
        "hostname": "***",
        "local_ip": "1.1.1.1",
        "machine_domain": "",
        "os_version": "Windows 10",
        "system_product_name": "***"
    }
]

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "cid": [
        "***",
        "***"
    ],
    "deviceId": [
        "***",
        "***"
    ],
    "FalconHostLink": [
        "https://falcon.CrowdStrike.com/hosts/hosts/host/***",
        "https://falcon.CrowdStrike.com/hosts/hosts/host/***"
    ],
    "hostname": [
        "***",
        "***"
    ],
    "localIP": [
        "1.1.1.1",
        "2.2.2.2"
    ],
    "machineDomain": [
        "***.van",
        ""
    ],
    "osVersion": [
        "Windows Server 2016",
        "Windows 10"
    ],
    "systemProductName": [
        "***",
        "***"
    ],
    "KeyFieldOutput": [
        {
            "device_id": "***",
            "cid": "***",
            "FalconHostLink": "https://falcon.CrowdStrike.com/hosts/hosts/host/***",
            "hostname": "EDR",
            "local_ip": "1.1.1.1",
            "machine_domain": "",
            "os_version": "Windows 10",
            "system_product_name": "***"
        }
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

device_id	cid	FalconHostLink	hostname	local_ip	machine_domain	os_version	system_product_name
***	***	https://falcon.CrowdStrike.com/hosts/hosts/host/***	***	1.1.1.1	***.van	Windows Server 2016	***
***	***	https://falcon.CrowdStrike.com/hosts/hosts/host/***	***	2.2.2.2		Windows 10	***

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.002410445,
        "powered_by": "device-api",
        "trace_id": "***-***-***-***-***"
    },
    "resources": [
        {
            "device_id": "***",
            "cid": "***",
            "agent_load_flags": "1",
            "agent_local_time": "2020-02-11T12:20:16.326Z",
            "agent_version": "5.19.10102.0",
            "bios_manufacturer": "AMI",
            "bios_version": "F.30",
            "build_number": "***",
            "config_id_base": "***",
            "config_id_build": "***",
            "config_id_platform": "3",
            "external_ip": "1.2.3.4",
            "mac_address": "00-********-bc",
            "hostname": "***",
            "first_seen": "2019-10-11T17:58:37Z",
            "last_seen": "2020-02-12T20:21:27Z",
            "local_ip": "1.2.3.4",
            "machine_domain": "***.van",
            "major_version": "10",
            "minor_version": "0",
            "os_version": "Windows Server 2016",
            "platform_id": "0",
            "platform_name": "Windows",
            "policies": [
                {
                    "policy_type": "prevention",
                    "policy_id": "***",
                    "applied": true,
                    "settings_hash": "***",
                    "assigned_date": "2019-10-23T17:46:41.522864925Z",
                    "applied_date": "2019-10-23T17:48:48.097155536Z",
                    "rule_groups": []
                }
            ],
            "device_policies": {
                "prevention": {
                    "policy_type": "prevention",
                    "policy_id": "***",
                    "applied": true,
                    "settings_hash": "***",
                    "assigned_date": "2019-10-23T17:46:41.522864925Z",
                    "applied_date": "2019-10-23T17:48:48.097155536Z",
                    "rule_groups": []
                },
                "sensor_update": {
                    "policy_type": "sensor-update",
                    "policy_id": "***",
                    "applied": true,
                    "settings_hash": ";2",
                    "assigned_date": "2019-10-11T19:00:34.442958221Z",
                    "applied_date": "2019-10-11T19:01:41.847280357Z",
                    "uninstall_protection": "***"
                },
                "device_control": {
                    "policy_type": "device-control",
                    "policy_id": "***",
                    "applied": true,
                    "assigned_date": "2020-01-13T01:17:37.341238739Z",
                    "applied_date": "2020-01-13T01:21:21.754574875Z"
                },
                "global_config": {
                    "policy_type": "globalconfig",
                    "policy_id": "***",
                    "applied": true,
                    "settings_hash": "***",
                    "assigned_date": "2020-01-22T00:17:41.370431801Z",
                    "applied_date": "2020-01-22T00:19:03.955924394Z"
                },
                "remote_response": {
                    "policy_type": "remote-response",
                    "policy_id": "***",
                    "applied": true,
                    "settings_hash": "***",
                    "assigned_date": "2019-10-23T17:46:41.522857135Z",
                    "applied_date": "2019-10-23T17:48:48.14101215Z"
                }
            },
            "groups": [
                "***"
            ],
            "group_hash": "***",
            "product_type": "3",
            "product_type_desc": "Server",
            "provision_status": "Provisioned",
            "service_pack_major": "0",
            "service_pack_minor": "0",
            "pointer_size": "8",
            "site_name": "***",
            "status": "containment_pending",
            "system_manufacturer": "HP",
            "system_product_name": "***",
            "modified_timestamp": "2020-02-12T20:22:32Z",
            "slow_changing_modified_timestamp": "2020-02-12T20:22:32Z",
            "meta": {
                "version": "***"
            },
            "FalconHostLink": "https://falcon.CrowdStrike.com/hosts/hosts/host/***"
        }
    ],
    "errors": []
}

Context Data

The data extracted from Raw Data converted into JSON format. Context Data may be identical to Raw Data in some cases.

D3 customizes the Context Data by extracting the data from path $.resources in API returned JSON.

It is recommended to refer to the Raw Data instead of Context Data, since it contains the complete API response data. D3 will deprecate Context Data in the future, and playbook tasks using Context Data will be replaced with Raw Data.

SAMPLE DATA

CODE

{
    "device_id": "***",
    "cid": "***",
    "FalconHostLink": "https://falcon.CrowdStrike.com/hosts/hosts/host/***",
    "hostname": "***",
    "local_ip": "1.2.3.4",
    "machine_domain": "***.van",
    "os_version": "Windows Server 2016",
    "system_product_name": "***"
}

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "CIDs": [
        "***",
        "***"
    ],
    "HostIDs": [
        "***",
        "***"
    ],
    "FalconHostLinks": [
        "https://falcon.CrowdStrike.com/hosts/hosts/host/***",
        "https://falcon.CrowdStrike.com/hosts/hosts/host/***"
    ],
    "HostNames": [
        "**",
        "***"
    ],
    "LocalIPs": [
        "1.2.3.4",
        "1.1.1.1"
    ],
    "MachineDomains": [
        "***.van",
        ""
    ],
    "OSVersions": [
        "Windows Server 2016",
        "Windows 10"
    ],
    "SystemProductNames": [
        "***",
        "***"
    ],
    "KeyFieldOutput": [
        {
            "device_id": "***",
            "cid": "***",
            "FalconHostLink": "https://falcon.CrowdStrike.com/hosts/hosts/host/***",
            "hostname": "EDR",
            "local_ip": "1.2.3.4",
            "machine_domain": "",
            "os_version": "Windows 10",
            "system_product_name": "***"
        }
    ],
    "resources": [
        {
            "device_id": "***",
            "cid": "***",
            "FalconHostLink": "https://falcon.CrowdStrike.com/hosts/hosts/host/***",
            "hostname": "***",
            "local_ip": "1.2.3.4",
            "machine_domain": "***.van",
            "os_version": "Windows Server 2016",
            "system_product_name": "***"
        }
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

device_id	cid	FalconHostLink	hostname	local_ip	machine_domain	os_version	system_product_name
***	***	https://falcon.CrowdStrike.com/hosts/hosts/host/***	***	1.2.3.4	***.van	Windows Server 2016	***

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.005585201,
        "pagination": {
            "limit": 1,
            "total": 27,
            "after": "***="
        },
        "powered_by": "spapi",
        "trace_id": "***-***-***-***-***"
    },
    "resources": [
        {
            "id": "***",
            "cid": "***",
            "aid": "***",
            "created_timestamp": "2023-03-10T16:03:44Z",
            "updated_timestamp": "2023-03-10T16:03:44Z",
            "status": "open",
            "apps": [
                {
                    "product_name_version": "linux-signed-hwe-5.15 5.15.0-58.64~20.04.1",
                    "sub_status": "open",
                    "remediation": {
                        "ids": [
                            "***"
                        ]
                    },
                    "evaluation_logic": {
                        "id": ""
                    }
                }
            ],
            "suppression_info": {
                "is_suppressed": false
            },
            "cve": {
                "id": "***"
            }
        }
    ]
}

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "VulnerabilityIDs": [
        "***"
    ],
    "CVE-IDs": [
        "***"
    ],
    "HostIDs": [
        "***"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

[
    {
        "meta": {
            "query_time": 0.000436739,
            "pagination": {
                "limit": 0,
                "total": 1
            },
            "powered_by": "ioc-manager",
            "trace_id": "***-***-***-***-***"
        },
        "errors": null,
        "resources": [
            {
                "id": "***",
                "type": "domain",
                "value": "abc.com",
                "source": "testSource",
                "action": "detect",
                "severity": "high",
                "description": "tes",
                "metadata": {},
                "platforms": [
                    "windows"
                ],
                "tags": [
                    "tag2"
                ],
                "expiration": "2031-05-01T12:00:02Z",
                "expired": false,
                "deleted": false,
                "applied_globally": true,
                "from_parent": false,
                "created_on": "2021-08-03T22:04:55.423670613Z",
                "created_by": "test@example.com",
                "modified_on": "2021-08-09T20:27:31.137596975Z",
                "modified_by": "***"
            }
        ]
    }
]

Context Data

The data extracted from Raw Data converted into JSON format. Context Data may be identical to Raw Data in some cases.

D3 customizes the Context Data by extracting the data from path $.resources in API returned JSON.

It is recommended to refer to the Raw Data instead of Context Data, since it contains the complete API response data. D3 will deprecate Context Data in the future, and playbook tasks using Context Data will be replaced with Raw Data.

SAMPLE DATA

CODE

[
    {
        "id": "***",
        "type": "domain",
        "value": "abc.com",
        "source": "testSource",
        "action": "detect",
        "severity": "high",
        "description": "tes",
        "metadata": {},
        "platforms": [
            "windows"
        ],
        "tags": [
            "tag2"
        ],
        "expiration": "2031-05-01T12:00:02Z",
        "expired": false,
        "deleted": false,
        "applied_globally": true,
        "from_parent": false,
        "created_on": "2021-08-03T22:04:55.423670613Z",
        "created_by": "test@example.com",
        "modified_on": "2021-08-09T20:27:31.137596975Z",
        "modified_by": "***"
    }
]

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "IDs": [
        "***"
    ],
    "Types": [
        "domain"
    ],
    "Values": [
        "abc.com"
    ],
    "Actions": [
        "detect"
    ],
    "Severities": [
        "high"
    ],
    "Descriptions": [
        "tes"
    ],
    "Sources": [
        "testSource"
    ],
    "Expirations": [
        "2031-05-01T12:00:02Z"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful, Partially Successful, or Failed.

The Partially Successful state only occurs when a command’s input accepts an array of items (e.g. an array of IP addresses) and one or more items within the array return an error from the API request.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

ID	TYPE	VALUE	SOURCE	ACTION	SEVERITY	DESCRIPTION	METADATA	PLATFORMS	TAGS	EXPIRATION	EXPIRED	DELETED	APPLIED_GLOBALLY	FROM_PARENT	CREATED_ON	CREATED_BY	MODIFIED_ON	MODIFIED_BY
***	domain	abc.com	testSource	detect	high	tes	{}	[ "windows" ]	[ "tag2" ]	5/1/2031 12:00:02 PM	False	False	True	False	2021-08-03T22:04:55.423670613Z	test@example.com	2021-08-09T20:27:31.137596975Z	***

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.070678186,
        "powered_by": "msa-api",
        "trace_id": ""
    },
    "resources": [
        {
            "device_id": "***",
            "command_line": "\"C:\\Users\\***\\AppData\\Local\\Temp\\***.tmp\\GoogleUpdateSetup.exe\" /installsource taggedmi /install \"appguid={***-***-***-***-***}&iid={***-***-***-***-***}&lang=en&browser=4&usagestats=1&appname=Google%20Chrome&needsadmin=prefers&ap=x64-stable-statsdef_1&brand=CHBD&installdataindex=empty\" /installelevated /nomitag",
            "process_id": "***:***",
            "process_id_local": "***",
            "file_name": "\\Device\\********\\Users\\***\\AppData\\Local\\Temp\\***.tmp\\***.exe",
            "start_timestamp": "2020-10-08T03:20:53Z",
            "start_timestamp_raw": "***",
            "stop_timestamp": "2020-10-08T03:21:12Z",
            "stop_timestamp_raw": "***"
        },
        {
            "device_id": "***",
            "command_line": "\"C:\\Users\\***\\Downloads\\***.exe\" ",
            "process_id": "***:***",
            "process_id_local": "***",
            "file_name": "\\Device\\***\\Users\\***\\Downloads\\***.exe",
            "start_timestamp": "2020-10-08T03:20:50Z",
            "start_timestamp_raw": "132466008501140395",
            "stop_timestamp": "2020-10-08T03:21:13Z",
            "stop_timestamp_raw": "132466008737119001"
        }
    ],
    "errors": []
}

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "results": [
        {
            "device_id": "***",
            "command_line": "\"C:\\Users\\***\\AppData\\Local\\Temp\\***.tmp\\***.exe\" /installsource taggedmi /install \"appguid={***-***-***-***-***}&iid={***-***-***-***-***}&lang=en&browser=4&usagestats=1&appname=Google%20Chrome&needsadmin=prefers&ap=x64-stable-statsdef_1&brand=CHBD&installdataindex=empty\" /installelevated /nomitag",
            "process_id": "***:***",
            "process_id_local": "***",
            "file_name": "\\Device\\***\\Users\\***\\AppData\\Local\\Temp\\***.tmp\\***.exe",
            "start_timestamp": "2020-10-08T03:20:53Z",
            "start_timestamp_raw": "***",
            "stop_timestamp": "2020-10-08T03:21:12Z",
            "stop_timestamp_raw": "***"
        },
        {
            "device_id": "***",
            "command_line": "\"C:\\Users\\***\\Downloads\\***.exe\" ",
            "process_id": "***:***",
            "process_id_local": "***",
            "file_name": "\\Device\\***\\Users\\***\\Downloads\\***.exe",
            "start_timestamp": "2020-10-08T03:20:50Z",
            "start_timestamp_raw": "***",
            "stop_timestamp": "2020-10-08T03:21:13Z",
            "stop_timestamp_raw": "***"
        }
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

DEVICE_ID	COMMAND_LINE	PROCESS_ID	PROCESS_ID_LOCAL	FILE_NAME	START_TIMESTAMP	START_TIMESTAMP_RAW	STOP_TIMESTAMP	STOP_TIMESTAMP_RAW
***	"C:\Users\*\AppData\Local\Temp\.tmp\.exe" /installsource taggedmi /install "appguid={----}&iid={----**}&lang=en&browser=4&usagestats=1&appname=Google%20Chrome&needsadmin=prefers&ap=x64-stable-statsdef_1&brand=CHBD&installdataindex=empty" /installelevated /nomitag	*:*	***	\Device\*\Users\\AppData\Local\Temp\.tmp\*.exe	10/8/2020 3:20:53 AM	***	10/8/2020 3:21:12 AM	***
***	"C:\Users\*\Downloads\*.exe"	*:*	***	\Device\*\Users\*\Downloads\ChromeSetup.exe	10/8/2020 3:20:50 AM	***	10/8/2020 3:21:13 AM	***

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.087031397,
        "powered_by": "msa-api",
        "trace_id": ""
    },
    "resources": [
        {
            "device_id": "***",
            "command_line": "\"C:\\Users\\***\\AppData\\Local\\Temp\\***.tmp\\***.exe\" /installsource taggedmi /install \"appguid={***-***-***-***-***}&iid={***-***-***-***-***}&lang=en&browser=4&usagestats=1&appname=Google%20Chrome&needsadmin=prefers&ap=x64-stable-statsdef_1&brand=CHBD&installdataindex=empty\" /installelevated /nomitag",
            "process_id": "***:***",
            "process_id_local": "***",
            "file_name": "\\Device\\***\\Users\\***\\AppData\\Local\\Temp\\***.tmp\\***.exe",
            "start_timestamp": "2020-10-08T03:20:53Z",
            "start_timestamp_raw": "***",
            "stop_timestamp": "2020-10-08T03:21:12Z",
            "stop_timestamp_raw": "***"
        },
        {
            "device_id": "***",
            "command_line": "\"C:\\Users\\***\\Downloads\\***.exe\" ",
            "process_id": "***:***",
            "process_id_local": "***",
            "file_name": "\\Device\\***\\Users\\***\\Downloads\\***.exe",
            "start_timestamp": "2020-10-08T03:20:50Z",
            "start_timestamp_raw": "***",
            "stop_timestamp": "2020-10-08T03:21:13Z",
            "stop_timestamp_raw": "***"
        },
        {
            "device_id": "***",
            "command_line": "\"C:\\Users\\***\\Downloads\\***.exe\" ",
            "process_id": "***:***",
            "process_id_local": "***",
            "file_name": "\\Device\\***\\Users\\***\\Downloads\\***.exe",
            "start_timestamp": "2020-10-08T17:24:53Z",
            "start_timestamp_raw": "***",
            "stop_timestamp": "2020-10-08T17:25:14Z",
            "stop_timestamp_raw": "***"
        }
    ],
    "errors": []
}

Context Data

The data extracted from Raw Data converted into JSON format. Context Data may be identical to Raw Data in some cases.

D3 customizes the Context Data by extracting the data from path $.resources in API returned JSON.

It is recommended to refer to the Raw Data instead of Context Data, since it contains the complete API response data. D3 will deprecate Context Data in the future, and playbook tasks using Context Data will be replaced with Raw Data.

SAMPLE DATA

CODE

[
  {
          "device_id": "***",
          "command_line": "\"C:\\Users\\***\\AppData\\Local\\Temp\\***.tmp\\***.exe\" /installsource taggedmi /install \"appguid={***-***-***-***-***}&iid={***-***-***-***-***}&lang=en&browser=4&usagestats=1&appname=Google%20Chrome&needsadmin=prefers&ap=x64-stable-statsdef_1&brand=CHBD&installdataindex=empty\" /installelevated /nomitag",
          "process_id": "***:***",
          "process_id_local": "***",
          "file_name": "\\Device\\***\\Users\\***\\AppData\\Local\\Temp\\***.tmp\\***.exe",
          "start_timestamp": "2020-10-08T03:20:53Z",
          "start_timestamp_raw": "***",
          "stop_timestamp": "2020-10-08T03:21:12Z",
          "stop_timestamp_raw": "***"
      },
      {
          "device_id": "***",
          "command_line": "\"C:\\Users\\***\\Downloads\\***.exe\" ",
          "process_id": "***:***",
          "process_id_local": "***",
          "file_name": "\\Device\\***\\Users\\***\\Downloads\\***.exe",
          "start_timestamp": "2020-10-08T03:20:50Z",
          "start_timestamp_raw": "***",
          "stop_timestamp": "2020-10-08T03:21:13Z",
          "stop_timestamp_raw": "***"
      },
      {
          "device_id": "***",
          "command_line": "\"C:\\Users\\***\\Downloads\\***.exe\" ",
          "process_id": "***:***",
          "process_id_local": "***",
          "file_name": "\\Device\\***\\Users\\***\\Downloads\\***.exe",
          "start_timestamp": "2020-10-08T17:24:53Z",
          "start_timestamp_raw": "***",
          "stop_timestamp": "2020-10-08T17:25:14Z",
          "stop_timestamp_raw": "***"
      }
]

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "results": [
        {
            "device_id": "***",
            "command_line": "\"C:\\Users\\***\\AppData\\Local\\Temp\\***.tmp\\***.exe\" /installsource taggedmi /install \"appguid={***-***-***-***-***}&iid={***-***-***-***-***}&lang=en&browser=4&usagestats=1&appname=Google%20Chrome&needsadmin=prefers&ap=x64-stable-statsdef_1&brand=CHBD&installdataindex=empty\" /installelevated /nomitag",
            "process_id": "***:***",
            "process_id_local": "***",
            "file_name": "\\Device\\***\\Users\\***\\AppData\\Local\\Temp\\***.tmp\\***.exe",
            "start_timestamp": "2020-10-08T03:20:53Z",
            "start_timestamp_raw": "***",
            "stop_timestamp": "2020-10-08T03:21:12Z",
            "stop_timestamp_raw": "***"
        },
        {
            "device_id": "***",
            "command_line": "\"C:\\Users\\***\\Downloads\\***.exe\" ",
            "process_id": "***:***",
            "process_id_local": "***",
            "file_name": "\\Device\\***\\Users\\***\\Downloads\\***.exe",
            "start_timestamp": "2020-10-08T03:20:50Z",
            "start_timestamp_raw": "***",
            "stop_timestamp": "2020-10-08T03:21:13Z",
            "stop_timestamp_raw": "***"
        },
        {
            "device_id": "***",
            "command_line": "\"C:\\Users\\***\\Downloads\\***.exe\" ",
            "process_id": "***:***",
            "process_id_local": "***",
            "file_name": "\\Device\\***\\Users\\***\\Downloads\\***.exe",
            "start_timestamp": "2020-10-08T17:24:53Z",
            "start_timestamp_raw": "***",
            "stop_timestamp": "2020-10-08T17:25:14Z",
            "stop_timestamp_raw": "***"
        }
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

DEVICE_ID	COMMAND_LINE	PROCESS_ID	PROCESS_ID_LOCAL	FILE_NAME	START_TIMESTAMP	START_TIMESTAMP_RAW	STOP_TIMESTAMP	STOP_TIMESTAMP_RAW
***	"C:\Users\*\AppData\Local\Temp\.tmp\.exe" /installsource taggedmi /install "appguid={----}&iid={----**}&lang=en&browser=4&usagestats=1&appname=Google%20Chrome&needsadmin=prefers&ap=x64-stable-statsdef_1&brand=CHBD&installdataindex=empty" /installelevated /nomitag	*:*	***	\Device\*\Users\\AppData\Local\Temp\.tmp\*.exe	10/8/2020 3:20:53 AM	***	10/8/2020 3:21:12 AM	***
***	"C:\Users\*\Downloads\*.exe"	*:*	***	\Device\*\Users\\Downloads\**.exe	10/8/2020 3:20:50 AM	***	10/8/2020 3:21:13 AM	***

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.008064359,
        "writes": {
            "resources_affected": 1
        },
        "powered_by": "svc-odsapi",
        "trace_id": "***-***-***-***-***"
    },
    "resources": [
        {
            "id": "***",
            "cid": "***",
            "profile_id": "***",
            "description": "test ODScanHost0207b ",
            "file_paths": [
                "C:\\Windows"
            ],
            "scan_exclusions": [
                "\\Windows\\SystemResources\\*"
            ],
            "initiated_from": "cloud_adhoc",
            "quarantine": true,
            "cpu_priority": 2,
            "preemption_priority": 1,
            "metadata": [
                {
                    "host_id": "***",
                    "scan_host_metadata_id": "***",
                    "filecount": {},
                    "status": "pending",
                    "last_updated": "2023-02-08T00:43:04.091759457Z"
                },
                {
                    "host_id": "***",
                    "scan_host_metadata_id": "***",
                    "filecount": {},
                    "status": "failed",
                    "last_updated": "2023-02-08T00:43:04.611553628Z"
                },
                {
                    "host_id": "***",
                    "host_scan_id": "***",
                    "scan_host_metadata_id": "***",
                    "filecount": {
                        "scanned": ***,
                        "malicious": 1,
                        "quarantined": 1,
                        "skipped": ***,
                        "traversed": ***
                    },
                    "status": "completed",
                    "severity": 50,
                    "started_on": "2023-02-08T00:43:10.294275696Z",
                    "completed_on": "2023-02-08T01:08:20.415234853Z",
                    "last_updated": "2023-02-08T01:08:33.47433981Z"
                },
                {
                    "host_id": "***",
                    "host_scan_id": "***",
                    "scan_host_metadata_id": "***",
                    "filecount": {
                        "scanned": ***,
                        "malicious": 0,
                        "quarantined": 0,
                        "skipped": ***,
                        "traversed": ***
                    },
                    "status": "completed",
                    "started_on": "2023-02-08T00:49:15.11696855Z",
                    "completed_on": "2023-02-08T00:57:42.758111872Z",
                    "last_updated": "2023-02-08T00:57:42.758156627Z"
                }
            ],
            "filecount": {},
            "maliciousFiles": [
                {
                    "id": "***",
                    "cid": "***",
                    "scan_id": "***",
                    "host_id": "***",
                    "host_scan_id": "***",
                    "filepath": "C:\\Windows\\Microsoft.NET\\Framework64\\v4.0.30319\\***\\***\\***\\***\\***.dll",
                    "filename": "***.dll",
                    "hash": "***",
                    "pattern_id": ***,
                    "severity": 50,
                    "quarantined": true,
                    "last_updated": "2023-02-08T00:50:45.310299448Z"
                }
            ],
            "affected_hosts_count": 1,
            "status": "running",
            "hosts": [
                "***"
            ],
            "host_groups": [
                "***"
            ],
            "pause_duration": 2,
            "max_duration": 0,
            "max_file_size": 60,
            "sensor_ml_level_detection": 2,
            "sensor_ml_level_prevention": 2,
            "cloud_ml_level_detection": 2,
            "cloud_ml_level_prevention": 2,
            "severity": 50,
            "policy_setting": [
                ***,
                ***
            ],
            "scan_started_on": "2023-02-08T00:43:10.294275696Z",
            "created_on": "2023-02-08T00:43:04.091759457Z",
            "created_by": "***",
            "last_updated": "2023-02-08T01:08:33.519625127Z"
        }
    ]
}

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "ScanIDs": [
        "***"
    ],
    "ScanStatuses": [
        "running"
    ],
    "AffectedHostCounts": [
        1
    ],
    "Severities": [
        50
    ],
    "MaliciousFilesCounts": [
        1
    ]
}

Return Data

Indicates one of the possible command execution states: Successful, Partially Successful, or Failed.

The Partially Successful state only occurs when a command’s input accepts an array of items (e.g. an array of IP addresses) and one or more items within the array return an error from the API request.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.041287389,
        "powered_by": "spapi",
        "trace_id": "***-***-***-***-***"
    },
    "resources": [
        {
            "id": "***",
            "cid": "***",
            "aid": "***",
            "created_timestamp": "2023-03-10T16:03:44Z",
            "updated_timestamp": "2023-03-10T16:03:44Z",
            "status": "open",
            "apps": [
                {
                    "product_name_version": "linux-signed-hwe-5.15 5.15.0-58.64~20.04.1",
                    "sub_status": "open",
                    "remediation": {
                        "ids": [
                            "***"
                        ]
                    },
                    "evaluation_logic": {
                        "id": ""
                    }
                }
            ],
            "suppression_info": {
                "is_suppressed": false
            },
            "app": {
                "product_name_version": "linux-signed-hwe-5.15 5.15.0-58.64~20.04.1"
            },
            "cve": {
                "id": "***",
                "base_score": 2.5,
                "severity": "LOW",
                "exploit_status": 0,
                "exprt_rating": "LOW",
                "remediation_level": "O",
                "cisa_info": {
                    "is_cisa_kev": false
                },
                "spotlight_published_date": "2022-11-23T02:16:00Z",
                "description": "A vulnerability has been found in Linux Kernel and classified as problematic. This vulnerability affects the function kcm_tx_work of the file net/kcm/kcmsock.c of the component kcm. The manipulation leads to race condition. It is recommended to apply a patch to fix this issue. VDB-211018 is the identifier assigned to this vulnerability.\n",
                "published_date": "2022-10-16T10:15:00Z",
                "vendor_advisory": [
                    "https://***/pub/scm/linux/kernel/git/***/linux.git/commit/?id=***"
                ],
                "references": [
                    "https://vuldb.com/?id.***",
                    "https://lists.debian.org/debian-lts-announce/2022/12/***.html",
                    "https://lists.debian.org/debian-lts-announce/2022/12/***.html"
                ],
                "exploitability_score": 1,
                "impact_score": 1.4,
                "vector": "***/AV:L/AC:H/PR:L/UI:N/S:U/C:N/I:N/A:L"
            },
            "host_info": {
                "hostname": "***",
                "local_ip": "1.2.3.4",
                "machine_domain": "",
                "os_version": "Ubuntu 20.04",
                "ou": "",
                "site_name": "",
                "system_manufacturer": "VMware, Inc.",
                "tags": [
                    "FalconGroupingTags/sandbox"
                ],
                "platform": "Linux",
                "product_type_desc": "Server"
            },
            "remediation": {
                "ids": [
                    "***"
                ],
                "entities": [
                    {
                        "id": "***",
                        "reference": "Ubuntu linux-signed-hwe-5.15",
                        "title": "Update Ubuntu linux-signed-hwe-5.15",
                        "action": "Update linux-signed-hwe-5.15 on Ubuntu 20.04",
                        "link": "",
                        "vendor_url": ""
                    }
                ]
            }
        }
    ]
}

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "VulnerabilityIDs": [
        "***"
    ],
    "CVE-IDs": [
        "***"
    ],
    "HostIDs": [
        "**"
    ],
    "Severities": [
        "LOW"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.02493014,
        "pagination": {
            "limit": 1,
            "total": 27,
            "after": "***="
        },
        "powered_by": "spapi",
        "trace_id": "***-***-***-***-***"
    },
    "resources": [
        {
            "id": "***",
            "cid": "***",
            "aid": "***",
            "created_timestamp": "2023-02-16T10:05:43Z",
            "updated_timestamp": "2023-02-16T10:05:43Z",
            "logic": [
                {
                    "id": ***,
                    "title": "Check if InstallLocation key of the xampp is present",
                    "type": "inventory",
                    "negate": false,
                    "existence_check": "at_least_one_exists",
                    "comparison_check": "",
                    "determined_by_comparison": false,
                    "items": [
                        {
                            "comparison_result": "not evaluated",
                            "hive": "***",
                            "item_type": "registry_item",
                            "key": "SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\xampp",
                            "name": "InstallLocation",
                            "type": "reg_none",
                            "value": [
                                ""
                            ],
                            "windows_view": "32_bit"
                        }
                    ]
                },
                {
                    "id": ***,
                    "title": "Check if php.exe (xampp) is installed",
                    "type": "inventory",
                    "negate": false,
                    "existence_check": "at_least_one_exists",
                    "comparison_check": "",
                    "determined_by_comparison": false,
                    "items": [
                        {
                            "comparison_result": "not evaluated",
                            "filename": "php.exe",
                            "filepath": "C:\\xampp\\php\\php.exe",
                            "item_type": "file_item",
                            "product_name": "PHP",
                            "product_version": "5.6.40",
                            "version": "5.6.40",
                            "windows_view": "64_bit"
                        }
                    ]
                },
                {
                    "id": ***,
                    "title": "Check if the version of PHP (xampp) is less than 7.1.27",
                    "type": "vulnerability",
                    "negate": false,
                    "existence_check": "at_least_one_exists",
                    "comparison_check": "all",
                    "determined_by_comparison": true,
                    "comparisons": {
                        "state_operator": "AND",
                        "state_comparisons": [
                            {
                                "entity_operator": "AND",
                                "entity_comparisons": [
                                    {
                                        "actual_value_field": "version",
                                        "expected_value": "7.1.27",
                                        "operation": "less than",
                                        "value_datatype": "version"
                                    }
                                ]
                            }
                        ]
                    },
                    "items": [
                        {
                            "comparison_result": "true",
                            "filename": "***.exe",
                            "filepath": "C:\\***\\php\\***.exe",
                            "item_type": "file_item",
                            "product_name": "PHP",
                            "product_version": "5.6.40",
                            "version": "5.6.40",
                            "windows_view": "64_bit"
                        }
                    ]
                }
            ]
        }
    ]
}

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "VulnerabilityEvaluationLogicIDs": [
        "**"
    ],
    "HostIDs": [
        "***"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

[
    {
        "meta": {
            "query_time": 0.122132036,
            "powered_by": "device-api",
            "trace_id": "***-***-***-***-***"
        },
        "resources": [
            {
                "id": "***",
                "path": "/devices/entities/devices/v1"
            }
        ],
        "errors": []
    }
]

Context Data

The data extracted from Raw Data converted into JSON format. Context Data may be identical to Raw Data in some cases.

For this command, the context data has been designed to output a renamed field (i.e. hostId) extracted from the raw data response. This design cleans the raw data and provides the field name with more context (e.g. hostId instead of id).

It is recommended to refer to the Raw Data instead of Context Data, since it contains the complete API response data. D3 will deprecate Context Data in the future, and playbook tasks using Context Data will be replaced with Raw Data.

SAMPLE DATA

CODE

[
    {
        "hostId": "***"
    }
]

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "hosts": [
        "***"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.010969033,
        "pagination": {
            "offset": 3,
            "limit": 100,
            "total": 3
        },
        "trace_id": "***-***-***-***-***"
    },
    "errors": [],
    "resources": [
        {
            "device_id": "***",
            "cid": "***",
            "agent_load_flags": "0",
            "agent_local_time": "2023-01-20T13:59:51.204Z",
            "agent_version": "6.50.16410.0",
            "bios_manufacturer": "Microsoft Corporation",
            "bios_version": "Hyper-V UEFI Release v4.1",
            "build_number": "***",
            "config_id_base": "**",
            "config_id_build": "***",
            "config_id_platform": "3",
            "cpu_signature": "***",
            "detection_suppression_status": "unsuppressed",
            "external_ip": "2.2.2.2",
            "mac_address": "00-********-d0",
            "instance_id": "***-***-***-***-***",
            "service_provider": "AZURE",
            "service_provider_account_id": "***-***-***-***-***",
            "hostname": "CYBERTEST",
            "host_hidden_status": "visible",
            "first_seen": "2022-06-13T14:51:53Z",
            "last_seen": "2023-02-07T22:44:05Z",
            "local_ip": "1.1.1.1",
            "machine_domain": "***.local",
            "major_version": "10",
            "minor_version": "0",
            "os_version": "Windows 10",
            "os_build": "***",
            "ou": [],
            "platform_id": "0",
            "platform_name": "Windows",
            "policies": [
                {
                    "policy_type": "prevention",
                    "policy_id": "***",
                    "applied": true,
                    "settings_hash": "***",
                    "assigned_date": "2023-02-01T06:57:00.461537665Z",
                    "applied_date": "2023-02-01T06:58:53.941285607Z",
                    "rule_groups": []
                }
            ],
            "reduced_functionality_mode": "no",
            "device_policies": {
                "prevention": {
                    "policy_type": "prevention",
                    "policy_id": "***",
                    "applied": true,
                    "settings_hash": "***",
                    "assigned_date": "2023-02-01T06:57:00.461537665Z",
                    "applied_date": "2023-02-01T06:58:53.941285607Z",
                    "rule_groups": []
                },
                "sensor_update": {
                    "policy_type": "sensor-update",
                    "policy_id": "***",
                    "applied": true,
                    "settings_hash": "tagged|11;0",
                    "assigned_date": "2023-02-01T23:55:20.837779703Z",
                    "applied_date": "2023-02-01T23:58:31.896513038Z",
                    "uninstall_protection": "DISABLED"
                },
                "device_control": {
                    "policy_type": "device-control",
                    "policy_id": "***",
                    "applied": true,
                    "assigned_date": "2022-06-13T14:53:44.190191366Z",
                    "applied_date": "2022-06-13T14:54:49.558076411Z"
                },
                "global_config": {
                    "policy_type": "globalconfig",
                    "policy_id": "***",
                    "applied": true,
                    "settings_hash": "***",
                    "assigned_date": "2023-02-06T21:49:37.610307683Z",
                    "applied_date": "2023-02-06T21:51:49.937260284Z"
                },
                "remote_response": {
                    "policy_type": "remote-response",
                    "policy_id": "***",
                    "applied": true,
                    "settings_hash": "***",
                    "assigned_date": "2022-06-13T14:53:44.19020603Z",
                    "applied_date": "2022-06-13T14:54:49.586843904Z"
                },
                "firewall": {
                    "policy_type": "firewall",
                    "policy_id": "***",
                    "applied": true,
                    "assigned_date": "2022-12-08T01:06:02.94952527Z",
                    "applied_date": "2022-12-08T01:11:25.149488125Z",
                    "rule_set_id": "***"
                }
            },
            "groups": [
                "**"
            ],
            "group_hash": "***",
            "product_type": "1",
            "product_type_desc": "Workstation",
            "provision_status": "Provisioned",
            "serial_number": "***",
            "service_pack_major": "0",
            "service_pack_minor": "0",
            "pointer_size": "8",
            "site_name": "***",
            "status": "contained",
            "system_manufacturer": "Microsoft Corporation",
            "system_product_name": "***",
            "tags": [],
            "modified_timestamp": "2023-02-07T22:45:03Z",
            "meta": {
                "version": "20801"
            },
            "zone_group": "CS",
            "kernel_version": "10.0.*****.2486",
            "connection_ip": "1.1.1.1",
            "default_gateway_ip": "1.1.1.1",
            "connection_mac_address": "00-********-e0"
        }
    ]
}

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "HostIDs": [
        "***"
    ],
    "HostNames": [
        "***"
    ],
    "HostLocalIPs": [
        "1.1.1.1"
    ],
    "HostOSVersions": [
        "Windows 10"
    ],
    "HostStatuses": [
        "contained"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.005389325,
        "pagination": {
            "offset": 2,
            "limit": 100,
            "total": 2
        },
        "trace_id": "***-***-***-***-***"
    },
    "errors": [],
    "resources": [
        {
            "id": "***",
            "group_type": "static",
            "name": "***",
            "description": "",
            "assignment_rule": "device_id:[''],hostname:['***','***','***','***']",
            "created_by": "test@example.com",
            "created_timestamp": "2021-06-24T18:50:12.278416854Z",
            "modified_by": "test@example.com",
            "modified_timestamp": "2021-09-10T00:39:19.983288237Z"
        },
        {
            "id": "***",
            "group_type": "staticByID",
            "name": "***",
            "description": "",
            "assignment_rule": "device_id:['***','***','***','***'],hostname:[]",
            "created_by": "test@example.com",
            "created_timestamp": "2022-05-05T06:38:37.739488163Z",
            "modified_by": "test@example.com",
            "modified_timestamp": "2022-05-05T06:38:37.739488163Z"
        }
    ]
}

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "HostGroupIDs": [
        "***",
        "***"
    ],
    "HostGroupNames": [
        "***",
        "***"
    ],
    "HostGroupTypes": [
        "static",
        "staticByID"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful, Partially Successful, or Failed.

The Partially Successful state only occurs when a command’s input accepts an array of items (e.g. an array of IP addresses) and one or more items within the array return an error from the API request.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.002792924,
        "powered_by": "quarantine",
        "trace_id": "691********bc2"
    },
    "resources": [
        {
            "id": "6d0********aa7",
            "aid": "6d0********294",
            "cid": "914********788",
            "sha256": "115********aa7",
            "paths": [
                {
                    "path": "\\Device\\********\\Users\\Administrator\\Downloads\\Bom*****nia.exe\\Bom*****nia.exe",
                    "filename": "Bom*****nia.exe",
                    "state": "quarantined"
                }
            ],
            "state": "quarantined",
            "detect_ids": [
                "ldt:6d0********294:272*****033",
                "ldt:6d0********294:272*****013"
            ],
            "alert_ids": [
                "ind:6d0********294:327********728",
                "ind:6d0********294:327********104"
            ],
            "hostname": "LA***C2",
            "username": "administrator",
            "primary_module": true,
            "date_updated": "2024-02-14T01:17:39Z",
            "date_created": "2024-02-14T01:08:29Z",
            "extracted": true
        }
    ],
    "errors": []
}

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "FileIDs": [
        "***"
    ],
    "HostNames": [
        "***"
    ],
    "SHA256s": [
        "***"
    ],
    "UserNames": [
         "administrator"
    ],
    "States": [
        "quarantined"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

[
    {
        "meta": {
            "query_time": 0.048229009,
            "powered_by": "empower-api",
            "trace_id": "***-***-***-***-***"
        },
        "resources": [
            {
                "id": "***",
                "name": "***",
                "description": "desc",
                "file_type": "script",
                "platform": [
                    "windows"
                ],
                "created_by": "api-client-***",
                "created_by_uuid": "***-***-***-***-***",
                "created_timestamp": "2020-06-10T04:39:12.822896104Z",
                "modified_by": "api-client-***",
                "modified_timestamp": "2020-06-10T04:39:12.822896593Z",
                "sha256": "***",
                "permission_type": "private",
                "run_attempt_count": 0,
                "run_success_count": 0,
                "write_access": true
            }
        ]
    },
    {
        "meta": {
            "query_time": 0.116930509,
            "powered_by": "empower-api",
            "trace_id": "***-***-***-***-***"
        },
        "resources": [
            {
                "id": "***",
                "name": "***",
                "file_type": "script",
                "platform": [
                    "windows"
                ],
                "created_by": "api-client-***",
                "created_by_uuid": "***-***-***-***-***",
                "created_timestamp": "2020-06-10T05:18:11.44134457Z",
                "modified_by": "api-client-***",
                "modified_timestamp": "2020-06-10T05:18:11.441344999Z",
                "sha256": "e3b********855",
                "permission_type": "private",
                "run_attempt_count": 0,
                "run_success_count": 0,
                "write_access": true
            }
        ]
    }
]

Context Data

The data extracted from Raw Data converted into JSON format. Context Data may be identical to Raw Data in some cases.

D3 customizes the Context Data by extracting the data from path $.resources in API returned JSON.

It is recommended to refer to the Raw Data instead of Context Data, since it contains the complete API response data. D3 will deprecate Context Data in the future, and playbook tasks using Context Data will be replaced with Raw Data.

SAMPLE DATA

CODE

[
    {
        "id": "***",
        "name": "***",
        "description": "desc",
        "file_type": "script",
        "platform": [
            "windows"
        ],
        "created_by": "api-client-***",
        "created_by_uuid": "***-***-***-***-***",
        "created_timestamp": "2020-06-10T04:39:12.822896104Z",
        "modified_by": "api-client-***",
        "modified_timestamp": "2020-06-10T04:39:12.822896593Z",
        "sha256": "***",
        "permission_type": "private",
        "run_attempt_count": 0,
        "run_success_count": 0,
        "write_access": true
    },
    {
        "id": "***",
        "name": "***",
        "file_type": "script",
        "platform": [
            "windows"
        ],
        "created_by": "api-client-***",
        "created_by_uuid": "***-***-***-***-***",
        "created_timestamp": "2020-06-10T05:18:11.44134457Z",
        "modified_by": "api-client-***",
        "modified_timestamp": "2020-06-10T05:18:11.441344999Z",
        "sha256": "***",
        "permission_type": "private",
        "run_attempt_count": 0,
        "run_success_count": 0,
        "write_access": true
    }
]

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "Ids": [
        "***",
        "***"
    ],
    "Names": [
        "***",
        "***"
    ],
    "FileTypes": [
        "script",
        "script"
    ],
    "SHA256s": [
        "***",
        "***"
    ],
    "PermissionTypes": [
        "private",
        "private"
    ],
    "CreatedTimestamps": [
        "2020-06-10T04:39:12.822896104Z",
        "2020-06-10T05:18:11.44134457Z"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

ID	NAME	DESCRIPTION	FILE_TYPE	PLATFORM	CREATED_BY	CREATED_BY_UUID	CREATED_TIMESTAMP	MODIFIED_BY	MODIFIED_TIMESTAMP	SHA256	PERMISSION_TYPE	RUN_ATTEMPT_COUNT	RUN_SUCCESS_COUNT	WRITE_ACCESS	SIZE	CONTENT
***	***	desc	script	[ "windows" ]	api-client-***	*----**	2020-06-10T04:39:12.822896104Z	api-client-******	2020-06-10T04:39:12.822896593Z	***	private	0	0	True
***	***		script	[ "windows" ]	api-client-***	*----**	2020-06-10T05:18:11.44134457Z	api-client-acb********6a9	2020-06-10T05:18:11.441344999Z	***	private	0	0	True

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.005215488,
        "pagination": {
            "offset": 0,
            "limit": 100,
            "total": 4
        },
        "powered_by": "svc-***",
        "trace_id": "***-***-***-***-***"
    },
    "resources": [
        "***",
        "***",
        "***",
        "***"
    ],
    "errors": null
}

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "ScanIDs": [
        "***",
        "***",
        "***",
        "***"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.003770412,
        "powered_by": "svc-odsapi",
        "trace_id": "***-***-***-***-***"
    },
    "resources": [
        {
            "id": "***",
            "cid": "***",
            "description": "test ODS Schedule scan Host0224CC",
            "file_paths": [
                "C:\\Windows"
            ],
            "scan_exclusions": [
                "\\Windows\\***\\*"
            ],
            "initiated_from": "cloud_scheduled",
            "cpu_priority": 2,
            "preemption_priority": 15,
            "metadata": [
                {
                    "host_id": "***",
                    "last_updated": "2023-02-24T23:32:18.283983527Z"
                },
                {
                    "host_id": "***",
                    "last_updated": "2023-02-24T23:32:18.283983527Z"
                }
            ],
            "status": "scheduled",
            "host_groups": [
                "***"
            ],
            "pause_duration": 2,
            "max_duration": 0,
            "max_file_size": 20,
            "sensor_ml_level_detection": 2,
            "sensor_ml_level_prevention": 2,
            "cloud_ml_level_detection": 2,
            "cloud_ml_level_prevention": 2,
            "policy_setting": [
                ***,
                ***,
                ***,
                ***,
                ***
            ],
            "schedule": {
                "start_timestamp": "2023-02-24T23:35",
                "interval": 0
            },
            "created_on": "2023-02-24T23:32:18.283983527Z",
            "created_by": "***",
            "last_updated": "2023-02-24T23:37:10.754748179Z",
            "deleted": false
        }
    ]
}

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "ScheduledScanIDs": [
        "***"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.04166015,
        "powered_by": "cs.flightcontrolapi",
        "trace_id": "***-***-***-***-***"
    },
    "resources": [
        {
            "uuid": "***-***-***-***-***",
            "cid": "***",
            "uid": "test@example.com",
            "first_name": "**",
            "last_name": "***",
            "last_login_at": "2023-02-03T08:12:39.55809Z"
        },
        {
            "uuid": "***-***-***-***-***",
            "cid": "***",
            "uid": "test2@example.com",
            "first_name": "***",
            "last_name": "***",
            "last_login_at": "2023-02-07T17:45:35.600379Z"
        }
    ]
}

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "EmailAddresses": [
        "test@example.com",
        "test2@example.com"
    ],
    "userUUIDs": [
        "***-***-***-***-***",
        "***-***-***-***-***"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.087990637,
        "pagination": {
            "limit": 1,
            "total": 3816,
            "after": "***="
        },
        "powered_by": "spapi",
        "trace_id": "***-***-***-***-***"
    },
    "resources": [
        {
            "id": "***",
            "cid": "***",
            "aid": "***",
            "created_timestamp": "2023-04-07T03:20:25Z",
            "updated_timestamp": "2023-04-07T03:20:25Z",
            "status": "open",
            "apps": [
                {
                    "product_name_version": "Chrome",
                    "sub_status": "open",
                    "remediation": {
                        "ids": [
                            "***"
                        ]
                    },
                    "evaluation_logic": {
                        "id": "***"
                    }
                }
            ],
            "suppression_info": {
                "is_suppressed": false
            },
            "cve": {
                "id": "***"
            }
        }
    ]
}

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "VulnerabilityIDs": [
        "***"
    ],
    "CVE-IDs": [
        "***"
    ],
    "HostIDs": [
        "***"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.053935087,
        "powered_by": "device-api",
        "trace_id": "***-***-***-***-***"
    },
    "resources": [
        {
            "id": "***",
            "path": "/devices/entities/devices/v1"
        }
    ],
    "errors": []
}

Context Data

The data extracted from Raw Data converted into JSON format. Context Data may be identical to Raw Data in some cases.

D3 customizes the Context Data by extracting the data from path $.resources in API returned JSON.

It is recommended to refer to the Raw Data instead of Context Data, since it contains the complete API response data. D3 will deprecate Context Data in the future, and playbook tasks using Context Data will be replaced with Raw Data.

SAMPLE DATA

CODE

[
    {
        "id": "***",
        "path": "/devices/entities/devices/v1",
        "result": "success"
    }
]

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "results": [
        {
            "id": "**",
            "path": "/devices/entities/devices/v1",
            "result": "success"
        }
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

id	path	result
***	/devices/entities/devices/v1	success

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.045532713,
        "powered_by": "device-api",
        "trace_id": "***-***-***-***-***"
    },
    "resources": [
        {
            "id": "***",
            "path": "/devices/entities/devices/v1"
        }
    ],
    "errors": []
}

Context Data

The data extracted from Raw Data converted into JSON format. Context Data may be identical to Raw Data in some cases.

D3 customizes the Context Data by extracting the data from path $.resources in API returned JSON.

It is recommended to refer to the Raw Data instead of Context Data, since it contains the complete API response data. D3 will deprecate Context Data in the future, and playbook tasks using Context Data will be replaced with Raw Data.

SAMPLE DATA

CODE

[
    {
        "id": "***",
        "path": "/devices/entities/devices/v1"
    }
]

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "results": {
        "id": "***",
        "path": "/devices/entities/devices/v1"
    }
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

id	path
***	/devices/entities/devices/v1

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.042817865,
        "powered_by": "empower-api",
        "trace_id": "***-***-***-***-***"
    },
    "resources": [
        {
            "session_id": "***-***-***-***-***",
            "scripts": [
                {
                    "command": "cd",
                    "description": "Change the current working directory",
                    "examples": "    C:\\> cd C:\\Users\\Administrator\r\n        Change working directory to 'C:\\Users\\Administrator'\r\n    C:\\Users> cd ..\\Windows\r\n        Change working directory to 'C:\\Windows'",
                    "internal_only": false,
                    "runnable": true,
                    "sub_commands": [],
                    "args": [
                        {
                            "id": 8,
                            "created_at": "2018-11-08T18:27:18Z",
                            "updated_at": "2018-11-08T18:27:18Z",
                            "script_id": 8,
                            "arg_type": "arg",
                            "data_type": "string",
                            "requires_value": false,
                            "arg_name": "Path",
                            "description": "Relative or absolute directory",
                            "default_value": "",
                            "required": true,
                            "sequence": 1,
                            "options": null,
                            "encoding": "",
                            "command_level": "non-destructive"
                        }
                    ]
                }
            ],
            "existing_aid_sessions": 1,
            "created_at": "2022-08-19T00:39:42.94510417Z",
            "offline_queued": false
        }
    ],
    "errors": []
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.029493429,
        "powered_by": "empower-api",
        "trace_id": "***-***-***-***-***"
    },
    "resources": {
        "***": {
            "aid": "***",
            "session_id": "***-***-***-***-***",
            "errors": []
        },
        "***": {
            "aid": "***",
            "session_id": "***-***-***-***-***",
            "errors": []
        }
    },
    "errors": []
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.054805663,
        "writes": {
            "resources_affected": 1
        },
        "powered_by": "legacy-detects",
        "trace_id": "***-***-***-***-***"
    }
}

Return Data

Indicates one of the possible command execution states: Successful, Partially Successful, or Failed.

The Partially Successful state only occurs when a command’s input accepts an array of items (e.g. an array of IP addresses) and one or more items within the array return an error from the API request.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.655908,
        "writes": {
            "resources_affected": 1
        },
        "powered_by": "svc-***",
        "trace_id": "***-***-***-***-***"
    },
    "resources": [
        {
            "id": "***",
            "cid": "***",
            "profile_id": "***",
            "description": "test *** ",
            "file_paths": [
                "C:\\Windows"
            ],
            "scan_exclusions": [
                "\\Windows\\***\\*"
            ],
            "initiated_from": "***",
            "quarantine": true,
            "cpu_priority": 2,
            "preemption_priority": 1,
            "metadata": [
                {
                    "host_id": "***",
                    "scan_host_metadata_id": "***",
                    "filecount": {},
                    "last_updated": "0001-01-01T00:00:00Z"
                },
                {
                    "host_id": "***",
                    "scan_host_metadata_id": "***",
                    "filecount": {},
                    "last_updated": "0001-01-01T00:00:00Z"
                },
                {
                    "host_id": "***",
                    "scan_host_metadata_id": "***",
                    "filecount": {},
                    "last_updated": "0001-01-01T00:00:00Z"
                },
                {
                    "host_id": "***",
                    "scan_host_metadata_id": "***",
                    "filecount": {},
                    "last_updated": "0001-01-01T00:00:00Z"
                }
            ],
            "filecount": {},
            "status": "pending",
            "hosts": [
                "***"
            ],
            "host_groups": [
                "***"
            ],
            "pause_duration": 2,
            "max_duration": 0,
            "max_file_size": 60,
            "sensor_ml_level_detection": 2,
            "sensor_ml_level_prevention": 2,
            "cloud_ml_level_detection": 2,
            "cloud_ml_level_prevention": 2,
            "policy_setting": [
                ***,
                ***,
                ***,
                ***,
                ***
            ],
            "created_on": "2023-02-08T00:43:04.091759457Z",
            "created_by": "***",
            "last_updated": "2023-02-08T00:43:04.091759457Z"
        }
    ]
}

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "ScanID": [
        "***"
    ],
    "Status": [
        "pending"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.043659562,
        "writes": {
            "resources_affected": 0
        },
        "powered_by": "***",
        "trace_id": "***-***-***-***-***"
    },
    "resources": [
        {
            "agent_id": "***",
            "agent_scan_id": "***",
            "cid": "***",
            "composite_id": "***:ods:***:***",
            "crawled_timestamp": "2023-02-08T05:06:09.441444773Z",
            "created_timestamp": "2023-02-08T05:06:09.38425366Z",
            "event_id": "73f********62b",
            "filename": "***.dll",
            "filepath": "C:\\\\Windows\\\\Microsoft.NET\\\\***\\\\v4.0.30319\\\\***\\\\***\\\\***\\\\**\\\\***.dll",
            "id": "ods:***:***",
            "os_name": "Windows",
            "pattern_id": ***,
            "product": "epp",
            "quarantined": true,
            "scan_id": "***",
            "severity": 50,
            "sha256hash": "***",
            "show_in_ui": true,
            "status": "new",
            "timestamp": "2023-02-08T00:50:45Z",
            "type": "ods",
            "updated_timestamp": "2023-02-08T05:06:09.38425366Z"
        }
    ]
}

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "AlertIDs": [
        "ods:***:***"
    ],
    "EventIDs": [
        "***"
    ],
    "Severities": [
        50
    ],
    "Statuses": [
        "new"
    ],
    "Products": [
        "epp"
    ],
    "AlertTypes": [
        "ods"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.014309788,
        "pagination": {
            "limit": 100,
            "total": 4,
            "after": "***="
        },
        "powered_by": "***",
        "trace_id": "***-***-***-***-***"
    },
    "resources": [
        {
            "id": "***",
            "cid": "***",
            "aid": "***",
            "hostInfo": {
                "device_id": "***",
                "cid": "***",
                "agent_load_flags": "1",
                "agent_local_time": "2022-11-20T19:45:47.733Z",
                "agent_version": "6.53.16705.0",
                "bios_manufacturer": "Microsoft Corporation",
                "bios_version": "***",
                "build_number": "***",
                "config_id_base": "***",
                "config_id_build": "***",
                "config_id_platform": "3",
                "cpu_signature": "***",
                "external_ip": "2.2.2.2",
                "mac_address": "00-********-a0",
                "instance_id": "***-***-***-***-***",
                "service_provider": "AZURE",
                "service_provider_account_id": "***-***-***-***-***",
                "hostname": "***",
                "first_seen": "2022-06-10T01:19:57Z",
                "last_seen": "2023-04-11T16:58:02Z",
                "local_ip": "1.1.1.1",
                "machine_domain": "**",
                "major_version": "10",
                "minor_version": "0",
                "os_version": "Windows Server 2016",
                "os_build": "***",
                "ou": [
                    "Domain Controllers"
                ],
                "platform_id": "0",
                "platform_name": "Windows",
                "policies": [
                    {
                        "policy_type": "prevention",
                        "policy_id": "***",
                        "applied": true,
                        "settings_hash": "***",
                        "assigned_date": "2023-04-06T19:30:20.230033907Z",
                        "applied_date": "2023-04-06T19:32:04.095965863Z",
                        "rule_groups": []
                    }
                ],
                "reduced_functionality_mode": "no",
                "device_policies": {
                    "prevention": {
                        "policy_type": "prevention",
                        "policy_id": "***",
                        "applied": true,
                        "settings_hash": "***",
                        "assigned_date": "2023-04-06T19:30:20.230033907Z",
                        "applied_date": "2023-04-06T19:32:04.095965863Z",
                        "rule_groups": []
                    },
                    "sensor_update": {
                        "policy_type": "sensor-update",
                        "policy_id": "***",
                        "applied": true,
                        "settings_hash": "***|11;0",
                        "assigned_date": "2023-03-28T22:05:11.967121737Z",
                        "applied_date": "2023-03-28T22:05:24.108466205Z",
                        "uninstall_protection": "DISABLED"
                    },
                    "device_control": {
                        "policy_type": "device-control",
                        "policy_id": "***",
                        "applied": true,
                        "assigned_date": "2023-04-03T00:20:01.045675843Z",
                        "applied_date": "2023-04-03T00:25:14.271493064Z"
                    },
                    "global_config": {
                        "policy_type": "globalconfig",
                        "policy_id": "***",
                        "applied": true,
                        "settings_hash": "***",
                        "assigned_date": "2023-04-06T07:40:12.238104468Z",
                        "applied_date": "2023-04-06T07:41:49.070990865Z"
                    },
                    "remote_response": {
                        "policy_type": "remote-response",
                        "policy_id": "***",
                        "applied": true,
                        "settings_hash": "***",
                        "assigned_date": "2023-03-22T06:58:55.092153689Z",
                        "applied_date": "2023-03-22T07:00:10.220960583Z"
                    },
                    "firewall": {
                        "policy_type": "firewall",
                        "policy_id": "***",
                        "applied": true,
                        "assigned_date": "2023-04-03T22:35:49.106450602Z",
                        "applied_date": "2023-04-03T22:40:50.295715033Z",
                        "rule_set_id": "***"
                    }
                },
                "groups": [
                    "***"
                ],
                "group_hash": "***",
                "product_type": "2",
                "product_type_desc": "Domain Controller",
                "provision_status": "Provisioned",
                "serial_number": "***",
                "service_pack_major": "0",
                "service_pack_minor": "0",
                "pointer_size": "8",
                "site_name": "***",
                "status": "normal",
                "system_manufacturer": "Microsoft Corporation",
                "system_product_name": "***",
                "tags": [],
                "modified_timestamp": "2023-04-11T16:59:59Z",
                "meta": {
                    "version": "***",
                    "version_string": "1:469764590"
                },
                "zone_group": "cs",
                "kernel_version": "10.0.14393.5786",
                "os_product_name": "Windows Server 2016 Datacenter",
                "chassis_type": "3",
                "chassis_type_desc": "Desktop",
                "connection_ip": "1.1.1.1",
                "default_gateway_ip": "1.1.1.1",
                "connection_mac_address": "00-********-a0"
            },
            "created_timestamp": "2023-04-07T03:20:25Z",
            "updated_timestamp": "2023-04-07T03:20:25Z",
            "status": "open",
            "apps": [
                {
                    "product_name_version": "Chrome",
                    "sub_status": "open",
                    "remediation": {
                        "ids": [
                            "***"
                        ]
                    },
                    "evaluation_logic": {
                        "id": "***"
                    }
                }
            ],
            "suppression_info": {
                "is_suppressed": false
            },
            "cve": {
                "id": "CVE-2023-***"
            }
        }
    ]
}

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "VulnerabilityIDs": [
        "***"
    ],
    "CVE-IDs": [
        "CVE-2023-***"
    ],
    "HostIDs": [
        "***"
    ],
    "HostNames": [
        "***"
    ],
    "LocalIPs": [
        "1.1.1.1"
    ],
    "ExternalIPs": [
        "2.2.2.2"
    ],
    "OSVersions": [
        "Windows Server 2016"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.053935087,
        "powered_by": "***-api",
        "trace_id": "***-***-***-***-***"
    },
    "resources": [
        {
            "id": "***",
            "path": "/devices/entities/devices/v1"
        }
    ],
    "errors": []
}

Context Data

The data extracted from Raw Data converted into JSON format. Context Data may be identical to Raw Data in some cases.

D3 customizes the Context Data by extracting the data from path $.resources in API returned JSON.

It is recommended to refer to the Raw Data instead of Context Data, since it contains the complete API response data. D3 will deprecate Context Data in the future, and playbook tasks using Context Data will be replaced with Raw Data.

SAMPLE DATA

CODE

[
    {
        "id": "***",
        "path": "/devices/entities/devices/v1",
        "result": "success"
    }
]

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "results": [
        {
            "id": "***",
            "path": "/devices/entities/devices/v1",
            "result": "success"
        }
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

id	path	result
***	/devices/entities/devices/v1	success

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.045532713,
        "powered_by": "***-api",
        "trace_id": "***-***-***-***-***"
    },
    "resources": [
        {
            "id": "***",
            "path": "/devices/entities/devices/v1"
        }
    ],
    "errors": []
}

Context Data

The data extracted from Raw Data converted into JSON format. Context Data may be identical to Raw Data in some cases.

D3 customizes the Context Data by extracting the data from path $.resources in API returned JSON.

It is recommended to refer to the Raw Data instead of Context Data, since it contains the complete API response data. D3 will deprecate Context Data in the future, and playbook tasks using Context Data will be replaced with Raw Data.

SAMPLE DATA

CODE

[
    {
        "id": "***",
        "path": "/devices/entities/devices/v1"
    }
]

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "results": {
        "id": "***",
        "path": "/devices/entities/devices/v1"
    }
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

id	path
***	/devices/entities/devices/v1

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.825471223,
        "writes": {
            "resources_affected": 1
        },
        "powered_by": "detectsapi",
        "trace_id": "***-***-***-***-***"
    }
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 4.337815281,
        "powered_by": "incident-api",
        "trace_id": "***-***-***-***-***"
    },
    "resources": [
        {
            "detections_updated": [
                "ldt:***:***",
                "ldt:**:***",
                "ldt:***:*&*",
                "ldt:***:***",
                "ldt:***:***"
            ]
        }
    ],
    "errors": []
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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: No Action: Saves the indicator for future use, but takes no action. No severity required. Allow: Applies to hashes only. Allows the indicator and does not detect it. Severity does not apply and should not be provided. Prevent No UI: Applies to hashes only. Blocks and detects the indicator, but hides it from Activity > Detections. Has a default severity value. Prevent: Applies to hashes only. Blocks the indicator and shows it as a detection at the selected severity. Detect: Enables detections for the indicator at the selected severity.	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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.134026196,
        "pagination": {
            "limit": 0,
            "total": 1
        },
        "powered_by": "ioc-manager",
        "trace_id": "***-***-***-***-***"
    },
    "errors": null,
    "resources": [
        {
            "id": "***",
            "type": "domain",
            "value": "abc.com",
            "source": "testSource",
            "action": "detect",
            "severity": "high",
            "description": "tes",
            "metadata": {},
            "platforms": [
                "windows"
            ],
            "tags": [
                "test_tag2"
            ],
            "expiration": "2031-05-01T12:00:02Z",
            "expired": false,
            "deleted": false,
            "applied_globally": true,
            "from_parent": false,
            "created_on": "2021-08-03T22:04:55.423670613Z",
            "created_by": "test@example.com",
            "modified_on": "2021-08-09T20:27:31.137596975Z",
            "modified_by": "***"
        }
    ]
}

Context Data

The data extracted from Raw Data converted into JSON format. Context Data may be identical to Raw Data in some cases.

D3 customizes the Context Data by extracting the data from path $.resources in API returned JSON.

It is recommended to refer to the Raw Data instead of Context Data, since it contains the complete API response data. D3 will deprecate Context Data in the future, and playbook tasks using Context Data will be replaced with Raw Data.

SAMPLE DATA

CODE

[
    {
        "id": "***",
        "type": "domain",
        "value": "abc.com",
        "source": "testSource",
        "action": "detect",
        "severity": "high",
        "description": "tes",
        "metadata": {},
        "platforms": [
            "windows"
        ],
        "tags": [
            "test_tag2"
        ],
        "expiration": "2031-05-01T12:00:02Z",
        "expired": false,
        "deleted": false,
        "applied_globally": true,
        "from_parent": false,
        "created_on": "2021-08-03T22:04:55.423670613Z",
        "created_by": "test@exqample.com",
        "modified_on": "2021-08-09T20:27:31.137596975Z",
        "modified_by": "***"
    }
]

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "IDs": [
        "***"
    ],
    "Types": [
        "domain"
    ],
    "Values": [
        "abc.com"
    ],
    "Sources": [
        "testSource"
    ],
    "Actions": [
        "detect"
    ],
    "Severities": [
        "high"
    ],
    "Descriptions": [
        "tes"
    ],
    "Expirations": [
        "2031-05-01T12:00:02Z"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

ID	TYPE	VALUE	SOURCE	ACTION	SEVERITY	DESCRIPTION	METADATA	PLATFORMS	TAGS	EXPIRATION	EXPIRED	DELETED	APPLIED_GLOBALLY	FROM_PARENT	CREATED_ON	CREATED_BY	MODIFIED_ON	MODIFIED_BY
***	domain	abc.com	testSource	detect	high	tes	{}	[ "windows" ]	[ "test_tag2" ]	5/1/2031 12:00:02 PM	False	False	True	False	2021-08-03T22:04:55.423670613Z	test@example.com	2021-08-09T20:27:31.137596975Z	***

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: No Action: Saves the indicator for future use, but takes no action. No severity required. Allow: Applies to hashes only. Allows the indicator and does not detect it. Severity does not apply and should not be provided. Prevent No UI: Applies to hashes only. Blocks and detects the indicator, but hides it from Activity > Detections. Has a default severity value. Prevent: Applies to hashes only. Blocks the indicator and shows it as a detection at the selected severity. Detect: Enables detections for the indicator at the selected severity.	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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.222846305,
        "pagination": {
            "limit": 0,
            "total": 2
        },
        "powered_by": "ioc-manager",
        "trace_id": "***-***-***-***-***"
    },
    "errors": null,
    "resources": [
        {
            "id": "***",
            "type": "domain",
            "value": "example.com",
            "action": "detect",
            "severity": "medium",
            "description": "test description 22, 30",
            "platforms": [
                "windows",
                "mac",
                "linux"
            ],
            "expired": false,
            "deleted": false,
            "applied_globally": true,
            "from_parent": false,
            "created_on": "2021-08-09T20:37:51.775153168Z",
            "created_by": "***",
            "modified_on": "2021-08-09T20:37:51.775153168Z",
            "modified_by": "***"
        },
        {
            "id": "***",
            "type": "domain",
            "value": "example.com",
            "action": "detect",
            "severity": "medium",
            "description": "test description 22, 30",
            "platforms": [
                "windows",
                "mac",
                "linux"
            ],
            "expired": false,
            "deleted": false,
            "applied_globally": true,
            "from_parent": false,
            "created_on": "2021-08-09T20:37:51.775153168Z",
            "created_by": "***",
            "modified_on": "2021-08-09T20:37:51.775153168Z",
            "modified_by": "***"
        }
    ]
}

Context Data

The data extracted from Raw Data converted into JSON format. Context Data may be identical to Raw Data in some cases.

D3 customizes the Context Data by extracting the data from path $.resources in API returned JSON.

It is recommended to refer to the Raw Data instead of Context Data, since it contains the complete API response data. D3 will deprecate Context Data in the future, and playbook tasks using Context Data will be replaced with Raw Data.

SAMPLE DATA

CODE

[
    {
        "id": "***",
        "type": "domain",
        "value": "example.com",
        "action": "detect",
        "severity": "medium",
        "description": "test description 22, 30",
        "platforms": [
            "windows",
            "mac",
            "linux"
        ],
        "expired": false,
        "deleted": false,
        "applied_globally": true,
        "from_parent": false,
        "created_on": "2021-08-09T20:37:51.775153168Z",
        "created_by": "***",
        "modified_on": "2021-08-09T20:37:51.775153168Z",
        "modified_by": "***"
    },
    {
        "id": "***",
        "type": "domain",
        "value": "example.com",
        "action": "detect",
        "severity": "medium",
        "description": "test description 22, 30",
        "platforms": [
            "windows",
            "mac",
            "linux"
        ],
        "expired": false,
        "deleted": false,
        "applied_globally": true,
        "from_parent": false,
        "created_on": "2021-08-09T20:37:51.775153168Z",
        "created_by": "***",
        "modified_on": "2021-08-09T20:37:51.775153168Z",
        "modified_by": "***"
    }
]

Key Fields

Common cyber security indicators such as unique IDs, file hash values, CVE numbers, IP addresses, etc., will be extracted from Raw Data as Key Fields.
The system stores these key fields in the path $.[playbookTask].outputData. You can use these key-value pairs as data points for playbook task inputs.

SAMPLE DATA

CODE

{
    "IDs": [
        "***",
        "***"
    ]
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

ID	TYPE	VALUE	ACTION	SEVERITY	DESCRIPTION	PLATFORMS	EXPIRED	DELETED	APPLIED_GLOBALLY	FROM_PARENT	CREATED_ON	CREATED_BY	MODIFIED_ON	MODIFIED_BY
***	domain	.com	detect	medium	test description 22, 30	[ "windows", "mac", "linux" ]	False	False	True	False	2021-08-09T20:37:51.775153168Z	***	2021-08-09T20:37:51.775153168Z	*****
***	domain	***.com	detect	medium	test description 22, 30	[ "windows", "mac", "linux" ]	False	False	True	False	2021-08-09T20:37:51.775153168Z	***	2021-08-09T20:37:51.775153168Z	***

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

Raw Data

The primary response data from the API request.

SAMPLE DATA

JSON

{
    "meta": {
        "query_time": 0.721246701,
        "writes": {
            "resources_affected": 1
        },
        "powered_by": "empower",
        "trace_id": "***-***-***-***-***1"
    }
}

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

Return Data can be passed down directly to a subsequent command or used to create conditional tasks in playbooks.

SAMPLE DATA

CODE

Successful

Result

Provides a brief summary of outputs in an HTML formatted table.

SAMPLE DATA

CODE

No Sample Data

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

Return Data

Indicates one of the possible command execution states: Successful or Failed.

The Failed state can be triggered by any of the following errors:

A connection issue with the integration
The API returned an error message
No response from the API

You can view more details about an error in the Error tab.

SAMPLE DATA

CODE

Successful

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.