PyGoat

Applicazione web intenzionalmente vulnerabile per la sicurezza in django. La nostra roadmap prevede la creazione di un'applicazione web intenzionalmente vulnerabile in django. Le vulnerabilità possono basarsi sulle prime dieci di OWASP.

Indice dei contenuti

• pygoat
  • Installazione
    • Dai sorgenti
    • Container Docker
    • Video di installazione
  • Disinstallazione
  • Soluzioni
  • Per sviluppatori

Installazione

Dai sorgenti

Per configurare il progetto sulla tua macchina locale:

Prima, clona il repository usando il sito web di GitHub o git nel Terminale.

  git clone https://github.com/adeyosemanputra/pygoat.git
  ### To Download a specific branch
  git clone -b <branch_name> https://github.com/adeyosemanputra/pygoat.git

Note su Windows (utenti PowerShell)

• PyGoat è testato principalmente su Linux/macOS. Agli utenti Windows si consiglia di utilizzare:
  • Docker Desktop (preferito), oppure
  • WSL2 (Ubuntu) per una configurazione più fluida.
• In alcuni ambienti Windows, il comando python3 potrebbe non essere disponibile per impostazione predefinita.
  • Se python3 non viene riconosciuto, prova a usare python invece (assicurati che punti a Python 3.x).
• Assicurati che la versione di Python sia 3.10 o 3.11 per la migliore compatibilità.
• Alcuni laboratori si basano su comandi in stile Unix e potrebbero comportarsi diversamente su shell Windows native.

Metodo 1

1. Installa tutti i requisiti dell'app e di Python usando il file di installazione - bash installer.sh
2. Applica le migrazioni python3 manage.py migrate.
   
3. Infine, avvia il server di sviluppo python3 manage.py runserver.
   
4. Il progetto sarà disponibile all'indirizzo http://127.0.0.1:8000

Metodo 2

1. Installa i requisiti python3 pip install -r requirements.txt.
   
2. Applica le migrazioni python3 manage.py migrate.
   
3. Infine, avvia il server di sviluppo python3 manage.py runserver.
   
4. Il progetto sarà disponibile all'indirizzo http://127.0.0.1:8000

Metodo 3

1. Installa tutti i requisiti dell'app e di Python usando il file setup.py - pip3 install .
2. Applica le migrazioni python3 manage.py migrate.
   
3. Infine, avvia il server di sviluppo python3 manage.py runserver.
   
4. Il progetto sarà disponibile all'indirizzo http://127.0.0.1:8000

Container Docker

1. Installa Docker
2. Esegui docker pull pygoat/pygoat oppure docker pull pygoat/pygoat:latest
3. Esegui docker run --rm -p 8000:8000 pygoat/pygoat:latest
4. Vai su http://127.0.0.1:8000
5. Rimuovi l'immagine esistente usando docker image rm pygoat/pygoat e ripeti il pull in caso di errore

Con Docker-Compose

1. Installa Docker
2. Esegui docker-compose up oppure docker-compose up -d

Popolare i dati delle challenge

PyGoat memorizza le definizioni delle challenge in challenge/challenge.json. Per popolare la tabella Challenge nel database da questo file, usa il comando di gestione integrato di Django:

Usando Docker Compose

docker compose exec web python manage.py populate_challenges

Build dell'immagine Docker ed esecuzione

1. Clona il repository   git clone https://github.com/adeyosemanputra/pygoat.git
2. Builda l'immagine Docker dal Dockerfile usando   docker build -f Dockerfile -t pygoat .
3. Esegui l'immagine Docker  docker run --rm -p 8000:8000 pygoat:latest
4. Vai su http://127.0.0.1:8000 o http://0.0.0.0:8000

Video di installazione

1. Dai sorgenti usando installer.sh

• Installare PyGoat dai sorgenti

2. Senza usare installer.sh

3. Installazione con Mac M1 (usando Virtualenv)

Disinstallazione

Su sistemi basati su Debian/Ubuntu

• Su sistemi basati su Debian/Ubuntu, puoi usare lo script uninstaller.sh per disinstallare pygoat insieme a tutte le sue dipendenze.
• Per disinstallare pygoat, esegui semplicemente:

$ bash ./uninstaller.sh

Su altri sistemi

• Su altri sistemi, puoi usare lo script uninstaller.py per disinstallare pygoat insieme a tutte le sue dipendenze
• Per disinstallare pygoat, esegui semplicemente:

$ python3 uninstaller.py

Soluzioni

Soluzioni a tutte le challenge

Contributori ✨

Un ringraziamento a queste meravigliose persone (chiave emoji):

Questo progetto segue la specifica all-contributors. Contributi di qualsiasi tipo sono benvenuti!