--- title: Create security incidents from User Reported Phishing emails description: Use this feature to create security incidents from user reported phishing emails.The User Reported Phishing feature available is an enhanced version of the existing user reported phishing functionality. See Create rules to validate user-reported phishing attacks.As a user with the sn\_si.admin role, you can define email matching rules to filter user reported phishing emails based on specific criteria. For example, you can define a rule where all emails sent either directly or through the Report Phish button to security@acme.com are categorized as user reported phishing emails.Define the header information that must be captured from user reported phishing emails.User reported phishing emails are converted to security incidents based on the email matching rules that have been defined.The Transform Phishing Email to Security Incident flow converts or transforms phishing email records to security incidents.Phishing email records stored in the sn\_si\_phishing\_email table are converted to security incidents records.You can view security incidents associated with the phishing email records in the Security Analyst Workspace.This section covers some of the frequently asked questions about the enhanced User Reported Phishing feature. locale: en-US canonical_url: https://www.servicenow.com/docs/r/australia/security-management/security-incident-response/urp-about.html release: australia product: Security Incident Response classification: security-incident-response topic_type: concept last_updated: "2026-03-12" reading_time_minutes: 24 breadcrumb: [Security incident automatic creation, Security incident creation, Security Incident Response, Enterprise security case management applications, Security Operations] --- # Create security incidents from User Reported Phishing emails Use this feature to create security incidents from user reported phishing emails. The enhanced User Reported Phishing functionality includes aggregation capabilities, email header extraction, and configuration. - You can report phishing emails in multiple ways: - Emails can be forwarded as attachments. - If the **PhishAlarm** plugin \(previously known as Wombat\) is configured with the Microsoft Outlook client, you can: - Select the **Report Phish** button. - Forward phishing emails from a mobile device using the **Report Phish** option. \[Omitted image "urp-report-phish.png"\] Alt text: Report phishing emails - You can upload a phishing email \(in .eml format\). \[Omitted image "urp-report-phish-1.png"\] Alt text: Report phishing emails as attachments - User reported phishing includes **aggregation business logic** that identifies duplicate phishing emails reported by users in an organization. Users can use this capability to: - Aggregate duplicate or similar user reported phishing incidents \(company initiated phishing campaigns\). - Avoid triaging duplicate user reported phishing incidents and reduce the manual effort involved in consolidating incidents. - Enable security analysts to work on a single user reported phishing incident. - Provides phishing email headers within the user reported phishing incident. - Security analysts can scan for key email header information within the incident. - Manual effort in gathering header information from other sources is no longer required. - The original phishing email submitted is stored as a **Phishing Email Record** in a new table. - Security analysts can view details of the original phishing email like phishing email content, headers, origin. - Security administrators can configure and make certain enhancements that include: - Configurations to extract email headers from the email body \(**Report Phish** submissions\). - Filters to capture selected headers. - Configurations to handle parent-child incident association when duplicate phishing email records are identified. - Flow Designer configurations to modify aggregation business logic based on the requirements. ## Set up ingestion rules for user reported phishing As a user with the `sn_si.admin` role, you can define email matching rules to filter user reported phishing emails based on specific criteria. For example, you can define a rule where all emails sent either directly or through the Report Phish button to `security@acme.com` are categorized as user reported phishing emails. For more information, see [Set up ingestion rules for User Reported Phishing](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/security-incident-response/urp-about.md). ## Define user reported phishing properties Define the header information that needs to be captured from user reported phishing emails. For more information, see [Define User Reported Phishing properties](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/security-incident-response/urp-about.md). ## Phishing email records created from user reported phishing emails User reported phishing emails are converted to security incidents based on the email matching rules that have been defined. For more information, see [Phishing email records created from user reported phishing emails](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/security-incident-response/urp-about.md). ## Transform phishing email to security incident The Transform Phishing Email to Security Incident flow converts or transforms phishing email records to security incidents. For more information, see [Transform user-reported phishing emails to security incidents](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/security-incident-response/urp-about.md). ## Security incident records created from phishing email records View the security incident record details including the Related Lists, Worknotes, and other important information. For more information, see [Security incident records created from phishing email records](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/security-incident-response/urp-about.md). ## Required components and plugins The User Reported Phishing feature available is an enhanced version of the existing user reported phishing functionality. See **Create rules to validate user-reported phishing attacks**. **Important Installation Instructions** This enhancement replaces the existing User Reported Phishing design. The new design includes the following updates: - The existing **User Reported Phishing** email inbound actions \(Type = Forward and Type = New\) have been disabled. - A new **Create Phishing Email** inbound action is now available. - The [Transform user-reported phishing emails to security incidents](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/security-incident-response/urp-about.md) is a new flow that contains the security incident creation and aggregation business logic for the new design. You must activate this flow for the new design to take effect. - The existing User Reported Phishing rules have been preserved during the upgrade. **Note:** If you use custom email inbound actions and custom workflows for user reported phishing submissions, you must review both the old and new designs for conflicting or overlapping functionalities. **User Reported Phishing Enhancement details**: The following are the details of the enhancement: - Reporting the phishing email in multiple ways: See [Create security incidents from User Reported Phishing emails](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/security-incident-response/urp-about.md) for the details. The phishing email is then moved to the `sn_si_phishing_email` table. - Creating phishing email records: If the email-matching rules are met \(See [Set up ingestion rules for User Reported Phishing](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/security-incident-response/urp-about.md)\), the **Create Phishing Email** inbound action creates a phishing email record. The parsed email headers are stored in the `sn_si_phishing_email_header` table and associated with the phishing email as a related list. - Aggregating similar phishing records into a single security incident: The [Transform user-reported phishing emails to security incidents](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/security-incident-response/urp-about.md) flow creates security incidents from the phishing email records and aggregates similar records into a single incident. The aggregation conditions can be modified as required in this flow. **Note:** - The **User Reported Phishing** inbound actions available prior to the Security Incident Response 9.0 release are now disabled. Security incidents are no longer created through the disabled inbound actions. - The Security Operations spoke application must be installed for the new design to take effect. This includes the [Transform user-reported phishing emails to security incidents](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/security-incident-response/urp-about.md) flow which is available in an inactive state by default. Activate this flow to create security incidents from the phishing email records. To use the enhanced User Reported Phishing feature, the following plugins and components are required: - Security Support Common \(`sn_sec_cmn`\): Includes: - Inbound action - New EmailUserReportedPhishing script - Ingestion Rules table - Security Incident Response \(sn\_si\): Includes: - Security incident table \(sn\_si\_incident\) - Security phishing emails table \(sn\_si\_phishing\_email\) - Security phishing email headers table \(sn\_si\_phishing\_email\_header\) - EML upload record producer - Security Operations Spoke Flows and subflows for aggregating emails and transforming phishing emails to security incidents. The following figure shows the new phishing emails table with references to the matched URP rule and target security incident record \(sn\_si\_incident\). \[Omitted image "sec-inc-resp-datamodel.png"\] Alt text: URP Data model ## Set up ingestion rules for User Reported Phishing As a user with the `sn_si.admin` role, you can define email matching rules to filter user reported phishing emails based on specific criteria. For example, you can define a rule where all emails sent either directly or through the Report Phish button to `security@acme.com` are categorized as user reported phishing emails. ### Before you begin Role required: sn\_si.admin ### Procedure 1. Navigate to **All** > **Security Operations** > **Email Processing** > **Ingestion Rules - User Reported Phishing**. 2. Select **New** to create a new Email Matching Rule. 3. Enter a name and define one or more conditions for the rule. You can configure **Rule Type** and select its value: - **Allow**: If the condition matches for an incoming email, a security incident is created. - **Deny**: If the condition matches for an incoming email, a security incident is not created. **Note:** Incoming emails are evaluated for the deny rules first irrespective of the **Order** value. 4. Select **Submit** to save the rule. The following are some sample rules: - **To Rule**: Filter emails that have been sent directly or forwarded to `security@example.com` email id. \[Omitted image "urp-torule-example.png"\] Alt text: Define ToRule - **User ID Rule**: Filter emails that have been sent from a specific email id. \[Omitted image "urp-phishbox-example.png"\] Alt text: Define User ID Rule ## Define User Reported Phishing properties Define the header information that must be captured from user reported phishing emails. ### Before you begin Role required: sn\_si.admin ### About this task Use these options to configure the following user reported phishing settings. - Configuration to extract email headers from the email body. \(**Report Phish** submissions.\) - Filter to select headers. - Enable or disable parent-child association. ### Procedure 1. Navigate to **All** > **Security Operations** > **Email Processing** > **User Reported Phishing Properties**. \[Omitted image "urp-phishing-email-properties.png"\] Alt text: User Reported Phishing Properties 2. Specify the configuration for extracting email headers from the email body: - Enter a string that identifies the beginning of the email header. - Enter a string that identifies the end of the email header. **Note:** Apply these settings only to headers captured as part of the email body of the phishing email. For instance, if the **PhishAlarm** plugin \(previously known as Wombat\) has configured with the Microsoft Outlook client, when the user selects the **Report Phish** button, the email headers are captured as per the configuration defined here. The header information is not captured if the phishing email is forwarded as an attachment. 3. Specify filters to eliminate headers that are not required for investigating the security incident. Enter a comma-separated list of email headers that must be captured from the user reported phishing email. If you don't specify any value here, all the header information is captured. 4. Enable or disable parent-child association. By default, the **Yes** option is enabled. Select **Yes** to indicate that child security incidents must be created when user reported phishing emails are aggregated. If you select **No**, child security incidents are not created, but the user reported phishing emails are associated with the security incident and the security incident record is updated. See [Transform user-reported phishing emails to security incidents](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/security-incident-response/urp-about.md) for more information on how the child security incidents are created. 5. Enable or disable the option to display the phishing email content in HTML format. By default, the **Yes** option is enabled. Select **Yes** to display the phishing email content in HTML format. If you select **No**, the email content in HTML format will not be visible within a phishing record. ## Phishing email records created from user reported phishing emails User reported phishing emails are converted to security incidents based on the email matching rules that have been defined. When a new phishing email is reported, the following actions take place: - An email record is created in the `sys_email` table. - The **Create Phishing Email** inbound action runs on the email record and uses the Email Matching Rules \(see [Set up ingestion rules for User Reported Phishing](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/security-incident-response/urp-about.md)\) to determine if it is a phishing email. **Note:** The email is first verified with all the email matching rules where the **Rule Type** is set to **Deny**. If the email matches to the condition for any of the deny rule, an audit record is created in the `sn_si_phishing_email_deny_audit` table. A security incident isn’t created for such email. - When the email is identified as a phishing email, and it matches to an email matching rule where the **Rule Type** is set to **Allow**, a phishing email record is created in the `sn_si_phishing_email` table. - Finally, the [Transform user-reported phishing emails to security incidents](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/security-incident-response/urp-about.md) flow is applied to convert the phishing email record to a security incident. To view the email details, navigate to **Security Incident** > **Phishing Emails** > **Show All Phishing Emails**. A list of phishing email records are displayed. Select the date link in the Created column to view the email record. \[Omitted image "urp-torule-email-record.png"\] Alt text: Phishing email with To Rule
| Field Name | Description |
|---|---|
| Number | The number assigned to the user-reported phishing email. |
| Subject | The subject of the email. The subject rule is useful in simulated phishing campaigns or tests. In this case, organizations send deceptive emails to their own staff to test their response to phishing and similar email attacks. In simulated phishing email tests, if the Microsoft Outlook email client with the **PhishAlarm** plugin \(previously known as Wombat\) is being used, the user can select the **Report Phish** button to report the phishing email. The email is sent to the Security Operations team with **Simulated Phishing** appended to the Subject of the email. This is used to identify the email as a simulated phishing email. |
| From | The email address from where this phishing email originated. This information is available if the phishing email is forwarded as an .EML file attachment or if the original headers are embedded in the email. If the user forwarded the phishing email directly, the From address may not be available. |
| Reported by | The email id of the user who reported this phishing email. Select the **Information** icon to view additional details. |
| Message id | The id assigned to the message. |
| Matched Ingestion rule | The User Reported Phishing rule that is to be applied on this email. |
| See [Set up ingestion rules for User Reported Phishing](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/security-incident-response/urp-about.md) for more information on defining email matching rules. | |
| State | When a new phishing email record is created in the `sn_si_phishing_email` table, the State field is set to **New**. When this email record is converted to a security incident \(see [Transform user-reported phishing emails to security incidents](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/security-incident-response/urp-about.md)\), the State field is updated to **Processed**. |
| Header origin | This field indicates how the email headers originated or how the user reported the phishing email:- **Email Header**: The user forwarded the phishing email to the security operations team. - **Email Text Body:** - The user selected the **Report Phish** option \(if the **PhishAlarm** plugin \(previously known as Wombat\) has been configured with the email client\). - Based on the User Reported Phishing rule defined, the phishing email is forwarded to the security operations team. - **EML Attachment Header**: - Attachment: The user forwarded the email as an attachment \(.EML file\). - Service catalog submission: The user downloaded the email as a .EML file to the desktop and then uploaded it to a specified location. The security incident is then created from the email. - **EML Attachment Body**: - The user selected the **Report Phish** option \(if the **PhishAlarm** plugin \(previously known as Wombat\) has been configured with the email client\). - Based on the User Reported Phishing rule defined, the phishing email is forwarded as an attachment to the security operations team. |
| Security Incident | This field is blank when the user-reported-phishing email is first reported. When the [Transform user-reported phishing emails to security incidents](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/security-incident-response/urp-about.md) flow has been executed, this email is converted to a security incident record and the number of this record is displayed here.**Note:** Security incident is only created for the emails, which matches to an email matching rule where the **Rule Type** is set to **Allow**. |
| Raw headers | This field shows the complete header information extracted from the email as defined in the [Define User Reported Phishing properties](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/security-incident-response/urp-about.md) page. The headers are parsed into key value pairs and displayed in the Phishing Email Headers list. |
| \[Omitted image "urp-phishing-email-headers.png"\] Alt text: Phishing email headers | |
| Body | Body of the user-reported phishing email. |