@anonympins/fingerprint 0.3.8 → 0.4.1

package/src/php/Utils/TLSClientHelloParser.php

@@ -0,0 +1,117 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Anonympins\Fingerprint\Utils;
+
+/**
+ * Décode nativement un paquet TLS Client Hello binaire pour calculer l'empreinte JA3/JA4.
+ */
+class TLSClientHelloParser
+{
+    private const GREASE_VALUES = [
+        2570, 6682, 10794, 14906, 19018, 23130, 27242, 31354,
+        35466, 39578, 43690, 47802, 51914, 55926, 60038, 64150
+    ];
+
+    /**
+     * Parse le Client Hello brut et retourne l'empreinte JA3 et une approximation JA4.
+     * 
+     * @param string $binary Le premier paquet TCP reçu sur la socket.
+     * @return array{ja3_string: string, ja3_hash: string, ja4_raw: string}|null
+     */
+    public static function parse(string $binary): ?array
+    {
+        $len = strlen($binary);
+        if ($len < 43) {
+            return null; // Paquet trop court
+        }
+
+        // 1. Vérification du Record Layer Type (0x16 = Handshake)
+        if (ord($binary[0]) !== 0x16) {
+            return null;
+        }
+
+        // 2. Vérification du Handshake Type (0x01 = Client Hello)
+        if (ord($binary[5]) !== 0x01) {
+            return null;
+        }
+
+        $offset = 43; // Sauter l'en-tête, la version et le Random Client (32 octets)
+        if ($len < $offset + 1) return null;
+
+        // 3. Lecture du Session ID
+        $sessionLen = ord($binary[$offset]);
+        $offset += 1 + $sessionLen;
+        if ($len < $offset + 2) return null;
+
+        // 4. Lecture des Cipher Suites
+        $ciphersLen = unpack('n', substr($binary, $offset, 2))[1];
+        $offset += 2;
+        if ($len < $offset + $ciphersLen + 1) return null;
+
+        $ciphers = [];
+        for ($i = 0; $i < $ciphersLen; $i += 2) {
+            $ciphers[] = unpack('n', substr($binary, $offset + $i, 2))[1];
+        }
+        $offset += $ciphersLen;
+
+        // 5. Lecture des Compression Methods
+        $compressionLen = ord($binary[$offset]);
+        $offset += 1 + $compressionLen;
+        if ($len < $offset + 2) return null;
+
+        // 6. Lecture des Extensions
+        $extensionsLen = unpack('n', substr($binary, $offset, 2))[1];
+        $offset += 2;
+
+        $extensions = [];
+        $curves = [];
+        $points = [];
+
+        $extLimit = $offset + $extensionsLen;
+        while ($offset < $extLimit && $offset + 4 <= $len) {
+            $extType = unpack('n', substr($binary, $offset, 2))[1];
+            $extLen = unpack('n', substr($binary, $offset + 2, 2))[1];
+            $offset += 4;
+
+            if ($offset + $extLen > $len) break;
+
+            $extensions[] = $extType;
+
+            if ($extType === 10) { // Extension Supported Groups (Elliptic Curves)
+                if ($extLen >= 2) {
+                    $curvesLen = unpack('n', substr($binary, $offset, 2))[1];
+                    for ($j = 2; $j < $curvesLen + 2; $j += 2) {
+                        $curves[] = unpack('n', substr($binary, $offset + $j, 2))[1];
+                    }
+                }
+            } elseif ($extType === 11) { // Extension EC Point Formats
+                if ($extLen >= 1) {
+                    $pointsLen = ord($binary[$offset]);
+                    for ($j = 1; $j < $pointsLen + 1; $j++) {
+                        $points[] = ord($binary[$offset + $j]);
+                    }
+                }
+            }
+            $offset += $extLen;
+        }
+
+        // Nettoyage des valeurs GREASE (RFC 8701) pour la conformité JA3
+        $filterGrease = fn(array $arr) => array_values(array_filter($arr, fn($v) => !in_array($v, self::GREASE_VALUES, true)));
+
+        $sslVersion = unpack('n', substr($binary, 9, 2))[1];
+        $ja3String = implode(',', [
+            $sslVersion,
+            implode('-', $filterGrease($ciphers)),
+            implode('-', $filterGrease($extensions)),
+            implode('-', $filterGrease($curves)),
+            implode('-', $filterGrease($points))
+        ]);
+
+        return [
+            'ja3_string' => $ja3String,
+            'ja3_hash'   => md5($ja3String)
+        ];
+    }
+}

package/src/php/bin/auto-tune.php

@@ -1,118 +1,118 @@
-<?php
-
-declare(strict_types=1);
-
-/**
- * CLI Script d'auto-tuning périodique des configurations de sécurité.
- * Ce script lit la configuration courante, récupère les logs, les assainit,
- * exécute l'optimiseur génétique, et écrase le fichier JSON d'origine.
- */
-
-$autoloaderPaths = [
-    __DIR__ . '/../../vendor/autoload.php',
-    __DIR__ . '/../vendor/autoload.php',
-    __DIR__ . '/../../../autoload.php',
-];
-
-$autoloaded = false;
-foreach ($autoloaderPaths as $path) {
-    if (file_exists($path)) {
-        require_once $path;
-        $autoloaded = true;
-        break;
-    }
-}
-
-if (!$autoloaded) {
-    fwrite(STDERR, "Erreur : Impossible de charger l'autoloader. Exécutez 'composer install'.\n");
-    exit(1);
-}
-
-use Anonympins\Fingerprint\Optimization\Optimization;
-use Anonympins\Fingerprint\Store\StoreManager;
-use Anonympins\Fingerprint\Utils\RequestUtils;
-
-// 1. Récupération des arguments CLI
-$configPath = $argv[1] ?? null;
-if (!$configPath) {
-    echo "Usage: php auto-tune.php [chemin_vers_security-config.json]\n";
-    exit(1);
-}
-
-if (!file_exists($configPath)) {
-    fwrite(STDERR, "Erreur : Fichier de configuration introuvable : {$configPath}\n");
-    exit(1);
-}
-
-$config = json_decode(file_get_contents($configPath), true);
-if (json_last_error() !== JSON_ERROR_NONE) {
-    fwrite(STDERR, "Erreur : Fichier de configuration JSON invalide.\n");
-    exit(1);
-}
-
-// 2. Connexion au store pour récupérer les logs accumulés
-$store = StoreManager::getStore();
-if (!$store) {
-    fwrite(STDERR, "Erreur : Aucun store de persistance actif.\n");
-    exit(1);
-}
-
-$rawTrafficLogs = $store->get('traffic_logs') ?? [];
-if (empty($rawTrafficLogs)) {
-    echo "[AutoTuning] Aucun log de trafic disponible pour l'optimisation.\n";
-    exit(0);
-}
-
-// 3. Nettoyage des données pour prévenir l'empoisonnement (Sybil attacks)
-$sanitizedLogs = RequestUtils::sanitizeTrafficData($rawTrafficLogs);
-
-$minDataPoints = $config['autotuning']['minDataPoints'] ?? 200;
-if (count($sanitizedLogs) < $minDataPoints) {
-    echo "[AutoTuning] Reporté : Pas assez de données assainies (" . count($sanitizedLogs) . "/{$minDataPoints}).\n";
-    exit(0);
-}
-
-echo "[AutoTuning] Lancement de l'optimisation sur " . count($sanitizedLogs) . " données de trafic...\n";
-
-// 4. Résolution du Front de Pareto
-$paretoFront = Optimization::solveFullSecurityTuning(['trafficData' => $sanitizedLogs]);
-if (empty($paretoFront)) {
-    fwrite(STDERR, "[AutoTuning] L'optimisation n'a retourné aucun résultat.\n");
-    exit(1);
-}
-
-// 5. Sélection de la solution la plus équilibrée
-$bestSolution = $paretoFront[0];
-$minDistance = sqrt(pow($bestSolution['objectives'][0], 2) + pow($bestSolution['objectives'][1], 2));
-foreach ($paretoFront as $candidate) {
-    $distance = sqrt(pow($candidate['objectives'][0], 2) + pow($candidate['objectives'][1], 2));
-    if ($distance < $minDistance) {
-        $minDistance = $distance;
-        $bestSolution = $candidate;
-    }
-}
-
-$newConfig = $bestSolution['solution'];
-$maxChangeVelocity = 0.15; // Inertie de 15% maximum par cycle
-
-$applyInertialUpdate = function (array &$current, array $target) use ($maxChangeVelocity) {
-    $sumCurrent = array_sum($current);
-    if ($sumCurrent === 0) return;
-    $sumTarget = 0;
-    foreach ($current as $k => $v) {
-        if (isset($target[$k])) $sumTarget += $target[$k];
-    }
-    $ratio = ($sumTarget - $sumCurrent) / $sumCurrent;
-    $factor = 1 + max(-$maxChangeVelocity, min($maxChangeVelocity, $ratio));
-    foreach ($current as $k => &$v) {
-        if (isset($target[$k])) $v *= $factor;
-    }
-};
-
-$applyInertialUpdate($config['thresholds'], $newConfig['thresholds']);
-$applyInertialUpdate($config['weights'], $newConfig['weights']);
-$applyInertialUpdate($config['patterns'], $newConfig['patterns']);
-
-// 6. Écrasement propre du fichier de configuration original
-file_put_contents($configPath, json_encode($config, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES));
+<?php
+
+declare(strict_types=1);
+
+/**
+ * CLI Script d'auto-tuning périodique des configurations de sécurité.
+ * Ce script lit la configuration courante, récupère les logs, les assainit,
+ * exécute l'optimiseur génétique, et écrase le fichier JSON d'origine.
+ */
+
+$autoloaderPaths = [
+    __DIR__ . '/../../vendor/autoload.php',
+    __DIR__ . '/../vendor/autoload.php',
+    __DIR__ . '/../../../autoload.php',
+];
+
+$autoloaded = false;
+foreach ($autoloaderPaths as $path) {
+    if (file_exists($path)) {
+        require_once $path;
+        $autoloaded = true;
+        break;
+    }
+}
+
+if (!$autoloaded) {
+    fwrite(STDERR, "Erreur : Impossible de charger l'autoloader. Exécutez 'composer install'.\n");
+    exit(1);
+}
+
+use Anonympins\Fingerprint\Optimization\Optimization;
+use Anonympins\Fingerprint\Store\StoreManager;
+use Anonympins\Fingerprint\Utils\RequestUtils;
+
+// 1. Récupération des arguments CLI
+$configPath = $argv[1] ?? null;
+if (!$configPath) {
+    echo "Usage: php auto-tune.php [chemin_vers_security-config.json]\n";
+    exit(1);
+}
+
+if (!file_exists($configPath)) {
+    fwrite(STDERR, "Erreur : Fichier de configuration introuvable : {$configPath}\n");
+    exit(1);
+}
+
+$config = json_decode(file_get_contents($configPath), true);
+if (json_last_error() !== JSON_ERROR_NONE) {
+    fwrite(STDERR, "Erreur : Fichier de configuration JSON invalide.\n");
+    exit(1);
+}
+
+// 2. Connexion au store pour récupérer les logs accumulés
+$store = StoreManager::getStore();
+if (!$store) {
+    fwrite(STDERR, "Erreur : Aucun store de persistance actif.\n");
+    exit(1);
+}
+
+$rawTrafficLogs = $store->get('traffic_logs') ?? [];
+if (empty($rawTrafficLogs)) {
+    echo "[AutoTuning] Aucun log de trafic disponible pour l'optimisation.\n";
+    exit(0);
+}
+
+// 3. Nettoyage des données pour prévenir l'empoisonnement (Sybil attacks)
+$sanitizedLogs = RequestUtils::sanitizeTrafficData($rawTrafficLogs);
+
+$minDataPoints = $config['autotuning']['minDataPoints'] ?? 200;
+if (count($sanitizedLogs) < $minDataPoints) {
+    echo "[AutoTuning] Reporté : Pas assez de données assainies (" . count($sanitizedLogs) . "/{$minDataPoints}).\n";
+    exit(0);
+}
+
+echo "[AutoTuning] Lancement de l'optimisation sur " . count($sanitizedLogs) . " données de trafic...\n";
+
+// 4. Résolution du Front de Pareto
+$paretoFront = Optimization::solveFullSecurityTuning(['trafficData' => $sanitizedLogs]);
+if (empty($paretoFront)) {
+    fwrite(STDERR, "[AutoTuning] L'optimisation n'a retourné aucun résultat.\n");
+    exit(1);
+}
+
+// 5. Sélection de la solution la plus équilibrée
+$bestSolution = $paretoFront[0];
+$minDistance = sqrt(pow($bestSolution['objectives'][0], 2) + pow($bestSolution['objectives'][1], 2));
+foreach ($paretoFront as $candidate) {
+    $distance = sqrt(pow($candidate['objectives'][0], 2) + pow($candidate['objectives'][1], 2));
+    if ($distance < $minDistance) {
+        $minDistance = $distance;
+        $bestSolution = $candidate;
+    }
+}
+
+$newConfig = $bestSolution['solution'];
+$maxChangeVelocity = 0.15; // Inertie de 15% maximum par cycle
+
+$applyInertialUpdate = function (array &$current, array $target) use ($maxChangeVelocity) {
+    $sumCurrent = array_sum($current);
+    if ($sumCurrent === 0) return;
+    $sumTarget = 0;
+    foreach ($current as $k => $v) {
+        if (isset($target[$k])) $sumTarget += $target[$k];
+    }
+    $ratio = ($sumTarget - $sumCurrent) / $sumCurrent;
+    $factor = 1 + max(-$maxChangeVelocity, min($maxChangeVelocity, $ratio));
+    foreach ($current as $k => &$v) {
+        if (isset($target[$k])) $v *= $factor;
+    }
+};
+
+$applyInertialUpdate($config['thresholds'], $newConfig['thresholds']);
+$applyInertialUpdate($config['weights'], $newConfig['weights']);
+$applyInertialUpdate($config['patterns'], $newConfig['patterns']);
+
+// 6. Écrasement propre du fichier de configuration original
+file_put_contents($configPath, json_encode($config, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES));
 echo "[AutoTuning] Succès : Fichier {$configPath} mis à jour avec les paramètres optimisés.\n";