Trainer's guide

Co-authored by Timo Pagel


Make sure all participants have their own running Juice Shop instance to work with. While attempting challenges like RCE or XXE students might occasionally take down their server and would severely impact other participants if they shared an instance.

There are multiple Run Options which you can choose from. It is perfectly fine to run multiple docker containers on one host. They do not effect each other.


Especially in awareness trainings for management you might want to create a higher immersion by making the Juice Shop look like an application in the corporate design of the participants' own company. Juice Shop offers various customization options to achieve this.

Several custom configurations already come packaged with the Juice Shop source code, the two most sophisticated ones being 7 Minute Security and Mozilla.

In addition, you might want to disable all challenge notifications during awareness trainings to avoid distraction. The Quiet configuration demonstrates the necessary options to achieve this.

Quiet mode

For a really sophisticated and immersive demo consider performing some Additional Browser tweaks. These will let you use OAuth2 login via Google and cast the illusion that coupon codes were actually tweeted by your customer's company.

Classroom hints

In a class room setup you have to find a way to distribute the URL of each instance to the participants. For small groups, it is probably fine to just spin up a number of containers and tell all participants which URL they have to use. An example to spin up 10 Docker containers on a UNIX based system is to run

for i in {10..19}; do docker run -d -p 40$i:3000 bkimminich/juice-shop; done

If you want to track progress centrally during the training, you might want to host a central CTF server where participants can post the challenges they already solved. You might consider turning off public visibility of the leader board on the CTF server unless you want to encourage the students to hack very competitively.

Hosting individual instances for multiple users

A solution to host and manage individual Juice Shop instances for multiple users is JuicyCTF. JuicyCTF is a Kubernetes based system to start up the required Juice Shop instances on demand. It will also clean up unused instances after a configured period of inactivity.

JuicyCTF comes with a custom-built load balancer. It allows every participant to use the same URL, but their traffic will always be sent to their own personal instance.

The JuicyCTF repository contains multiple guides on how to set up the system on different cloud provider environments.

Existing trainings

One existing training which uses the Juice Shop for example is Timo Pagel's University Module. The structure mostly is as follows:

  1. Introduce a topic (e.g. SQL Injection)
  2. Let the participants try it out in the Juice Shop
  3. Show mitigation/counter measures

The 2nd semester web attack chapters of Björn Kimminich's IT Security Lecture follow a similar pattern of

  1. Introduction
  2. Timeboxed exercise
  3. Demonstration of the hack (for all who did not finish the exercise in time)
  4. Explaining mitigation and prevention

You can find more links to existing material in the Lectures and Trainings section of the project references on on GitHub.

Challenges for demos

The following challenges are well suited for live demonstrations in trainings or talks. You should always begin by showing how to find the Score Board ( ⭐ ) so you can then pick any of the challenge below to further demonstrate certain categories of vulnerabilities.

Description Category Difficulty Time for demo Dependencies
Confidential Document Sensitive Data Exposure None
Login Admin Injection ⭐⭐ None
Reflected XSS XSS Log in as any user
Classic Stored XSS XSS Log in as any user
Privacy Policy Miscellaneous Log in as any user
Privacy Policy Inspection Security through Obscurity ⭐⭐⭐ ⏳⏳ Privacy Policy
Admin Section Broken Access Control ⭐⭐ ⏳⏳ Login Admin or Admin Registration
View Basket Broken Access Control ⭐⭐ ⏳⏳ Log in with two different users
Easter Egg Broken Access Control ⭐⭐⭐⭐ ⏳⏳⏳ Explain Poison Null Byte
Nested Easter Egg Cryptographic Issues ⭐⭐⭐⭐ ⏳⏳⏳ Easter Egg
Forgotten Developer Backup Sensitive Data Exposure ⭐⭐⭐⭐ ⏳⏳⏳ Explain Poison Null Byte
Forged Coupon Cryptographic Issues ⭐⭐⭐⭐⭐⭐ ⏳⏳⏳⏳ Forgotten Developer Backup and z85-cli installed or Forgotten Sales Backup or tracing coupons from Twitter/Reddit back to

XSS demo

A particularly impressive showcase of XSS site-defacement combined with a keylogger is provided explicitly for live demos and awareness trainings:

  1. Install Docker.
  2. Run git clone
  3. Run cd shake-logger and then docker-compose up.
  4. Turn on your speakers and make sure your browser is allowed to play sound.
  5. Open this link to launch the XSS demo (🔊).
  6. Use the application normally, e.g. doing a search and logging in with some user.
  7. In a new tab go to http://localhost:8080/logger.php to see that all user input was transmitted to a third-party server.
  8. Show the Network tab of the browser window with Juice Shop to see the requests that are sent to the logger.php script.
  9. Reload the Juice Shop with F5 and use the application a bit more.
  10. You will see that no more logging takes place as XSS payload was removed during the reload.

There is also a video recording available on YouTube: This is a good fallback in case the Docker-based setup does not work for you.

results matching ""

    No results matching ""