@anonympins/fingerprint 0.3.5 → 0.3.7

package/src/php/RequestContext.php

@@ -1,91 +1,91 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Anonympins\Fingerprint;
-
-/**
- * Représente le contexte d'une requête HTTP, fournissant un accès unifié
- * aux informations nécessaires pour l'analyse de l'empreinte.
- * Cette classe est conçue pour être créée à partir d'un objet de requête
- * standard (ex: PSR-7, Symfony, Laravel).
- */
-class RequestContext
-{
-    public string $clientIp;
-    public string $path;
-    /** @var array<string, string> */
-    public array $headers;
-    /** @var array<string, mixed> */
-    public array $query;
-    /** @var array<string, mixed>|object|null */
-    public $body;
-    /** @var array<string, string> */
-    public array $cookies;
-    public ?string $httpVersion;
-    public int $requestTimestamp;
-
-    /** @var ?array{type: string, name: string} */
-    public ?array $graphqlOperation = null;
-
-    /** @var ?array<string, mixed> */
-    public ?array $newCookieForResponse = null;
-
-    // Propriétés spécifiques qui peuvent être fournies par un proxy inverse
-    public ?string $ja3;
-    public ?string $ja4;
-    public ?string $ja4s;
-    public ?string $ja4h;
-    public ?string $http2Fingerprint;
-    public ?string $tcpFingerprint;
-
-    /**
-     * @param string $clientIp
-     * @param string $path
-     * @param array<string, string> $headers
-     * @param array<string, mixed> $query
-     * @param array<string, mixed>|object|null $body
-     * @param array<string, string> $cookies
-     * @param string|null $httpVersion
-     * @param int|null $requestTimestamp
-     */
-    public function __construct(
-        string $clientIp,
-        string $path,
-        array $headers,
-        array $query,
-        $body,
-        array $cookies,
-        ?string $httpVersion,
-        ?int $requestTimestamp = null
-    ) {
-        $this->clientIp = $clientIp;
-        $this->path = $path;
-        // Normaliser les en-têtes en minuscules pour un accès cohérent
-        $this->headers = array_change_key_case($headers, CASE_LOWER);
-        $this->query = $query;
-        $this->body = $body;
-        $this->cookies = $cookies;
-        $this->httpVersion = $httpVersion;
-        $this->requestTimestamp = $requestTimestamp ?? (int)(microtime(true) * 1000);
-
-        // Extraire les empreintes TLS/HTTP2/TCP si elles sont fournies par les en-têtes
-        $this->ja3 = $this->headers['x-ja3-hash'] ?? null;
-        $this->ja4 = $this->headers['x-ja4-hash'] ?? null;
-        $this->ja4s = $this->headers['x-ja4s-hash'] ?? null;
-        $this->ja4h = $this->headers['x-ja4h-hash'] ?? null;
-        $this->http2Fingerprint = $this->headers['x-http2-fingerprint'] ?? null;
-        $this->tcpFingerprint = $this->headers['x-tcp-fingerprint'] ?? null;
-    }
-    /**
-     * Récupère la valeur d'un en-tête HTTP de manière insensible à la casse.
-     *
-     * @param string $name Le nom de l'en-tête.
-     * @return string|null La valeur de l'en-tête ou null si non trouvé.
-     */
-
-    public function getHeader(string $name): ?string
-    {
-        return $this->headers[strtolower($name)] ?? null;
-    }
+<?php
+
+declare(strict_types=1);
+
+namespace Anonympins\Fingerprint;
+
+/**
+ * Représente le contexte d'une requête HTTP, fournissant un accès unifié
+ * aux informations nécessaires pour l'analyse de l'empreinte.
+ * Cette classe est conçue pour être créée à partir d'un objet de requête
+ * standard (ex: PSR-7, Symfony, Laravel).
+ */
+class RequestContext
+{
+    public string $clientIp;
+    public string $path;
+    /** @var array<string, string> */
+    public array $headers;
+    /** @var array<string, mixed> */
+    public array $query;
+    /** @var array<string, mixed>|object|null */
+    public $body;
+    /** @var array<string, string> */
+    public array $cookies;
+    public ?string $httpVersion;
+    public int $requestTimestamp;
+
+    /** @var ?array{type: string, name: string} */
+    public ?array $graphqlOperation = null;
+
+    /** @var ?array<string, mixed> */
+    public ?array $newCookieForResponse = null;
+
+    // Propriétés spécifiques qui peuvent être fournies par un proxy inverse
+    public ?string $ja3;
+    public ?string $ja4;
+    public ?string $ja4s;
+    public ?string $ja4h;
+    public ?string $http2Fingerprint;
+    public ?string $tcpFingerprint;
+
+    /**
+     * @param string $clientIp
+     * @param string $path
+     * @param array<string, string> $headers
+     * @param array<string, mixed> $query
+     * @param array<string, mixed>|object|null $body
+     * @param array<string, string> $cookies
+     * @param string|null $httpVersion
+     * @param int|null $requestTimestamp
+     */
+    public function __construct(
+        string $clientIp,
+        string $path,
+        array $headers,
+        array $query,
+        $body,
+        array $cookies,
+        ?string $httpVersion,
+        ?int $requestTimestamp = null
+    ) {
+        $this->clientIp = $clientIp;
+        $this->path = $path;
+        // Normaliser les en-têtes en minuscules pour un accès cohérent
+        $this->headers = array_change_key_case($headers, CASE_LOWER);
+        $this->query = $query;
+        $this->body = $body;
+        $this->cookies = $cookies;
+        $this->httpVersion = $httpVersion;
+        $this->requestTimestamp = $requestTimestamp ?? (int)(microtime(true) * 1000);
+
+        // Extraire les empreintes TLS/HTTP2/TCP si elles sont fournies par les en-têtes
+        $this->ja3 = $this->headers['x-ja3-hash'] ?? null;
+        $this->ja4 = $this->headers['x-ja4-hash'] ?? null;
+        $this->ja4s = $this->headers['x-ja4s-hash'] ?? null;
+        $this->ja4h = $this->headers['x-ja4h-hash'] ?? null;
+        $this->http2Fingerprint = $this->headers['x-http2-fingerprint'] ?? null;
+        $this->tcpFingerprint = $this->headers['x-tcp-fingerprint'] ?? null;
+    }
+    /**
+     * Récupère la valeur d'un en-tête HTTP de manière insensible à la casse.
+     *
+     * @param string $name Le nom de l'en-tête.
+     * @return string|null La valeur de l'en-tête ou null si non trouvé.
+     */
+
+    public function getHeader(string $name): ?string
+    {
+        return $this->headers[strtolower($name)] ?? null;
+    }
 }

package/src/php/Store/MongoDbStore.php

@@ -0,0 +1,105 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Anonympins\Fingerprint\Store;
+
+/**
+ * Adaptateur de stockage MongoDB pour le moteur Fingerprint.
+ * Utilise la bibliothèque officielle mongodb/mongodb.
+ */
+class MongoDbStore implements IStore
+{
+    /**
+     * @var \MongoDB\Collection
+     */
+    private $collection;
+
+    /**
+     * @param \MongoDB\Collection $collection Collection dédiée au stockage des empreintes
+     */
+    public function __construct($collection)
+    {
+        $this->collection = $collection;
+    }
+
+    public function get(string $key)
+    {
+        $doc = $this->collection->findOne(['_id' => $key]);
+        if (!$doc) {
+            return null;
+        }
+
+        // Vérification d'expiration active pour bypasser le délai de 60s du démon de MongoDB
+        if (isset($doc['expiresAt'])) {
+            $expiresAt = $doc['expiresAt'];
+            if ($expiresAt instanceof \MongoDB\BSON\UTCDateTime) {
+                $expiresAtMs = $expiresAt->toDateTime()->getTimestamp() * 1000;
+                $nowMs = (int)(microtime(true) * 1000);
+                if ($expiresAtMs < $nowMs) {
+                    $this->delete($key);
+                    return null;
+                }
+            }
+        }
+
+        return isset($doc['value']) ? json_decode($doc['value'], true) : null;
+    }
+
+    public function set(string $key, $value, ?int $ttl = null): void
+    {
+        $doc = [
+            '_id' => $key,
+            'value' => json_encode($value),
+        ];
+
+        if ($ttl !== null && $ttl > 0) {
+            $doc['expiresAt'] = new \MongoDB\BSON\UTCDateTime((time() + $ttl) * 1000);
+        }
+
+        $this->collection->replaceOne(
+            ['_id' => $key],
+            $doc,
+            ['upsert' => true]
+        );
+    }
+
+    public function has(string $key): bool
+    {
+        $doc = $this->collection->findOne(
+            ['_id' => $key],
+            ['projection' => ['expiresAt' => 1]]
+        );
+
+        if (!$doc) {
+            return false;
+        }
+
+        if (isset($doc['expiresAt']) && $doc['expiresAt'] instanceof \MongoDB\BSON\UTCDateTime) {
+            $expiresAtMs = $doc['expiresAt']->toDateTime()->getTimestamp() * 1000;
+            $nowMs = (int)(microtime(true) * 1000);
+            if ($expiresAtMs < $nowMs) {
+                $this->delete($key);
+                return false;
+            }
+        }
+
+        return true;
+    }
+
+    public function delete(string $key): void
+    {
+        $this->collection->deleteOne(['_id' => $key]);
+    }
+
+    /**
+     * Automatise la configuration de l'index TTL nécessaire dans MongoDB.
+     */
+    public function init(): void
+    {
+        $this->collection->createIndex(
+            ['expiresAt' => 1],
+            ['expireAfterSeconds' => 0]
+        );
+    }
+}

package/src/php/Store/RedisStore.php

@@ -0,0 +1,54 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Anonympins\Fingerprint\Store;
+
+/**
+ * Adaptateur de stockage Redis pour le moteur Fingerprint.
+ * Compatible avec phpredis et predis.
+ */
+class RedisStore implements IStore
+{
+    /**
+     * @var mixed Une instance de \Redis ou de \Predis\Client
+     */
+    private $redis;
+
+    /**
+     * @param mixed $redis Client Redis déjà configuré et connecté
+     */
+    public function __construct($redis)
+    {
+        $this->redis = $redis;
+    }
+
+    public function get(string $key)
+    {
+        $value = $this->redis->get($key);
+        if ($value === false || $value === null) {
+            return null;
+        }
+        return json_decode($value, true);
+    }
+
+    public function set(string $key, $value, ?int $ttl = null): void
+    {
+        $stringValue = json_encode($value);
+        if ($ttl !== null && $ttl > 0) {
+            $this->redis->setex($key, $ttl, $stringValue);
+        } else {
+            $this->redis->set($key, $stringValue);
+        }
+    }
+
+    public function has(string $key): bool
+    {
+        return (bool)$this->redis->exists($key);
+    }
+
+    public function delete(string $key): void
+    {
+        $this->redis->del($key);
+    }
+}

package/src/php/Tests/ChallengeUtilsTest.php

@@ -4,9 +4,9 @@ declare(strict_types=1);
 
 namespace Anonympins\Fingerprint\Tests;
 
-use PHPUnit\Framework\TestCase;
 use Anonympins\Fingerprint\Challenge\ChallengeUtils;
 use Anonympins\Fingerprint\Utils\BigInt;
+use PHPUnit\Framework\TestCase;
 
 class ChallengeUtilsTest extends TestCase
 {

package/src/php/Tests/FingerprintBuilderTest.php

@@ -4,8 +4,8 @@ declare(strict_types=1);
 
 namespace Anonympins\Fingerprint\Tests;
 
-use PHPUnit\Framework\TestCase;
 use Anonympins\Fingerprint\FingerprintBuilder;
+use PHPUnit\Framework\TestCase;
 
 class FingerprintBuilderTest extends TestCase
 {

package/src/php/Tests/FingerprintEngineTest.php

@@ -4,13 +4,13 @@ declare(strict_types=1);
 
 namespace Anonympins\Fingerprint\Tests;
 
-use PHPUnit\Framework\TestCase;
-use Anonympins\Fingerprint\FingerprintEngine;
+use Anonympins\Fingerprint\Config\SecurityProfiles;
 use Anonympins\Fingerprint\FingerprintBuilder;
+use Anonympins\Fingerprint\FingerprintEngine;
 use Anonympins\Fingerprint\RequestContext;
-use Anonympins\Fingerprint\Store\StoreManager;
 use Anonympins\Fingerprint\Store\InMemoryStore;
-use Anonympins\Fingerprint\Config\SecurityProfiles;
+use Anonympins\Fingerprint\Store\StoreManager;
+use PHPUnit\Framework\TestCase;
 
 class FingerprintEngineTest extends TestCase
 {

package/src/php/Tests/IpReputationTest.php

@@ -4,11 +4,11 @@ declare(strict_types=1);
 
 namespace Anonympins\Fingerprint\Tests;
 
-use PHPUnit\Framework\TestCase;
-use Anonympins\Fingerprint\Utils\RequestUtils;
-use Anonympins\Fingerprint\Store\StoreManager;
-use Anonympins\Fingerprint\Store\IStore;
 use Anonympins\Fingerprint\RequestContext;
+use Anonympins\Fingerprint\Store\IStore;
+use Anonympins\Fingerprint\Store\StoreManager;
+use Anonympins\Fingerprint\Utils\RequestUtils;
+use PHPUnit\Framework\TestCase;
 
 class IpReputationTest extends TestCase
 {

package/src/php/Tests/Ja3AnomalyDetectorTest.php

@@ -4,8 +4,8 @@ declare(strict_types=1);
 
 namespace Anonympins\Fingerprint\Tests;
 
-use PHPUnit\Framework\TestCase;
 use Anonympins\Fingerprint\Ja3AnomalyDetector;
+use PHPUnit\Framework\TestCase;
 
 /**
  * Tests unitaires pour la classe Ja3AnomalyDetector.

package/src/php/Tests/MetricsTest.php

@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Anonympins\Fingerprint\Tests;
+
+use Anonympins\Fingerprint\RequestContext;
+use Anonympins\Fingerprint\DirectFingerprint;
+use Anonympins\Fingerprint\Utils\MetricsManager;
+use Anonympins\Fingerprint\Store\InMemoryStore;
+use Anonympins\Fingerprint\Store\StoreManager;
+use PHPUnit\Framework\TestCase;
+
+class MetricsTest extends TestCase
+{
+    protected function setUp(): void
+    {
+        parent::setUp();
+        StoreManager::configureStore(new InMemoryStore());
+    }
+
+    public function testIncrementCounterAndGetPrometheusMetrics(): void
+    {
+        MetricsManager::incrementCounter('requests_total', ['status' => 'passed']);
+        $metrics = MetricsManager::getPrometheusMetrics();
+
+        $this->assertStringContainsString('fingerprint_requests_total', $metrics);
+        $this->assertStringContainsString('status="passed"', $metrics);
+    }
+
+    public function testGetPrometheusMetricsViaDirectFingerprint(): void
+    {
+        $config = [
+            'metricsAuthorizationCallback' => function (RequestContext $context) {
+                return true;
+            }
+        ];
+
+        $direct = new DirectFingerprint($config);
+        MetricsManager::incrementCounter('requests_total', ['status' => 'passed']);
+        $metrics = $direct->getPrometheusMetrics();
+
+        $this->assertNotNull($metrics);
+        $this->assertStringContainsString('fingerprint_requests_total', $metrics);
+    }
+}

package/src/php/Tests/PowTest.php

@@ -4,12 +4,12 @@ declare(strict_types=1);
 
 namespace Anonympins\Fingerprint\Tests;
 
-use PHPUnit\Framework\TestCase;
+use Anonympins\Fingerprint\Config\SecurityProfiles;
 use Anonympins\Fingerprint\FingerprintEngine;
 use Anonympins\Fingerprint\ProblemManager;
 use Anonympins\Fingerprint\Store\InMemoryStore;
 use Anonympins\Fingerprint\Store\StoreManager;
-use Anonympins\Fingerprint\Config\SecurityProfiles;
+use PHPUnit\Framework\TestCase;
 
 class PowTest extends TestCase
 {

package/src/php/Tests/ProblemManagerTest.php

@@ -4,11 +4,13 @@ declare(strict_types=1);
 
 namespace Anonympins\Fingerprint\Tests;
 
-use PHPUnit\Framework\TestCase;
+use Anonympins\Fingerprint\Optimization\FunctionRegistry;
 use Anonympins\Fingerprint\ProblemManager;
-use Anonympins\Fingerprint\Store\IStore;
 use Anonympins\Fingerprint\Store\InMemoryStore;
-use Anonympins\Fingerprint\Optimization\FunctionRegistry; // Assurez-vous que cette classe est autoloadable
+use Anonympins\Fingerprint\Store\IStore;
+use PHPUnit\Framework\TestCase;
+
+// Assurez-vous que cette classe est autoloadable
 
 class ProblemManagerTest extends TestCase
 {

package/src/php/Tests/RequestUtilsTest.php

@@ -4,9 +4,9 @@ declare(strict_types=1);
 
 namespace Anonympins\Fingerprint\Tests;
 
-use PHPUnit\Framework\TestCase;
 use Anonympins\Fingerprint\RequestContext;
 use Anonympins\Fingerprint\Utils\RequestUtils;
+use PHPUnit\Framework\TestCase;
 
 class RequestUtilsTest extends TestCase
 {
@@ -78,4 +78,69 @@ class RequestUtilsTest extends TestCase
         $result = RequestUtils::getClickVarianceScore($context);
         $this->assertEquals(0.0, $result['clickVarianceScore']);
     }
+
+    public function testSanitizeTrafficDataFiltersSybilAttacks(): void
+    {
+        $trafficData = [];
+        // Ajout de 100 logs provenant d'un attaquant (Sybil)
+        for ($i = 0; $i < 100; $i++) {
+            $trafficData[] = ['deviceId' => 'attacker_device', 'type' => 'trap_triggered'];
+        }
+        // Ajout de 10 logs d'utilisateurs légitimes distincts
+        for ($i = 0; $i < 10; $i++) {
+            $trafficData[] = ['deviceId' => "legit_device_{$i}", 'type' => 'challenge_solved'];
+        }
+
+        $sanitized = RequestUtils::sanitizeTrafficData($trafficData);
+
+        $attackerLogs = array_filter($sanitized, fn($log) => $log['deviceId'] === 'attacker_device');
+
+        // Total de 110 logs. 2% de 110 est 2.2 -> max(3, 2) = 3 logs maximum autorisés pour l'attaquant.
+        $this->assertLessThanOrEqual(3, count($attackerLogs));
+    }
+
+    public function testChallengePayloadSigningAndVerification(): void
+    {
+        $secret = 'test-fallback-dev-secret-32-chars-minimum';
+        $clientIp = '203.0.113.42';
+        $payload = [
+            'clientSecret' => 'some_client_secret',
+            'cpuTarget' => '00000000ffffffff',
+            'fingerprint' => 'os:hash|gpu:hash2',
+            'memDifficulty' => '16',
+            'originalPath' => '/submit',
+        ];
+
+        // 1. Cas nominal : Signature et vérification réussies
+        $signature = RequestUtils::signChallengePayload($secret, $payload, $clientIp);
+        $this->assertNotEmpty($signature);
+
+        $payloadWithSig = $payload;
+        $payloadWithSig['signature'] = $signature;
+
+        $isValid = RequestUtils::verifyChallengePayload($secret, $payloadWithSig, $clientIp);
+        $this->assertTrue($isValid, "La signature valide doit être acceptée.");
+
+        // 2. Détection de modification (tampering) sur cpuTarget
+        $tamperedPayload = $payloadWithSig;
+        $tamperedPayload['cpuTarget'] = 'ffffffffffffffff'; // Tentative de baisse de la difficulté
+        
+        $isTamperedValid = RequestUtils::verifyChallengePayload($secret, $tamperedPayload, $clientIp);
+        $this->assertFalse($isTamperedValid, "Un payload modifié doit être rejeté.");
+
+        // 3. Détection de modification sur le fingerprint
+        $tamperedFpPayload = $payloadWithSig;
+        $tamperedFpPayload['fingerprint'] = 'os:another_hash|gpu:hash2';
+        
+        $isTamperedFpValid = RequestUtils::verifyChallengePayload($secret, $tamperedFpPayload, $clientIp);
+        $this->assertFalse($isTamperedFpValid, "Un fingerprint modifié doit être rejeté.");
+
+        // 4. Détection d'usurpation d'adresse IP (IP mismatch)
+        $isIpMismatchValid = RequestUtils::verifyChallengePayload($secret, $payloadWithSig, '198.51.100.1');
+        $this->assertFalse($isIpMismatchValid, "Le payload ne doit pas être valide pour une autre adresse IP.");
+
+        // 5. Absence de signature
+        $isMissingSigValid = RequestUtils::verifyChallengePayload($secret, $payload, $clientIp);
+        $this->assertFalse($isMissingSigValid, "Un payload sans signature doit être rejeté.");
+    }
 }