@anonympins/fingerprint 0.7.0 → 0.7.2

package/src/php/Tests/TLSClientHelloParserTest.php

@@ -1,178 +1,178 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Anonympins\Fingerprint\Tests;
-
-use Anonympins\Fingerprint\Utils\TLSClientHelloParser;
-use PHPUnit\Framework\TestCase;
-
-/**
- * Tests unitaires pour le décodeur binaire TLS Client Hello.
- */
-class TLSClientHelloParserTest extends TestCase
-{
-    /**
-     * Helper pour construire un paquet TLS Client Hello binaire valide et réaliste.
-     *
-     * @param int $sslVersion Version TLS (ex: 0x0303 pour TLS 1.2)
-     * @param array<int> $ciphers Liste des Cipher Suites
-     * @param array<array{type: int, data: string}> $extensions Liste des extensions
-     * @return string Paquet binaire brut
-     */
-    private function buildMockClientHello(int $sslVersion = 0x0303, array $ciphers = [4865, 2570], array $extensions = []): string
-    {
-        $recordType = pack('C', 0x16); // Handshake Record (22)
-        $recordVersion = pack('n', 0x0301); // TLS 1.0 record layer version
-        $recordLength = pack('n', 120); // Dummy length
-
-        $handshakeType = pack('C', 0x01); // Client Hello (1)
-        $handshakeLength = pack('C3', 0, 0, 110); // Dummy length
-
-        $clientVersion = pack('n', $sslVersion);
-        $random = str_repeat("\x00", 32); // Random de 32 octets
-        $sessionId = pack('C', 0x00); // Session ID vide (longueur 0)
-
-        // Construction des Cipher Suites
-        $ciphersBinary = '';
-        foreach ($ciphers as $cipher) {
-            $ciphersBinary .= pack('n', $cipher);
-        }
-        $ciphersPayload = pack('n', strlen($ciphersBinary)) . $ciphersBinary;
-
-        // Compression Methods (Standard: 1 méthode, valeur 0x00 = null)
-        $compression = pack('C2', 1, 0);
-
-        // Construction des Extensions
-        $extensionsBinary = '';
-        foreach ($extensions as $ext) {
-            $extensionsBinary .= pack('n', $ext['type']) . pack('n', strlen($ext['data'])) . $ext['data'];
-        }
-        $extensionsPayload = pack('n', strlen($extensionsBinary)) . $extensionsBinary;
-
-        return $recordType . $recordVersion . $recordLength . $handshakeType . $handshakeLength . $clientVersion . $random . $sessionId . $ciphersPayload . $compression . $extensionsPayload;
-    }
-
-    public function testParseValidClientHelloWithGreaseAndExtensions(): void
-    {
-        // On injecte l'extension 10 (Supported Groups / Curves)
-        // Data: 4 octets de longueur de liste + 29 (X25519) + 2570 (GREASE)
-        $extCurves = [
-            'type' => 10,
-            'data' => pack('n', 4) . pack('n2', 29, 2570)
-        ];
-
-        // On injecte l'extension 11 (EC Point Formats)
-        // Data: 1 octet de longueur de liste + 0 (uncompressed)
-        $extPoints = [
-            'type' => 11,
-            'data' => pack('C2', 1, 0)
-        ];
-
-        // On build le paquet binaire de test
-        $binary = $this->buildMockClientHello(
-            0x0303, // SSL Version: 771 (TLS 1.2)
-            [4865, 2570], // Ciphers (2570 est une valeur GREASE)
-            [$extCurves, $extPoints]
-        );
-
-        $result = TLSClientHelloParser::parse($binary);
-
-        $this->assertNotNull($result);
-        
-        // Vérifications des filtrages GREASE et de la construction de la chaîne JA3
-        // Chaîne JA3 attendue: "Version,Ciphers,Extensions,Curves,Points"
-        // - Version: 771
-        // - Ciphers: 4865 (2570 a été nettoyé car GREASE)
-        // - Extensions: 10-11
-        // - Curves: 29 (2570 a été nettoyé car GREASE)
-        // - Points: 0
-        $expectedJa3String = '771,4865,10-11,29,0';
-        $this->assertSame($expectedJa3String, $result['ja3_string']);
-        $this->assertSame(md5($expectedJa3String), $result['ja3_hash']);
-    }
-
-        public function testParseValidClientHelloWithJa4(): void
-        {
-            // On injecte l'extension 0 (SNI) avec données vides
-            $extSni = [
-                'type' => 0,
-                'data' => pack('n', 0)
-            ];
-
-            // On injecte l'extension 16 (ALPN)
-            // Data: list len (3) + str len (2) + "h2"
-            $extAlpn = [
-                'type' => 16,
-                'data' => pack('n', 3) . pack('C', 2) . 'h2'
-            ];
-
-            // On injecte l'extension 13 (Signature Algorithms)
-            // Data: list len (4) + 2 sig algs (0x0401, 0x0804)
-            $extSigAlgs = [
-                'type' => 13,
-                'data' => pack('n', 4) . pack('n2', 0x0401, 0x0804)
-            ];
-
-            // On injecte l'extension 43 (Supported Versions) pour forcer la version TLS 1.3 (0x0304)
-            // Data: list len (4) + 2 versions (0x0304, 0x0303)
-            $extSupportedVersions = [
-                'type' => 43,
-                'data' => pack('C', 4) . pack('n2', 0x0304, 0x0303)
-            ];
-
-            // On build le paquet binaire de test
-            $binary = $this->buildMockClientHello(
-                0x0303, // Version de base
-                [4865, 2570], // Ciphers (2570 est GREASE, sera ignoré dans les comptes)
-                [$extSni, $extAlpn, $extSigAlgs, $extSupportedVersions]
-            );
-
-            $result = TLSClientHelloParser::parse($binary);
-
-            $this->assertNotNull($result);
-            $this->assertArrayHasKey('ja4_raw', $result);
-
-            // Version la plus haute: 0x0304 -> "13"
-            // SNI présent: "d"
-            // Nombre de ciphers (hors GREASE): 4865 (0x1301) -> 1 -> "01"
-            // Nombre d'extensions (hors GREASE): 0, 13, 16, 43 -> 4 -> "04"
-            // ALPN: "h2"
-            // Partie A attendue: "t13d0104h2"
-            $this->assertStringStartsWith('t13d0104h2', $result['ja4_raw']);
-
-            // Partie B: hash sha256 de "1301" haché en hexadécimal et tronqué à 12 caractères
-            $expectedJa4b = substr(hash('sha256', '1301'), 0, 12);
-            $this->assertStringContainsString($expectedJa4b, $result['ja4_raw']);
-
-            // Partie C: extensions triées et hachées: "0000,000d,0010,002b_0401,0804"
-            $extensionsString = '0000,000d,0010,002b';
-            $sigAlgsString = '0401,0804';
-            $expectedJa4c = substr(hash('sha256', $extensionsString . '_' . $sigAlgsString), 0, 12);
-            $this->assertStringEndsWith($expectedJa4c, $result['ja4_raw']);
-        }
-
-    public function testParseReturnsNullWhenPacketTooShort(): void
-    {
-        $shortBinary = str_repeat("\x16", 40);
-        $this->assertNull(TLSClientHelloParser::parse($shortBinary));
-    }
-
-    public function testParseReturnsNullOnInvalidRecordType(): void
-    {
-        // 0x17 au lieu de 0x16 (Application data au lieu de Handshake)
-        $invalidRecord = $this->buildMockClientHello();
-        $invalidRecord[0] = chr(0x17);
-
-        $this->assertNull(TLSClientHelloParser::parse($invalidRecord));
-    }
-
-    public function testParseReturnsNullOnInvalidHandshakeType(): void
-    {
-        // 0x02 au lieu de 0x01 (Server Hello au lieu de Client Hello)
-        $invalidHandshake = $this->buildMockClientHello();
-        $invalidHandshake[5] = chr(0x02);
-
-        $this->assertNull(TLSClientHelloParser::parse($invalidHandshake));
-    }
+<?php
+
+declare(strict_types=1);
+
+namespace Anonympins\Fingerprint\Tests;
+
+use Anonympins\Fingerprint\Utils\TLSClientHelloParser;
+use PHPUnit\Framework\TestCase;
+
+/**
+ * Tests unitaires pour le décodeur binaire TLS Client Hello.
+ */
+class TLSClientHelloParserTest extends TestCase
+{
+    /**
+     * Helper pour construire un paquet TLS Client Hello binaire valide et réaliste.
+     *
+     * @param int $sslVersion Version TLS (ex: 0x0303 pour TLS 1.2)
+     * @param array<int> $ciphers Liste des Cipher Suites
+     * @param array<array{type: int, data: string}> $extensions Liste des extensions
+     * @return string Paquet binaire brut
+     */
+    private function buildMockClientHello(int $sslVersion = 0x0303, array $ciphers = [4865, 2570], array $extensions = []): string
+    {
+        $recordType = pack('C', 0x16); // Handshake Record (22)
+        $recordVersion = pack('n', 0x0301); // TLS 1.0 record layer version
+        $recordLength = pack('n', 120); // Dummy length
+
+        $handshakeType = pack('C', 0x01); // Client Hello (1)
+        $handshakeLength = pack('C3', 0, 0, 110); // Dummy length
+
+        $clientVersion = pack('n', $sslVersion);
+        $random = str_repeat("\x00", 32); // Random de 32 octets
+        $sessionId = pack('C', 0x00); // Session ID vide (longueur 0)
+
+        // Construction des Cipher Suites
+        $ciphersBinary = '';
+        foreach ($ciphers as $cipher) {
+            $ciphersBinary .= pack('n', $cipher);
+        }
+        $ciphersPayload = pack('n', strlen($ciphersBinary)) . $ciphersBinary;
+
+        // Compression Methods (Standard: 1 méthode, valeur 0x00 = null)
+        $compression = pack('C2', 1, 0);
+
+        // Construction des Extensions
+        $extensionsBinary = '';
+        foreach ($extensions as $ext) {
+            $extensionsBinary .= pack('n', $ext['type']) . pack('n', strlen($ext['data'])) . $ext['data'];
+        }
+        $extensionsPayload = pack('n', strlen($extensionsBinary)) . $extensionsBinary;
+
+        return $recordType . $recordVersion . $recordLength . $handshakeType . $handshakeLength . $clientVersion . $random . $sessionId . $ciphersPayload . $compression . $extensionsPayload;
+    }
+
+    public function testParseValidClientHelloWithGreaseAndExtensions(): void
+    {
+        // On injecte l'extension 10 (Supported Groups / Curves)
+        // Data: 4 octets de longueur de liste + 29 (X25519) + 2570 (GREASE)
+        $extCurves = [
+            'type' => 10,
+            'data' => pack('n', 4) . pack('n2', 29, 2570)
+        ];
+
+        // On injecte l'extension 11 (EC Point Formats)
+        // Data: 1 octet de longueur de liste + 0 (uncompressed)
+        $extPoints = [
+            'type' => 11,
+            'data' => pack('C2', 1, 0)
+        ];
+
+        // On build le paquet binaire de test
+        $binary = $this->buildMockClientHello(
+            0x0303, // SSL Version: 771 (TLS 1.2)
+            [4865, 2570], // Ciphers (2570 est une valeur GREASE)
+            [$extCurves, $extPoints]
+        );
+
+        $result = TLSClientHelloParser::parse($binary);
+
+        $this->assertNotNull($result);
+        
+        // Vérifications des filtrages GREASE et de la construction de la chaîne JA3
+        // Chaîne JA3 attendue: "Version,Ciphers,Extensions,Curves,Points"
+        // - Version: 771
+        // - Ciphers: 4865 (2570 a été nettoyé car GREASE)
+        // - Extensions: 10-11
+        // - Curves: 29 (2570 a été nettoyé car GREASE)
+        // - Points: 0
+        $expectedJa3String = '771,4865,10-11,29,0';
+        $this->assertSame($expectedJa3String, $result['ja3_string']);
+        $this->assertSame(md5($expectedJa3String), $result['ja3_hash']);
+    }
+
+        public function testParseValidClientHelloWithJa4(): void
+        {
+            // On injecte l'extension 0 (SNI) avec données vides
+            $extSni = [
+                'type' => 0,
+                'data' => pack('n', 0)
+            ];
+
+            // On injecte l'extension 16 (ALPN)
+            // Data: list len (3) + str len (2) + "h2"
+            $extAlpn = [
+                'type' => 16,
+                'data' => pack('n', 3) . pack('C', 2) . 'h2'
+            ];
+
+            // On injecte l'extension 13 (Signature Algorithms)
+            // Data: list len (4) + 2 sig algs (0x0401, 0x0804)
+            $extSigAlgs = [
+                'type' => 13,
+                'data' => pack('n', 4) . pack('n2', 0x0401, 0x0804)
+            ];
+
+            // On injecte l'extension 43 (Supported Versions) pour forcer la version TLS 1.3 (0x0304)
+            // Data: list len (4) + 2 versions (0x0304, 0x0303)
+            $extSupportedVersions = [
+                'type' => 43,
+                'data' => pack('C', 4) . pack('n2', 0x0304, 0x0303)
+            ];
+
+            // On build le paquet binaire de test
+            $binary = $this->buildMockClientHello(
+                0x0303, // Version de base
+                [4865, 2570], // Ciphers (2570 est GREASE, sera ignoré dans les comptes)
+                [$extSni, $extAlpn, $extSigAlgs, $extSupportedVersions]
+            );
+
+            $result = TLSClientHelloParser::parse($binary);
+
+            $this->assertNotNull($result);
+            $this->assertArrayHasKey('ja4_raw', $result);
+
+            // Version la plus haute: 0x0304 -> "13"
+            // SNI présent: "d"
+            // Nombre de ciphers (hors GREASE): 4865 (0x1301) -> 1 -> "01"
+            // Nombre d'extensions (hors GREASE): 0, 13, 16, 43 -> 4 -> "04"
+            // ALPN: "h2"
+            // Partie A attendue: "t13d0104h2"
+            $this->assertStringStartsWith('t13d0104h2', $result['ja4_raw']);
+
+            // Partie B: hash sha256 de "1301" haché en hexadécimal et tronqué à 12 caractères
+            $expectedJa4b = substr(hash('sha256', '1301'), 0, 12);
+            $this->assertStringContainsString($expectedJa4b, $result['ja4_raw']);
+
+            // Partie C: extensions triées et hachées: "0000,000d,0010,002b_0401,0804"
+            $extensionsString = '0000,000d,0010,002b';
+            $sigAlgsString = '0401,0804';
+            $expectedJa4c = substr(hash('sha256', $extensionsString . '_' . $sigAlgsString), 0, 12);
+            $this->assertStringEndsWith($expectedJa4c, $result['ja4_raw']);
+        }
+
+    public function testParseReturnsNullWhenPacketTooShort(): void
+    {
+        $shortBinary = str_repeat("\x16", 40);
+        $this->assertNull(TLSClientHelloParser::parse($shortBinary));
+    }
+
+    public function testParseReturnsNullOnInvalidRecordType(): void
+    {
+        // 0x17 au lieu de 0x16 (Application data au lieu de Handshake)
+        $invalidRecord = $this->buildMockClientHello();
+        $invalidRecord[0] = chr(0x17);
+
+        $this->assertNull(TLSClientHelloParser::parse($invalidRecord));
+    }
+
+    public function testParseReturnsNullOnInvalidHandshakeType(): void
+    {
+        // 0x02 au lieu de 0x01 (Server Hello au lieu de Client Hello)
+        $invalidHandshake = $this->buildMockClientHello();
+        $invalidHandshake[5] = chr(0x02);
+
+        $this->assertNull(TLSClientHelloParser::parse($invalidHandshake));
+    }
 }

package/src/php/Tests/config/ed25519_key.json

@@ -1,4 +1,4 @@
-{
-    "privateKey": "-----BEGIN PRIVATE KEY-----\\ndummy-php-private\\n-----END PRIVATE KEY-----",
-    "publicKey": "-----BEGIN PUBLIC KEY-----\\ndummy-php-public\\n-----END PUBLIC KEY-----"
+{
+    "privateKey": "-----BEGIN PRIVATE KEY-----\\ndummy-php-private\\n-----END PRIVATE KEY-----",
+    "publicKey": "-----BEGIN PUBLIC KEY-----\\ndummy-php-public\\n-----END PUBLIC KEY-----"
 }

package/src/php/Utils/BlockList.php

@@ -1,100 +1,100 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Anonympins\Fingerprint\Utils;
-
-/**
- * Implémentation PHP d'une liste de blocage IP/CIDR, similaire à Node.js `net.BlockList`.
- */
-class BlockList
-{
-    /**
-     * @var array<string> Liste des IPs ou CIDR à bloquer.
-     */
-    private array $entries = [];
-
-    /**
-     * Ajoute une adresse IP ou une plage CIDR à la liste.
-     * @param string $entry Une adresse IP (ex: '192.168.1.1') ou une plage CIDR (ex: '192.168.1.0/24').
-     * @return void
-     */
-    public function add(string $entry): void
-    {
-        $this->entries[] = $entry;
-    }
-
-    /**
-     * Vérifie si une adresse IP est présente dans la liste de blocage.
-     * @param string $ip L'adresse IP à vérifier.
-     * @return bool True si l'IP est bloquée, false sinon.
-     */
-    public function check(string $ip): bool
-    {
-        foreach ($this->entries as $entry) {
-            if (str_contains($entry, '/')) {
-                // C'est une plage CIDR
-                if ($this->ipInCidr($ip, $entry)) {
-                    return true;
-                }
-            } else {
-                // C'est une IP directe
-                if ($ip === $entry) {
-                    return true;
-                }
-            }
-        }
-        return false;
-    }
-
-    /**
-     * Vérifie si une adresse IP se trouve dans une plage CIDR donnée.
-     * @param string $ip L'adresse IP à vérifier.
-     * @param string $cidr La plage CIDR (ex: '192.168.1.0/24').
-     * @return bool True si l'IP est dans la plage, false sinon.
-     */
-    private function ipInCidr(string $ip, string $cidr): bool
-    {
-        [$network, $mask] = explode('/', $cidr);
-        $mask = (int)$mask;
-
-        if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6) && filter_var($network, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)) {
-            // IPv6
-            $ipBinary = inet_pton($ip);
-            $networkBinary = inet_pton($network);
-
-            if ($ipBinary === false || $networkBinary === false) {
-                return false;
-            }
-
-            $ipHex = bin2hex($ipBinary);
-            $networkHex = bin2hex($networkBinary);
-
-            $numBytes = (int)ceil($mask / 8);
-            $compareLength = $numBytes * 2;
-
-            if (substr($ipHex, 0, $compareLength) !== substr($networkHex, 0, $compareLength)) {
-                return false;
-            }
-
-            if ($mask % 8 !== 0) {
-                $bitMask = (0xFF << (8 - ($mask % 8))) & 0xFF;
-                $ipByte = hexdec(substr($ipHex, $numBytes * 2 - 2, 2));
-                $networkByte = hexdec(substr($networkHex, $numBytes * 2 - 2, 2));
-                return ($ipByte & $bitMask) === ($networkByte & $bitMask);
-            }
-
-            return true;
-
-        } elseif (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4) && filter_var($network, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) {
-            // IPv4
-            $ipLong = ip2long($ip);
-            $networkLong = ip2long($network);
-            $wildcard = pow(2, (32 - $mask)) - 1;
-            $netmask = ~$wildcard;
-            return (($ipLong & $netmask) === ($networkLong & $netmask));
-        }
-
-        return false;
-    }
+<?php
+
+declare(strict_types=1);
+
+namespace Anonympins\Fingerprint\Utils;
+
+/**
+ * Implémentation PHP d'une liste de blocage IP/CIDR, similaire à Node.js `net.BlockList`.
+ */
+class BlockList
+{
+    /**
+     * @var array<string> Liste des IPs ou CIDR à bloquer.
+     */
+    private array $entries = [];
+
+    /**
+     * Ajoute une adresse IP ou une plage CIDR à la liste.
+     * @param string $entry Une adresse IP (ex: '192.168.1.1') ou une plage CIDR (ex: '192.168.1.0/24').
+     * @return void
+     */
+    public function add(string $entry): void
+    {
+        $this->entries[] = $entry;
+    }
+
+    /**
+     * Vérifie si une adresse IP est présente dans la liste de blocage.
+     * @param string $ip L'adresse IP à vérifier.
+     * @return bool True si l'IP est bloquée, false sinon.
+     */
+    public function check(string $ip): bool
+    {
+        foreach ($this->entries as $entry) {
+            if (str_contains($entry, '/')) {
+                // C'est une plage CIDR
+                if ($this->ipInCidr($ip, $entry)) {
+                    return true;
+                }
+            } else {
+                // C'est une IP directe
+                if ($ip === $entry) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+
+    /**
+     * Vérifie si une adresse IP se trouve dans une plage CIDR donnée.
+     * @param string $ip L'adresse IP à vérifier.
+     * @param string $cidr La plage CIDR (ex: '192.168.1.0/24').
+     * @return bool True si l'IP est dans la plage, false sinon.
+     */
+    private function ipInCidr(string $ip, string $cidr): bool
+    {
+        // Handle IPv4-mapped IPv6 addresses by converting them to IPv4
+        if (str_starts_with(strtolower($ip), '::ffff:') && filter_var(substr($ip, 7), FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) {
+            $ip = substr($ip, 7);
+        }
+
+        [$network, $mask] = explode('/', $cidr, 2);
+        $mask = (int)$mask;
+
+        // Now, both $ip and $network should be in the same family for a valid comparison
+        if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4) && filter_var($network, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) {
+            if ($mask < 0 || $mask > 32) { return false; }
+            $ipLong = ip2long($ip);
+            $networkLong = ip2long($network);
+            if ($ipLong === false || $networkLong === false) return false;
+            $netmask = -1 << (32 - $mask);
+            return ($ipLong & $netmask) === ($networkLong & $netmask);
+        } elseif (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6) && filter_var($network, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)) {
+            // IPv6 vs IPv6 CIDR
+            if ($mask < 0 || $mask > 128) { return false; }
+            $ipBinary = inet_pton($ip);
+            $networkBinary = inet_pton($network);
+            if ($ipBinary === false || $networkBinary === false) return false;
+
+            $bytesToCompare = (int)floor($mask / 8);
+            if (strncmp($ipBinary, $networkBinary, $bytesToCompare) !== 0) {
+                return false;
+            }
+
+            $bitsToCompare = $mask % 8;
+            if ($bitsToCompare > 0) {
+                $byteIndex = $bytesToCompare;
+                $bitmask = (0xFF << (8 - $bitsToCompare)) & 0xFF;
+                if ((ord($ipBinary[$byteIndex]) & $bitmask) !== (ord($networkBinary[$byteIndex]) & $bitmask)) {
+                    return false;
+                }
+            }
+
+            return true;
+        }
+
+        return false;
+    }
 }