Brute Force Investigation - Generic
This playbook investigates a "Brute Force" incident by gathering user and IP information, calculating the incident severity based on the gathered information and information received from the user, and performs remediation.
The playbook handles the following use-cases:
- Brute Force IP Detected - A detection of source IPs that are exceeding a high threshold of rejected and/or invalid logins.
- Brute Force Increase Percentage - A detection of large increase percentages in various brute force statistics over different periods of time.
- Brute Force Potentially Compromised Accounts - A detection of accounts that have shown high amount of failed logins with one successful login.
Used Sub-playbooks:
- IP Enrichment - Generic v2
- Account Enrichment - Generic v2.1
- Calculate Severity - Critical Assets v2
- Isolate Endpoint - Generic
- Block Indicators - Generic v2
Dependencies#
This playbook uses the following sub-playbooks, integrations, and scripts.
Sub-playbooks#
- Account Enrichment - Generic v2.1
- Isolate Endpoint - Generic
- IP Enrichment - Generic v2
- Block Indicators - Generic v2
- Calculate Severity - Critical Assets v2
Integrations#
- Builtin
Scripts#
- GenerateInvestigationSummaryReport
Commands#
- send-mail
- setIncident
- ad-expire-password
- ad-disable-account
- ad-enable-account
- closeInvestigation
Playbook Inputs#
| Name | Description | Default Value | Source | Required |
|---|---|---|---|---|
| username | Username of the user who is suspected of the activity. | username | incident | Required |
| src | Source endpoint that triggered the incident. | src | incident | Required |
| traps_endpoint_id | Traps endpoint ID, used for endpoint isolation. | agentid | incident | Optional |
| logins_count_threshold | The threshold for number of logins, from which the investigation and remediation will start automatically without waiting for the user"s reply. Default is 10. | 10 | Optional | |
| severity_threshold | The threshold for the severity value from which an automatic remediation takes place. Specify the severity number (default is Critical): 0 - Unknown, 0.5 - Informational. 1 - Low, 2 - Medium, 3 - High, 4 - Critical | 4 | Optional | |
| internal_range | A list of internal IP ranges to check IP addresses against. The list should be provided in CIDR notation, separated by commas. An example of a list of ranges would be: '172.16.0.0/12,10.0.0.0/8,192.168.0.0/16' (without quotes). If a list is not provided, will use default list provided in the IsIPInRanges script (the known IPv4 private address ranges). | Optional | ||
| critical_users | Critical users, separated by comma. | Optional | ||
| critical_endpoints | Critical endpoints, separated by comma. | Optional | ||
| critical_groups | Critical groups, separated by comma. | Optional | ||
| CustomBlockRule | This input determines whether Palo Alto Networks Panorama or Firewall Custom Block Rules are used. | |||
| Specify True to use Custom Block Rules. | True | Optional | ||
| AutoCommit | This input determines whether Palo Alto Networks Panorama or Firewall Static Address Groups are used. | |||
| Specify the Static Address Group name for IP handling. | No | Optional | ||
| IPListName | This input determines whether Palo Alto Networks Panorama or Firewall External Dynamic Lists are used for blocking IPs. | |||
| Specify the EDL name for IP handling. | Demisto Remediation - IP EDL | Optional | ||
| DAG | This input determines whether Palo Alto Networks Panorama or Firewall Dynamic Address Groups are used. | |||
| Specify the Dynamic Address Group tag name for IP handling. | Optional | |||
| StaticAddressGroup | This input determines whether Palo Alto Networks Panorama or Firewall Static Address Groups are used. | |||
| Specify the Static Address Group name for IP handling. | Optional | |||
| URLListName | URL list from the instance context with which to override the remote file. | Demisto Remediation - URL EDL | Optional | |
| CustomURLCategory | Custom URL Category name. | Demisto Remediation - Malicious URLs | Optional | |
| type | Custom URL category type. Insert "URL List"/ "Category Match". | Optional | ||
| device-group | Device group for the Custom URL Category (Panorama instances). | Optional | ||
| categories | The list of categories. Relevant from PAN-OS v9.x. | Optional | ||
| EDLServerIP | This input determines whether Palo Alto Networks Panorama or Firewall External Dynamic Lists are used: |
* The IP address of the web server on which the files are stored. * The web server IP address is configured in the integration instance. | | | Optional |
Playbook Outputs#
There are no outputs for this playbook.
Extra Information#
Through the remediation process, the playbook checks whether one of the attempted logins was successful. If so, it raises the incident severity, which also affects the decision whether to isolate the destination endpoint. This check is done through the 'Successful Login' incident field which is associated to the 'Brute Force' incident type. As part of the mapping process and for the playbook to complete the logic, users should map this field value to be 'True' if a successful login occurred, and to 'False' if it hasn't.
Playbook Image#
