CrowdStrike Falcon Host (OAuth Based)
CrowdStrike Falcon Host uniquely combines an array of powerful methods to provide prevention against the rapidly changing tactics, techniques and procedures (TTPs) used by adversaries to breach organizations - including commodity malware, zero-day malware and even advanced malware-free attacks.
Connect CrowdStrike with Devo SOAR
Navigate to Automations > Integrations.
Search for CrowdStrike.
Click Details, then the + icon. Enter the required information in the following fields.
Label: Enter a connection name.
Reference Values: Define variables here to templatize integration connections and actions. For example, you can use https://www.{{hostname}}.com where, hostname is a variable defined in this input. For more information on how to add data, see 'Add Data' Input Type for Integrations.
Verify SSL: Select option to verify connecting server's SSL certificate (Default is Verify SSL Certificate).
Remote Agent: Run this integration using the Devo SOAR Remote Agent.
URL: URL to your CrowdStrike Falcon Host (OAuth Based) instance. Example: https://api.crowdstrike.com
Client ID: Client ID of your CrowdStrike Falcon Host.
Client Secret: Client Secret of your CrowdStrike Falcon Host.
After you've entered all the details, click Connect.
Actions for CrowdStrike
Search Detections (Deprecated)
Search for detection IDs that match a given query.
Input Field
Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.
Input Name | Description | Required |
---|---|---|
Query | Search all detection metadata for the provided string. | Â |
Example: 'malicious' | Optional | Â |
Sort | Sort detections using these options. (Default is 'Max Severity: Descending'). | Optional |
Filter | Filter detections using a query in Falcon Query Language (FQL) An asterisk wildcard * includes all results. | Â |
Example: 'behaviors.behavior_id: {{behavior_id_column}}'. | Optional | Â |
Offset | The first detection to return, where 0 is the latest detection. Use with 'Limit' to manage pagination of results. | Optional |
Limit | The maximum number of detections to return in this response (default: 9999; max: 9999). Use with 'Offset' to manage pagination of results. | Optional |
Output
A JSON object containing multiple rows of result:
has_error: True/False
error: message/null
result: Detection details
Get Detection Details (Deprecated)
Get detection details action allows you to view details for specific detections given one or more detection IDs.
Input Field
Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.
Input Name | Description | Required |
---|---|---|
Detection ID Column Name | Column name from the parent table to lookup value for detection ID. | Required |
Output
A JSON object containing multiple rows of result:
has_error: True/False
error: message/null
other fields of detections
Modify Detection (Deprecated)
Change the state and assignee of one or more detections.
Note
In addition to FalconX
Scope, User Management
[Read] Scope is also required for this integration action to work. This is required to create a mapping of the assignee uid (email) vs. the corresponding UUID to supply it to the remote API.
Input Field
Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.
Input Name | Description | Required |
---|---|---|
Detection ID | Column name from the parent table to lookup value for detection id to modify. | Required |
Assignee | Column name from the parent table to lookup value for uid of the assignee (typically an email id) to modify the detection with. An empty value will ignore the updation of the assignee for that detection. | Optional |
Status | Status to modify all the detection with among New/InProgress/TruePositive/FalsePositive/Ignored/Closed/Reopened. | Â |
Note: One of Assignee
or Status
must be provided. | Optional |
| Comment | Jinja-templated comment to add to the detection. Comments are displayed with the detection in Falcon and usually used to provide context or notes for other Falcon users. A detection can have multiple comments over time. Example: Changed assignee of Detection: {{dection_id_column}} to {{assignee_uuid_column}} by Devo SOAR
. | Optional |
Output
A JSON object containing multiple rows of result:
has_error: True/False
error: message/null
result: Successfully Updated
``` {json}{ "result": "Successfully updated", "error": null, "has_error": false }
## Search Devices
Search for devices based on a filter.
### Input Field
Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.
| Input Name | Description | Required |
| : -------- | : -------- | : -------- |
| Devices Filter Template Column Name | Jinja2 template for the device filter. Following are a few examples. Find more on falcon API documentation.
1. To find devices with host name
hostname: '{{host_column}}'
2. To find devices based on prefix or suffix use wildcard ' _ ' (supported by few fields)
hostname: '{{host_prefix_column}}_'
3. To find devices with local IP
local_ip: '{{ip_column}}'
4. To find devices which matches both hostname and platform '+' operator is used. Example:
hostname: '{{host_column}}' + platform_name:'{{platform_column}}'5\. To find devices which matches either hostname or platform name ' , ' operator is used. Example:
hostname: '{{host_column}}' , platform_name:'{{platform_column}}' | Required |
| Max Number of Results | Number of results to fetch (default is 100 results). | Optional |
### Output
A JSON object containing multiple rows of result:
- has_error: True/False
- error: message/null
- result: Device details
![](https://files.readme.io/100d697-devices.png "devices.png")
## Get Device Details
Get device details action allows you to view details for specific devices given one or more device IDs.
### Input Field
Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.
| Input Name | Description | Required |
| :-------------------- | :------------------------------------------------------------------- | :------- |
| Device ID Column Name | Column name from the parent table to lookup value for the device ID. | Required |
### Output
A JSON object containing multiple rows of result:
- has_error: True/False
- error: message/null
- other fields of device
![](https://files.readme.io/6af07ea-Screenshot_2020-03-30_at_10.08.10_PM.png "Screenshot 2020-03-30 at 10.08.10 PM.png")
## Search Processes
Search for processes associated with a custom IOC type.
### Input Field
Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.
| Input Name | Description | Required |
| :-------------------- | :------------------------------------------------------------------- | :------- |
| IOC Type | Select IOC Type. sha256/md5/domain/ipv4/ipv6. | Required |
| Indicator Values | Select column containing the string representation of the indicator. | Required |
| Device ID | Specify a host's ID to return only processes from that host. | Required |
| Max Number of Results | Number of results to fetch (default is 100 results). | Optional |
### Output
A JSON object containing multiple rows of result:
- has_error: True/False
- error: message/null
- result: Process details
## Get Process Details
Retrieve the details of a process that is running or that previously ran, given one or more process IDs.
### Input Field
Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.
| Input Name | Description | Required |
| :--------------------- | :---------------------------------------------------------------- | :------- |
| Process ID Column Name | Column name from the parent table to lookup value for process ID. | Required |
### Output
A JSON object containing multiple rows of result:
- has_error: True/False
- error: message/null
- other fields of process
![](https://files.readme.io/97e62e7-process.png "process.png")
## Search IOCs
Search custom IOCs in your account
### Input Field
Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.
| Input Name | Description | Required |
| :--------------- | :-------------------------------------------------------------------------------------------------------------------------------- | :------- |
| IOC Type | Select IOC Type. sha256/md5/domain/ipv4/ipv6. | Optional |
| Indicator Values | Select column containing the string representation of the indicator. | Optional |
| Indicator Policy | Select Indicator Policy. detect/none. | Optional |
| Source | The source where this indicator originated. This can be used for tracking where this indicator was defined. Limit 200 characters. | Optional |
| Created By | The user or API client who created the custom IOC. | Optional |
| Deleted By | The user or API client who deleted the custom IOC. | Optional |
| Include Deleted | Select the option to include deleted IOCs. | Optional |
| After Timestamp | Find custom IOCs created after this time (RFC-3339 timestamp). | Optional |
| Before Timestamp | Find custom IOCs created before this time (RFC-3339 timestamp). | Optional |
### Output
A JSON object containing multiple rows of result:
- has_error: True/False
- error: message/null
- result: IOC details
### Get IOC Details
Get IOC (Indicators of Compromise) details based on value and type.
### Input Field
Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.
| Input Name | Description | Required |
| :-------------------- | :----------------------------------------------------- | :------- |
| IOC Type | Select the value of IOC Type. | Required |
| IOC Value Column Name | Column name from parent table that contains IOC value. | |
### Output
A JSON object containing multiple rows of result:
- has_error: True/False
- error: message/null
- other fields of IOC
![](https://files.readme.io/bc7dd28-ioc_details.png "ioc details.png")
## Create Custom IOCs
Create new IOCs to block custom domains, hashes or ips
### Input Field
Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.
| Input Name | Description | Required |
| :--------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------- |
| Indicator Type | Select IOC Type. | Required |
| Indicator Value | The string representation of the indicator | Required |
| Action | Select Action | Required |
| Severity | Select Severity (Required for the Prevent and Detect action) | Required |
| Platforms | Jinja-Templated text containing CSVs of platforms that the indicator applies to. Example: mac,linux,{{os}} | Required |
| Source | Jinja-Templated text containing the source where this indicator originated. This can be used for tracking where this indicator was defined (Limit is 256 characters). Example: {{source}} | Optional |
| IOC Description | Jinja-Templated text containing descriptive label for this custom IOC. Example: {{description}} | Optional |
| Tags | Jinja-Templated text containing CSVs of tags to apply to the indicator. Example: test_tag,{{tags}} | Optional |
| Host Groups | Jinja-Templated text containing CSVs of host group IDs that the indicator applies to. Example: sbcd,{{host_groups}} | Optional |
| Applied Globally | Select option for applied globally (Default is False). | Optional |
| Expiration | Jinja-Templated text containing the value of the date on which the indicator will become inactive (format is 2021-04-17T09:12:36-00:00). Example: {{date}} | Optional |
### Output
A JSON object containing multiple rows of result:
- has_error: True/False
- error: message/null
## RTR Command: Single Host
Send Real-Time Response commands to a single host.
### Input Field
Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.
| Input Name | Description | Required |
| :------------- | :----------------------------------------------------------------------------------------- | :------- |
| Command Scope | Select Scope of RTR Command. RTR Read-Only Analyst/RTR Active Responder/RTR Administrator. | Required |
| Device ID | The Host Agent ID of the device on which an RTR command is to be sent. | Required |
| Command String | Full command string for the command. For example, cd C:\\some_directory. | Required |
### Output
A JSON object containing multiple rows of result:
- has_error: True/False
- error: message/null
- stdout: output response of running the RTR command on the host
- stderr: error response of running the RTR command on the host
![](https://files.readme.io/8a8ceab-Screenshot_2020-03-24_at_11.00.59_PM.png "Screenshot 2020-03-24 at 11.00.59 PM.png")
## Take Action on Devices
Take various actions on the hosts in your environment. Contain or lift containment on hosts. Delete or restore hosts.
### Input Field
Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.
| Input Name | Description | Required |
| : -------- | : -------- | : -------- |
| Action Name | Select one of the actions:
- Contain: This action contains the host, which stops any network communications to locations other than the CrowdStrike cloud and IPs specified in your containment policy.
- Lift Containment: This action lifts containment on the host, which returns its network communications to normal.
- Hide Host: This action will delete a host. After the host is deleted, no new detections for that host will be reported via UI or APIs.
- Unhide Host: This action will restore a host. Detection reporting will resume after the host is restored | Required |
| Device ID | The Host Agent ID of the device. | Required |
### Output
A JSON object containing multiple rows of result:
- has_error: True/False
- error: message/null
- result: Successfully executed action on host
![](https://files.readme.io/8e86216-screenshot-1_2 "screenshot-1 (2)")
## Search Incidents
Search for incidents by providing an FQL filter, sorting, and paging details.
### Input Field
| Input Name | Description | Required |
| : -------- | : -------- | : -------- |
| Filter | Filter criteria in the form of an FQL query. For more information about FQL queries, see documentation (<https://falcon.crowdstrike.com/support/documentation/45/falcon-query-language-fql>) in Falcon. | Optional |
| Sort | Enter the jinja-templated property to sort on, followed by a dot (.), followed by the sort direction, either "asc" or "desc". Example: `{{property}}.{{direction}}` or `start.desc` | Optional |
| Limit | Maximum number of incidents to return. (Default is 500).
Note: Crowdstrike allows us to fetch only 500 results in a single API call, therefore a value greater than 500 will involve multiple API calls and may take some time. Increase Action Timeout, in case of action, gets timed out. | Optional |
### Output
A JSON object containing multiple rows of result:
- has_error: True/False
- error: message/null
- result: incident-id of a matched incident
``` {json}{
"error": null,
"has_error": false,
"result": "inc:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
Get Incident Details
Get details on incidents by providing incident IDs.
Input Field
Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.
Input Name | Description | Required |
---|---|---|
Incident ID | Column name from the parent table to lookup value for the incident ID. | Â |
Output
A JSON object containing multiple rows of result:
has_error: True/False
error: message/null
other keys containing incident details
``` {json}{ "incident_id": "inc:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "incident_type": 1, "cid": "c2f696880d9b4371b9760f7536078690", "host_ids": [ "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" ], "hosts": [ { "device_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "cid": "c2f696880d9b4371b9760f7536078690", "agent_load_flags": "0", "agent_local_time": "2020-09-23T13:51:08.032Z", "agent_version": "5.37.11804.0", "bios_manufacturer": "Apple Inc.", "bios_version": "199.0.0.0.0", "config_id_base": "65994753", "config_id_build": "11804", "config_id_platform": "4", "external_ip": "xx.xx.xx.xx", "hostname": "my-backup.local", "first_seen": "2020-07-20T04:09:07Z", "last_seen": "2020-09-23T14:11:08Z", "local_ip": "127.0.0.1", "mac_address": "xx-xx-xx-xx-xx-xx", "major_version": "19", "minor_version": "6", "os_version": "Catalina (10.15)", "platform_id": "1", "platform_name": "Mac", "product_type_desc": "Workstation", "status": "normal", "system_manufacturer": "Apple Inc.", "system_product_name": "MacBookPro11,4", "modified_timestamp": "2020-09-23T14:12:17Z" } ], "created": "2020-09-23T14:32:32Z", "start": "2020-09-23T14:32:32Z", "end": "2020-09-23T14:54:21Z", "state": "closed", "assigned_to": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "assigned_to_name": "Saurabh Prakash", "status": 40, "tactics": [ "Persistence" ], "techniques": [ "Modify Existing Service" ], "objectives": [ "Keep Access" ], "modified_timestamp": "2020-09-23T14:45:15.179411419Z", "fine_score": 10, "error": null, "has_error": false }
## Falcon X Sandbox File Upload
Upload a file for sandbox analysis. After uploading, use `Falcon X Sandbox Analysis` to start analyzing the file.
Max file size: 100 MB.
Accepted file formats:
- Portable executables: .exe, .scr, .pif, .dll, .com, .cpl.
- Office documents: .doc, .docx, .ppt, .pps, .pptx, .ppsx, .xls, .xlsx, .rtf, .pub
- PDF
- APK
- Executable JAR
- Windows script component: .sct
- Windows shortcut: .lnk
- Windows help: .chm
- HTML application: .hta
- Windows script file: .wsf
- Javascript: .js
- Visual Basic: .vbs, .vbe
- Shockwave Flash: .swf
- Perl: .pl
- Powershell: .ps1, .psd1, .psm1
- Scalable vector graphics: .svg
- Python: .py
- Linux ELF executables
- Email files: MIME RFC 822 .eml, Outlook .msg.
### Input Field
| Input Name | Description | Required |
| :--------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------- |
| File ID | Column name from parent table that contains Devo SOAR File ID of the file to be uploaded. | Required |
| File Name | Column name from parent table that contains the File name of the file to be uploaded (defaults to Devo SOAR File ID, if the column is not selected or if the column value is empty). | Optional |
| Comment | [Jinja-templated](doc:jinja-template) descriptive comment to identify the file for other users. | Optional |
### Output
A JSON object containing multiple rows of result:
- has_error: True/False
- error: message/null
- sha256: SHA256 hash of the uploaded file as reported by CrowdStrike
- file_name: file name of file uploaded
``` {json}{
"error": null,
"has_error": false,
"sha256": "42a615198bcdfc72839936409c88af7ded125feabfec4753b307dc985aaba48f",
"file_name": "virus.exe"
}
Falcon X Sandbox Analysis
Submit either a URL or a sample SHA256 for sandbox analysis. For SHA256 analysis, a file needs to be uploaded to Falcon X first using the action Falcon X Sandbox File Upload
. This action waits for the analysis to complete for each row of input. Use the appropriate number of Thread Count
to make this action run faster (Recommended: max number of rows expected in the input table). As per Crowdstrike, the time required for each resource to be analyzed varies but is usually less than 15 minutes. Therefore, set Action Timeout
appropriately.
Input Field
Input Name | Description | Required |
---|---|---|
Type | Select type SHA256/ URL of analysis you want to run. | Required |
URL/SHA256 | Column name from parent table that contains URL or SHA256 of the file to analyze. Appropriate | Required |
Environment ID | The environment relevant to the URLs/SHA being analyzed. | Â |
- Linux (Ubuntu 16.04, 64 bit) | Â | Â |
- Android Static Analysis | Â | Â |
- Windows 10 64 bit | Â | Â |
- Windows 7 64 bit | Â | Â |
- Windows 7 32 bit | Required | Â |
Report Type | Select the type of report Detailed/Summarized you want to get. (Default is | Required |
Output
A JSON object containing multiple rows of result:
has_error: True/False
error: message/null
other keys representing the information in the report
``` {json}{ "id": "c2f696880d9b4371b9760f7536078690_d00d7b1b2c184d24a63d2c59d638a052", "cid": "c2f696880d9b4371b9760f7536078690", "created_timestamp": "2020-12-02T04:08:00Z", "origin": "apigateway", "sandbox": [ { "sha256": "dac3aaa58e1796468ee1b96d8c1c59c8192bff99b1622a1cf09e71ea2a8f8e72", "environment_id": 100, "environment_description": "Windows 7 32 bit", "submit_name": "dac3aaa58e1796468ee1b96d8c1c59c8192bff99b1622a1cf09e71ea2a8f8e72", "submission_type": "file", "verdict": "no specific threat", "file_type": "PDF document, version 1.6", "sample_flags": [ "Extracted Files" ] } ], "verdict": "no specific threat", "ioc_report_strict_csv_artifact_id": "65172ac1acf79d79958462f9123ee8f365f0e474c92185a2616adc2db2c19360", "ioc_report_broad_csv_artifact_id": "65172ac1acf79d79958462f9123ee8f365f0e474c92185a2616adc2db2c19360", "ioc_report_strict_json_artifact_id": "734de9198c5a6eae53e2a1a062e83ff9981d2c2a0cde4276a5235db5100cf795", "ioc_report_broad_json_artifact_id": "734de9198c5a6eae53e2a1a062e83ff9981d2c2a0cde4276a5235db5100cf795", "ioc_report_strict_stix_artifact_id": "205d28c146e45927ad04f99e6154a62682ec1f8fc5a62d8ff5005a8854c81717", "ioc_report_broad_stix_artifact_id": "205d28c146e45927ad04f99e6154a62682ec1f8fc5a62d8ff5005a8854c81717", "ioc_report_strict_maec_artifact_id": "0ad1af8daad615421fca9aa2bdbc3271a0225c3cee691f5d9fed2bacfa8e6190", "ioc_report_broad_maec_artifact_id": "0ad1af8daad615421fca9aa2bdbc3271a0225c3cee691f5d9fed2bacfa8e6190", "error": null, "has_error": false }
## Run GraphQL Query
Run graphQL query
### Input Field
Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.
| Input Name | Description | Required |
| :--------- | :---------------------------------------------------------------------------------- | :------- |
| Query | [Jinja-templated](doc:jinja-template) text containing the graphQL query to execute. | Required |
### Output
JSON containing the following items:
```Text json
{
"data":
{
"timeline":{
"edges":[{
"node":{
"__typename":"SomeControllerEvent",
"eventType":"EVENT1",
"eventSeverity":"MODERATE",
"timestamp":"2023-03-26T08:42:11.122Z",
"startTime":"2023-03-26T08:42:11.122Z",
"endTime":"2023-03-26T08:42:11.122Z",
"state":{
"dismissed":false,
"resolved":false
},
"domainControllerEntity":{
"hostName":"test.comm"
}
}
},{
"node":{
"__typename":"SomeControllerEvent",
"eventType":"EVENT2",
"eventSeverity":"MODERATE",
"timestamp":"2023-03-26T08:42:11.122Z",
"startTime":"2023-03-26T08:42:11.122Z",
"endTime":"2023-03-26T08:42:11.122Z",
"state":{
"dismissed":false,
"resolved":false
},
"domainControllerEntity":{
"hostName":"test.com"
}
}
}],
}
},
"error":null,
"has_error":false
}
Search Alerts
Search for alerts IDs that match a given filter.
Input Field
Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.
Input Name | Description | Required |
---|---|---|
Filter | Jinja-templated text containing the filter alerts using a filter query Eg: 'product: {{product_filter_column}}' | Â |
Offset | The first alert to return, where 0 is the latest alert. Use with 'Limit' to manage pagination of results. | Â |
Limit | The maximum number of alerts to return in this response (default: 100; max: 9999). Use with 'Offset' to manage pagination of results. | Â |
Output
JSON containing the following items:
``` {json}{ "error": null, "has_error": false, "resource": "eb8b5d1f79404eafaaafafee6b362ccc:cwpp:eb8b5d1f79404eafaaafafee6b362ccc:ffc50fb4a8eb463" }
Modify Alerts
Change the state and assignee of one or more alerts.
Input Field
Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.
Input Name | Description | Required |
---|---|---|
Alert ID | Jinja-templated text containing the value for alert Id. | Required |
Assignee | Jinja-templated text containing the value for uid of assignee to modify the alert with. An empty value will ignore the updation of assignee for that alert. | Â |
Status | Status to modify all the detection with | Â |
Comment | Jinja-templated comment to add to the alert. Comments are displayed with the alert in Falcon and usually used to provide context or notes for other Falcon users. A alert can have multiple comments over time. Eg: | Â |
Output
JSON containing the following items:
``` {json}{ "error": null, "has_error": false, "result": "Successfully updated" }
Modify Static Host Group
Modify static host group.
Input Field
Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.
Input Name | Description | Required |
---|---|---|
Host Group Body | Jinja-templated JSON containing the body of the static host group. Example {"name": "Test Group 45", "id": "XXXX"} | Required |
Output
JSON containing the following items:
``` {json}{ "errors": null, "has_error": false, "meta": { "query_time": 0.450510996, "trace_id": "trace-id" }, "error": null, "resources": [ { "id": "id", "group_type": "static", "name": "Test Group 140001", "description": "Test Group 140002 description", "created_by": "api-client-id", "created_timestamp": "2024-05-14T12:51:33.283695187Z", "modified_by": "api-client-id", "modified_timestamp": "2024-05-14T12:51:33.283695187Z" } ] }
Manage Static Host Group
Manage static host group
Input Field
Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.
Input Name | Description | Required |
---|---|---|
Host Group ID | Jinja-templated text containing the ID of the static host group. | Required |
Host Group Body | Jinja-templated JSON containing the body of the static host group. Example { "name": "filter", "value": "(device_id: ['e139xxxxxxxx5885','389axxxxxxxx5e80'])"} | Required |
Action Type | Select action. | Required |
Output
JSON containing the following items:
``` {json}{ "errors": null, "has_error": false, "meta": { "query_time": 0.450510996, "trace_id": "trace-id" }, "error": null, "resources": [ { "id": "id", "group_type": "static", "name": "Test Group 140001", "description": "Test Group 140002 description", "created_by": "api-client-id", "created_timestamp": "2024-05-14T12:51:33.283695187Z", "modified_by": "api-client-id", "modified_timestamp": "2024-05-14T12:51:33.283695187Z" } ] }
Search Static Host Group
Search static host group
Input Field
Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.
Input Name | Description | Required |
---|---|---|
FQL Filter | Jinja-templated text containing the fql filter. Example "group_type:'static'" | Optional |
Limit | The maximum number of host group to return in this response.(Maximum 500) | Optional |
Output
JSON containing the following items:
``` {json}{ "errors": null, "has_error": false, "meta": { "query_time": 0.450510996, "trace_id": id }, "error": null, "resources": [ { "id": "id1", "group_type": "static", "name": "Test Group 140002", "description": "Test Group 140001 description", "created_by": "api-client-id", "created_timestamp": "2024-05-14T12:51:33.283695187Z", "modified_by": "api-client-id", "modified_timestamp": "2024-05-14T12:51:33.283695187Z" }, { "id": "id2", "group_type": "static", "name": "Test Group 140002", "description": "Test Group 140002 description", "created_by": "api-client-id", "created_timestamp": "2024-05-14T12:51:33.283695187Z", "modified_by": "api-client-id", "modified_timestamp": "2024-05-14T12:51:33.283695187Z" } ] }
Get Host Details in Host Group
Get the details of member host in static host group
Input Field
Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.
Input Name | Description | Required |
---|---|---|
Host Group ID | Jinja-templated text containing the ID of the static host group. | Required |
Limit | The maximum number of host group to return in this response.(Maximum 500) | Optional |
Output
JSON containing the following items:
{json}{
"errors": null,
"has_error": false,
"meta": {
"query_time": 0.017531341,
"pagination": {
"offset": 3,
"limit": 3,
"total": 79040
},
"trace_id": "trace-id"
},
"error": null,
"resources": [
{
"device_id": "device-id",
"cid": "cid",
"agent_load_flags": "1",
"agent_local_time": "2024-05-14T01:40:01.040Z",
"agent_version": "7.11.18110.0",
"bios_manufacturer": "American.",
"bios_version": "5.6.5",
"build_number": "17763",
"config_id_base": "65994753",
"config_id_build": "18110",
"config_id_platform": "3",
"cpu_signature": "198265",
"cpu_vendor": "0",
"external_ip": "198.175.154.194",
"mac_address": "00-04-5f-a8-f8-d7",
"hostname": "108PERKINELMER",
"first_seen": "2022-08-26T19:50:38Z",
"last_login_timestamp": "2024-05-08T05:39:55Z",
"last_login_user": "TE1K1579",
"last_login_user_sid": "S-1-5-21-1547161642-484763869-725345543-921865",
"last_seen": "2024-05-14T06:12:20Z",
"local_ip": "64.1.1.2",
"machine_domain": "us.tycoelectronics.com",
"major_version": "10",
"minor_version": "0",
"os_version": "Windows 10",
"os_build": "17763",
"ou": [
"East",
"NCS",
"Workstations"
],
"platform_id": "0",
"platform_name": "Windows",
"policies": [
{
"policy_type": "prevention",
"policy_id": "policy-id",
"applied": true,
"settings_hash": "7c5959eb",
"assigned_date": "2024-01-05T16:30:17.751663753Z",
"applied_date": "2024-01-05T16:30:34.892376096Z",
"rule_groups": [
"rule-group-id1",
"rule-group-id2"
]
}
],
"reduced_functionality_mode": "no",
"device_policies": {
"prevention": {
"policy_type": "prevention",
"policy_id": "ploicy-id",
"applied": true,
"settings_hash": "7c5959eb",
"assigned_date": "2024-01-05T16:30:17.751663753Z",
"applied_date": "2024-01-05T16:30:34.892376096Z",
"rule_groups": [
"rule-group-id1",
"rule-group-id2"
]
}
},
"groups": [
"group-id1",
"group-id2"
],
"group_hash": "group hash",
"product_type": "1",
"product_type_desc": "Workstation",
"provision_status": "Provisioned",
"serial_number": "To be filled by O.E.M.",
"kernel_version": "10.0.17763.2114",
"os_product_name": "Windows 10 Enterprise LTSC 2019",
"chassis_type": "3",
"chassis_type_desc": "Desktop",
"last_reboot": "2024-05-14T05:39:37Z",
"connection_ip": "163.241.218.218",
"default_gateway_ip": "163.241.218.1",
"connection_mac_address": "00-04-5f-a8-f8-d6"
}
]
}
Release Notes
v2.2.11
- Bug Fix - Host ID not working inGet Host ID in Host Group
andGet Host Details in Host Group
.v2.2.9
- Added 8 new action:Create Static Host Group
,Modify Static Host Group
,Delete Static Host Group
,Manage Static Host Group
,Get Static Host Group
,Search Static Host Group
,Get Host ID in Host Group
andGet Host Details in Host Group
.v2.2.6
- Bug Fix forRTR Command: Single Host
v2.2.4
- Bug Fix - Issue with Default limit inSearch IOCs
fixed.v2.2.3
- Added 3 new action:Search Alerts
,Get Alert Details
andModify Alert
which support v2 API inplace of 3 deprecated actionsSearch Detection
,Get Detection Details
andModify Detection
respectively.v2.1.8
- Added support for pid which starts aspid:12341234
inGet Process Detail
action.v2.1.0
- Added 1 new action:Run GraphQL Query
.v2.0.0
- Updated architecture to support IO via filesystemv1.2.2
- Bug fix - Made severity field required in getCreate Custom IOC
action.v1.2.1
- Bug fix - Fix error message to show the original error/warnings from crowdstrike.