OWASP Juice Shop is an intentionally insecure webapp for security trainings written entirely in Javascript which encompasses the entire [OWASP Top Ten](OWASP Juice Shop is an intentionally insecure webapp for security trainings written entirely in Javascript which encompasses the entire OWASP Top Ten and other severe security flaws.
Juice Shop is written in Node.js, Express and AngularJS. It was the first application written entirely in JavaScript listed in the OWASP VWA Directory.
The application contains 28+ challenges of varying difficulty where the user is supposed to exploit the underlying vulnerabilities. The hacking progress is tracked on a score board. Finding this score board is actually one of the (easy) challenges!
Apart from the hacker and awareness training use case, pentesting proxies or security scanners can use Juice Shop as a "guinea pig"-application to check how well their tools cope with Javascript-heavy application frontends and REST APIs.
Translating "dump" or "useless outfit" into German yields "Saftladen" which can be reverse-translated word by word into "juice shop". Hence the project name. That the initials "JS" match with those of "Javascript" was purely coincidental!
- Easy-to-install: Requires nothing but node.js* or Docker to run on Windows/Mac/Linux
- Self-contained: Additional dependencies are pre-packaged or will be resolved and downloaded automatically
- Self-healing: The simple SQLite database is wiped and regenerated from scratch on every server startup
- Gamification: On a Score Board the application keeps track of successfully exploited vulnerabilities
- Free and Open source: Licensed under the MIT license with no hidden costs or caveats
Feel free to have a look at the latest version of OWASP Juice Shop: https://juice-shop.herokuapp.com
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!
- 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!
- Install node.js 4.x or higher*
- Run
git clone https://github.com/bkimminich/juice-shop.git(or clone your own fork of the repository) - Run
npm install(only has to be done before first start or when you change the source code) - Run
npm start - Browse to http://localhost:3000
- Install Docker
- Run
docker pull bkimminich/juice-shop - Run
docker run -d -p 3000:3000 bkimminich/juice-shop - Browse to http://localhost:3000
- Install and launch Docker Toolbox
- Search for
juice-shopand click Create to download image and run container - Click on the Open icon next to Web Preview to browse to OWASP Juice Shop
- Install a 64bit node.js 4.x, 5.x or 6.x* on your Windows (or Linux) machine
- Download
juice-shop-<version>_<node-version>_<os>_x64.zip(or.tgz) attached to latest release - Unpack and run
npm startin unpacked folder - Browse to http://localhost:3000
Each packaged distribution includes some binaries for SQLite bound to the OS and node.js version which
npm installwas executed on.
- Setup an Amazon Linux AMI instance
- In Step 3: Configure Instance Details unfold Advanced Details and copy the script below into User Data
- In Step 6: Configure Security Group add a Rule that opens port 80 for HTTP
- Launch instance
- Browse to your instance's public DNS
#!/bin/bash
yum update -y
yum install -y docker
service docker start
docker pull bkimminich/juice-shop:latest
docker run -d -p 80:3000 bkimminich/juice-shop:latest
Technically Amazon could view hacking activity on any EC2 instance as an attack on their AWS infrastructure! We highly disrecommend aggressive scanning or automated brute force attacks! You have been warned!
OWASP Juice Shop officially supports the following versions of node.js:
- 4.x (recommended version)
- 5.x
- 6.x
Support for node.js 0.10, 0.11 and 0.12 has been dropped to reduce the complexity of the build matrix and get less timeouts from Sauce Labs during test execution.
If you need help with the application setup please check the Troubleshooting section below or post your specific problem or question in the official Gitter Chat.
- If you are experiencing Error 128 from some GitHub repos during
bower_install.jsexecution, rungit config --global url."https://".insteadOf git://and trynpm installagain - If using Boot2Docker (Docker inside VirtualBox on Windows) make sure that you also enable port forwarding from Host
127.0.0.1:3000to0.0.0.0:3000for TCP - If
npm installfails after an update of your local copy duringbower_install.jscomplaining about version issues, delete/app/bower_componentsand try again to remove outdated versions that cause conflicts - You may find it easier to find vulnerabilities using a pen test tool. I strongly recommend Zed Attack Proxy which is open source and very powerful, yet beginner friendly.
Found a bug? Crashed the app? Broken challenge? Found a vulnerability that is not on the Score Board?
Feel free to create an issue or post your ideas in the chat! Pull requests are also highly welcome as long as the tests still pass!
In case you are wondering about some red or yellow dependency badges: OWASP Juice Shop is intentionally broken, so using components with known vulnerabilities is considered a feature!
There is a full suite containing independent unit tests for the client- and server-side code. These tests verify if the normal use cases of the application should work. All server-side vulnerabilities are also tested.
npm test
The e2e test suite verifies if all client- and server-side vulnerabilities are exploitable. It passes only when all challenges are solvable on the score board.
npm run protractor
The e2e tests require a working internet connection in order to verify the redirect challenges!
- German guest post on Informatik Aktuell: Juice Shop - Der kleine Saftladen für Sicherheitstrainings
- Guest post on The official Sauce Labs Blog: Proving that an application is as broken as intended
- Teaser post on Björn Kimminich's Blog': Juice Shop
- Hacking the Juice Shop ("So ein Saftladen!"), JavaLand 2016, 08.03.2016
- Hacking the JuiceShop! ("Hackt den Saftladen!"), node.HH Meetup: Security!, 03.02.2016
- Lightning Talk: Hacking the Juice Shop ("So ein Saftladen!"), German OWASP Day 2015, 01.12.2015
- Juice Shop - Hacking an intentionally insecure Javascript Web Application, JS Unconf 2015, 25.04.2015
- So ein Saftladen! - Hacking Session für Developer (und Pentester), 17. OWASP Stammtisch Hamburg, 27.01.2015
- On Spreadshirt.com and Spreadshirt.de you can get some swag (Shirts, Hoodies, Mugs) with the official OWASP Juice Shop logo
- On Stickermule.com you can get three variants of the OWASP Juice Shop logo to decorate your laptop
An alternative way to get a sticker for free is to somehow contribute to the project by fixing an issue, finding a serious bug or submitting a good idea for a new challenge! We're also happy to send some stickers your way if you organize a meetup or conference talk where you use or mention OWASP Juice Shop! Just contact the project leader to discuss your plans: [email protected]!
Inspired by the "classic" BodgeIt Store by @psiinon.
This program is free software: you can redistribute it and/or modify it under the terms of the MIT license. OWASP Juice Shop and any contributions are Copyright © by Bjoern Kimminich 2014-2016.
