Using the Sim Creation Tool

Updated 1 month ago by Sam McDougall

Overview
Sim Body Creation

This article will cover how to use the Sim Creation Tool to create a Simulation

Overview

On creating a Sim the user will need to complete some basic information about the Sim as per the screenshot below, and described here:

Simulation Name: This is the name that will be seen the UI when selecting the Simulation.
Email Subject: This will be used to populate the subject of the email that the user will receive.
Email Display Name: This will be used for the sender name field of the email that the user will receive.
Email From Address: This will be the actual address that the email is sent from, and can be chosen from a selection of email addresses based on the domains that are owned by Boxphish.
Simulation Domain Name: This will be the domain displayed when a user hovers over the links in the email, and can be chosen from a selection of domains that are owned by Boxphish.
Simulation Difficulty Rating: Used to set the star rating of the Simulation difficulty. 3 being the most challenging.

Sim Body Creation

The Sim Creation Tool uses HTML combined with a range of tools to enable you to create an email format for the purpose of a phishing simulation. In this guide we will cover the follow:

Core Tools
HTML source code input
Image input
Placeholders/Links

Core Tools

Text editing

The text editer includes the use of Size, Bold, Italic, Font colour, Highlighter.

Each change will be automatically written into the source code.

Undo, Redo

These arrows are used to undo or redo edits made on the tool.

You can also use the shortcuts ctrl + z, crtl + shift + z

Source code

The Source code tool is used to view/edit the source code of the Simulation.

Preview

Located in File and View, Preview is used to preview your Simulation as it will appear when sent.

Alignment

These are used to select the alignment of the element you currently have selected. I.e. centre a table.

Bullet Pointing & Ident

These are used to either bullet point, number or indent text.

Link

This tool is used to link current text or element selection.

Click the Link tool and input URL, Text to display, Title and whether you want the link to open a new window or redirect the current page.

HTML source code input

The Simulation Creation Tool primarily relies on the input of HTML to create more complex formatted Emails/Simulations.

Although you can build a simulation without the use of raw HTML input, it is recommended to have some knowledge of this as some tweaking may be required depending on the result you would like to achieve.

To input HTML click the Source code Icon ( <> )

You will see a text input box appear, shown below:

Code can be copied directly into this box from another code editing software, for example Notepad ++.

Click Save to save your work to your current project.

Once saved, you will see the result populated in the main box, such as the below:

You can extract Source code directly from any email and paste it into the Source code tool as a template

It's important to note that anything entered within the main box creates HTML within the Source code tool:

Image input

There are currently two ways to include images in your simulation. The first is through a custom image referenced through the hosted URL. This can be entered directly in the HTML, or through the Image tool as detailed below.

HTML directly through the Source code tool, shown below:

Using the Image tool URL:

Click in the body, where you would like the image to be placed
Select the Image tool button in the left side of the Nav bar
Input the hosted URL of the image
Input an Alternative description (optional)
Input size parameters for the image
Click Save

The second option is to select an image from the included library of images hosted in the platform. It is also possible to upload an image if desired, however as a shared library this is available to all customers. As such proprietary, or customer specific images should not be uploaded. This method is detailed below:

Using the Image tool upload:

Click in the body, where you would like the image to be placed
Select the Image tool button in the left side of the Nav bar
Click the Upload icon on the right:

Select the '+' icon in the top right and select 'Upload file'

Select the image uploaded

This will populate the Source box with the image uploaded via Tiny.cloud (shown below):

Any images uploaded to the shared library using the upload feature (i.e. not externally hosted) can be viewed by all licensed system users on the platform. Boxphish Limited cannot assume any responsibility nor accept any liability for consequences arising from the uploading, copying or creation of images or personal data uploaded by licensed users not directly employed by Boxphish Limited to its system.

Placeholders

Placeholders are used to either add a function to any element of the simulation or automatically input text.

These are listed below:

{user.name} - This will display the user's full name
{user.firstname} - This will display the user's first name
{user.lastname} - This will display the user's last name
{user.action} - This is used as a trigger to pick up a simulation having been clicked
{user.email} - This will display the user's email address

The Placeholders can either be added via the source code or typed directly into the main body of the simulation. Such as the below:

To apply {user.action} to an element follow the below:

Click the element you would like to attach an action to
Select the Link tool
In URL type {user.action}
Click Save

Now, if a user were to click this element, for example an image, they will be redirected to the Landing page and a click will be recorded.

Simulation clicks can be seen in the Reports section of the portal.

If you need further support in using this tool, please don't hesitate to contact support@boxphish.com