Skip to main content

Phishing - Generic v3

This Playbook is part of the Phishing Pack.#

Supported versions

Supported Cortex XSOAR versions: 6.1.0 and later.

This playbook investigates and remediates a potential phishing incident. It engages with the user that triggered the incident while investigating the incident itself.


  • Final remediation tasks are always decided by a human analyst.
  • Please do not rerun this playbook inside a phishing incident since it can produce an unexpected result. Create a new incident instead if needed.


This playbook uses the following sub-playbooks, integrations, and scripts.


  • Block Indicators - Generic v2
  • Phishing - Machine Learning Analysis
  • Detonate URL - Generic
  • Detect & Manage Phishing Campaigns
  • Detonate File - Generic
  • Process Email - Generic v2
  • Calculate Severity - Generic v2
  • Process Microsoft's Anti-Spam Headers
  • Extract Indicators From File - Generic v2
  • Entity Enrichment - Phishing v2
  • Email Address Enrichment - Generic v2.1
  • Search And Delete Emails - Generic v2


This playbook does not use any integrations.


  • AssignAnalystToIncident
  • CheckEmailAuthenticity


  • closeInvestigation
  • send-mail
  • setIncident

Playbook Inputs#

NameDescriptionDefault ValueRequired
RoleThe default role to assign the incident to.AdministratorRequired
SearchAndDeleteEnables the Search and Delete capability.
For a malicious email, the "Search and Delete" sub-playbook looks for other instances of the email and deletes them pending analyst approval.
BlockIndicatorsEnables the Block Indicators capability.
For a malicious email, the "Block Indicators" sub-playbook blocks all malicious indicators in the relevant integrations.
AuthenticateEmailDetermines whether the authenticity of the email should be verified using SPF, DKIM, and DMARC.TrueOptional
OnCallSet to True to assign only the user that is currently on shift.FalseOptional
SearchAndDeleteIntegrationDetermines which product and playbook is used to search and delete the phishing email from user inboxes.
- Set this to "O365" to use the "O365 - Security And Compliance - Search And Delete" playbook.
- Set this to "EWS" to use the "Search And Delete Emails - EWS" playbook.
- Set this to "Gmail" to use the "Search And Delete - Gmail" playbook.
O365DeleteTypeSets the method to delete emails in the "O365 - Security And Compliance - Search And Delete" playbook. Can be "Soft" (recoverable), or "Hard" (unrecoverable). Leave empty to decide manually for each email incident.
This is only applicable if the SearchAndDeleteIntegration input is set to "O365".
O365ExchangeLocationThe exchange location. Determines from where to search and delete emails using O365 playbooks. Use the value "All" to search all mailboxes. If no input provided, it will search and delete the email only from the recipient's mailboxes. Note - Searching all mailboxes may take a significant amount of time. This input is used only when searching and deleting emails in O365 and only applies if the SearchAndDeleteIntegration input is set to O365.Optional
O365AllowNotFoundSearchLocationsUsed only when searching and deleting emails in O365. Determines whether to include mailboxes other than regular user mailboxes in the compliance search.FalseOptional
O365ExchangeLocationExclusionUsed only when searching and deleting emails in O365. A comma-separated list of mailboxes/distribution groups to exclude when you use the value "All" for the O365ExchangeLocation input.Optional
CheckMicrosoftHeadersWhether to check Microsoft headers for BCL/PCL/SCL scores and set the "Severity" and "Email Classification" accordingly.TrueOptional
InternalDomainsA CSV list of internal domains. The list is used to determine whether an email address is internal or external.Optional
DetonateURLDetermines whether to use the "URL Detonation" playbook. Detonating a URL may take a few minutes.FalseOptional
InternalRangeThis input is used in the "Entity Enrichment - Phishing v2" playbook.
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 is: ",," (without quotes). If a list is not provided, uses the default list provided in the IsIPInRanges script (the known IPv4 private address ranges).
PhishingModelNameOptional - the name of a pre-trained phishing model to predict phishing type using machine learning.Optional
GetOriginalEmailFor forwarded emails. When "True", retrieves the original email in the thread.

You must have the necessary permissions in your email service to execute global search.

- For EWS: eDiscovery
- For Gmail: Google Apps Domain-Wide Delegation of Authority
- For MSGraph: As described in these links
DBotPredictURLPhishingURLsNumberThe number of URLs to extract from the email HTML and analyze in the "DBotPredictURLPhishing" automation.
This automation runs several checks to determine the score of the URLs found in the email, sets a verdict for URLs found as "Suspicious" or "Malicious", and adds these URLs as indicators. Based on the verdict, the incident severity is set (Medium for "Suspicious" and High for "Malicious").
- You need to install the "Phishing URL" pack to use this automation.
- False/True positives are possible.
- This automation may take a few minutes to run.
- To increase result accuracy, it is recommended to install and enable the "Whois" pack (optional).
EmailFileToExtractReported emails and emails retrieved during playbook execution can contain multiple nested email files. For example, an EML nested inside another EML file.
If multiple level files are detected, this field determines which file represents the phishing email.

For example:
User1 receives an email from Attacker. User1 attaches the email as an EML file and sends the email to User2.
User2 also attaches that email as a file, and reports it as phishing. In this case, the phishing email would be the "inner file" (as opposed to "outer file").

Possible values are: Inner file, Outer file, All files.
Inner file: The file at the deepest level is parsed. If there is only one file, that file is parsed.
Outer file: The file at the first level is parsed.
All files: All files are parsed. Do not use this option in the phishing playbook, as there should only be one phishing email per playbook run.
Inner fileOptional

Playbook Outputs#

There are no outputs for this playbook.

Playbook Image#

Phishing - Generic v3