@anonympins/fingerprint 0.3.3 → 0.3.5

package/src/php/Config/SecurityProfiles.php

@@ -36,7 +36,9 @@ class SecurityProfiles
                 'botScore' => 1.0, // Poids pour le score de bot explicite
                 'cookieDroppingScore' => 0.9, // Pénalité élevée pour la suppression de cookies
                 'threatIntelScore' => 0.4, // Poids pour le renseignement sur les menaces (ex: IP de proxy connu)
+                'clientHintsInconsistencyScore' => 0.7, // Penalizes inconsistency between User-Agent and Client-Hints
                 'clickVarianceScore' => 0.6, // Poids pour la variance des clics
+                'subnetScore' => 0.5, // Pénalise les sous-réseaux IP avec une activité suspecte agrégée
             ],
             'thresholds' => ['low' => 20, 'medium' => 45, 'high' => 75, 'block' => 95],
             'patterns' => [
@@ -76,7 +78,9 @@ class SecurityProfiles
                 'botScore' => 1.0,
                 'cookieDroppingScore' => 1.0, // Pénalité maximale
                 'threatIntelScore' => 0.7, // Poids élevé pour les menaces connues (Tor, etc.)
-                'clickVarianceScore' => 0.7, // Poids élevé pour la variance des clics
+                'clientHintsInconsistencyScore' => 0.9, // Very high penalty in strict mode
+                'clickVarianceScore' => 0.7, // High weight for click variance
+                'subnetScore' => 0.7, // Poids plus élevé en mode strict
             ],
             'thresholds' => ['low' => 10, 'medium' => 35, 'high' => 65, 'block' => 90],
             'patterns' => [
@@ -115,8 +119,10 @@ class SecurityProfiles
                 'tlsSpoofingScore' => 0.7,
                 'botScore' => 0.5,
                 'cookieDroppingScore' => 0.8, // Important pour les clients API qui doivent maintenir un état
-                'threatIntelScore' => 0.5, // Les API sont souvent ciblées par des IPs malveillantes
-                'clickVarianceScore' => 0.3, // Poids faible car non applicable aux API
+                'threatIntelScore' => 0.5, // APIs are often targeted by malicious IPs
+                'clientHintsInconsistencyScore' => 0.6, // Relevant signal for APIs
+                'clickVarianceScore' => 0.3, // Low weight as not applicable to APIs
+                'subnetScore' => 0.8, // Très important pour les API pour détecter les botnets
             ],
             'thresholds' => ['low' => 25, 'medium' => 50, 'high' => 80, 'block' => 95],
             'patterns' => [
@@ -157,8 +163,10 @@ class SecurityProfiles
                 'tlsSpoofingScore' => 0.6,
                 'botScore' => 0.8,
                 'cookieDroppingScore' => 0.7, // Moins critique, mais toujours un signal
-                'threatIntelScore' => 0.3, // Moins prioritaire pour un blog
-                'clickVarianceScore' => 0.5, // Poids modéré pour la variance des clics
+                'threatIntelScore' => 0.3, // Lower priority for a blog
+                'clientHintsInconsistencyScore' => 0.5,
+                'clickVarianceScore' => 0.5, // Moderate weight for click variance
+                'subnetScore' => 0.4, // Utile contre le spam de commentaires coordonné
             ],
             'thresholds' => ['low' => 25, 'medium' => 55, 'high' => 80, 'block' => 95],
             'patterns' => [
@@ -198,8 +206,10 @@ class SecurityProfiles
                 'tlsSpoofingScore' => 0.9,
                 'botScore' => 1.0,
                 'cookieDroppingScore' => 1.0, // Crucial pour la détection de bots e-commerce
-                'threatIntelScore' => 0.8, // Très important pour l'e-commerce (proxies de scalping)
-                'clickVarianceScore' => 0.8, // Poids très élevé pour la variance des clics
+                'threatIntelScore' => 0.8, // Very important for e-commerce (scalping proxies)
+                'clientHintsInconsistencyScore' => 0.9, // Very important for e-commerce
+                'clickVarianceScore' => 0.8, // Very high weight for click variance
+                'subnetScore' => 0.9, // Crucial contre les attaques de scalping distribuées
             ],
             'thresholds' => ['low' => 15, 'medium' => 40, 'high' => 70, 'block' => 90],
             'patterns' => [

package/src/php/FingerprintBuilder.php

@@ -1,185 +1,186 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Anonympins\Fingerprint;
-
-/**
- * Classe pour construire une empreinte composite (Multi-Hash).
- * Format de sortie : "grp1:hash1|grp2:hash2|grp3:hash3"
- */
-class FingerprintBuilder
-{
-    /**
-     * @var array<string, string|int>
-     */
-    private array $components = [];
-
-    /**
-     * Ajoute un composant à l'empreinte.
-     * La valeur est hachée pour l'anonymiser et réduire sa taille.
-     *
-     * @param string $group Le nom du groupe (ex: 'hw', 'screen', 'geo').
-     * @param string|int|bool|null $value La valeur brute à hacher.
-     * @return self
-     */
-    public function add(string $group, $value): self
-    {
-        if ($value === null || $value === '') {
-            return $this;
-        }
-        // On hache la valeur individuellement.
-        $this->components[$group] = self::cyrb53((string)$value);
-        return $this;
-    }
-
-    /**
-     * Ajoute un composant brut sans le hacher.
-     * Utile pour les métriques qui doivent être lues telles quelles par le serveur.
-     *
-     * @param string $group Le nom du groupe.
-     * @param string|int|null $value La valeur brute.
-     * @return self
-     */
-    public function addRaw(string $group, $value): self
-    {
-        if ($value === null) {
-            return $this;
-        }
-        $this->components[$group] = $value;
-        return $this;
-    }
-
-    /**
-     * Génère la chaîne de l'empreinte finale.
-     * Les composants sont triés par clé pour garantir un ordre déterministe.
-     *
-     * @return string
-     */
-    public function __toString(): string
-    {
-        // ksort trie le tableau par clé.
-        ksort($this->components);
-
-        $parts = [];
-        foreach ($this->components as $key => $hash) {
-            $parts[] = "{$key}:{$hash}";
-        }
-
-        return implode('|', $parts);
-    }
-
-    /**
-     * Compare deux empreintes et retourne un score de similarité (de 0 à 1).
-     * Utilise une pondération pour donner plus d'importance aux invariants forts (Canvas, GPU, JA3).
-     *
-     * @param string|null $fpString1 Empreinte A.
-     * @param string|null $fpString2 Empreinte B.
-     * @return float
-     */
-    public static function compare(?string $fpString1, ?string $fpString2): float
-    {
-        if (empty($fpString1) || empty($fpString2)) {
-            return 0.0;
-        }
-
-        $parse = function (string $str): array {
-            $map = [];
-            foreach (explode('|', $str) as $part) {
-                $pair = explode(':', $part, 2);
-                if (count($pair) === 2 && !empty($pair[0]) && !empty($pair[1])) {
-                    $map[$pair[0]] = $pair[1];
-                }
-            }
-            return $map;
-        };
-
-        $map1 = $parse($fpString1);
-        $map2 = $parse($fpString2);
-
-        $volatileKeys = [
-            'ch_ua', 'ch_platform', 'ch_mobile', 'ch_model', 'ch_arch', 'ch_bitness',
-            'cookie_keys', 'upgrade', 'network', 'http_ver',
-            'x_forwarded_for', 'x_real_ip', 'cf_connecting_ip'
-        ];
-
-        $weights = [
-            'cvs' => 5.0, 'gpu' => 4.0, 'ja3' => 3.5, 'ja4' => 4.0,
-            'h2_settings' => 3.0, 'tcp_fp' => 2.5, 'ua' => 2.0,
-            'client_fp_hash' => 3.0, 'browser' => 1.5, 'os_version' => 1.5,
-            'device_type' => 1.0, 'hw' => 1.5, 'scr' => 1.0, 'os' => 0.8, 'geo' => 0.5,
-        ];
-
-        $weightedMatches = 0.0;
-        $totalWeight = 0.0;
-
-        $allKeys = array_unique(array_merge(array_keys($map1), array_keys($map2)));
-
-        foreach ($allKeys as $key) {
-            // On ignore les clés volatiles pour cette comparaison spécifique.
-            if (in_array($key, $volatileKeys, true)) { // @phpstan-ignore-line
-                continue;
-            }
-
-            // On ne compare que les clés qui ont un poids défini.
-            $weight = $weights[$key] ?? null;
-            if ($weight === null) continue;
-
-            $totalWeight += $weight;
-            if (isset($map1[$key]) && isset($map2[$key])) {
-                if ($map1[$key] === $map2[$key]) {
-                    $weightedMatches += $weight;
-                }
-            }
-        }
-
-        return $totalWeight === 0.0 ? 0.0 : $weightedMatches / $totalWeight;
-    }
-
-    /**
-     * Algorithme de hachage cyrb53 (rapide et faible taux de collision).
-     * Porté depuis la version JavaScript.
-     *
-     * @param string $str La chaîne à hacher.
-     * @param int $seed Une graine optionnelle.
-     * @return string Le hash sous forme de chaîne de caractères.
-     */
-    public static function cyrb53(string $str, int $seed = 0): string
-    {
-        $h1 = 0xdeadbeef ^ $seed;
-        $h2 = 0x41c6ce57 ^ $seed;
-
-        for ($i = 0, $l = strlen($str); $i < $l; $i++) {
-            $ch = ord($str[$i]);
-            $h1 = self::imul($h1 ^ $ch, 2654435761);
-            $h2 = self::imul($h2 ^ $ch, 1597334677);
-        }
-
-        $h1 = self::imul($h1 ^ ($h1 >> 16), 2246822507) ^ self::imul($h2 ^ ($h2 >> 13), 3266489909);
-        $h2 = self::imul($h2 ^ ($h2 >> 16), 2246822507) ^ self::imul($h1 ^ ($h1 >> 13), 3266489909);
-
-        // En PHP, les opérations sur les grands nombres peuvent être délicates.
-        // On utilise bcmath pour une arithmétique de précision arbitraire, garantissant le même résultat que JS.
-        $val_h2 = bcadd(bcmul((string)(2097151 & $h2), '4294967296'), (string)($h1 >= 0 ? $h1 : $h1 + 4294967296));
-        return $val_h2;
-    }
-
-    /**
-     * Émule la multiplication 32-bit `Math.imul` de JavaScript.
-     *
-     * @param int $a
-     * @param int $b
-     * @return int Un entier signé 32-bit.
-     */
-    private static function imul(int $a, int $b): int
-    {
-        // Utiliser GMP pour la multiplication pour éviter le dépassement en float sur les systèmes 64-bit.
-        $gmp_a = gmp_init($a);
-        $gmp_b = gmp_init($b);
-        $gmp_result = gmp_mul($gmp_a, $gmp_b);
-
-        // Tronquer le résultat à 32 bits et le convertir en entier signé.
-        $truncated = gmp_and($gmp_result, '0xFFFFFFFF');
-        return gmp_intval(gmp_sign($truncated) < 0 ? gmp_sub($truncated, '0x100000000') : $truncated);
-    }
+<?php
+
+declare(strict_types=1);
+
+namespace Anonympins\Fingerprint;
+
+/**
+ * Classe pour construire une empreinte composite (Multi-Hash).
+ * Format de sortie : "grp1:hash1|grp2:hash2|grp3:hash3"
+ */
+class FingerprintBuilder
+{
+    /**
+     * @var array<string, string|int>
+     */
+    private array $components = [];
+
+    /**
+     * Ajoute un composant à l'empreinte.
+     * La valeur est hachée pour l'anonymiser et réduire sa taille.
+     *
+     * @param string $group Le nom du groupe (ex: 'hw', 'screen', 'geo').
+     * @param string|int|bool|null $value La valeur brute à hacher.
+     * @return self
+     */
+    public function add(string $group, $value): self
+    {
+        if ($value === null || $value === '') {
+            return $this;
+        }
+        // On hache la valeur individuellement.
+        $this->components[$group] = self::cyrb53((string)$value);
+        return $this;
+    }
+
+    /**
+     * Ajoute un composant brut sans le hacher.
+     * Utile pour les métriques qui doivent être lues telles quelles par le serveur.
+     *
+     * @param string $group Le nom du groupe.
+     * @param string|int|null $value La valeur brute.
+     * @return self
+     */
+    public function addRaw(string $group, $value): self
+    {
+        if ($value === null) {
+            return $this;
+        }
+        $this->components[$group] = $value;
+        return $this;
+    }
+
+    /**
+     * Génère la chaîne de l'empreinte finale.
+     * Les composants sont triés par clé pour garantir un ordre déterministe.
+     *
+     * @return string
+     */
+    public function __toString(): string
+    {
+        // ksort trie le tableau par clé.
+        ksort($this->components);
+
+        $parts = [];
+        foreach ($this->components as $key => $hash) {
+            $parts[] = "{$key}:{$hash}";
+        }
+
+        return implode('|', $parts);
+    }
+
+    /**
+     * Compare deux empreintes et retourne un score de similarité (de 0 à 1).
+     * Utilise une pondération pour donner plus d'importance aux invariants forts (Canvas, GPU, JA3).
+     *
+     * @param string|null $fpString1 Empreinte A.
+     * @param string|null $fpString2 Empreinte B.
+     * @return float
+     */
+    public static function compare(?string $fpString1, ?string $fpString2): float
+    {
+        if (empty($fpString1) || empty($fpString2)) {
+            return 0.0;
+        }
+
+        $parse = function (string $str): array {
+            $map = [];
+            foreach (explode('|', $str) as $part) {
+                $pair = explode(':', $part, 2);
+                if (count($pair) === 2 && !empty($pair[0]) && !empty($pair[1])) {
+                    $map[$pair[0]] = $pair[1];
+                }
+            }
+            return $map;
+        };
+
+        $map1 = $parse($fpString1);
+        $map2 = $parse($fpString2);
+
+        $volatileKeys = [
+            'ch_ua', 'ch_platform', 'ch_mobile', 'ch_model', 'ch_arch', 'ch_bitness',
+            'cookie_keys', 'upgrade', 'network', 'http_ver',
+            'x_forwarded_for', 'x_real_ip', 'cf_connecting_ip'
+        ];
+
+        $weights = [
+            'cvs' => 5.0, 'gpu' => 4.0, 'ja3' => 3.5, 'ja4' => 4.0, 'ja4s' => 4.0, 'ja4h' => 3.8,
+            'h2_settings' => 3.0, 'tcp_fp' => 2.5, 'ua' => 2.0,
+            'client_fp_hash' => 3.0, 'browser' => 1.5, 'os_version' => 1.5,
+            'device_type' => 1.0, 'hw' => 1.5, 'scr' => 1.0, 'os' => 0.8, 'geo' => 0.5,
+        ];
+
+        $weightedMatches = 0.0;
+        $totalWeight = 0.0;
+
+        $allKeys = array_unique(array_merge(array_keys($map1), array_keys($map2)));
+
+        foreach ($allKeys as $key) {
+            // On ignore les clés volatiles pour cette comparaison spécifique.
+            if (in_array($key, $volatileKeys, true)) { // @phpstan-ignore-line
+                continue;
+            }
+
+            // On ne compare que les clés qui ont un poids défini.
+            $weight = $weights[$key] ?? null;
+            if ($weight === null) continue;
+
+            $totalWeight += $weight;
+            if (isset($map1[$key]) && isset($map2[$key])) {
+                if ($map1[$key] === $map2[$key]) {
+                    $weightedMatches += $weight;
+                }
+            }
+        }
+
+        return $totalWeight === 0.0 ? 0.0 : $weightedMatches / $totalWeight;
+    }
+
+    /**
+     * Algorithme de hachage cyrb53 (rapide et faible taux de collision).
+     * Porté depuis la version JavaScript.
+     *
+     * @param string $str La chaîne à hacher.
+     * @param int $seed Une graine optionnelle.
+     * @return string Le hash sous forme de chaîne de caractères.
+     */
+    public static function cyrb53(string $str, int $seed = 0): string
+    {
+        $h1 = 0xdeadbeef ^ $seed;
+        $h2 = 0x41c6ce57 ^ $seed;
+
+        for ($i = 0, $l = strlen($str); $i < $l; $i++) {
+            $ch = ord($str[$i]);
+            $h1 = self::imul($h1 ^ $ch, 2654435761);
+            $h2 = self::imul($h2 ^ $ch, 1597334677);
+        }
+
+        $h1 = self::imul($h1 ^ ($h1 >> 16), 2246822507) ^ self::imul($h2 ^ ($h2 >> 13), 3266489909);
+        $h2 = self::imul($h2 ^ ($h2 >> 16), 2246822507) ^ self::imul($h1 ^ ($h1 >> 13), 3266489909);
+
+        // En PHP, les opérations sur les grands nombres peuvent être délicates.
+        // On utilise bcmath pour une arithmétique de précision arbitraire, garantissant le même résultat que JS.
+        $val_h2 = bcadd(bcmul((string)(2097151 & $h2), '4294967296'), (string)($h1 >= 0 ? $h1 : $h1 + 4294967296));
+        return $val_h2;
+    }
+
+    /**
+     * Émule la multiplication 32-bit `Math.imul` de JavaScript.
+     *
+     * @param int $a
+     * @param int $b
+     * @return int Un entier signé 32-bit.
+     */
+    private static function imul(int $a, int $b): int
+    {
+        // Emulation of JavaScript's Math.imul for signed 32-bit integer multiplication.
+        // This version correctly handles overflows on 64-bit systems.
+        $ah = ($a >> 16) & 0xffff;
+        $al = $a & 0xffff;
+        $bh = ($b >> 16) & 0xffff;
+        $bl = $b & 0xffff;
+        $lo = $al * $bl;
+        $hi = (($lo >> 16) + ($al * $bh) + ($ah * $bl)) & 0xffff;
+        return (($hi << 16) | ($lo & 0xffff)) | 0;
+    }
 }

package/src/php/FingerprintClient.php

@@ -3,6 +3,7 @@
 declare(strict_types=1);
 
 namespace Anonympins\Fingerprint;
+use Anonympins\Fingerprint\Config\SecurityProfiles;
 
 /**
  * FingerprintClient - Wrapper PHP pour la bibliothèque de fingerprinting côté client.
@@ -38,8 +39,7 @@ class FingerprintClient
     {
         $this->clientScriptPath = $clientScriptPath;
 
-        // Configuration par défaut si non fournie
-        $this->clientConfig = array_merge([
+        $defaultConfig = [
             'mouse' => true,
             'keystrokes' => true,
             'clicks' => true,
@@ -47,8 +47,13 @@ class FingerprintClient
             'fetch' => [
                 'handleChallenges' => true,
                 'probationaryTtl' => 30000, // 30 seconds
-            ]
-        ], $clientConfig);
+            ],
+            'wasm' => true, // Activer la tentative de chargement du module WASM
+            'wasmPath' => '/fp.js' // Chemin vers le script de chargement WASM
+        ];
+
+        // Utiliser une fusion profonde pour permettre de surcharger des sous-clés
+        $this->clientConfig = SecurityProfiles::deepMerge($defaultConfig, $clientConfig);
 
         try {
             // Génère un nonce pour CSP si possible, pour une sécurité renforcée.
@@ -94,8 +99,17 @@ class FingerprintClient
         // Le script d'initialisation qui sera inclus dans la page.
         $initScript = <<<JS
 document.addEventListener('DOMContentLoaded', function() {
+    const config = {$configJson};
     if (window.ClientLibrary) {
-        window.ClientLibrary.initializeClient({$configJson});
+        if (config.wasmPath) {
+            const wasmScript = document.createElement('script');
+            wasmScript.src = config.wasmPath;
+            wasmScript.async = true;
+            wasmScript.nonce = '{$this->nonce}';
+            document.head.appendChild(wasmScript);
+        }
+
+        window.ClientLibrary.initializeClient(config);
     } else {
         console.error('Fingerprint client library not loaded.');
     }