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 agents | Lab 1: AI Application Safety |
| Cloud infrastructure | Lab 2: Cloud IAM Posture |
| SOC or detection | Lab 3: Identity Threat Hunting |
| Privacy or data governance | Lab 4: Sensitive-Data Protection |
| Resilience or GRC | Lab 5: Backup Resilience |
| AppSec or DevSecOps | Lab 6: Software Supply Chain |
| Platform or containers | Lab 7: Container Configuration |
| Security awareness | Lab 8: Password Strength |
| Web applications | Lab 9: Web Exposure |