nikkeisadev / sentry

👾 Are you annoyed having problems while using school computers? 👉 🟣Sentry is the solution! Prevent blacklisted files, websites, downloads, and system settings on computers! 🐱‍💻 Deny access to folders, or files. 💻

Sentry is a school cyber security system developed in Python. It's a private project that I have been working on for one year. The goal of Sentry is to provide robust security measures for educational institutions, ensuring the safety of student's computers. 👾

This project is licensed under the Creative Commons Zero CC0 .

📌 YouTube demo video: https://www.youtube.com/watch?v=pboiQy_5B8g

Features ✨

• Protect the computer from malicious programs in startup folder.
• Prevent wallpaper changes.
• Generate reports on security incidents and vulnerabilities.
• Report to the database.
• Block different websites.
• Prevent installed apps from runing for a specified time. (Disable any application while, for example, exams.)

Usage 📖

Always run the program from VS Code terminal, and open the /source directory, otherwise the software will break. 📘

If the client, and the enviorment is ready, then you just have to start the software. Then you have to register a user from the administrator terminal window, and then login with these credentials.

Backend management 🎛

Start terminal.py, and login with the root password of the database, which should be neumannverseny, or the one what you selected while installing it. (MySQL)

Action	Description
User Register	Register a new user in the system
User Delete	Remove an existing user from the system
Get Activity	Retrieve activity from the database
Get Requests	Retrieve requests from clients

Installation 👾

Run setup.py from main, which will download all the requirements for Sentry with pip, and also gonna download the official MySQL installer for the backend.

MySQL backend 🌐

1. When you start installing Sentry's requirements with setup.py, the mysql installer should start.
2. Click on Custom, we need only the graphical interface and the server.
3. In the installer, select MySQL Workbench from Applications, and MySQL server. MySQL Servers>MySQL Server>MySQL Server 8.0, and then the lastest version | Applications>MySQL Workbench>> MySQL Workbench 8.0> and then the latest version.
4. After downloading, and installing the Workbench and the server, the server configuration will open.
5. Here in TCP/IP Port, please change the port to 8080, and then click on next.
6. Select strong password encryption and make the root password neumannverseny.
7. You can now click on next, and the installer will setup the server. IF THE PASSWORD IS SOMETHING ELSE, THEN CHANGE THE PASSWORD IN sql/key/sql.key TOO!
8. After that, initalize Workbench, and create a new connection. You can name it as you want, I recommend SENTRY-Neumannverseny or something like that.
9. The IP, is 127.0.0.0, so localhost, and the port should be 8080 again.
10. Then click on test connection, and write the root password, which was neumannverseny.
11. Check the backend if it's running.
12. If the backend can't run, please try again installing it, or restart the computer.

Import the exported backend tables, which will be in the sql folder (in main). <--- !!!FAILED!!!

• The exported database will already contain demo informations for testing. You have to make the SQL table by this chart:

Client initialization 💻

BEFORE RUNNING THE CLIENT, PLEASE INSTALL THE BACKEND FIRST!

1. To start the client open the files in Visual Studio code.
2. Run main.py with the play button.
3. You will see the debug status in the terminal, and it should start booting up.
4. Login with your login credentials, but first register a new user from the terminal.

Contributing ❗

As this is a private project, there is no possibility for external contributions. However, if you have any suggestions or feedback, feel free to reach out to me.

Contact 📨

For any inquiries or support, please contact me at [email protected]. Discord: notnikkecrd, contact me anytime! 😇

License 📜

This project is licensed under the Creative Commons Zero CC0 .

sentry's Issues

The menu placement is incostintent

When switching between different menu options the main container moves all around and its padding always keeps changing. The main menu is also not centered.

str is not a valid type in sql

The title explains itself

There are missing module in the requirement.txt file

Some modules (like qheel or pyqt5) are missing from the requirements.txt file and also from the setup script.(Note: the module "wheel" is a dependency of the "playsound" module therefore it errors out when trying to install it. Explanation)

Having the sql root password stored in a file is unsafe

It works for a temporary approach but it it takes out the security from cybersecurity.

The setup script is not working as intended

The setup script fails to download the mysql installer properly. Instead of a folder it creates a file named utils and then errors out when trying to open it as a folder.

The terminal app is not working as intented

The exit command is not working. Sometimes it says "error in command" sometimes it raises an exception (which does make it exit but it is not the intented way). It doesn't work in vscode either.

The IP adress in the installation guide is invalid

127.0.0.0 is a network address. Did you mean 127.0.0.1?

The SQL structure located within the source file is incorrect

"machine_id" shouldn't be a table but a column inside the database and "id_table" should be the table's name.