Guide d'Utilisation des Admonitions Pédagogiques

Ce guide présente les 8 types d’admonitions personnalisées disponibles dans la documentation TAAF.

---

1. Prerequis (Bleu)

Utilisé pour lister les prérequis techniques avant de démarrer un TP ou une phase.

Prérequis techniques

Infrastructure requise:

• VM TAAF-DOCKER-001 opérationnelle
• Docker et Docker Compose installés
• Stack monitoring démarrée (TP1 et TP2 terminés)

Validation rapide:

docker-compose ps
curl http://localhost:3000

Code Markdown:

:::prerequis[Prérequis techniques]
Contenu ici...
:::

---

2. Validation (Vert)

Points de contrôle pour vérifier que l’étudiant a bien complété une étape.

Point de validation

Vérifiez que vous avez complété:

• Falco installé sur TAAF-DOCKER-001
• Falco installé sur TAAF-MONITORING-001
• Les deux instances démarrent sans erreur
• Configuration JSON activée
• Surveillance des conteneurs active

Test de validation:

docker logs falco-docker
docker exec falco-docker falco --version

Code Markdown:

:::validation[Point de validation]
- [ ] Tâche 1
- [ ] Tâche 2
:::

---

3. Attention (Orange)

Avertissements critiques, notamment pour la sécurité.

Point de vigilance sécurité

ATTENTION CRITIQUE - Configuration ACLs Pare-feu:

Respectez le principe du moindre privilège:

• ✅ Limitez l’accès aux services nécessaires uniquement
• ✅ Ne jamais exposer SSH (port 22) sur Internet
• ✅ Documentez chaque règle ACL créée
• ❌ NE PAS ouvrir tous les ports par défaut

Impact: Une mauvaise configuration expose l’infrastructure TAAF à des intrusions.

Code Markdown:

:::attention[Point de vigilance sécurité]
Contenu critique...
:::

---

4. Test (Cyan)

Scénarios de test et simulations d’incidents.

Scénario de test

Test 1 - Détection d’accès shell PostgreSQL:

# Déclencher une alerte Falco
docker exec -it postgres-af bash
# → Doit générer: "Shell spawned in PostgreSQL Container"

Test 2 - Vérification dans les logs:

docker logs falco-siem | grep -i postgres

Résultat attendu: Alerte visible avec user, container, command.

Code Markdown:

:::test[Scénario de test]
Étapes du test...
:::

---

5. Architecture (Indigo)

Explications sur l’architecture et l’infrastructure.

Architecture de l’infrastructure

Topologie réseau TAAF:

graph TB
 DOCKER[TAAF-DOCKER-001
Nextcloud + PostgreSQL] --> WAZUH[TAAF-WAZUH-001
SIEM]
 MONITORING[TAAF-MONITORING-001
Grafana + Loki] --> WAZUH

Flux de données:

• Stack SIEM: Falco → Wazuh Manager → Wazuh Indexer
• Stack Monitoring: Logs → Grafana Alloy → Loki → Grafana

Important: Les deux stacks sont 100% indépendantes par design.

Code Markdown:

:::architecture[Architecture de l'infrastructure]
Description de l'architecture...
:::

---

6. Troubleshooting (Jaune)

Dépannage et résolution de problèmes courants.

Problèmes courants et solutions

Problème: Falco ne détecte aucun événement

Causes possibles:

1. Falco ne tourne pas en mode privilégié

   # Vérifier dans docker-compose.yml
   privileged: true

2. Volumes non montés correctement

   # Vérifier les montages
   docker inspect falco-siem | grep Mounts

3. Règles mal placées

   # Vérifier le chemin
   ls /etc/falco/rules.d/

Solution: Redémarrer avec la configuration corrigée:

docker-compose down && docker-compose up -d

Code Markdown:

:::troubleshooting[Problèmes courants et solutions]
Problème et solution...
:::

---

7. Important (Bleu clair)

Notes importantes à retenir (non critiques).

Point important

Architecture à deux stacks indépendantes:

• Stack SIEM (Wazuh): Analyse de sécurité et corrélation d’événements
• Stack Monitoring (Loki/Grafana): Supervision opérationnelle

Ces deux stacks ne communiquent PAS entre elles par design. Elles sont déployées sur des VMs séparées pour garantir l’isolation.

Code Markdown:

:::important[Point important]
Information importante...
:::

---

8. Bonus (Or/Doré)

Exercices optionnels et approfondissements.

Exercice bonus (optionnel)

Extension Windows Active Directory

Pour aller plus loin, intégrez la surveillance d’un environnement Windows dans votre SIEM:

• Installation Active Directory sur Windows Server
• Déploiement d’agents Wazuh Windows
• Corrélation d’événements Linux-Windows
• Détection d’attaques Active Directory

Points bonus: +10 points

📄 Voir TP-integration-Windows.md

Code Markdown:

:::bonus[Exercice bonus (optionnel)]
Contenu bonus...
:::

---

Admonitions Pliables (Collapsible)

Toutes les admonitions peuvent être rendues pliables en utilisant ??? au lieu de !!!:

??? prerequis “Prérequis détaillés (cliquer pour déplier)” Ce contenu est masqué par défaut.

- Point 1
- Point 2
- Point 3

Code Markdown:

??? prerequis "Titre pliable"
    Contenu masqué par défaut...

Pour avoir une admonition pliable mais dépliée par défaut, utilisez ???+:

???+ validation “Checklist de validation (déjà dépliée)” - [ ] Item 1 - [ ] Item 2

Code Markdown:

???+ validation "Titre (déplié par défaut)"
    Contenu...

---

Combinaisons et Bonnes Pratiques

Exemple de TP complet

# TP 1 - Installation Falco

:::prerequis[Avant de commencer]
- VM TAAF-DOCKER-001 accessible en SSH
- Docker installé et fonctionnel
:::
## Installation

:::attention[Sécurité]
N'installez Falco qu'en mode privilégié pour la détection kernel.
:::
[Instructions d'installation...]

:::validation[Vérification]
- [ ] Falco installé
- [ ] Logs visibles dans `docker logs`
:::
## Tests

:::test[Scénario de test 1]
```bash
docker exec -it postgres-af bash

:::

Si ça ne marche pas

Vérifiez que privileged: true est bien dans docker-compose.yml

Pour aller plus loin

Créez vos propres règles Falco personnalisées.

---

## Récapitulatif des Types

| Type | Couleur | Icône | Usage |
|------|---------|-------|-------|
| `prerequis` | Bleu | ✓ | Prérequis techniques |
| `validation` | Vert | ✓✓ | Points de contrôle |
| `attention` | Orange | ⚠️ | Avertissements sécurité |
| `test` | Cyan | 🧪 | Scénarios de test |
| `architecture` | Indigo | 🏗️ | Explications infrastructure |
| `troubleshooting` | Jaune | 🔧 | Dépannage |
| `important` | Bleu clair | ℹ️ | Notes importantes |
| `bonus` | Or | ⭐ | Exercices optionnels |

---

**Bonne rédaction !** 📝