Getting Started

CyberSHIELD Labs need only Python 3.9 or later. There’s nothing to install: no packages, containers, accounts, or API keys.

1. Check your Python version

python3 --version

2. Clone the repository

git clone https://github.com/d0uble3L/CyberSHIELD-Labs
cd CyberSHIELD-Labs

3. Run your first lab

Every lab runs from the repository root as a Python module. Lab 9 is a good first run because it starts its own throwaway practice server:

python3 -m labs.web_exposure.check --demo

Or start at the beginning of the learning path:

python3 -m labs.ai_application_safety.analyze

4. Bring your own input

Most labs read a bundled synthetic fixture by default and accept a path to your own copy. Copy the fixture, edit it, and pass it as an argument:

cp labs/cloud_iam_posture/policy.json /tmp/my-policy.json
python3 -m labs.cloud_iam_posture.audit /tmp/my-policy.json

Use only synthetic data. Never put real credentials, personal data, or production configs into a lab.

5. Run the tests

python3 -m unittest discover -s tests -v

Repository layout

labs/<lab_name>/README.md   guide for the exercise
labs/<lab_name>/*.py        runnable script (python3 -m labs.<lab_name>.<script>)
labs/<lab_name>/*.json|txt  synthetic fixture
tests/test_labs.py          unit tests for every lab

Suggested path

Work through the labs in order. Each takes about 15–30 minutes, including the “Try this” exercises. If you’re short on time, start with the area closest to your role:

If you work on…Start with
AI features or agentsLab 1: AI Application Safety
Cloud infrastructureLab 2: Cloud IAM Posture
SOC or detectionLab 3: Identity Threat Hunting
Privacy or data governanceLab 4: Sensitive-Data Protection
Resilience or GRCLab 5: Backup Resilience
AppSec or DevSecOpsLab 6: Software Supply Chain
Platform or containersLab 7: Container Configuration
Security awarenessLab 8: Password Strength
Web applicationsLab 9: Web Exposure