Infra PolyCyber

L'objectif de ce dépot est de rassembler l'ensemble des ressources utilisées pour déployer les infrastructures CTFd de PolyCyber (PolyPwn, ainsi que CTFd interne à PolyCyber) afin de partager une méthode de déploiement de services fonctionnelle et simplifiée.

Scripts Disponibles

1. Script d'Installation CTFd (setup.sh)

Script Bash qui automatise l'installation et la configuration d'un serveur CTFd utilisant le plugin Zync et son instancer dédié Galvanize.

2. Outil de Gestion des Challenges (challenges_management.sh)

Script Bash avancé pour la construction, l'ingestion et la synchronisation des challenges CTF avec support des conteneurs Docker et Docker compose.

Prérequis

Pour le script d'installation CTFd

• Systèmes d'exploitation : Testé et vérifié sous :
  • Ubuntu Server 24
  • Ubuntu Server 25
  • Debian 12
• Privilèges : Le script doit être exécuté en tant que root (utilise sudo automatiquement si nécessaire)

Pour l'outil de gestion des challenges

• Docker : Installé et fonctionnel
• curl, jq, yq : Pour les appels API et le traitement YAML/JSON (vérifiés automatiquement)
• Dépôt de challenges : Structure de dossiers avec fichiers challenge.yml

Installation du serveur CTFd

1. Clonez ce dépôt :

   git clone https://github.com/polycyber/infra
   cd infra
   chmod +x setup.sh challenges_management.sh

2. Exécutez le script d'installation et suivez les instructions :

   ./setup.sh --ctfd-url <votre-domaine.com>

3. Rendez-vous sur l'URL du serveur configurée

   • Effectuez la configuration de l'événement CTF
   • Dirigez-vous vers le panneau de configuration administrateur Admin Panel --> Plugins --> Zync Config
   • Entrez l'URL de votre instancer Galvanize et le secret JWT généré par le script d'installation

Utilisation

Options du script d'installation

Option	Description	Obligatoire
--ctfd-url URL/IP	URL/domaine de votre serveur CTFd	✅ Oui
--working-folder DIR	Répertoire de travail (défaut: /home/$USER)	❌ Non
--theme DIR/URL	Active l'utilisation d'un thème personnalisé	❌ Non
--backup-schedule TYPE	Fréquence de sauvegarde de la base de données (daily (défaut), hourly, 10min)	❌ Non
--no-https	Déploiement sans HTTPS	❌ Non
--help	Affiche l'aide	❌ Non

Exemples d'installation

# Installation basique avec domaine
./setup.sh --ctfd-url exemple.com

# Installation basique avec IP - utilise l'option --no-https automatiquement
./setup.sh --ctfd-url 192.168.12.34

# Installation avec répertoire personnalisé
./setup.sh --ctfd-url exemple.com --working-folder /opt/ctfd

# Installation avec thème personnalisé activé
./setup.sh --ctfd-url exemple.com --theme  /home/user/my-custom-theme

# Installation avec thème personnalisé activé en téléchargeant un thème depuis github directement 
./setup.sh --ctfd-url exemple.com --theme https://github.com/user/theme.git

# Sauvegarde toutes les heures
./setup.sh --ctfd-url exemple.com --backup-schedule hourly

# Sauvegarde toutes les 10 minutes
./setup.sh --ctfd-url exemple.com --backup-schedule 10min

# Afficher l'aide
./setup.sh --help

Configuration du thème personnalisé

Si vous utilisez l'option --theme, le script activera automatiquement le montage du thème personnalisé dans le docker-compose.yml.

Outil de gestion des challenges

Actions disponibles

Action	Description
all	Construction + ingestion (défaut)
build	Construction des images Docker uniquement
ingest	Ingestion des challenges dans CTFd
sync	Synchronisation des challenges existants
status	Affichage du statut et statistiques
cleanup	Nettoyage des images Docker

Options principales

Option	Description	Obligatoire
--ctf-repo REPO	Nom du dépôt de challenges présent dans le répertoire de travail	✅ Oui
--action ACTION	Action à effectuer (all, build, ingest, sync, status, cleanup)	❌ Non
--working-folder DIR	Répertoire de travail (défaut: /home/$USER)	❌ Non
--config FILE	Charger la configuration depuis un fichier	❌ Non

Options de filtrage

Option	Description
--categories LIST	Liste des catégories à traiter (séparées par virgules)
--challenges LIST	Liste des challenges spécifiques à traiter (séparés par virgules)

Options de comportement

Option	Description
--dry-run	Mode simulation (affiche les actions sans les exécuter)
--force	Force les opérations (reconstruction, écrasement)
--parallel-builds N	Nombre de constructions parallèles (défaut: 4)

Options de debug

Option	Description
--debug	Active la sortie de debug
--skip-docker-check	Ignore la vérification du daemon Docker
--help	Affiche l'aide
--version	Affiche les informations de version

Exemples de gestion des challenges

# Configuration complète (construction + ingestion)
./challenges_management.sh --ctf-repo PolyPwnCTF-2025-challenges

# Construction uniquement pour certaines catégories
./challenges_management.sh --action build --ctf-repo PolyPwnCTF-2025-challenges --categories "web,crypto"

# Synchronisation avec mise à jour forcée
./challenges_management.sh --action sync --ctf-repo PolyPwnCTF-2025-challenges --force

# Mode simulation pour voir les actions prévues
./challenges_management.sh --ctf-repo PolyPwnCTF-2025-challenges --dry-run

# Traitement de challenges spécifiques
./challenges_management.sh --action build --ctf-repo PolyPwnCTF-2025-challenges --challenges "web-challenge-1,crypto-rsa"

# Construction parallèle avec 8 threads
./challenges_management.sh --action build --ctf-repo PolyPwnCTF-2025-challenges --parallel-builds 8

# Affichage du statut
./challenges_management.sh --action status --ctf-repo PolyPwnCTF-2025-challenges

# Nettoyage des images Docker
./challenges_management.sh --action cleanup --ctf-repo PolyPwnCTF-2025-challenges

Fichier de configuration

Créez un fichier .env avec des paires CLE=VALEUR :

CTF_REPO=PolyPwnCTF-2025-challenges
WORKING_DIR=/opt/ctf
PARALLEL_BUILDS=8
FORCE=true
DEBUG=false

Utilisation :

./challenges_management.sh --config .env

Fonctionnement des scripts

Script d'installation CTFd

1. Mise à jour du système

• Mise à jour des paquets système
• Installation des dépendances

2. Installation de Docker

• Ajout du dépôt officiel Docker
• Installation de Docker CE, Docker Compose...
• Configuration des groupes utilisateurs

3. Configuration des thèmes (optionnel)

Si l'option --theme est utilisée :

• Active le montage du dossier theme/custom/ dans le conteneur CTFd
• Permet l'utilisation de thèmes personnalisés

Outil de gestion des challenges

1. Vérification des dépendances

• Vérification de la disponibilité de Docker et du daemon
• Contrôle de la présence des outils système requis (curl, jq, yq)

2. Découverte des challenges

• Analyse de la structure du dépôt de challenges
• Identification des challenges Docker et statiques

3. Construction des images Docker

• Construction séquentielle ou parallèle des images
• Support du mode --force pour reconstruction complète
• Gestion des erreurs avec rapports détaillés

4. Ingestion des challenges

• Installation via l'API CTFd dans l'instance CTFd

5. Synchronisation

• Mise à jour des challenges existants
• Option de sauvegarde avant synchronisation
• Support du mode --force pour écrasement

6. Nettoyage

• Suppression des images Docker associées aux challenges
• Mode dry-run disponible

Structure des challenges

Dépôt de challenges attendu

repo-challenges/
├── challenges/                    # (optionnel, détecté automatiquement)
│   ├── web/
│   │   ├── challenge-1/
│   │   │   ├── challenge.yml      # Configuration du challenge
│   │   │   ├── Dockerfile         # Image Docker (pour type: docker)
│   │   │   ├── src/               # Code source
│   │   │   └── files/             # Fichiers du challenge
│   │   └── challenge-2/
│   ├── crypto/
│   └── pwn/

Warning

Le script d'ingestion de challenges fonctionne par ordre alphabétique de catégories et de challenges. Si un challenge a des prérequis, il est donc nécessaire d'ingest les prérequis en amont

Format du fichier challenge.yml

name: "MonChallenge"
author: Auteur_du_chall
category: AI

description: |-
  ## Description (français)

  Petite description en français

  ## Description (english)

  Small English description

flags:
  - polycyber{flag_a_tr0uv3r}
  
tags:
  - AI
  - A:Auteur_du_chall

requirements:
  - "Règles"

# If files needed
files:
  - "files/hello_world.txt"

# If hints needed, choose the cost
hints:
  - Hint intéressant

value: 500
type: docker                          # ou type: dynamic
extra:
  docker_image: "monchallenge:latest" # requis pour type; docker
  dynamic: True                       # requis pour type; docker
  initial: 500
  decay: 10
  minimum: 50

Configuration générée

Secrets générés

Le script génère automatiquement :

• Clé secrète CTFd (32 caractères)
• Mot de passe base de données (16 caractères)
• Mot de passe root base de données (16 caractères)

Ces scripts sont développés par l'équipe PolyCyber pour l'installation automatisée et la gestion de serveurs CTFd.