Déploiement en laboratoire¶

Un laboratoire Stentor offre un environnement sûr pour tester les opérations C2, valider la fonctionnalité des implants et développer de nouvelles techniques. Ce guide couvre deux approches de déploiement : un pipeline IaC automatisé qui déploie une forêt Active Directory de 8 VM avec une seule commande, et une configuration manuelle de 3 VM pour des tests rapides.

Conditions préalables¶

Le pipeline de laboratoire automatisé nécessite les outils suivants. Vérifiez l'installation avec make check (exécute scripts/check-prerequisites.sh).

Collections Ansible (installées automatiquement par les playbooks) :

• ansible.windows (2.5+) -- Ensemble de modules Windows
• microsoft.ad (1.7+) -- Gestion Active Directory

Architecture du laboratoire¶

Le pipeline automatisé déploie une forêt Active Directory de 8 machines virtuelles sur Proxmox, simulant un environnement d'entreprise réaliste avec des contrôleurs de domaine, des postes de travail, des serveurs de fichiers et des serveurs d'applications.

graph TB
    subgraph Proxmox["Proxmox Host (<proxmox-ip>)"]
        subgraph DC["Domain Controllers"]
            DC01["DC01<br/>10.10.10.10<br/>Primary DC"]
            DC02["DC02<br/>10.10.10.11<br/>Replica DC"]
        end

        subgraph WS["Workstations"]
            WS01["WS01<br/>10.10.10.21<br/>Engineering"]
            WS02["WS02<br/>10.10.10.22<br/>HR"]
            WS03["WS03<br/>10.10.10.23<br/>Finance"]
        end

        subgraph SRV["Servers"]
            FILE01["FILE01<br/>10.10.10.30<br/>File Server"]
            SRV01["SRV01<br/>10.10.10.40<br/>SQL + IIS"]
            WEB01["WEB01<br/>10.10.10.50<br/>nginx/Apache"]
        end
    end

    DC01 <-->|Replication| DC02
    WS01 & WS02 & WS03 -->|Domain Join| DC01
    FILE01 & SRV01 -->|Domain Join| DC01

Inventaire des machines virtuelles¶

Toutes les machines virtuelles partagent le sous-réseau 10.10.10.0/24 sur le pont Proxmox vmbr0. Le DNS est servi par DC01 (primaire) et DC02 (secondaire) pour le domaine lab.local. Passerelle : 10.10.10.1 (pont hôte Proxmox).

Démarrage rapide¶

# 1. Configure Proxmox credentials and ISO paths
cp lab/.env.example lab/.env
# Edit lab/.env with your settings

# 2. Verify prerequisites
cd lab && make check

# 3. Deploy everything (templates + provision + configure + integrate)
make deploy

Aperçu du pipeline¶

Le laboratoire utilise un pipeline Infrastructure-as-Code en quatre étapes. Chaque étape peut être exécutée indépendamment ou dans le cadre du pipeline make deploy complet.

flowchart LR
    A["Stage 1<br/><b>Packer</b><br/>make templates"] --> B["Stage 2<br/><b>Terraform</b><br/>make provision"]
    B --> C["Stage 3<br/><b>Ansible</b><br/>make configure"]
    C --> D["Stage 4<br/><b>C2 Integration</b><br/>make integrate"]

    A1["ISO files"] --> A
    A --> A2["VM Templates<br/>(9000-9002)"]
    B --> B2["8 Lab VMs<br/>(200-240)"]
    C --> C2["AD Forest<br/>lab.local"]
    D --> D2["Relay + Listener<br/>+ Beacon"]

Étape 1 : Modèles de packer (make templates)¶

Packer crée trois modèles de VM de base à partir de fichiers ISO sur le stockage Proxmox. Les modèles sont des images dorées que Terraform clone pour créer des machines virtuelles de laboratoire.

Inventaire des modèles¶

Comportements clés :

• Idempotent : vérifie l'API Proxmox avant la construction ; ignore les modèles qui existent déjà.
• Builds individuelles : make template-win-server, make template-win10, make template-ubuntu
• Durée de construction : les modèles Windows prennent 30 à 60 minutes chacun (installation ISO + Sysprep). Ubuntu prend environ 15 minutes.

Fichiers clés :

Étape 2 : Approvisionnement de Terraform (make provision)¶

Terraform clone les modèles Packer dans 8 machines virtuelles de laboratoire avec des adresses IP statiques, une allocation de ressources et une configuration réseau. Il génère également le fichier d'inventaire Ansible à partir des sorties Terraform.

Ce qu'il fait :

1. Clone chaque modèle dans une VM complète avec un VMID, une IP, un CPU et une RAM attribués.
2. Configure les interfaces réseau sur le pont vmbr0 avec des adresses IP statiques.
3. Génère ansible/inventory/hosts.yml à partir des sorties Terraform pour un transfert transparent vers l'étape 3.

Commandes clavier :

# Provision all VMs
make provision

# View current Terraform state
make status

Les variables sont définies dans terraform/variables.tf et peuvent être remplacées via lab/.env :

Fichiers clés :

Étape 3 : Configuration Ansible (make configure)¶

Ansible configure l'environnement Active Directory complet, transformant les machines virtuelles nues en un réseau d'entreprise réaliste.

# Run all Ansible playbooks
make configure

Étapes de configuration¶

Fichiers clés :

Étape 4 : Intégration C2 (make integrate)¶

La dernière étape connecte l'infrastructure C2 de Stentor à l'environnement du laboratoire, établissant la chaîne relais-listener-beacon.

# Run C2 integration
make integrate

Ce qu'il fait :

1. Enregistre le relais dans la base de données Stentor (s'il n'est pas déjà présent).
2. Crée et démarre un listener HTTPS sur le relais.
3. Déploie l'implant sur WS01 (ou un VMID personnalisé).
4. Vérifie que le beacon apparaît dans le backend de Stentor.

Commandes C2 supplémentaires¶

# Check relay, listener, and beacon status
make c2-status

# Deploy implant to a specific VM
VMID=212 make c2-deploy-implant

Fichiers clés :

Configuration¶

Fichier d'environnement¶

Copiez lab/.env.example dans lab/.env et configurez les sections suivantes.

Connexion Proxmox¶

Deux méthodes d'authentification sont prises en charge :

PROXMOX_URL=https://<proxmox-ip>:8006/api2/json
PROXMOX_NODE=proxmox
PROXMOX_USERNAME=root@pam
PROXMOX_PASSWORD=your-password

PROXMOX_URL=https://<proxmox-ip>:8006/api2/json
PROXMOX_NODE=proxmox
PROXMOX_API_TOKEN=root@pam!stentor-lab
PROXMOX_API_SECRET=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Chemins ISO¶

Les ISO utilisent la notation de stockage Proxmox (local:iso/filename.iso), et non les chemins du système de fichiers.

ISO_WIN_SERVER=local:iso/SERVER_EVAL_x64FRE_en-us.iso
ISO_WIN10=local:iso/22631.2428_PROFESSIONAL_x64_en-us.iso
ISO_UBUNTU=local:iso/ubuntu-22.04.4-live-server-amd64.iso
ISO_VIRTIO=local:iso/virtio-win.iso

Plages VMID¶

Le laboratoire automatisé est conçu pour coexister avec (et éventuellement remplacer) les VM manuelles car elles utilisent différentes plages de VMID.

Paramètres réseau¶

NETWORK_BRIDGE=vmbr0
NETWORK_GATEWAY=10.10.10.1
NETWORK_SUBNET=24
STORAGE_POOL=local-lvm

Commandes de gestion¶

# Full pipeline (check + templates + provision + configure + integrate)
make deploy

# Individual stages
make templates          # Build all Packer VM templates (idempotent)
make provision          # Deploy VMs with Terraform
make configure          # Run Ansible playbooks
make integrate          # Connect Stentor C2

# Status
make status             # Show current VM state via Terraform
make c2-status          # Check relay/listener/beacon status

# Teardown
make destroy            # Remove VMs (keep templates for fast rebuild)
make clean              # Remove VMs AND templates (full reset)

Options de démontage¶

Dépannage¶

Structure du répertoire¶

lab/
  Makefile                    # Pipeline orchestration
  .env.example                # Configuration template (copy to .env)
  .gitignore                  # Protects secrets, state, cache
  README.md                   # Source documentation
  packer/
    *.pkr.hcl                 # Packer template definitions
    http/                     # HTTP-served files (preseed, autoinstall)
    scripts/                  # Provisioning scripts (WinRM, Sysprep)
    files/autounattend/       # Windows unattended install XML
  terraform/
    main.tf                   # Provider config, VM definitions
    variables.tf              # Input variables
    outputs.tf                # Ansible inventory generation
    modules/vm/               # Reusable VM module
    templates/                # Ansible inventory template
  ansible/
    site.yml                  # Main playbook entry
    inventory/                # Generated by Terraform (gitignored)
    group_vars/               # Group variable files
    roles/                    # Role per configuration task
  scripts/
    check-prerequisites.sh    # Tool verification
    c2-integrate.sh           # C2 integration script
    c2-status.sh              # Status checker
    c2-deploy-implant.sh      # Implant deployment

Configuration rapide du laboratoire (manuel 3-VM)¶

Pour les opérateurs qui souhaitent un environnement de test minimal sans la forêt AD complète, Stentor peut fonctionner sur une simple configuration à 3 VM.

Architecture¶

graph LR
    subgraph Proxmox["Proxmox Host"]
        VM103["Stentor Server<br/>VM 103 / 10.0.0.10<br/>Docker: backend + DB + UI"]
        VM102["Kali Relay<br/>VM 102 / 10.0.0.50<br/>stentor-relay service"]
        VM110["Win10 Target<br/>VM 110 / 10.0.0.20<br/>implant.exe"]
    end

    VM103 <-->|WebSocket| VM102
    VM110 -->|HTTPS :8443| VM102

Étapes de configuration¶

1. Déployer le serveur : exécutez ./update-stentor.sh pour déployer Stentor sur la VM 103 via Docker.

2. Connectez-vous et obtenez un jeton :

   TOKEN=$(curl -s -X POST https://stentor.app/api/v1/auth/login \
     -H "Content-Type: application/json" \
     -d '{"email":"[email protected]","password":"your-password"}' \
     | jq -r '.access_token')
   

3. Enregistrer le relais dans la base de données (obligatoire avant que le relais puisse se connecter) :

   ssh root@<proxmox-ip> 'ssh [email protected] \
     "docker exec -i stentor-db psql -U stentor -d stentor_db"' <<< \
     "INSERT INTO relays (id, name, description, ip_address, status) \
      VALUES ('aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee', 'Kali Relay', \
      'Kali relay agent', '10.0.0.50', 'online') \
      ON CONFLICT (id) DO NOTHING;"
   

4. Redémarrer le service de relais :

   ssh root@<proxmox-ip> 'sshpass -p "<relay-password>" ssh [email protected] \
     "systemctl restart stentor-relay"'
   

5. Créer et démarrer un listener :

   LISTENER_ID=$(curl -s -X POST https://stentor.app/api/v1/listeners \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"name":"HTTPS Relay","type":"https","host":"10.0.0.50",
          "port":8443,"relay_id":"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"}' \
     | jq -r '.id')
   
   curl -s -X POST "https://stentor.app/api/v1/listeners/$LISTENER_ID/start" \
     -H "Authorization: Bearer $TOKEN"
   

6. Déployez et exécutez l'implant (voir Gestion des relais pour les instructions de construction) :

   # Kill old implant if running
   ssh root@<proxmox-ip> 'qm guest exec 110 -- cmd /c "taskkill /F /IM implant.exe"'
   
   # Run implant (CRITICAL: no space before &&)
   ssh root@<proxmox-ip> 'qm guest exec 110 --timeout 5 -- cmd /c \
     "set IMPLANT_C2_URL=https://10.0.0.50:8443&& \
      set IMPLANT_INSECURE_SKIP_VERIFY=true&& \
      C:\\Users\\Public\\implant.exe"'
   

7. Vérifier le beacon :

   curl -s https://stentor.app/api/v1/c2/beacons \
     -H "Authorization: Bearer $TOKEN" | jq
   

Problèmes courants¶