PyGoat

Aplicação web intencionalmente vulnerável para segurança em django. nosso roadmap: construir uma aplicação web intencionalmente vulnerável em django. As vulnerabilidades podem ser baseadas no OWASP Top Ten.

Índice

• pygoat
  • Instalação
    • A partir das fontes
    • Container Docker
    • Vídeo de Instalação
  • Desinstalação
  • Soluções
  • Para Desenvolvedores

Instalação

A partir das fontes

Para configurar o projeto na sua máquina local:

Primeiro, clone o repositório usando o site do GitHub ou git no terminal

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

Notas para Windows (usuários do PowerShell)

• PyGoat é testado principalmente em Linux/macOS. Recomenda-se que usuários do Windows usem:
  • Docker Desktop (preferencial) ou
  • WSL2 (Ubuntu) para uma configuração mais suave.
• Em alguns ambientes Windows, o comando python3 pode não estar disponível por padrão.
  • Se python3 não for reconhecido, tente usar python (certifique-se de que aponta para Python 3.x).
• Garanta que a versão do Python seja 3.10 ou 3.11 para melhor compatibilidade.
• Alguns laboratórios dependem de comandos no estilo Unix e podem se comportar de maneira diferente em shells nativos do Windows.

Método 1

1. Instale todos os requisitos da aplicação e do Python usando o arquivo instalador - bash installer.sh
2. Aplique as migrações python3 manage.py migrate.
   
3. Por fim, execute o servidor de desenvolvimento python3 manage.py runserver.
   
4. O projeto estará disponível em http://127.0.0.1:8000

Método 2

1. Instale os requisitos do Python pip install -r requirements.txt.
   
2. Aplique as migrações python3 manage.py migrate.
   
3. Por fim, execute o servidor de desenvolvimento python3 manage.py runserver.
   
4. O projeto estará disponível em http://127.0.0.1:8000

Método 3

1. Instale todos os requisitos da aplicação e do Python usando o arquivo setup.py - pip3 install .
2. Aplique as migrações python3 manage.py migrate.
   
3. Por fim, execute o servidor de desenvolvimento python3 manage.py runserver.
   
4. O projeto estará disponível em http://127.0.0.1:8000

Container Docker

1. Instale o Docker
2. Execute docker pull pygoat/pygoat ou docker pull pygoat/pygoat:latest
3. Execute docker run --rm -p 8000:8000 pygoat/pygoat:latest
4. Acesse http://127.0.0.1:8000
5. Remova a imagem existente usando docker image rm pygoat/pygoat e faça pull novamente em caso de erro.

Com Docker-Compose

1. Instale o Docker
2. Execute docker-compose up ou docker-compose up -d

Popular Dados dos Desafios

PyGoat armazena definições de desafios em challenge/challenge.json. Para popular a tabela Challenge no banco de dados a partir deste arquivo, use o comando de gerenciamento integrado do Django:

Usando Docker Compose

docker compose exec web python manage.py populate_challenges

Construir Imagem Docker e Executar

1. Clone o repositório   git clone https://github.com/adeyosemanputra/pygoat.git
2. Construa a imagem Docker a partir do Dockerfile usando   docker build -f Dockerfile -t pygoat .
3. Execute a imagem Docker  docker run --rm -p 8000:8000 pygoat:latest
4. Acesse http://127.0.0.1:8000 ou http://0.0.0.0:8000

Vídeo de Instalação

1. A partir das fontes usando installer.sh

• Instalando PyGoat a partir das fontes

2. Sem usar installer.sh

3. Instalação com Mac M1 (usando Virtualenv)

Desinstalação

Em Sistemas Baseados em Debian/Ubuntu

• Em sistemas baseados em Debian/Ubuntu, você pode usar o script uninstaller.sh para desinstalar o pygoat junto com todas as suas dependências.
• Para desinstalar o pygoat, execute:

$ bash ./uninstaller.sh

Em Outros Sistemas

• Em outros sistemas, você pode usar o script uninstaller.py para desinstalar o pygoat junto com todas as suas dependências
• Para desinstalar o pygoat, execute:

$ python3 uninstaller.py

Soluções

Soluções para todos os desafios

Contribuidores ✨

Agradecimentos a estas pessoas maravilhosas (chave de emoji):

Este projeto segue a especificação all-contributors. Contribuições de qualquer tipo são bem-vindas!