THE MORPHISEC SERVER CONSOLE SIMULATOR

Introduction

The MSC Simulator is an internal tool that was developed inhouse for the purpose of creating credible
looking ‘dummy data’ as a supportive tool for both sales and technical staff.

Once the script is run database tables are populated with simulated data of a typical customer
environment. These take the form of typical real-world threats as well as Protectors.

The Installation Process

A) Prerequires
One important prerequisite is the Python editor framework as well as its supportive libraries. These are
required to run the inhouse script. The Python framework can be downloaded from the official website.
See link below.

https://www.python.org/downloads/

As of writing this document, the latest Windows version is Python 3.9.4. This will be the environment
that we will be working this.

The other important prerequisite required are the various files developed internally by Morphisec. These
include several JSON files as well as the simulate Python script that will be run to populate the MSC.
For our purposes we will create a folder for these files so we can have a target location to launch the
simulate.py.

Morphisec LTD | www.morphisec.com | 77 Haenergia St., Gav Yam Park Bldg. 1, Beer-Sheva, 8470912, Israel
B) The Installation of the Python Editor Framework
1. Once you have downloaded the Python installation file, right click upon it so that you can run the
installation as a local administrator.

2. Choose the Install Now option. That will give us all the essential components that we require
including both IDLE and PIP.

NOTE: Ensure that you tick the, Add Python 3.9 to PATH so that it can be added to the Environment
path within the Windows operation system.

Morphisec LTD | www.morphisec.com | 77 Haenergia St., Gav Yam Park Bldg. 1, Beer-Sheva, 8470912, Israel
3. Wait for the installation to complete

4. Click Close.

5. At this point, open an Administrative Command Prompt and type the word python as show above.
This we establish two things. First whether the installation was truly successful. Second, whether the
environment PATH was written within the Windows operating system. If there any issues, you might
have to uninstall the Python Editor Framework and start again.

Morphisec LTD | www.morphisec.com | 77 Haenergia St., Gav Yam Park Bldg. 1, Beer-Sheva, 8470912, Israel
6. Furthermore, to establish that your Python installation is the same version as the one that you ran
type python –version as show below.

This final step is relevant if you are upgrading from an earlier installation of Python.

Launching the Simulator file

1. Navigate to the location where the Simulator.py is located through Windows File Manager.

2. Right click the Simulate file. Navigate the context menu as shown below. i.e. Edit with IDLE > Edit
with IDLE 3.9 (64-bit). Select the option.

Morphisec LTD | www.morphisec.com | 77 Haenergia St., Gav Yam Park Bldg. 1, Beer-Sheva, 8470912, Israel
3. At this point, we need to configure the script in a few key locations.

The NUM_OF_PROTECTORS string needs a figure set. The recommend level is 1000.

The DB_PASSWORD string needs to be set to the POSTgreSQL root password as above.

Finally, we need to ensure that the above functions are enabled as shown above.

NOTE: if you wish to disable any of the above functions simply add a # symbol at the beginning of each
string.

4. At the top of the script go to the menu bar and select Run > Run Module F5 to launch the script.

Morphisec LTD | www.morphisec.com | 77 Haenergia St., Gav Yam Park Bldg. 1, Beer-Sheva, 8470912, Israel
Troubleshooting
A library or Module needs to imported

If you launch the script you may get an error as above. This simply means that a library or module
needs to be added to your Python framework. To install this additional library or module you need to
navigate to your scripts folder where the pip script resides within your command prompt. You then
use pip to install the missing library with the following command.

pip install <Library or Module>

Press enter. If the process is successful you will get a similar messages as shown above.

Morphisec LTD | www.morphisec.com | 77 Haenergia St., Gav Yam Park Bldg. 1, Beer-Sheva, 8470912, Israel
If you receive another similar error message simply follow the same process until all required Libaries
and modules are installed

NOTE: For more on this go to the following link

https://datatofish.com/install-package-python-using-pip/

Red multiple warnings

You may receive the above warning messages when you run the simulate script. You can safely ignore
them. The script will still populate both the SOLR and POSTgreSQL databases.

Console
If the script has run successfully you will see the following:

Morphisec LTD | www.morphisec.com | 77 Haenergia St., Gav Yam Park Bldg. 1, Beer-Sheva, 8470912, Israel
Dashboard option

Here you will an exponential increase in Protectors.

Protectors Option

Here you will see more detailed information about each of the simulated protectors.

Morphisec LTD | www.morphisec.com | 77 Haenergia St., Gav Yam Park Bldg. 1, Beer-Sheva, 8470912, Israel
Plans option

Here you will see all the protectors assigned to the default plans.

Threat option

Here you will see a number of threats added to the SOLR database.

Morphisec LTD | www.morphisec.com | 77 Haenergia St., Gav Yam Park Bldg. 1, Beer-Sheva, 8470912, Israel
When you drill down further and examine individual threats from different Protectors you will note the
actual process that the threat took.

Despite the fact that these are simulated entries our DEV OPS people have go to pains to include, real
world threats with genuine hashes.

Morphisec LTD | www.morphisec.com | 77 Haenergia St., Gav Yam Park Bldg. 1, Beer-Sheva, 8470912, Israel