Skip to content

Commit

Permalink
update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
moeinfatehi authored May 9, 2022
1 parent 6caa651 commit ac67f31
Showing 1 changed file with 16 additions and 7 deletions.
23 changes: 16 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# XSS-challenges
# XSS Vulnerability Scenarios (challenges)
This repository is a Dockerized php application containing some XSS vulnerability challenges.<br>
The ideas behind challenges are:</br>
* Javascript validation bypass
Expand All @@ -10,18 +10,27 @@ The ideas behind challenges are:</br>
* Exploiting XSS by bypassing escape characters


# Run this image
To run this image you need <a href="https://docs.docker.com/install">docker</a> installed.</br>
Then run the command:</br>
```docker run -d -p 8008:80 moeinfatehi/xss_vulnerability_challenges```</br></br>
# Quick Start Using Docker
**Using docker hub (Quickest):**
1. To access the challenges, you need <a href="https://docs.docker.com/install">docker</a> installed.</br>
2. Run this command to pull and run the image from docker hub:</br>`sudo docker run -d -p 9003:80 moeinfatehi/xss_vulnerability_challenges`
3. Access the challenges with this URL: <a href="http://localhost:9003">http://localhost:9003</a></br></br>

Help:
```
-d: detached mode (You can use terminal after running command
-p: specifies port (you can change 8008 to whatever you want. If you don't have a web server on your host, set it to 80)
```
</br>
Then request localhost:8008 to access the challenges.</br></br>

**Using docker-compose:**
1. To access the challenges, you need <a href="https://docs.docker.com/install">docker</a> and <a href="https://docs.docker.com/compose/install/">docker-compose</a> installed.</br>
2. Clone the repository</br>`git clone https://github.com/moeinfatehi/xss_vulnerability_challenges.git`
3. Open the main directory of the project (where docker-compose.yml file exists) and run: `docker-compose up`
4. Access the challenges with this URL: <a href="http://localhost:9003">http://localhost:9003</a>



</br>
<img src="https://i.imgur.com/UTAVmoG.png">

# Disclaimer
Expand Down

0 comments on commit ac67f31

Please sign in to comment.