BeamReactor Intrusion Scanner #

Description #

Outil de scan de sécurité qui teste l'accès direct à tous les fichiers PHP de l'installation BeamReactor pour vérifier qu'ils sont correctement protégés.

Fonctionnalités #

• Scan Récursif : Parcourt automatiquement tous les répertoires (modules/, plugins/, rss/, members/)
• Catégorisation : Identifie le type de chaque fichier (handler, config, library, locale, etc.)
• Tests HTTP : Vérifie que l'accès direct renvoie bien "forbidden" ou 401/403
• Détection de Fuites : Identifie les fichiers qui exposent du contenu sans protection
• Rapport Détaillé : Affiche les résultats avec code HTTP et extrait de réponse

Structure du Plugin #

plugins/intrusion_scanner/
├── intrusion_scanner.php			  # Interface principale
├── conf/
│   └── intrusion_scanner.conf.inc.php # Configuration
└── locale/
	└── intrusion_scanner.fr.inc.php   # Traductions françaises

Installation #

1. Créer le répertoire plugins/intrusion_scanner/

2. Copier les fichiers dans la structure ci-dessus

3. Accéder à index.php?obj=intrusion_scanner.php (niveau OVERMIND requis)

Utilisation #

Lancer un Scan #

1. Accéder au plugin : ?obj=intrusion_scanner.php

2. Cliquer sur "Lancer le Scan"

3. Attendre la fin du scan (peut prendre quelques minutes)

Interpréter les Résultats #

Le scanner classe les fichiers en 4 catégories :

✓ Fichiers Protégés (Vert) #

Fichiers correctement sécurisés qui renvoient :

• Le texte "forbidden"
• Un code HTTP 401 ou 403
• Tout autre message d'interdiction configuré

Action : Aucune action requise

✗ Fichiers Vulnérables (Rouge) #

Fichiers qui renvoient du contenu (>50 caractères) sans protection.

Action URGENTE : Vérifier chaque fichier et ajouter la protection :

if(!function_exists('frameheader')) die('forbidden');

? Vérification Manuelle Requise (Orange) #

Fichiers avec réponse ambiguë (courte mais pas "forbidden").

Action : Vérifier manuellement chaque fichier

⚠ Erreurs (Rouge) #

Fichiers qui n'ont pas pu être testés (erreur cURL, timeout, etc.).

Action : Vérifier la configuration réseau et réessayer

Configuration #

Répertoires Scannés #

Par défaut :

• modules/
• plugins/
• rss/
• members/

Répertoires Exclus #

• data/, var/ (données)
• ui/, css/, js/ (assets)
• doc/, sql/, tests/ (dev)
• .git/, node_modules/ (version control)

Fichiers Exclus #

• index.php (point d'entrée légitime)
• .htaccess
• README.md

Réponses Attendues #

Le scanner considère qu'un fichier est protégé s'il contient :

• forbidden
• 401
• unauthorized
• access denied
• direct access not permitted

Sécurité #

Niveau d'Accès #

OVERMIND uniquement : Cet outil peut révéler la structure interne du système et doit être strictement limité aux administrateurs système.

Protection des Données #

• Limite la taille de réponse capturée (500 caractères)
• N'enregistre pas les réponses complètes
• Timeout de 10 secondes par fichier

Performance #

• Timeout total : 300 secondes (5 minutes)
• Timeout par fichier : 10 secondes
• Progression : Affichage en temps réel via JavaScript

Résolution de Problèmes #

Le scan ne démarre pas #

• Vérifier que vous avez le niveau OVERMIND
• Vérifier que cURL est activé en PHP

Tous les fichiers sont en erreur #

• Vérifier la configuration réseau
• Vérifier que le serveur web est accessible en local

Faux positifs #

• Vérifier manuellement les fichiers "ambigus"
• Ajuster max_response_length si nécessaire

Recommandations #

Après un Scan #

1. Corriger immédiatement tous les fichiers vulnérables

2. Vérifier les fichiers ambigus

3. Documenter les exceptions légitimes

4. Re-scanner après correction

Bonnes Pratiques #

• Lancer un scan après chaque ajout de plugin
• Lancer un scan après chaque mise à jour majeure
• Vérifier les fichiers .htaccess dans les répertoires sensibles

Architecture BeamReactor #

Rappel : Aucun fichier PHP ne doit être accessible directement

Tous les accès passent par index.php :

• members/edit_profile.php → index.php?obj=edit_profile.php
• plugins/mailbox/mailbox.php → index.php?obj=mailbox.php
• modules/handler.mod.php → index.php?obj=handler.mod

Chaque fichier doit commencer par :

if(!function_exists('frameheader')) die('forbidden');

Version #

• Version : 1.0.0
• Date : 2025-12-27
• Auteur : Treveur Bretaudière

Support #

Pour toute question ou problème, contacter l'équipe BeamReactor/AEGIS IA.