/rapid7-siem | Type: Application | PCID required: Yes
Tools
rapid7_siem_add_collector
Add Collector Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
deployment_type | string | No | — | Optional indication of how the collector is deployed. |
key | string | Yes | — | The registration key for the collector. Must be unique, and a valid UUID. |
name | string | Yes | — | The name for the new collector. Must be unique. |
rapid7_siem_add_indicators
Add indicators to a Community Threat Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | Yes | — | The key of a Community Threat for which the indicators are going to be added. |
format | string | Yes | — | The input format. |
body | string | Yes | — | The request body format should be one of JSON, STIX XML, CSV, or multi-part file data. The maximum payload size is 50 MB. |
rapid7_siem_assign_user_to_investigation
Assign user to investigation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | The ID or RRN of the investigation to assign the user to. |
user_email_address | string | Yes | — | The email address of the user to assign to this investigation, used to log into the Insight Platform. |
rapid7_siem_bulk_close_investigations
Close investigations in bulk Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
alert_type | string | No | — | The category of alerts that should be closed. This parameter is required if the source is ALERT and ignored for other sources. This value must exactly match the alert type returned by the List Investigations response. |
detection_rule_rrn | string | No | — | The RRN of the detection rule. Investigations will only be closed that are associated with this detection rule. If a detection rule RRN is given, the alert_type is required to be ‘Attacker Behavior Detected’. |
from | string | Yes | — | An ISO formatted timestamp. Only investigations whose createTime is after this date will be closed. |
max_investigations_to_close | integer | No | — | An optional, maximum number of alerts to close with this request. If this parameter is not specified, then there is no maximum. If this limit is exceeded, then a 400 error response is returned. The minimum value is 0. |
source | string | Yes | — | The name of an investigation source. Only investigations from this source will be closed. If the source is ALERT, an alert type must be specified as well. |
to | string | Yes | — | An ISO formatted timestamp. Only investigations whose createTime is before this date will be closed. |
rapid7_siem_create_comment
Create comment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
attachments | string[] | No | — | An array of attachment RRNs to associate with the comment. |
body | string | No | — | The body of the comment. |
target | string | Yes | — | The target of the comment, which determines where it will appear within InsightIDR. |
rapid7_siem_create_community_threat
Create a Community Threat Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
body | string | Yes | — | The request body format must be in JSON. The maximum payload size is 50 MB. |
rapid7_siem_delete_attachment
Delete an attachment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
rrn | string | Yes | — | The RRN of the attachment. |
rapid7_siem_delete_comment
Delete a comment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
rrn | string | Yes | — | The RRN of the comment. |
rapid7_siem_delete_community_threat
Delete a Community Threat Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | Yes | — | The key value |
reason | string | No | — | The reason value |
rapid7_siem_download_attachment
Download attachment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
rrn | string | Yes | — | The RRN of the attachment. |
rapid7_siem_find_account_by_rrn
Get account by RRN Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
rrn | string | Yes | — | The RRN of the account. |
rapid7_siem_find_asset_by_rrn
Get asset by RRN Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
rrn | string | Yes | — | The RRN of the asset. |
rapid7_siem_get_attachment
Get attachment information Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
rrn | string | Yes | — | The RRN of the attachment. |
rapid7_siem_get_comment
Get comment by rrn Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
rrn | string | Yes | — | Return a comment with this rrn. |
rapid7_siem_get_local_account_by_rrn
Get local account by RRN Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
rrn | string | Yes | — | The RRN of the local account. |
rapid7_siem_get_metrics
Retrieve health metrics by org Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
index | integer | No | — | The optional, 0 based index of the page to retrieve. Must be an integer greater than or equal to 0. |
size | integer | No | — | The optional size of the page to retrieve. Must be an integer greater than 0 or less than or equal to 100. |
resourceTypes | string | No | — | An optional, comma-separated set of resource types. Only resources whose type matches one of the entries in the list are returned. If this parameter is omitted, health metrics with any resource type may be returned. |
orgId | string | No | — | Optional organization ID to get metrics for. If not specified, metrics for the user’s current organization will be returned. User must have access to the specified organization. |
rapid7_siem_get_user_by_rrn
Get user by RRN Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
rrn | string | Yes | — | The RRN of the user. |
rapid7_siem_list_attachments
List attachments Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
target | string | Yes | — | Return attachments with this target. |
index | integer | No | — | The optional, 0 based index of the page to retrieve. Must be an integer greater than or equal to 0. |
size | integer | No | — | The optional size of the page to retrieve. Must be an integer greater than 0 or less than or equal to 100. |
rapid7_siem_list_comments
List comments Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
target | string | Yes | — | Return comments with this target. |
index | integer | No | — | The optional 0, based index of the page to retrieve. Must be an integer greater than or equal to 0. |
size | integer | No | — | The optional size of the page to retrieve. Must be an integer greater than 0 or less or equal to 100. |
rapid7_siem_list_investigations
List investigations Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
index | integer | No | — | The optional, 0 based index of the page to retrieve. Must be an integer greater than or equal to 0. |
size | integer | No | — | The optional size of the page to retrieve. Must be an integer greater than 0 or less then or equal to 1000. |
statuses | string | No | — | An optional, comma-separated set of investigation statuses. Only investigations whose status matches one of the entries in the list will be returned. If this parameter, is omitted investigations with any status may be returned. |
start_time | string | No | — | An optional, ISO-formatted timestamp. Only investigations whose createTime is after this date will be returned by the API. If this parameter is omitted, investigations with any create_time may be returned. |
end_time | string | No | — | An optional, ISO-formatted timestamp. Only investigations whose createTime is before this date will be returned by the API. If this parameter is omitted, investigations with any create_time may be returned. |
rapid7_siem_replace_indicators
Replace indicators for a Community Threat Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | Yes | — | The key of a Community Threat for which the indicators are going to be added. |
format | string | Yes | — | The input format. |
body | string | Yes | — | The request body format should be one of JSON, STIX XML, CSV, or multi-part file data. The maximum payload size is 50 MB. |
rapid7_siem_search_accounts
Search accounts Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
index | integer | No | — | The optional, 0 based index of the page to retrieve. Must be an integer greater than or equal to 0. |
size | integer | No | — | The optional size of the page to retrieve. Must be an integer greater than 0 or less than or equal to 1000. |
search | object[] | No | — | The criteria for which entities to return. |
sort | object[] | No | — | The sorting information. |
rapid7_siem_search_assets
Search assets Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
index | integer | No | — | The optional, 0 based index of the page to retrieve. Must be an integer greater than or equal to 0. |
size | integer | No | — | The optional size of the page to retrieve. Must be an integer greater than 0 or less than or equal to 1000. |
search | object[] | No | — | The criteria for which entities to return. |
sort | object[] | No | — | The sorting information. |
rapid7_siem_search_local_accounts
Search local accounts Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
index | integer | No | — | The optional, 0 based index of the page to retrieve. Must be an integer greater than or equal to 0. |
size | integer | No | — | The optional size of the page to retrieve. Must be an integer greater than 0 or less than or equal to 1000. |
search | object[] | No | — | The criteria for which entities to return. |
sort | object[] | No | — | The sorting information. |
rapid7_siem_search_users
Search users Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
index | integer | No | — | The optional, 0 based index of the page to retrieve. Must be an integer greater than or equal to 0. |
size | integer | No | — | The optional size of the page to retrieve. Must be an integer greater than 0 or less than or equal to 1000. |
search | object[] | No | — | The criteria for which entities to return. |
sort | object[] | No | — | The sorting information. |
rapid7_siem_set_status
Set the status of an investigation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | The ID or RRN of the investigation to change the status of. |
status | string | Yes | — | The new status for the investigation (case-insensitive). |
rapid7_siem_update_comment
Update comment visibility Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
rrn | string | Yes | — | The RRN of the comment. |
visibility | string | Yes | — | The new visibility for the comment (case insensitive). |
rapid7_siem_upload_attachment
Upload attachment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filedata | string[] | Yes | — | The filedata value |

