Skip to content

Commit

Permalink
Merge pull request #1 from SamoKopecky/dev
Browse files Browse the repository at this point in the history
Dev
  • Loading branch information
SamoKopecky authored Aug 4, 2021
2 parents a32b51d + 2cf862f commit 2c91b82
Show file tree
Hide file tree
Showing 33 changed files with 585 additions and 528 deletions.
16 changes: 0 additions & 16 deletions Dockerfile

This file was deleted.

35 changes: 13 additions & 22 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,23 +1,17 @@
# Overview

- This repository contains:
- The standalone script that can be run in a console
- Web server app that allows to use the script with a GUI (if hosted locally on this [url](http://localhost:5000))
- A standalone script that can be run in a console
- File `resources/security_levels.json` can be edited to change the parameter rating values

# Run the standalone script
# Run the script

- Run the main file `tlstest.py` with option `-u` to enter the url.
- Run the main file `ssltest.py` with option `-u` to enter the url.
- Use `-h` or `--help` for more help.
- Example: `./tlstest.py -u vutbr.cz`

# Prepare the environment

- The required dependencies can be installed either on the hosting OS or by creating a docker container.
- Example: `./ssltest.py -u vutbr.cz`

## Prepare hosting OS environment

- If you are going to run the script, or the web app on the hosting OS these dependencies are required
- If you are going to run the script these dependencies are required
- To install required python packages use `pip3 install -r requirements.txt` command which installs:
- [cryptography](https://pypi.org/project/cryptography/)
- [pyopenssl](https://pypi.org/project/pyOpenSSL/)
Expand All @@ -27,17 +21,14 @@
- [Flask](https://pypi.org/project/Flask/)
- [flask-restful](https://pypi.org/project/Flask-RESTful/)
- Nmap is required to for some functions, install with `apt install -y nmap`
- To start the server app with the rest api server run the `start.sh` script or `script.sh -h` for more information
- To run the tool script refer to the section at the start

## Create environment using docker

- To create the environment docker engine ([guide here](https://docs.docker.com/engine/install/)) and docker
compose ([guide here](https://docs.docker.com/compose/install/)) need to be installed.
- Create the docker container with this command `docker-compose up -d` ran in the root project directory
- The web app will be automatically deployed, and the environment with required dependencies can be accessed via this
command:
`docker exec -it bp_flask_server /bin/bash`
- The standalone script can be then ran inside the created environment, refer to the section at the begging to see how
to run the script
## Supported vulnerability tests

- Heartbleed
- CCS Injection
- Insecure renegotiation
- ZombiePOODLE/GOLDENDOODLE
- Session ticker support
- CRIME
- RC4 Support
40 changes: 0 additions & 40 deletions README_SK.md

This file was deleted.

8 changes: 0 additions & 8 deletions docker-compose.yaml

This file was deleted.

File renamed without changes.
Loading

0 comments on commit 2c91b82

Please sign in to comment.