Skip to content

01xR4in/PenChecker-contrib

 
 

Repository files navigation

PenChecker

logo

Description

PenChecker is a student project carried out as part of our Master 1 year at Oteria Cyber School. We wanted to create a tool based on a plug-and-play physical module that would enable any type of population to scan their local network and identify vulnerabilities.

Features

The features currently available on the software are :

  • Scanning and versioning of accessible machines
  • Links service versions to known vulnerabilities
  • Clear and simple report

Getting Ready

Installation :

  • chmod +x install.sh
  • ./install.sh, which will install everything needed, with the python dependencies with pip in .venv

⚠️ Don't forget to activate the virtual environment : source .venv/bin/activate in an elevated environment (required for scan) Then you can just run the Main.py program.
python Main.py --interface Interface_name let you choose the network interface (without it's eth0 by default)

Debug :

Since 1.6.5 and still improving it, the codes is progressivly commented and functions got their docstrings.
If you face bug or error will running the project, you can find logs in the logs/ folder that's created. You got one .log file by main program for this project.
And more important, do not hesitate to contact us to remediate to this !

How to push

push.sh is there to help you commit corrections or modifications you want to propose

Special thanks

  • Paul de Montalivet, Head of Training and Projects at Oteria Cyber School, for his guidance throughout the year.

  • Laurent Ladreyt, IT Manager/Cybersecurity Referent at KROHNE France, who helped us come up with ideas for the development, accompanied us on the project and tested the solution on a perimeter of his company.

  • To all the people who contacted us via LinkedIn to advise us and give their opinion on the features we had planned for our solution.

Disclaimer

This project is intended solely for educational and defensive purposes. The creators and contributors are not responsible for any misuse or malicious use of this tool. Use it responsibly and ethically, adhering to all relevant laws and regulations.

About

my small hands on this projects

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 89.9%
  • Shell 10.1%