djangoによる意図的に脆弱性を持たせたWebアプリケーションセキュリティ。
私たちのロードマップは、djangoで意図的に脆弱性を持たせたWebアプリケーションを構築することです。脆弱性はOWASPトップ10に基づくことができます。
各ラボは独自のDockerコンテナで実行されるため、PyGoatはすべてのセットアップにおいて Dockerが必要です。
これによりPyGoat、Traefik、およびラボに必要なすべてのものが起動します。
8000、80(Traefik、ラボを提供)、および8080(Traefikダッシュボード)が空いている必要があります。git clone https://github.com/adeyosemanputra/pygoat.git
cd pygoat
docker compose up -d
(古い Docker インストールでは docker-compose up -d を使用します。)docker compose logs -f migration で確認できます。以降の実行ではイメージが再利用され、すぐに起動します。localhost ではありません)。ラボは lab-<username>-<lab>.lvh.me で提供され、起動したユーザーのみがアクセスできます。これにはログイン Cookie が *.lvh.me 間で共有されている必要があります。docker compose down を実行します。Docker Hub 上の
pygoat/pygoatイメージは旧 v2 リリースであり、v3 のラボは含まれていません。代わりに Docker Compose を使用してください。
ローカルマシンでプロジェクトをセットアップするには:
まず、GitHub の Web サイトまたはターミナルの git を使用してリポジトリをクローンします
git clone https://github.com/adeyosemanputra/pygoat.git
### To Download a specific branch
git clone -b <branch_name> https://github.com/adeyosemanputra/pygoat.git
次に、Docker Compose を使用していない場合は、Traefik のリリースページから Traefik を Pygoat ディレクトリ内のローカルマシンにダウンロードします。別のターミナルを開き、以下のコマンドを実行します:
Linux/WSL の場合 -
tar -zxvf traefik_<traefik_version>_linux_<arch>.tar.gz
sudo ./traefik
Windows(Powershell)の場合 -
Expand-Archive traefik_<traefik_version>_windows_<arch>.zip
cd traefik_<traefik_version>_windows_<arch>
./traefik.exe
インストール中に問題が発生した場合は、ドキュメントを参照してください。
bash installer.shpython3 manage.py migrate
python3 manage.py seed_scoring
python3 manage.py populate_labs
python3 manage.py runserver を実行します。pip install -r requirements.txt。python3 manage.py migrate
python3 manage.py seed_scoring
python3 manage.py populate_labs
python3 manage.py runserver を実行します。setup.py ファイルを使用して、すべてのアプリと Python の要件をインストールします - pip3 install .python3 manage.py migrate
python3 manage.py seed_scoring
python3 manage.py populate_labs
python3 manage.py runserver を実行します。python3 コマンドが利用できません。代わりに python を使用し、Python 3 を指していることを確認してください。installer.sh を使用したソースからのインストールinstaller.sh を使用しない場合このセクションでは、新しい脆弱性ラボを作成し、PyGoat に統合する手順を説明します。
dockerized_labs フォルダに移動します:cd dockerized_labs
mkdir your_lab_name
cd your_lab_name
Dockerfile、docker-compose.yml、requirements.txt(Python を使用する場合)、メインアプリケーションのエントリポイント(例: app.py、main.py、または同等のもの)、ラボに関連する脆弱なエンドポイントやコンポーネント、およびラボを文書化した README.md を含む標準的なアプリケーション構造を作成します。アプリケーションは必ずしも Flask アプリケーションである必要はありません。任意の Python プロジェクト(Pygoat の一部であるため推奨されます)、または適切であれば別の言語でも構いません。例と構造の慣例については、dockerized_labs フォルダ内の既存のラボを参照してください。
重要: コンテナのヘルスチェック用に、app.py に /health エンドポイントを追加してください。
http://localhost:8000/admin/ の Django 管理パネルにアクセスし、Labs セクションに移動します。
以下の内容で新しいエントリを追加します:
your_lab_namedockerized_labs/your_lab_name<PORT_NUMBER>(あるいは、Django シェルまたはカスタムデータマイグレーションを介して登録することもできます)。
重要:
Dockerfile、docker-compose.yml、app.py、およびデータベースエントリで同じポート番号を使用してください。cd /path/to/pygoat
cd dockerized_labs/your_lab_name
docker compose up
http://localhost:<PORT_NUMBER> でラボにアクセスします
脆弱性が期待どおりに動作することを確認します
個別のラボコンテナを停止します
base.html にラボの詳細を追加します
PyGoat のルートディレクトリから、アプリケーション全体を再ビルドします:
docker compose down
docker compose up --build
uninstaller.sh スクリプトを使用して、pygoat とそのすべての依存関係をアンインストールできます。pygoat をアンインストールするには、以下を実行するだけです:$ bash ./uninstaller.sh
uninstaller.py スクリプトを使用して、pygoat とそのすべての依存関係をアンインストールできますpygoat をアンインストールするには、以下を実行するだけです:$ python3 uninstaller.py
これらの素晴らしい人々に感謝します(絵文字キー):