athena-cyber-hub's Introduction

Athena OS Cyber Hub

Athena Cyber Hub (ACH) is a forked version of Vanilla Control Center with several differences in order to fit the needs of Cyber Security users on Athena OS.

Unlike Vanilla OS, it replaces distrobox by docker and it is not intended to run operating systems or managing the updates, but it is intended to run vulnerable laboratories for learning purposes and cyber security platforms for offensive and defensive activities.

Usage

Athena OS Cyber Hub provides three sections:

Cyber Platform Center
Vulnerability Lab
Cyber Lab

Cyber Platform Center

It offers a set of Cyber Security platforms used for several purposes (i.e., defensive), as DefectDojo and GreenBone tools.

Vulnerability Lab

It contains several CVE laboratories from Vulhub where you can train on real CVEs to exploit technologies and services. Furthermore, it provides also several OWASP machines to enjoy with. Run your favourite vulnerable environment and get your CVE!

Cyber Lab

Set your custom containers and manage them in a centralized manner! When ACH is run for the first time, it will create ~/.config/athena-cyber-hub/cyberlab.toml configuration file. Edit it by inserting the required information about your container, and then run ACH. Your containers will be collected in Cyber Lab section.

Example configuration file:

[[environment]]
id = "vulhub/activemq"
name = "ActiveHello"
path_docker = "/usr/share/athena-platform-center/vulhub/activemq/CVE-2015-5254/docker-compose.yml"
path_readme = "/usr/share/athena-platform-center/vulhub/activemq/CVE-2015-5254/README.md"

[[environment]]
id = "well-hub/yourlab"
name = "Container 2"
path_docker = "/path/to/docker-compose.yml"
path_readme = "/path/to/README.md"

Installation

Athena IS Cyber Hub can be installed through Athena Repository by:

sudo pacman -S athena-cyber-hub

Build from source

Dependencies

base-devel
meson
go
appstream-glib
libadwaita
gettext
desktop-file-utils
python-lxml
python-toml
vte4
docker
docker-compose
gnome-console
marktext

Build

meson setup build
ninja -C build

Install

sudo ninja -C build install

Run

athena-cyber-hub

Contribution

If you would like to have a new Cyber Security Platform or new CVE labs, please open an issue by reporting the project information to integrate.

Credits

Athena Cyber Hub is a forked project of Vanilla Control Center adapted for Athena OS. I would like to thank @mirkobrombin and Vanilla OS team for the original project.

Special Thanks to @phith0n and its Vulnhub project that is the main source of CVE environments inside Athena Cyber Hub.

athena-cyber-hub's People

Contributors

Stargazers

Watchers

athena-cyber-hub's Issues

Error with Athena-Cyber-Hub and Cinnamon DE

Hi,

So I installed Cinnamon DE using the Rust programming installer from the iso. I tried to start the athena-cyber-hub but I get this error:

Traceback (most recent call last):
File "/usr/bin/athena-cyber-hub", line 46, in
from athena_cyber_hub import main
File "/usr/share/athena-cyber-hub/athena_cyber_hub/main.py", line 33, in
from .window import AthenaWindow
File "/usr/share/athena-cyber-hub/athena_cyber_hub/window.py", line 29, in
from athena_cyber_hub.backends.ach import Ach
File "/usr/share/athena-cyber-hub/athena_cyber_hub/backends/ach.py", line 35, in
class Ach:
File "/usr/share/athena-cyber-hub/athena_cyber_hub/backends/ach.py", line 55, in Ach
data = toml.load("/usr/share/athena-cyber-hub/vulhub/environments.toml")
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/usr/lib/python3.11/site-packages/toml/decoder.py", line 134, in load
return loads(ffile.read(), _dict, decoder)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/usr/lib/python3.11/site-packages/toml/decoder.py", line 340, in loads
raise TomlDecodeError("Unbalanced quotes", original, i)
toml.decoder.TomlDecodeError: Unbalanced quotes (line 567 column 23 char 13104)

How do I fix it?

Thanks,
hammy

Recommend Projects

athena-os / athena-cyber-hub Goto Github PK