Skip to main content

Mail Settings

PhishingBox Support
  • Updated

Overview

The Mail Settings page shows you where system and phishing email will come from. You can connect PhishingBox to a mail server via IMAP to log reported actions for forwarded emails or to monitor replies from reply-to phishing email templates. You can connect to a mail server via SMTP in order to send PhishingBox system emails or phishing emails from your own mail server.

To reach the Mail Settings page, navigate to Administration > Settings > Mail Settings.

Screenshot_2022-10-19_092006.png

  1. General
  2. Security Inboxes
  3. Reply Inboxes
  4. SMTP (Outgoing)
  5. Custom Active Directory App

General

The General tab on the Mail Settings page shows an overview of the system email addresses, account manager, and saved system email and phishing email settings including the From Name for school (Testing Center) and PhishingBox emails system emails.

The System Email Addresses drop-down is the From and Reply-To address for all system emails. To use a custom System Email Address, you should also set up a custom SMTP connection as well (deliverability can be impacted if you are using a custom email address without an SMTP server). For reseller accounts, the parent account's selection will be displayed as the default selected option in sub-accounts.

You can send yourself a test system/phishing email by clicking the Send Test Email button.

 

Screenshot_2023-03-14_080715.png

 

Custom System Email From - This field specifies the email address from which system emails will be sent.

Custom System Email Reply-To - This field specifies the email address in which will receive replies to system emails.

Custom Email Header - This is the email header added to phishing emails to help them get past email security and replaces the default X-PHISHTEST. The safelisting settings in your email client will need to be adjusted to accept your settings.

Custom Email Header Value - This is the value for the custom email header added to phishing emails to help them get past email security. The safelisting settings in your email client will need to be adjusted to accept your settings. 

Add DKIM to Campaign Emails? - If turned on, then all campaign emails (both phishing and training, as well as Preview & Test emails), will have DKIM added if the domain has DKIM correctly configured. (DKIM [domain keys identified mail] helps with email deliverability.) To check if a domain has DKIM correctly configured, go to Templates > Template Domains. If, in the errors/warnings column you see a warning about the domain not having DKIM configured correctly, then any emails that use that domain can still be sent, however, they will not be DKIM authenticated.

NOTE: The Add DKIM to Campaign Emails setting is on by default.

Saved System Email Settings - The system email settings that have been saved on the account. You can check deliverability of these types of emails by clicking on the Send Test Email button. (The settings have been obfuscated in the picture above.)

Saved Phishing Email Settings - The phishing email settings that have been saved on the account. You can check deliverability of these types of emails by clicking on the Send Test Email button.

Custom SMTP for System Emails - This setting lets you configure your own SMTP server for sending email. Clicking the "Custom SMTP for System Emails" switch will reveal the outgoing mail server configuration panel, where you can configure the SMTP server from which system emails will come. Input the configuration specified by your mail server in order to allow PhishingBox to connect to the server via SMTP. This will allow PhishingBox to send mail via your mail server.

NOTE 1: If you are attempting to connect to a mailbox in Microsoft, the account must be a licensed Microsoft user.

NOTE 2: Some security configurations may block PhishingBox from connecting to your mail servers. PhishingBox admin portal servers (US -54.80.160.189, EU -54.93.55.235) must have access to the SMTP port. Consult with your software or hardware vendor(s) for troubleshooting assistance.

 

Security Inboxes

The Security Inboxes tab shows the email accounts that you've added as Inbox connections. The primary goal of these inboxes is for logging reported actions. If a target forwards a simulated phishing email to an inbox listed on your Security Inboxes page, a "Reported" action will show up on the test for the target. If your account has the Inbox feature, then these mail accounts will show up on your Inbox page in Portal.

You can add two types of email accounts: Microsoft Active Directory and IMAP.

You can view Active Directory connections or IMAP connections by choosing one from the dropdown beside the Show Deleted checkbox. If you select Show Deleted, then connections that have been deleted will be displayed (you can reenable deleted connections). The dropdown under actions allows you to edit, turn off/on, delete, or reauthorize (Active Directory only) connections. 

Screenshot_2022-10-19_094447.png

To connect an IMAP account, you'll need the server, port, username, password, and encryption type (SSL or TLS). Once you've entered this information, click the "Test IMAP" button. If PhishingBox is able to successfully connect to the IMAP account, you'll be able to click the Create button. This email account will then appear on your list of Inboxes. It will also show up in the dropdown when you navigate to the Inbox page. The account will be scanned once an hour 

adding_an_imap_connection.png

Gmail users - If you are using a Gmail account, and you have trouble connecting to IMAP, then you may need to follow these steps:

  1. Login to your Gmail account and enable IMAP (see this article for instructions).

  2. Allow access to less secure apps by following this link: https://www.google.com/settings/security/lesssecureapps

  3. Go tohttps://accounts.google.com/b/0/DisplayUnlockCaptchaand enable access.
    Source: Stackoverflow - https://stackoverflow.com/questions/24525284/access-emails-using-imap/32239136#32239136

  • NOTE: Some security configurations may block PhishingBox from connecting to your mail servers. Consult with your software or hardware vendors for help with troubleshooting.

To connect a Microsoft Active Directory account, set the connection type to Microsoft Active Directory, choose a Microsoft App, and click the Authorize button.

The Azure Active Directory App require two delegated permissions into the connected mailbox.

  1. Mail.ReadWrite
  2. User.Read

If desired, you can create your own custom Azure Active Directory Application with the above permissions to use with Inbox. This process is described below in the Custom Active Directory App section.

active_directory.png

 

You'll then be taken to a Microsoft page where you will select the email account you want to connect. Since both the required permissions are delegated, they do not require Administrator consent. If successful, you will be returned to PhishingBox and get a success message.

 

Microsfot_Authorize.jpg

 

 

Reply Inboxes

The Reply Inboxes page shows inboxes set up on your account that will listen for replies to phishing emails. If a target replies to a simulated phishing email and the reply goes to an inbox listed on the Reply Inboxes page, then a "Replied" action will be logged on the test.

  • NOTE: Custom reply inboxes are not required to log reply-to failures. As long as a reply to a simulated phishing email goes to an email address with a domain that belongs to Portal, the reply action will be logged.

Last Scan Started - The time that the scan began for the inbox. Once an hour, Portal will read emails in the inbox, searching for simulated phishing emails from targets. 

Last Scan Finished - The time that a scan of the inbox completed.

Errors - Any error tied to logging into the inbox that Portal encountered.

Last Tested - The time the inbox connection was last tested.

 

Only IMAP inboxes can be added on the Reply Inboxes page. To add an inbox, click the Create button, enter the server, port, username, password, and encryption type and test the connection.

 

Screenshot_2022-10-19_094630.png

SMTP (Outgoing)

The SMTP (Outgoing) tab allows you to set up SMTP connections from which phishing/training emails can be sent. Once you create an SMTP connection from this tab, you will be able to choose it at the end of campaign setup, as shown in the second screenshot below.

Screenshot_2022-11-28_125824.png

 

This is how the SMTP connection can be selected at the end of campaign setup to send phishing/training emails.

 

Screenshot_2022-11-28_130220.png

 

Custom Active Directory App

Microsoft requires the use of OAuth to connect to an email account and modify messages. In order to add a Microsoft account inbox connection to your list of Inboxes, you must first create an app registration inside your Azure AD admin account. Then, from the Custom Active Directory App tab on the Mail Settings page, you can add the app registration by clicking the Add Custom App button. This displays a modal in which you'll enter the app name, client id, and client secret. The client id and client secret will come from the app registration in Azure. The app name is something you assign to the Active Directory App in PhishingBox for identification purposes.

 

graph_app_popup.png

The client id and client secret will come from the app registration you create in Azure AD.

 

ad_app.png

 

Once you've added an Azure Active Directory App, the app will be available from the Microsoft App dropdown when you add a new Inbox connection.

Back to top

Related articles

Comments

0 comments

Please sign in to leave a comment.