MAL-GUI

A graphical user interface tool used to create MAL instance models and scenarios (with attacker agents specified). (Note, it does not support visualization for attack graphs, for that we recommend Neo4j or GraphViz - see the MAL toolbox documentation.)

Installation

Install the package from pypi by running pip install mal-gui.

Run

If you have installed the package locally you can run the command malgui to run the GUI.

This will open up the graphical user interface.

If you for any reason don't want to install the package, you can run it as a module directly with python -m mal_gui.app from this directory.

Contributing

• If you have contributions, please make a PR or an issue
• Write test if possible
• Make sure the pipeline passes in Github

Making a release

• Change the version number in pyproject.toml according to semantic versioning
• Make a commit
• Tag the latest commit with the new version number

How to use the graphical interface

Starting up

When you start up malgui you need to select and load a MAL-language.

Read this tutorial if you do not know how.

Add an asset

When you have started the application you can drag and drop new assets from the object explorer on the left.

Create associations

To create associations you use SHIFT + Left click to drack and drop between two assets. This lets you select what association they should have. Same goes for attacker entry points.

Remove an asset

To remove an asset, click it and press delete key on your keyboard or the Delete button in the top bar. Alternatively, you can also right click and click 'Delete Asset'.

Remove an association

To remove an association, right click the association name/label and select 'Delete connection'. Same goes for attacker entry points.