What is PhishER?

KnowBe4's PhishER is a built-in Security Orchestration and Automation Response (SOAR) platform that can be used to manage all of the emails that your users report as suspicious or malicious. Using third-party analysis tools, PhishER breaks down each email into different components: Raw data, headers, attachments, and body. The email components are then examined for potentially malicious content or red flags that may indicate a phishing attack. Based on your organization's customized rules and actions, PhishER will automatically disposition each email so you can prioritize reported emails and respond quickly to real-life phishing attacks.

The purpose of this platform is to provide your organization with a way to evaluate all suspicious emails making it through to the inbox of your users. Using PhishER as a detective security control, your organization can identify potential threats and strengthen your security measures and defense-in-depth plan.

 

Jump to:
PhishER and SOAR
Prerequisites
Enable and Access PhishER
PhishER Workflow

• Dashboard
• Rooms
• Inbox
  
  • Inbox CSV Download
  • Inbox Columns
  • Selecting Messages
  • Inbox Filters
  • Message Details
  • Actions and Discussion
• Rules
  Actions

Reports

• Attachments
• Reporters
• Senders
• Domains and URLs
• Tags

Additional Resources

 

PhishER and SOAR

PhishER is a SOAR platform, meaning it coordinates and automates security tasks across connected security applications and processes. The use of PhishER rules and actions allow your organization to automate the review process of reported email threats making it through to the inbox of your users. Also, the PhishER platform allows integration with third-party analysis tools like VirusTotal and Syslog. The options for integration provide your organization with multiple security scans and evaluations from external security applications. KnowBe4 then displays all internal and external security results in one location - your PhishER platform.

Back to top

 

Prerequisites

PhishER is accessible through the KnowBe4 console. This means you must have an active KnowBe4 account to use this platform. Visit here to request a demo for PhishER.

An email forwarding system for your organization is also required so that all user-reported emails can be forwarded to the PhishER inbox for analysis. Using one of the following email forwarding methods is acceptable:

• Installation of the KnowBe4 Phish Alert Button (PAB).
• Manually forward all suspicious emails to a PhishER generated email address tied to your organization's PhishER platform. If you plan to use this method, refer to the PhishER Settings article for more information.

Back to top

 

Enable and Access PhishER

1. Log in to your KnowBe4 account and navigate to your Account Settings screen. This screen will look different depending on your subscription level.
2. Scroll down to the PhishER section and click on the Create PhishER Account button.
3. If you're using the PAB to forward user-reported emails to your PhishER inbox, add your reporting email addresses to the Forward non-simulated phishing emails to field located under the Phish Alert section of your Account Settings. Then, click the Update Account Info button.

   

Once PhishER is enabled in your account, the Go to PhishER button will be accessible through your KnowBe4 Account Settings. Clicking on this button will take you directly to your PhishER platform. Alternatively, you may access your PhishER platform by visiting: https://phisher.knowbe4.com

Back to top

 

PhishER Workflow

Above is a diagram of the PhishER workflow. We recommend reviewing the PhishER workflow before getting started to better understand how PhishER works.

The PhishER interface can be broken down into five main sections:

• Dashboard
• Rooms
• Inbox
• Rules
  Actions

 

Dashboard

When you enter the PhishER platform, the first screen you will see is the Dashboard. Here, a quick overview of your PhishER platform will appear. Below is a description of each chart and the data it displays:

1. Last 30 days By default, the Dashboard displays data and activity over the last 30 days. However, the Dashboard view can be adjusted to reflect a different date range by clicking on the Last 30 days button in the top-right. This will open the date range pop-up window (click to view).
2. Reported Messages The number of user-reported messages forwarded to your PhishER inbox.
3. Automatically Resolved The number of messages that were dispositioned based on the enabled rules and actions configured in your PhishER platform.
4. Manually Resolved The number of messages that were dispositioned without active rules and actions configured in your PhishER platform.
5. Unresolved The number of messages that have not been dispositioned in your PhishER platform.
6. Received Messages A bar graph used to display the number of user-reported messages forwarded to your PhishER inbox. The data is broken down by the number of messages reported each day or hour.
7. Messages Summary A pie chart comparison of PhishER messages in the Automatically Resolved, Manually Resolved, and Pending Review status.
8. Reported Messages by Category A line chart used to display how PhishER messages are being dispositioned. A message can be dispositioned in one of four ways: Unknown, Clean, Spam, or Threat. The data is broken down by the number of messages reported each day or hour for each category.
9. Categories A pie chart comparison of how PhishER messages are being dispositioned.
10. Reported Messages by Priority A line chart used to display the priority of PhishER messages. A message can be assigned one of the following priorities: Unknown, Low, Medium, High, or Critical. The data is broken down by the number of messages reported each day or hour for each priority type.
11. Priorities A pie chart comparison of how PhishER messages are prioritized. 

Back to top

 

Rooms

The Rooms section of PhishER consists of multiple filtered views of the messages in your PhishER inbox. Each filtered view is considered to be an "Emergency Room". An emergency room is a dynamic grouping of messages by a commonality that may help to identify a trend or potential threat in your inbox. Each PhishER emergency room is listed below:

• Overview Displayed as a quick-filter view of all emergency rooms, Overview provides you with the option to navigate to any emergency room you find the most threatening or in need of attention.
• Saved Queries A filtered view set to display all custom queries created from the inbox screen.
• Subject Lines A filtered view set to display and group messages by their subject line.
• Sender Address A filtered view set to display and group messages by the sender address tied to the message.
• Attachment Names A filtered view set to display and group messages by an attachment name found in the message.
• URL Domains A filtered view set to display and group messages by a URL domain embedded in the message.

Each group of messages inside of an emergency room is interactive, which means clicking on a specific group will take you to a filtered view of your inbox. A group of messages is established in an emergency room if a minimum of two messages meet the emergency room criteria.

Back to top

 

Inbox

The PhishER inbox is where all user-reported messages will be displayed. From here, you have the ability to manage all of the reported messages. Below is a description of each column of your PhishER inbox:

1. Category The grouping of messages based on disposition. A message can be categorized or dispositioned in one of four ways: Clean, Spam, Threat, or Unknown. Each message starts out as being Unknown until further analysis determines otherwise.
2. From The sender name associated with the original source of the message.
3. From Email The email address associated with the original source of the message.
4. Subject The text found in the Subject line of the original message.
5. First Disposition Date The timestamp of when the message was first dispositioned.
6. Current Disposition Date The timestamp of when the message's current disposition was applied.
7. Reported At The date and time of when the message was received by the PhishER inbox.
8. Reported By The name of the user who reported the message.
9. Reported By (Email) The email address of the user who reported the message.
10. Status The current state of PhishER analysis a message is in. A message can have a status of Received, In Review, or Resolved.
11. Tags A label attached to a message based on the message's attributes. There is no limit to the number of tags a message can have. Tags can be automatically or manually assigned to a message.
    • Tags are automatically assigned to a message when the message matches a rule containing that specific tag.
    • An admin can manually add a tag to a message from the Inbox or Message Detail screen of the PhishER inbox. Adding multiple tags to multiple messages can also be done from the inbox by mass selecting messages.
    • All tags are clickable. Clicking on a tag will create a tag-specific filtered view of the PhishER inbox.
12. Priority Indicates how urgent the review of a message may be due to the potential of it having malicious content. A message can be evaluated as having a Low, Medium, High, Critical, or Unknown priority. The priority of a message is originally determined by the rules and actions put in place by your organization, but an admin has the option to change the priority of a message at any moment.

 

Inbox CSV Download

You can download a CSV file of your inbox by clicking on the Download CSV button in the top-right. This CSV file will include all visible and hidden columns of your PhishER inbox. Expand the drop-down for more information.

Back to top

 

Inbox Columns

If you would like to show or hide specific inbox columns, select the gear icon in the top-right corner of the inbox screen. This will open the Inbox Table Settings (click to view) pop-up window. Here, you have the option to show or hide columns by checking or unchecking the box to the left of the column name.

Back to top

 

Selecting Messages

To select a message, click on the checkbox to the left of the message. When a message is selected, the Run drop-down (click to view) will appear in the top-left. From this drop-down, you can choose to run an option from the Replay, Email, or Actions section.

• 
  Replay
  All Rules
  This option allows you to run all of your custom rules against the selected message(s).
  All Rules and All Actions
  This option allows you to run all of your custom rules and actions against the selected message(s). If enabled, VirusTotal and/or PhishML will run against the selected message(s) as well.
  
  

  ---

  Email
  Send Custom Email
  This option allows you to send a custom email using the Email Template Editor. Click on Send Custom
  Email to open the template editor in a pop-up window. When your email is ready to be sent, click the Send button.
  
  

  ---

  Actions
  Example Custom Action
  A list of your custom actions will populate under the Actions section. Choose one of your custom actions to run against the selected message(s).
  
  

Alternatively, you may select a custom quick action from the QuickActions bar (click to view) to run against your selected message(s). Both options may be helpful if a message was received before an action was created.

You also have the option to set a Category, Status, and Priority (click to view) for the selected message(s) and add multiple tags.

Back to top

 

Inbox Filters

At the admin level, you have the ability to filter your inbox messages by the following options:

For more filter options, you can use the Search... box to filter your PhishER inbox using Lucene queries. Visit here for more information about how to use Lucene query syntax.

Also, you can save a customized filter by clicking on the Save query as room button. Visit our How to Create a PhishER Room article to learn more.

Back to top

 

Message Details

By clicking on an individual message in your PhishER inbox, you will enter the Message Details screen. At the top of the Message Details screen, the following message information will be listed:

• From: The name or email address of the original message source.
• Reply-to: The name or email address that will populate the to field of an email if the message is replied to.
• To: The name or email address of the original message recipient.
• CC: The email address(es) copied on the original message.
• Reported The date and time of when the message was reported by a user.
• Reported by The name or email address of the user who reported the message.

All email addresses present in this section of the Message Details screen are clickable. Clicking on an email address will take you to a filtered view of your inbox and display all of the messages tied to the specific email address.

Note: The timestamp displayed in the top-right is when the message was received by the reporter. A phish hook will appear next to the date and time if the message was reported using the KnowBe4 PAB. If the message was not reported using the PAB, a forwarding arrow will show.

For more details about the message, there are seven unique tabs:

Back to top

 

Actions and Discussion

Located to the right of the Message Details is the Actions and Discussion sidebar.

Actions

Under the Actions tab, you have the option to:

• Manually update the Category, Status, and Priority of the message.
• Run an action against the message by clicking on one of your custom QuickActions.
• Download a copy of the original email by clicking on the Download Original Email button. This download will be a .eml file. Note: If an email was manually forwarded to your PhishER inbox instead of being reported via the Phish Alert Button (PAB), the downloaded message will not include email headers.
• Using the Run drop-down, you can:
  Replay Run all rules or all rules and actions against the message
  Email Send a custom email
  Actions Run a single action against the message
• Add or remove a message's Assigned Tags.
• Delete the message by clicking on the Delete Message button.

Discussion

The Discussion feature provides a platform for PhishER admins to communicate with each other about a specific message. Behaving as a chat window, this method of communication may be useful for organizations with multiple admins managing the PhishER inbox. To post a comment in the Discussion tab:

1. Click in the Comment here text box to write your message.
2. Then, click on the Send button. Keep in mind, this comment will be visible to all admins with PhishER access.

Back to top

 

Rules

A rule is a logical expression used to disposition emails forwarded to the PhishER inbox. There are two types of rules:

• Custom Rules
  Rules your organization creates from scratch using the PhishER Rule Editor.
  System Rules
  A default set of rules provided by KnowBe4.

On the rules page, there are two tabs: Custom Rules and System Rules. Select a tab to view the Rules List. The Rules List contains all Custom or System Rules in your PhishER platform.

1. Name The unique name assigned to the rule.
2. Description A custom description of the rule. For best practices, we recommend providing a brief description of the rule's intended behavior.
3. Rule Target The part of a message the rule is run against.
4. Status The current state of the rule. A rule can be enabled or disabled. Use the toggle button to change the status of a rule. For a rule to run against emails in your PhishER inbox, it must be enabled.
5. Updated At The date and time of when the rule last had changes applied to it.
6. Matched Count The number of times the rule matched a message in your PhishER inbox.
7. Tags All of the tags attached to a message if it matches the rule.

For a filtered view of your Enabled or Disabled rules, use the Filter By Status drop-down in the top-right.

If you would like to create a custom rule, visit our How Do I Create a Rule and Action in PhishER? article for more information.

Back to top

 

Actions

When a message is assigned a tag, the tag will indicate how the message should be handled in PhishER. This handling process is considered an Action. All actions have to be created in your PhishER platform from the Post Actions screen.

1. Name The custom name of your action. We suggest selecting a descriptive name to easily recall the action's behavior.
2. Description A custom summary of the action.
3. Status The current state of an action. An action can have a status of Active or Inactive.
   
   • To change the status of an action, click on the action. Then, toggle the Active Status button in the top-right of the Action Details screen.
4. Last Updated At The date and time of when a change was last made to the action.
5. Trigger Tags All of the tags that will trigger this specific action to take place.

All of your actions will be listed on the Post Actions screen. Here, you have the option to arrange your actions by dragging and dropping them. It's important to arrange your actions in a meaningful order. This is because your actions will run in sequential order, from top to bottom.

If you would like to create an action, visit our How Do I Create a Rule and Action in PhishER? article for more information.

Back to top

 

Reports

The Reports screen will display four different dashboards of information:

• Attachments
• Reporters
• Senders
• Domains and URLs
• Tags

To view a report, click on the respective dashboard panel. Below is a description of each report and the information it provides. By default, each report displays data and activity over the last 30 days. However, the report view can be adjusted to reflect a different date range using the drop-down in the top-right of the report screen.

You can download a CSV file of each report by clicking on the Download CSV button in the top-right. This CSV file will include all the details of the report. If a report contains a row for messages grouped as Other, those messages will be listed individually in the CSV file.

 

Attachments

The Attachments report includes a chart of the information listed in the table below. As well, there is a Most Common Attachment Types pie chart visible to provide a proportional representation of the data found in the table.

File Extension	Message Count	Unknown	Clean	Spam	Threat
The attachment file extension type. Note: Only the top ten attachment file extension types will be displayed. The Other row indicates the number of additional attachment file extension types that were reported.	The number of messages in your PhishER inbox that have this file extension.	The number of messages in your PhishER inbox that have this file extension and determined to be Unknown.	The number of messages in your PhishER inbox that have this file extension and determined to be Clean.	The number of messages in your PhishER inbox that have this file extension and determined to be Spam.	The number of messages in your PhishER inbox that have this file extension and determined to be a Threat.

 

Reporters

The Reporters report includes a chart of the information listed in the table below. As well, there is a Most Common Reporters pie chart visible to provide a proportional representation of the data found in the table.

Reporter	Message Count	Unknown	Clean	Spam	Threat
The email address of the user responsible for reporting messages to the PhishER inbox. Note: Only the top ten reporters will be displayed. The Other row indicates the number of additional reporters that reported a message.	The number of messages the reporter has forwarded to the PhishER inbox.	The number of messages in your PhishER inbox that were forwarded by the reporter and determined to be Unknown	The number of messages in your PhishER inbox that were forwarded by the reporter and determined to be Clean.	The number of messages in your PhishER inbox that were forwarded by the reporter and determined to be Spam.	The number of messages in your PhishER inbox that were forwarded by the reporter and determined to be a Threat.

 

Senders

The Senders report includes a Most Common Senders pie chart to provide a proportional representation of the data found in the table.

Sender Domain	Message Count	Unknown	Clean	Spam	Threat
The sender domain tied to the original source of the reported message. Note: Only the top ten sender domains will be displayed. The Other row indicates the number of additional sender domains that were reported.	The number of messages forwarded to your PhishER inbox with this sender domain.	The number of messages forwarded to your PhishER inbox with this sender domain and determined to be Unknown.	The number of messages forwarded to your PhishER inbox with this sender domain and determined to be Clean.	The number of messages forwarded to your PhishER inbox with this sender domain and determined to be Spam.	The number of messages forwarded to your PhishER inbox with this sender domain and determined to be a Threat.

 

Domains and URLs

The Domains and URLs report includes a Most Common Domains and URLs pie chart to provide a proportional representation of the data found in the table.

Domain	Message Count	Unknown	Clean	Spam	Threat
The URL domain associated with a message in your PhishER inbox. Note: Only the top ten domains and URLs will be displayed. The Other row indicates the number of additional domains and URLs that were reported.	The number of messages forwarded to your PhishER inbox with this URL domain.	The number of messages forwarded to your PhishER inbox with this URL domain and determined to be Unknown.	The number of messages forwarded to your PhishER inbox with this URL domain and determined to be Clean.	The number of messages forwarded to your PhishER inbox with this URL domain and determined to be Spam.	The number of messages forwarded to your PhishER inbox with this URL domain and determined to be a Threat.

 

Tags

The Tags report includes a Most Common Tags pie chart to provide a proportional representation of the data found in the table.

Tag	Message Count	Unknown	Clean	Spam	Threat
The tag applied to at least one message in your PhishER inbox. Note: Only the top ten tags will be displayed. The Other row indicates the number of additional tags that were applied.	The number of messages in your PhishER inbox that include this tag.	The number of messages in your PhishER inbox with this tag and determined to be Unknown.	The number of messages in your PhishER inbox with this tag and determined to be Clean.	The number of messages forwarded to your PhishER inbox with this tag and determined to be Spam.	The number of messages in your PhishER inbox with this tag and determined to be a Threat.

Back to top

 

Additional Resources

• PhishER Settings
• How Do I Create a Rule and Action in PhishER?
• How to Create a PhishER Room
• How to Write YARA Rules
• How to Use Lucene Query Syntax

Back to top