View on GitHub

DamnVulnerableCryptoApp

An app with really insecure crypto. To be used to see/test/exploit weak cryptographic implementations as well as to learn a little bit more about crypto, without the need to dive deep into the math behind it

Logo

GitHub package.json version GitHub Workflow Status GitHub GitHub repo size Docker Image Size (latest by date) GitHub contributors GitHub commit activity

Why?

If you try to learn a little bit more about crypto, either because you want to know how the attacks work or just because you want to do safe code, you end up diving really fast into the math behind the algorithms, and for a lot of people this is a NO.

This project was created with some key points in mind:

Build

(Make sure you have node installed)

npm install -g yarn

# This will install necessary dependencies
# (in frontend and backend)
yarn run build-with-deps

# In case you already have dependencies 
# or want to install them manually you can build it with:
# yarn run build

Run

yarn run start

You can change the port with an environment variable:

PORT=4000 yarn run start

Docker

From DockerHub

You can download the latest docker image with:

docker pull damnvulnerablecryptoapp1/damnvulnerablecryptoapp

Build

If you prefer to build the docker image yourself run:

npm install -g yarn

yarn build:docker
# or just:
# docker build -t dvca .

Run

By default port 4000 is being exported, So you can map it to your own port:

docker run -p 4000:4000 -t dvca

Developing

If you want to to develop new features, or just run without building the app you can start by installing dependencies with:

# installs deps  both for FE and BE
yarn run install-deps

Then you need to run independently the frontend and the backend apps.

Backend

cd backend 
yarn start:dev

if you want to change the port (default is 4000) you can set an environment variable:

PORT=3000 yarn start

If you changed the server port you need to specify it when booting the frontend, again, as an environment variable:

REACT_APP_SERVER_PORT=5000 yarn start

Frontend

cd frontend
yarn start

Documentation

You can find project’s documentation on github wiki

Some other nice projects crypto related

License

DamnVulnerableCryptoApp is MIT licensed

Screenshots

printscreen1 printscreen2 printscreen3 printscreen4