OWASP Juice Shop Insecure Web Application

OWASP Juice Shop is probably the most modern and sophisticated insecure web application! It can be used in security trainings, awareness demos, CTFs and as a guinea pig for security tools! Juice Shop encompasses vulnerabilities from the entire OWASP Top Ten along with many other security flaws found in real-world applications!

For a detailed introduction, full list of features and architecture overview please visit the official project page: https://owasp-juice.shop

Table of contents

• Setup
  • Deploy on Heroku (free ($0/month) dyno)
  • From Sources
  • Packaged Distributions
  • Docker Container
  • Vagrant
  • Amazon EC2 Instance
  • Azure Container Instance
  • Google Compute Engine Instance
• Demo
• Documentation
  • Node.js version compatibility
  • Troubleshooting
  • Official companion guide
• Contributing
• References
• Merchandise
• Donations
• Contributors
• Licensing

Setup

You can find some less common installation variations in the Running OWASP Juice Shop documentation.

Deploy on Heroku (free ($0/month) dyno)

1. Sign up to Heroku and log in to your account
2. Click the button below and follow the instructions

This is the quickest way to get a running instance of Juice Shop! If you have forked this repository, the deploy button will automatically pick up your fork for deployment! As long as you do not perform any DDoS attacks you are free to use any tools or scripts to hack your Juice Shop instance on Heroku!

From Sources

1. Install node.js
2. Run git clone https://github.com/bkimminich/juice-shop.git (or clone your own fork of the repository)
3. Go into the cloned folder with cd juice-shop
4. Run npm install (only has to be done before first start or when you change the source code)
5. Run npm start
6. Browse to http://localhost:3000

Packaged Distributions

1. Install a 64bit node.js on your Windows, MacOS or Linux machine
2. Download juice-shop-<version>_<node-version>_<os>_x64.zip (or .tgz) attached to latest release
3. Unpack and cd into the unpacked folder
4. Run npm start
5. Browse to http://localhost:3000

Each packaged distribution includes some binaries for sqlite3 and libxmljs bound to the OS and node.js version which npm install was executed on.

Docker Container

1. Install Docker
2. Run docker pull bkimminich/juice-shop
3. Run docker run --rm -p 3000:3000 bkimminich/juice-shop
4. Browse to http://localhost:3000 (on macOS and Windows browse to http://192.168.99.100:3000 if you are using docker-machine instead of the native docker installation)

Vagrant

1. Install Vagrant and Virtualbox
2. Run git clone https://github.com/bkimminich/juice-shop.git (or clone your own fork of the repository)
3. Run cd vagrant && vagrant up
4. Browse to 192.168.33.10:3000

Amazon EC2 Instance

1. In the EC2 sidenav select Instances and click Launch Instance
2. In Step 1: Choose an Amazon Machine Image (AMI) choose an Amazon Linux AMI or Amazon Linux 2 AMI
3. In Step 3: Configure Instance Details unfold Advanced Details and copy the script below into User Data
4. In Step 6: Configure Security Group add a Rule that opens port 80 for HTTP
5. Launch your instance
6. Browse to your instance’s public DNS

#!/bin/bash
yum update -y
yum install -y docker
service docker start
docker pull bkimminich/juice-shop
docker run -d -p 80:3000 bkimminich/juice-shop

Azure Container Instance

1. Open and login (via az login) to your Azure CLI or login to the Azure Portal, open the CloudShell and then choose Bash (not PowerShell).
2. Create a resource group by running az group create --name <group name> --location <location name, e.g. "centralus">
3. Create a new container by running az container create --resource-group <group name> --name <container name> --image bkimminich/juice-shop --dns-name-label <dns name label> --ports 3000 --ip-address public
4. Your container will be available at http://<dns name label>.<location name>.azurecontainer.io:3000

Google Compute Engine Instance

1. Login to the Google Cloud Console and open Cloud Shell.
2. Launch a new GCE instance based on the juice-shop container. Take note of the EXTERNAL_IP provided in the output.

gcloud compute instances create-with-container owasp-juice-shop-app --container-image bkimminich/juice-shop

3. Create a firewall rule that allows inbound traffic to port 3000

gcloud compute firewall-rules create juice-rule --allow tcp:3000

4. Your container is now running and available at http://<EXTERNAL_IP>:3000/

Demo

Feel free to have a look at the latest version of OWASP Juice Shop: http://demo.owasp-juice.shop

This is a deployment-test and sneak-peek instance only! You are not supposed to use this instance for your own hacking endeavours! No guaranteed uptime! Guaranteed stern looks if you break it!

Documentation

Node.js version compatibility

OWASP Juice Shop officially supports the following versions of node.js in line with the official node.js LTS schedule as close as possible. Docker images and packaged distributions are offered accordingly.

node.js	Supported	Tested	Packaged Distributions	Docker images from master	Docker images from develop
15.x
14.x			Windows (x64), MacOS (x64), Linux (x64)
13.x	()
12.x			Windows (x64), MacOS (x64), Linux (x64)	latest (linux/amd64, linux/arm/v7, linux/arm64)	snapshot (linux/amd64, linux/arm/v7, linux/arm64)
11.x	()
10.x			Windows (x64), MacOS (x64), Linux (x64)
<10.x

Juice Shop is automatically tested only on the latest .x minor version of each node.js version mentioned above! There is no guarantee that older minor node.js releases will always work with Juice Shop! Please make sure you stay up to date with your chosen version.

Troubleshooting

If you need help with the application setup please check our our existing Troubleshooting guide. If this does not solve your issue please post your specific problem or question in the Gitter Chat where community members can best try to help you.

Please avoid opening GitHub issues for support requests or questions!

Official companion guide

OWASP Juice Shop comes with an official companion guide eBook. It will give you a complete overview of all vulnerabilities found in the application including hints how to spot and exploit them. In the appendix you will even find complete step-by-step solutions to every challenge. Extensive documentation of custom re-branding, CTF-support, trainer’s guide and much more is also included.

Pwning OWASP Juice Shop is published under CC BY-NC-ND 4.0 and is available for free in PDF, Kindle and ePub format on LeanPub. You can also browse the full content online!

Download: https://github.com/bkimminich/juice-shop

Please follow and like us: