@anonympins/fingerprint 0.6.6 → 0.7.0

package/src/php/Ja3AnomalyDetector.php

@@ -1,228 +1,258 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Anonympins\Fingerprint;
-
-/**
- * Classe de détection d'anomalies et d'usurpation TLS (JA3) en PHP.
- */
-class Ja3AnomalyDetector
-{
-    // Liste décimale des valeurs GREASE (RFC 8701) utilisées par les moteurs Chromium/Safari récents
-    private const GREASE_VALUES = [
-        2570, 6682, 10794, 14906, 19018, 23130, 27242, 31354,
-        35466, 39578, 43690, 47802, 51914, 55926, 60038, 64150
-    ];
-
-    // Base de données locale de signatures JA3 MD5 connues pour la corroboration de base
-    private const TLS_FINGERPRINT_DB = [
-        'e188a442b87f422c5a1e80b05399435b' => ['Chrome'],
-        'd8e35855049321c6042a4325c697858f' => ['Chrome'],
-        'a9f90958d44533748c139a5d1895b925' => ['Chrome'],
-        '3b5379916d2b3882253c42885956a350' => ['Chrome'],
-        '59822058c95c33d2d06e52f410855c8c' => ['Chrome'],
-        'b386946a5a586163c7c533636b45c355' => ['Firefox'],
-        '66236495a523c1785f8f3a105b248b11' => ['Firefox'],
-        'b73d470006575b5e35167a0b5a8540e2' => ['Firefox'],
-        '8443d7562933834333943465d52363cf' => ['Firefox'],
-        'b633f21d532d35967c8753c38536b4d3' => ['Safari'],
-        '4d7a28d5f55b359b69100a311013f03e' => ['Safari', 'Chrome', 'Firefox'],
-        '8dd3d7532873575314df23c447543001' => ['Safari', 'Chrome', 'Firefox'],
-        // Bibliothèques et scrapers automatisés connus
-        '47344a349b75c4e82333475553b5f358' => ['Python'],
-        'b29587b8a143c42546133ad7704b3310' => ['Go'],
-        'd435b5223b2884c5a832b842637e245f' => ['Java'],
-        'c72366b9551263d990b7fa574225332c' => ['curl'],
-    ];
-
-    /**
-     * Analyse une chaîne JA3 brute non hachée.
-     * Format attendu : "TLSVersion,Ciphers,Extensions,EllipticCurves,EllipticCurveFormats"
-     */
-    public static function parseJa3(string $ja3String): ?array
-    {
-        if (empty($ja3String)) {
-            return null;
-        }
-
-        $parts = explode(',', $ja3String);
-        if (count($parts) !== 5) {
-            return null;
-        }
-
-        return [
-            'tlsVersion' => (int)$parts[0],
-            'ciphers'    => $parts[1] !== '' ? array_map('intval', explode('-', $parts[1])) : [],
-            'extensions' => $parts[2] !== '' ? array_map('intval', explode('-', $parts[2])) : [],
-            'curves'     => $parts[3] !== '' ? array_map('intval', explode('-', $parts[3])) : [],
-            'points'     => $parts[4] !== '' ? array_map('intval', explode('-', $parts[4])) : []
-        ];
-    }
-
-    /**
-     * Vérifie si un tableau contient au moins une valeur GREASE.
-     */
-    public static function hasGrease(array $values): bool
-    {
-        foreach ($values as $val) {
-            if (in_array($val, self::GREASE_VALUES, true)) {
-                return true;
-            }
-        }
-        return false;
-    }
-
-    /**
-     * Parse sommairement le User-Agent pour en extraire la famille de navigateur.
-     */
-    public static function getBrowserFamily(string $userAgent): ?string
-    {
-        $ua = strtolower($userAgent);
-        if (strpos($ua, 'edg') !== false) {
-            return 'Edge';
-        }
-        if (strpos($ua, 'chrome') !== false) {
-            return 'Chrome';
-        }
-        if (strpos($ua, 'firefox') !== false) {
-            return 'Firefox';
-        }
-        if (strpos($ua, 'safari') !== false) {
-            return 'Safari';
-        }
-        return null;
-    }
-
-    /**
-     * Calcule le score global d'anomalie et d'usurpation JA3.
-     * 
-     * @param string|null $ja3Hash L'empreinte MD5 du JA3 (32 caractères)
-     * @param string|null $ja3Raw L'empreinte brute non hachée (si disponible)
-     * @param string $userAgent Le User-Agent de la requête
-     * @param string $httpVersion La version HTTP de la requête (ex: "HTTP/2", "HTTP/1.1", ou "2.0")
-     * @param object|null $cacheInstance Un driver de cache (ex: instance Redis) supportant get() et set() pour la détection de stagnation
-     * @return int Un score de suspicion compris entre 0 et 100
-     */
-    public static function getJa3AnomalyScore(
-        ?string $ja3Hash,
-        ?string $ja3Raw,
-        string $userAgent,
-        string $httpVersion,
-        ?object $cacheInstance = null
-    ): int {
-        $score = 0;
-        $claimedBrowser = self::getBrowserFamily($userAgent);
-        $isHumanBrowser = in_array($claimedBrowser, ['Chrome', 'Firefox', 'Safari', 'Edge'], true);
-
-        // --- ANALYSE 1 : CONTRÔLE SUR LE MD5 DU JA3 ---
-        if ($ja3Hash && strlen($ja3Hash) === 32) {
-            if (isset(self::TLS_FINGERPRINT_DB[$ja3Hash])) {
-                $expectedBrowsers = self::TLS_FINGERPRINT_DB[$ja3Hash];
-
-                // Cas A : L'empreinte correspond à un outil de scraping mais le UA prétend être humain
-                $isLibrary = array_intersect($expectedBrowsers, ['Python', 'Go', 'Java', 'curl']);
-                if (!empty($isLibrary) && $isHumanBrowser) {
-                    $score = max($score, 90); // Suspicion maximale : usurpation évidente
-                }
-                
-                // Cas B : Incohérence directe entre le UA prétendu et la stack TLS correspondante
-                if ($claimedBrowser !== null) {
-                    $matched = false;
-                    foreach ($expectedBrowsers as $expected) {
-                        if (stripos($claimedBrowser, $expected) === 0) {
-                            $matched = true;
-                            break;
-                        }
-                    }
-                    if (!$matched) {
-                        $score = max($score, 80); // Le navigateur déclaré ne correspond pas au client TLS utilisé
-                    }
-                }
-            }
-
-            // Cas C : Tracking de stagnation multi-UA (Stateful)
-            if ($cacheInstance && $claimedBrowser !== null && method_exists($cacheInstance, 'get') && method_exists($cacheInstance, 'set')) {
-                $cacheKey = "ja3-browsers:" . $ja3Hash;
-                
-                try {
-                    $rawCached = $cacheInstance->get($cacheKey);
-                    $seenBrowsers = $rawCached ? json_decode((string)$rawCached, true) : [];
-                    if (!is_array($seenBrowsers)) {
-                        $seenBrowsers = [];
-                    }
-
-                    if (!in_array($claimedBrowser, $seenBrowsers, true)) {
-                        $seenBrowsers[] = $claimedBrowser;
-                        // Cache pendant 24 heures (86400 secondes)
-                        if (method_exists($cacheInstance, 'setex')) {
-                            $cacheInstance->setex($cacheKey, 86400, json_encode($seenBrowsers));
-                        } else {
-                            $cacheInstance->set($cacheKey, json_encode($seenBrowsers), 86400);
-                        }
-                    }
-
-                    // Si une seule stack TLS génère des requêtes avec différents navigateurs, c'est un bot en rotation de UA
-                    if (count($seenBrowsers) > 1) {
-                        $score = max($score, 85);
-                    }
-                } catch (\Throwable $e) {
-                    // Tolérance aux pannes du cache
-                }
-            }
-        }
-
-        // --- ANALYSE 2 : CONTRÔLE PROFOND SUR L'EMPREINTE BRUTE (RAW JA3) ---
-        if ($ja3Raw) {
-            $parsed = self::parseJa3($ja3Raw);
-            if ($parsed) {
-                // Contrôle A : Mécanisme GREASE pour Chrome / Edge (obligatoire)
-                if ($claimedBrowser === 'Chrome' || $claimedBrowser === 'Edge') {
-                    $hasCiphersGrease = self::hasGrease($parsed['ciphers']);
-                    $hasExtensionsGrease = self::hasGrease($parsed['extensions']);
-                    
-                    if (!$hasCiphersGrease && !$hasExtensionsGrease) {
-                        // Chrome ou Edge moderne sans GREASE = spoofing de bas niveau (ex: python-requests déguisé)
-                        $score = max($score, 75);
-                    }
-                }
-
-                // Contrôle B : HTTP/2 ou HTTP/3 sans négociation ALPN (Extension 16)
-                $isH2OrHigher = (
-                    strpos($httpVersion, '2.0') !== false || 
-                    strpos($httpVersion, 'HTTP/2') !== false || 
-                    strpos($httpVersion, 'HTTP/3') !== false
-                );
-                $hasAlpnExtension = in_array(16, $parsed['extensions'], true);
-                
-                if ($isH2OrHigher && !$hasAlpnExtension) {
-                    // Négociation HTTP/2 active au niveau serveur mais absente au niveau des extensions TLS du client
-                    $score = max($score, 70);
-                }
-
-                // Contrôle C : Version TLS obsolète négociée par un navigateur moderne (ex: TLS < 1.2, id < 771)
-                if ($isHumanBrowser && $parsed['tlsVersion'] < 771) {
-                    $score = max($score, 80);
-                }
-            }
-        }
-
-        return $score;
-    }
-}
-
-// --- EXEMPLE D'UTILISATION PRATIQUE ---
-/*
-$userAgent = $_SERVER['HTTP_USER_AGENT'] ?? '';
-$httpVersion = $_SERVER['SERVER_PROTOCOL'] ?? '';
-
-// Récupération des en-têtes injectés par votre Reverse-Proxy (Nginx, HAProxy, etc.)
-$ja3Hash = $_SERVER['HTTP_X_JA3_HASH'] ?? null;
-$ja3Raw  = $_SERVER['HTTP_X_JA3_RAW'] ?? null; 
-
-// Redis facultatif pour la détection stateful de rotation UA
-$redis = new \Redis();
-$redis->connect('127.0.0.1', 6379);
-
-$suspicionScore = Ja3AnomalyDetector::getJa3AnomalyScore($ja3Hash, $ja3Raw, $userAgent, $httpVersion, $redis);
+<?php
+
+declare(strict_types=1);
+
+namespace Anonympins\Fingerprint;
+
+/**
+ * Classe de détection d'anomalies et d'usurpation TLS (JA3) en PHP.
+ */
+class Ja3AnomalyDetector
+{
+    // Liste décimale des valeurs GREASE (RFC 8701) utilisées par les moteurs Chromium/Safari récents
+    private const GREASE_VALUES = [
+        2570, 6682, 10794, 14906, 19018, 23130, 27242, 31354,
+        35466, 39578, 43690, 47802, 51914, 55926, 60038, 64150
+    ];
+
+    // Base de données locale de signatures JA3 MD5 connues pour la corroboration de base
+    private const TLS_FINGERPRINT_DB = [
+        'e188a442b87f422c5a1e80b05399435b' => ['Chrome'],
+        'd8e35855049321c6042a4325c697858f' => ['Chrome'],
+        'a9f90958d44533748c139a5d1895b925' => ['Chrome'],
+        '3b5379916d2b3882253c42885956a350' => ['Chrome'],
+        '59822058c95c33d2d06e52f410855c8c' => ['Chrome'],
+        'b386946a5a586163c7c533636b45c355' => ['Firefox'],
+        '66236495a523c1785f8f3a105b248b11' => ['Firefox'],
+        'b73d470006575b5e35167a0b5a8540e2' => ['Firefox'],
+        '8443d7562933834333943465d52363cf' => ['Firefox'],
+        'b633f21d532d35967c8753c38536b4d3' => ['Safari'],
+        '4d7a28d5f55b359b69100a311013f03e' => ['Safari', 'Chrome', 'Firefox'],
+        '8dd3d7532873575314df23c447543001' => ['Safari', 'Chrome', 'Firefox'],
+        // Bibliothèques et scrapers automatisés connus
+        '47344a349b75c4e82333475553b5f358' => ['Python'],
+        'b29587b8a143c42546133ad7704b3310' => ['Go'],
+        'd435b5223b2884c5a832b842637e245f' => ['Java'],
+        'c72366b9551263d990b7fa574225332c' => ['curl'],
+    ];
+
+    /**
+     * Analyse une chaîne JA3 brute non hachée.
+     * Format attendu : "TLSVersion,Ciphers,Extensions,EllipticCurves,EllipticCurveFormats"
+     */
+    public static function parseJa3(string $ja3String): ?array
+    {
+        if (empty($ja3String)) {
+            return null;
+        }
+
+        $parts = explode(',', $ja3String);
+        if (count($parts) !== 5) {
+            return null;
+        }
+
+        return [
+            'tlsVersion' => (int)$parts[0],
+            'ciphers'    => $parts[1] !== '' ? array_map('intval', explode('-', $parts[1])) : [],
+            'extensions' => $parts[2] !== '' ? array_map('intval', explode('-', $parts[2])) : [],
+            'curves'     => $parts[3] !== '' ? array_map('intval', explode('-', $parts[3])) : [],
+            'points'     => $parts[4] !== '' ? array_map('intval', explode('-', $parts[4])) : []
+        ];
+    }
+
+    /**
+     * Vérifie si un tableau contient au moins une valeur GREASE.
+     */
+    public static function hasGrease(array $values): bool
+    {
+        foreach ($values as $val) {
+            if (in_array($val, self::GREASE_VALUES, true)) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    /**
+     * Parse sommairement le User-Agent pour en extraire la famille de navigateur.
+     */
+    public static function getBrowserFamily(string $userAgent): ?string
+    {
+        $ua = strtolower($userAgent);
+        if (strpos($ua, 'edg') !== false) {
+            return 'Edge';
+        }
+        if (strpos($ua, 'chrome') !== false) {
+            return 'Chrome';
+        }
+        if (strpos($ua, 'firefox') !== false) {
+            return 'Firefox';
+        }
+        if (strpos($ua, 'safari') !== false) {
+            return 'Safari';
+        }
+        return null;
+    }
+
+    /**
+     * Calcule le score global d'anomalie et d'usurpation JA3.
+     * 
+     * @param string|null $ja3Hash L'empreinte MD5 du JA3 (32 caractères)
+     * @param string|null $ja3Raw L'empreinte brute non hachée (si disponible)
+     * @param string $userAgent Le User-Agent de la requête
+     * @param string $httpVersion La version HTTP de la requête (ex: "HTTP/2", "HTTP/1.1", ou "2.0")
+     * @param object|null $cacheInstance Un driver de cache (ex: instance Redis) supportant get() et set() pour la détection de stagnation
+     * @return int Un score de suspicion compris entre 0 et 100
+     */
+    public static function getJa3AnomalyScore(
+        ?string $ja3Hash,
+        ?string $ja3Raw,
+        string $userAgent,
+        string $httpVersion,
+        ?object $cacheInstance = null
+    ): int {
+        $score = 0;
+        $claimedBrowser = self::getBrowserFamily($userAgent);
+        $isHumanBrowser = in_array($claimedBrowser, ['Chrome', 'Firefox', 'Safari', 'Edge'], true);
+
+        // --- ANALYSE 1 : CONTRÔLE SUR LE MD5 DU JA3 ---
+        if ($ja3Hash && strlen($ja3Hash) === 32) {
+            if (isset(self::TLS_FINGERPRINT_DB[$ja3Hash])) {
+                $expectedBrowsers = self::TLS_FINGERPRINT_DB[$ja3Hash];
+
+                // Cas A : L'empreinte correspond à un outil de scraping mais le UA prétend être humain
+                $isLibrary = array_intersect($expectedBrowsers, ['Python', 'Go', 'Java', 'curl']);
+                if (!empty($isLibrary) && $isHumanBrowser) {
+                    $score = max($score, 90); // Suspicion maximale : usurpation évidente
+                }
+                
+                // Cas B : Incohérence directe entre le UA prétendu et la stack TLS correspondante
+                if ($claimedBrowser !== null) {
+                    $matched = false;
+                    foreach ($expectedBrowsers as $expected) {
+                        if (stripos($claimedBrowser, $expected) === 0) {
+                            $matched = true;
+                            break;
+                        }
+                    }
+                    if (!$matched) {
+                        $score = max($score, 80); // Le navigateur déclaré ne correspond pas au client TLS utilisé
+                    }
+                }
+            }
+
+            // Cas C : Tracking de stagnation multi-UA (Stateful)
+            if ($cacheInstance && $claimedBrowser !== null && method_exists($cacheInstance, 'get') && method_exists($cacheInstance, 'set')) {
+                $cacheKey = "ja3-browsers:" . $ja3Hash;
+                
+                try {
+                    $rawCached = $cacheInstance->get($cacheKey);
+                    $seenBrowsers = $rawCached ? json_decode((string)$rawCached, true) : [];
+                    if (!is_array($seenBrowsers)) {
+                        $seenBrowsers = [];
+                    }
+
+                    if (!in_array($claimedBrowser, $seenBrowsers, true)) {
+                        $seenBrowsers[] = $claimedBrowser;
+                        // Cache pendant 24 heures (86400 secondes)
+                        if (method_exists($cacheInstance, 'setex')) {
+                            $cacheInstance->setex($cacheKey, 86400, json_encode($seenBrowsers));
+                        } else {
+                            $cacheInstance->set($cacheKey, json_encode($seenBrowsers), 86400);
+                        }
+                    }
+
+                    // Si une seule stack TLS génère des requêtes avec différents navigateurs, c'est un bot en rotation de UA
+                    if (count($seenBrowsers) > 1) {
+                        $score = max($score, 85);
+                    }
+                } catch (\Throwable $e) {
+                    // Tolérance aux pannes du cache
+                }
+            }
+        }
+
+        // --- ANALYSE 2 : CONTRÔLE PROFOND SUR L'EMPREINTE BRUTE (RAW JA3) ---
+        if ($ja3Raw) {
+            $parsed = self::parseJa3($ja3Raw);
+            if ($parsed) {
+                // Contrôle A : Mécanisme GREASE pour Chrome / Edge (obligatoire)
+                if ($claimedBrowser === 'Chrome' || $claimedBrowser === 'Edge') {
+                    $hasCiphersGrease = self::hasGrease($parsed['ciphers']);
+                    $hasExtensionsGrease = self::hasGrease($parsed['extensions']);
+                    
+                    if (!$hasCiphersGrease && !$hasExtensionsGrease) {
+                        // Chrome ou Edge moderne sans GREASE = spoofing de bas niveau (ex: python-requests déguisé)
+                        $score = max($score, 75);
+                    }
+                }
+
+                // Contrôle B : HTTP/2 ou HTTP/3 sans négociation ALPN (Extension 16)
+                $isH2OrHigher = (
+                    strpos($httpVersion, '2.0') !== false || 
+                    strpos($httpVersion, 'HTTP/2') !== false || 
+                    strpos($httpVersion, 'HTTP/3') !== false
+                );
+                $hasAlpnExtension = in_array(16, $parsed['extensions'], true);
+                
+                if ($isH2OrHigher && !$hasAlpnExtension) {
+                    // Négociation HTTP/2 active au niveau serveur mais absente au niveau des extensions TLS du client
+                    $score = max($score, 70);
+                }
+
+                // Contrôle C : Version TLS obsolète négociée par un navigateur moderne (ex: TLS < 1.2, id < 771)
+                if ($isHumanBrowser && $parsed['tlsVersion'] < 771) {
+                    $score = max($score, 80);
+                }
+            }
+        }
+
+        return $score;
+    }
+
+    /**
+     * Feature 7 : Corrélation RTT & Latence de Proxy Résidentiel
+     * Calcule un score d'anomalie en corrélant le RTT TCP de bas niveau avec la latence applicative.
+     */
+    public static function getRttProxyScore(RequestContext $context): int
+    {
+        $tcpRttHeader = $context->headers['x-tcp-rtt'] ?? $context->headers['x-real-rtt'] ?? null;
+        $tcpRtt = $tcpRttHeader !== null ? (int)$tcpRttHeader : null;
+
+        $behaviorHeader = $context->headers['x-behavior-metrics'] ?? null;
+        if ($behaviorHeader) {
+            $metrics = json_decode($behaviorHeader, true);
+            if (json_last_error() === JSON_ERROR_NONE && isset($metrics['clientTimestamp'])) {
+                $clientTimestamp = (int)$metrics['clientTimestamp'];
+                $appLatency = $context->requestTimestamp - $clientTimestamp;
+                if ($tcpRtt !== null && $tcpRtt > 0) {
+                    $clientToProxyDelta = $appLatency - $tcpRtt;
+                    if ($tcpRtt < 35 && $clientToProxyDelta > 150) {
+                        return 85;
+                    }
+                } else {
+                    if ($appLatency > 350) {
+                        return 40;
+                    }
+                }
+            }
+        }
+        return 0;
+    }
+}
+
+// --- EXEMPLE D'UTILISATION PRATIQUE ---
+/*
+$userAgent = $_SERVER['HTTP_USER_AGENT'] ?? '';
+$httpVersion = $_SERVER['SERVER_PROTOCOL'] ?? '';
+
+// Récupération des en-têtes injectés par votre Reverse-Proxy (Nginx, HAProxy, etc.)
+$ja3Hash = $_SERVER['HTTP_X_JA3_HASH'] ?? null;
+$ja3Raw  = $_SERVER['HTTP_X_JA3_RAW'] ?? null; 
+
+// Redis facultatif pour la détection stateful de rotation UA
+$redis = new \Redis();
+$redis->connect('127.0.0.1', 6379);
+
+$suspicionScore = Ja3AnomalyDetector::getJa3AnomalyScore($ja3Hash, $ja3Raw, $userAgent, $httpVersion, $redis);
 */

package/src/php/Optimization/OptimizationOperators.php

@@ -104,7 +104,7 @@ class OptimizationOperators
                     'importance' => 3.0,
                     'ux_vs_security_ratio' => 0.8,
                     'target_threshold' => 'low',
-                    'indicators' => ['requestPatternScore', 'renderingAnomalyScore', 'clientHintsInconsistencyScore']
+                'indicators' => ['requestPatternScore', 'renderingAnomalyScore', 'clientHintsInconsistencyScore', 'virtualizationScore']
                 ],
                 'distributed_botnets' => [
                     'importance' => 6.0,
@@ -116,7 +116,7 @@ class OptimizationOperators
                     'importance' => 5.0,
                     'ux_vs_security_ratio' => 0.4,
                     'target_threshold' => 'medium',
-                    'indicators' => ['botScore', 'tlsSpoofingScore', 'tcpAnomalyScore']
+                'indicators' => ['botScore', 'tlsSpoofingScore', 'tcpAnomalyScore', 'virtualizationScore']
                 ]
             ];
 

package/src/php/ProblemManager.php

@@ -303,6 +303,89 @@ class ProblemManager
         return false;
     }
 
+    /**
+     * S'assure qu'un problème a une solution initiale. Si non, en génère une.
+     *
+     * @param array &$problem Le problème à vérifier (passé par référence).
+     */
+    private function ensureInitialSolution(array &$problem): void
+    {
+        if (!empty($problem['state']['bestSolution'])) {
+            return;
+        }
+
+        $scoreFunction = $problem['workUnit']['scoreFunction'] ?? null;
+        $initialSolutionSourceKey = $problem['workUnit']['initialSolutionSource'] ?? '';
+        $initialSolution = $problem['payload'][$initialSolutionSourceKey] ?? null;
+
+        if ($scoreFunction && is_array($initialSolution)) {
+            $score = $scoreFunction($initialSolution, $problem['payload'] ?? []);
+            $problem['state']['bestSolution'] = $initialSolution;
+            $problem['state']['bestEnergy'] = $score;
+            $problem['state']['lastUpdate'] = (new \DateTime())->format(\DateTime::ATOM);
+            $this->store->set("problem-state:{$problem['id']}", $problem['state']);
+        }
+    }
+
+    /**
+     * Formate l'état d'un problème pour l'export externe.
+     */
+    private function formatSolution(array $problem): ?array
+    {
+        if (!isset($problem['state'])) {
+            return null;
+        }
+
+        if (($problem['workUnit']['type'] ?? '') === 'multi_objective_genetic_algorithm') {
+            return [
+                'id' => $problem['id'],
+                'solution' => $problem['state']['paretoFront'] ?? [],
+                'score' => count($problem['state']['paretoFront'] ?? []),
+                'lastUpdate' => $problem['state']['lastUpdate'] ?? null,
+            ];
+        }
+
+        return [
+            'id' => $problem['id'],
+            'solution' => $problem['state']['bestSolution'] ?? null,
+            'score' => $problem['state']['bestEnergy'] ?? null,
+            'lastUpdate' => $problem['state']['lastUpdate'] ?? null,
+        ];
+    }
+
+    /**
+     * Récupère la meilleure solution actuellement connue pour un ou plusieurs problèmes.
+     *
+     * @param string|null $problemId L'ID optionnel du problème à consulter.
+     * @return array|null Un tableau associatif ou une liste de tableaux associatifs.
+     */
+    public function getBestSolutions(?string $problemId = null): ?array
+    {
+        $problemsToProcess = [];
+        foreach ($this->problems as &$p) {
+            if ($problemId === null || $p['id'] === $problemId) {
+                if (($p['workUnit']['type'] ?? '') !== 'multi_objective_genetic_algorithm') {
+                    $this->ensureInitialSolution($p);
+                }
+                $problemsToProcess[] = $p;
+            }
+        }
+        unset($p);
+
+        if ($problemId !== null) {
+            return !empty($problemsToProcess) ? $this->formatSolution($problemsToProcess[0]) : null;
+        }
+
+        $results = [];
+        foreach ($this->problems as $p) {
+            $formatted = $this->formatSolution($p);
+            if ($formatted && $formatted['solution'] !== null) {
+                $results[] = $formatted;
+            }
+        }
+        return $results;
+    }
+
     /**
      * Réinitialise l'instance singleton.
      * @internal Uniquement pour les tests.

package/src/php/Tests/FingerprintEngineTest.php

@@ -222,8 +222,8 @@ class FingerprintEngineTest extends TestCase
 
         $decision = $this->engine->processRequest($nextContext);
 
-        // Le score d'incohérence devrait être de 100
-        $this->assertEquals(100, $decision['vector']['inconsistencyScore']);
+        // Le score d'incohérence plafonne à l'asymptote de 99.9
+        $this->assertEqualsWithDelta(99.9, $decision['vector']['inconsistencyScore'], 0.1);
         // L'action devrait être un challenge ou un blocage
         $this->assertContains($decision['action'], ['challenge', 'block']);
     }
@@ -288,37 +288,6 @@ class FingerprintEngineTest extends TestCase
         $this->assertEquals(0, $decision['score']);
     }
 
-    public function testReChallengeWhenScoreIsHighEvenWithValidTicket(): void
-    {
-        // 1. Établir l'identité d'origine du terminal
-        $context = $this->createRequestContext();
-        $decision = $this->engine->processRequest($context);
-        $deviceIdCookie = $decision['newCookieForResponse'];
-
-        // Générer un ticket de clearance cryptographiquement valide
-        $expiry = (time() + 3600) * 1000;
-        $secret = getenv('POW_SECRET') ?: "fallback-dev-secret-32-chars-minimum";
-        $signature = hash_hmac('sha256', "{$context->clientIp}:{$expiry}", $secret);
-        $validTicket = "{$expiry}:{$signature}";
-
-        // Créer une requête avec un ticket valide, mais avec un UA et des attributs incohérents provoquant un score >= 75
-        $suspiciousContext = $this->createRequestContext([
-            'cookies' => [
-                $deviceIdCookie['name'] => $deviceIdCookie['value'],
-                'pow_clearance' => $validTicket
-            ],
-            'headers' => [
-                'user-agent' => 'DefinitelyNotTheSameBrowser/1.0', // Incohérence matérielle forte
-                'accept-language' => 'fr-FR',
-            ]
-        ]);
-
-        $redecision = $this->engine->processRequest($suspiciousContext);
-
-        // Malgré le ticket valide, le score est élevé, une nouvelle vérification PoW doit être imposée
-        $this->assertEquals('challenge', $redecision['action']);
-    }
-
     public function testEd25519KeyAutoGenerationAndPersistence(): void
     {
         if (!extension_loaded('openssl')) {