@anonympins/fingerprint 0.6.7 → 0.7.1

package/src/php/WordPress/WpDbStore.php

@@ -0,0 +1,155 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Anonympins\Fingerprint\WordPress;
+
+use Anonympins\Fingerprint\Store\IStore;
+
+// Polyfill pour ARRAY_A si chargé hors du cycle de vie standard de WordPress
+if (!defined('ARRAY_A')) {
+    define('ARRAY_A', 'ARRAY_A');
+}
+
+/**
+ * Adaptateur IStore persistant pour WordPress exploitant l'objet $wpdb.
+ * Permet de stocker les sessions d'appareils, nonces et états de PoW
+ * sans dépendre d'une extension mémoire comme Redis ou APCu.
+ */
+class WpDbStore implements IStore
+{
+    /** @var \wpdb|object|null */
+    private $db;
+    private string $table;
+
+    public function __construct($db = null)
+    {
+        global $wpdb;
+        $this->db = $db ?? $wpdb;
+        $prefix = (is_object($this->db) && isset($this->db->prefix)) ? $this->db->prefix : 'wp_';
+        $this->table = $prefix . 'fingerprint_store';
+    }
+
+    /**
+     * Crée la table de stockage si elle n'existe pas encore.
+     */
+    public function ensureTable(): void
+    {
+        if (!$this->db || !method_exists($this->db, 'get_charset_collate')) {
+            return;
+        }
+
+        $charsetCollate = $this->db->get_charset_collate();
+        $sql = "CREATE TABLE IF NOT EXISTS {$this->table} (
+            `key_id` VARCHAR(191) NOT NULL,
+            `value` LONGTEXT NOT NULL,
+            `expires_at` BIGINT UNSIGNED NULL,
+            PRIMARY KEY (`key_id`),
+            KEY `expires_idx` (`expires_at`)
+        ) {$charsetCollate};";
+
+        // Chargement sécurisé de dbDelta si ABSPATH est présent
+        if (!function_exists('dbDelta') && defined('ABSPATH')) {
+            $upgradeFile = ABSPATH . 'wp-admin/includes/upgrade.php';
+            if (file_exists($upgradeFile)) {
+                require_once $upgradeFile;
+            }
+        }
+
+        if (function_exists('dbDelta')) {
+            dbDelta($sql);
+        } elseif (method_exists($this->db, 'query')) {
+            $this->db->query($sql);
+        }
+    }
+
+    public function get(string $key)
+    {
+        if (!$this->db || !method_exists($this->db, 'prepare')) {
+            return null;
+        }
+
+        $sql = $this->db->prepare(
+            "SELECT `value`, `expires_at` FROM {$this->table} WHERE `key_id` = %s",
+            $key
+        );
+        $outputType = defined('ARRAY_A') ? \ARRAY_A : 'ARRAY_A';
+        $row = $this->db->get_row($sql, $outputType);
+
+        if (!$row) {
+            return null;
+        }
+
+        if ($row['expires_at'] !== null && (int)$row['expires_at'] < time()) {
+            $this->delete($key);
+            return null;
+        }
+
+        $decoded = json_decode((string)$row['value'], true);
+        return (json_last_error() === JSON_ERROR_NONE) ? $decoded : $row['value'];
+    }
+
+    public function set(string $key, $value, ?int $ttl = null): void
+    {
+        if (!$this->db || !method_exists($this->db, 'replace')) {
+            return;
+        }
+
+        $expiresAt = ($ttl !== null && $ttl > 0) ? (time() + $ttl) : null;
+        $serialized = is_scalar($value) && !is_bool($value)
+            ? (string)$value
+            : json_encode($value, JSON_UNESCAPED_SLASHES);
+
+        $this->db->replace(
+            $this->table,
+            [
+                'key_id'     => $key,
+                'value'      => $serialized,
+                'expires_at' => $expiresAt
+            ],
+            ['%s', '%s', $expiresAt !== null ? '%d' : null]
+        );
+    }
+
+    public function has(string $key): bool
+    {
+        return $this->get($key) !== null;
+    }
+
+    public function delete(string $key): void
+    {
+        if (!$this->db || !method_exists($this->db, 'delete')) {
+            return;
+        }
+
+        $this->db->delete(
+            $this->table,
+            ['key_id' => $key],
+            ['%s']
+        );
+    }
+
+    public function clear(): void
+    {
+        if (!$this->db || !method_exists($this->db, 'query')) {
+            return;
+        }
+        $this->db->query("TRUNCATE TABLE {$this->table}");
+    }
+
+    /**
+     * Nettoie les lignes expirées (appelé par le WP-Cron périodique).
+     */
+    public function pruneExpired(): int
+    {
+        if (!$this->db || !method_exists($this->db, 'prepare')) {
+            return 0;
+        }
+
+        $now = time();
+        $deleted = $this->db->query(
+            $this->db->prepare("DELETE FROM {$this->table} WHERE `expires_at` IS NOT NULL AND `expires_at` < %d", $now)
+        );
+        return is_numeric($deleted) ? (int)$deleted : 0;
+    }
+}

package/src/php/WordPress/fingerprint-wordpress.php

@@ -0,0 +1,217 @@
+<?php
+/**
+ * Plugin Name: Fingerprint Anti-Bot & Proof-of-Work
+ * Plugin URI: https://github.com/anonympins/fingerprint
+ * Description: Protection bot haute performance pour WordPress avec Proof-of-Work client et détection d'anomalies.
+ * Version: 0.7.1
+ * Author: Anonympins
+ * License: MIT
+ */
+
+declare(strict_types=1);
+
+use Anonympins\Fingerprint\DirectFingerprint;
+use Anonympins\Fingerprint\Store\StoreManager;
+use Anonympins\Fingerprint\Config\SecurityProfiles;
+use Anonympins\Fingerprint\WordPress\WpDbStore;
+
+if (!defined('ABSPATH')) {
+    exit;
+}
+
+// =============================================================================
+// PIÈGES HONEYPOT POUR ENVIRONNEMENTS TIERS (NON-WORDPRESS)
+// Détecte et bloque instantanément les scans de vulnérabilités ciblant
+// Laravel, Symfony, Spring Boot, Django, ASP.NET, phpMyAdmin, Git, Cloud, etc.
+// =============================================================================
+$foreignEnvTrapUrls = [
+    // Outils d'administration BDD & scripts de debug
+    '/phpmyadmin', '/pma', '/adminer', '/mysql', '/dbadmin', '/phpinfo',
+    // Frameworks PHP (Laravel, Symfony) & fichiers d'environnement
+    '/.env', '/artisan', '/telescope', '/_profiler', '/config/database.php', '/vendor/',
+    // Java / Spring Boot / Actuator
+    '/actuator', '/actuator/health', '/actuator/gateway', '/api-docs', '/swagger-ui',
+    // Python / Django / Flask
+    '/.flask', '/django_admin', '/__pycache__',
+    // Node.js & configuration paquets
+    '/.npmrc', '/package.json', '/package-lock.json',
+    // ASP.NET / IIS / CGI
+    '/elmah.axd', '/trace.axd', '/cgi-bin/',
+    // DevOps, VCS & Déploiements cloud
+    '/.git', '/.svn', '/.aws', '/.kube', '/docker-compose', '/serverless'
+];
+
+$foreignEnvHoneypotFields = [
+    // Tokens CSRF et formulaires spécifiques à d'autres frameworks
+    '_token',                // Laravel
+    'csrfmiddlewaretoken',   // Django
+    'authenticity_token',    // Ruby on Rails
+    'form_build_id',         // Drupal
+    'form_id',               // Drupal
+    'j_username',            // Java / Spring Security
+    'j_password',            // Java / Spring Security
+    '__VIEWSTATE',           // ASP.NET WebForms
+    '__EVENTVALIDATION',     // ASP.NET WebForms
+];
+
+// =============================================================================
+// CONFIGURATION RAPIDE DES PROFILS DE SÉCURITÉ PAR CONTEXTE
+// =============================================================================
+$fingerprintSecurityProfiles = [
+    'api' => [
+        'profile'   => 'api',
+        'overrides' => [
+            'verbose'             => false,
+            'challengeNewDevices' => false,
+            'honeypot'            => [
+                'fields'           => $foreignEnvHoneypotFields,
+                'trapUrls'         => $foreignEnvTrapUrls,
+                'detectInjections' => true,
+            ],
+        ],
+    ],
+    'admin' => [
+        'profile'   => 'strict',
+        'overrides' => [
+            'verbose'             => true,
+            'challengeNewDevices' => true,
+            'honeypot'            => [
+                'fields'           => $foreignEnvHoneypotFields,
+                'trapUrls'         => $foreignEnvTrapUrls,
+                'detectInjections' => true,
+            ],
+        ],
+    ],
+    'frontend' => [
+        'profile'   => 'blog',
+        'overrides' => [
+            'verbose'             => false,
+            'challengeNewDevices' => false,
+            'honeypot'            => [
+                'fields'           => $foreignEnvHoneypotFields,
+                'trapUrls'         => $foreignEnvTrapUrls,
+                'detectInjections' => true,
+            ],
+        ],
+    ],
+];
+
+// 1. Autoloader PSR-4 pour le moteur Fingerprint
+if (!class_exists(DirectFingerprint::class)) {
+    $composerPaths = [
+        __DIR__ . '/vendor/autoload.php',
+        dirname(__DIR__, 2) . '/vendor/autoload.php',
+        dirname(__DIR__, 3) . '/vendor/autoload.php',
+        (defined('ABSPATH') ? ABSPATH . 'vendor/autoload.php' : ''),
+    ];
+    foreach ($composerPaths as $cPath) {
+        if (!empty($cPath) && file_exists($cPath)) {
+            require_once $cPath;
+            break;
+        }
+    }
+
+    spl_autoload_register(function (string $class): void {
+        $prefix = 'Anonympins\\Fingerprint\\';
+        $len = strlen($prefix);
+        if (strncmp($prefix, $class, $len) !== 0) {
+            return;
+        }
+
+        $relativeClass = substr($class, $len);
+
+        // Classes spécifiques WordPress (ex: WpDbStore)
+        if (str_starts_with($relativeClass, 'WordPress\\')) {
+            $localClass = substr($relativeClass, strlen('WordPress\\'));
+            $localFile = __DIR__ . '/' . str_replace('\\', '/', $localClass) . '.php';
+            if (file_exists($localFile)) {
+                require_once $localFile;
+                return;
+            }
+        }
+
+        // Chemins candidats pour le moteur PHP (packagé ou environnement dev)
+        $candidateDirs = [
+            __DIR__ . '/src/',
+            __DIR__ . '/includes/',
+            __DIR__ . '/',
+            dirname(__DIR__) . '/',
+        ];
+
+        $fileRelative = str_replace('\\', '/', $relativeClass) . '.php';
+        foreach ($candidateDirs as $dir) {
+            $fullPath = $dir . $fileRelative;
+            if (file_exists($fullPath)) {
+                require_once $fullPath;
+                return;
+            }
+        }
+    });
+}
+
+// 2. Activation du plugin : Création de la table de cache SQL
+register_activation_hook(__FILE__, function () {
+    $store = new WpDbStore();
+    $store->ensureTable();
+
+    if (!wp_next_scheduled('fingerprint_prune_expired_entries')) {
+        wp_schedule_event(time(), 'hourly', 'fingerprint_prune_expired_entries');
+    }
+});
+
+// 3. Désactivation : Nettoyage du WP-Cron
+register_deactivation_hook(__FILE__, function () {
+    wp_clear_scheduled_hook('fingerprint_prune_expired_entries');
+});
+
+// 4. Tâche de fond WP-Cron : Purge des clés expirées dans la BDD
+add_action('fingerprint_prune_expired_entries', function () {
+    $store = new WpDbStore();
+    $store->pruneExpired();
+});
+
+// 5. Avertissement Admin si le site n'utilise pas HTTPS (Environnement Non Sécurisé)
+add_action('admin_notices', function () {
+    if (!is_ssl()) {
+        echo '<div class="notice notice-warning is-dismissible">';
+        echo '<p><strong>[Fingerprint Anti-Bot Security Warning]</strong> : Votre site fonctionne actuellement sous le protocole non chiffré <code>HTTP</code>. ';
+        echo 'Dans ce mode, l\'API native <em>Web Cryptography</em> (<code>crypto.subtle</code>) des navigateurs est désactivée par mesure de sécurité par les navigateurs modernes, ';
+        echo 'forçant l\'exécution d\'un simulacre/fallback purement JavaScript plus lent et vulnérable aux attaques par interception (MitM). ';
+        echo 'Il est fortement recommandé de déployer un certificat TLS/SSL et de forcer <code>HTTPS</code> pour garantir l\'intégrité des calculs PoW et la protection des cookies d\'identité.</p>';
+        echo '</div>';
+    }
+});
+
+// 5. Interception de sécurité au plus tôt du cycle de vie WordPress
+add_action('plugins_loaded', function () use ($fingerprintSecurityProfiles) {
+    // Ignore WP-CLI et les exécutions internes de cron
+    if ((defined('WP_CLI') && WP_CLI) || (defined('DOING_CRON') && DOING_CRON)) {
+        return;
+    }
+
+    // Initialiser le Store persistant basé sur $wpdb
+    $store = new WpDbStore();
+    StoreManager::configureStore($store);
+
+    $requestUri = $_SERVER['REQUEST_URI'] ?? '/';
+    $isRestApi = defined('REST_REQUEST') && REST_REQUEST;
+    $isAdmin = is_admin() || str_contains($requestUri, 'wp-login.php');
+
+    // Possibilité de filtrer la configuration via functions.php ou un thème
+    $configs = apply_filters('fingerprint_security_profiles', $fingerprintSecurityProfiles);
+
+    // Sélection adaptative du profil selon la cible de la requête
+    if ($isRestApi || str_starts_with($requestUri, '/wp-json/')) {
+        $contextConfig = $configs['api'] ?? $fingerprintSecurityProfiles['api'];
+    } elseif ($isAdmin) {
+        $contextConfig = $configs['admin'] ?? $fingerprintSecurityProfiles['admin'];
+    } else {
+        $contextConfig = $configs['frontend'] ?? $fingerprintSecurityProfiles['frontend'];
+    }
+
+    $securityConfig = SecurityProfiles::createSecurityProfile($contextConfig['profile'], $contextConfig['overrides'] ?? []);
+    $guard = new DirectFingerprint($securityConfig);
+
+    // Inspecte la requête : bloque ou envoie le challenge si nécessaire et stoppe le script
+    $guard->protect();
+}, 0);

package/src/php/WordPress/package.php

@@ -0,0 +1,123 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * Script d'empaquetage automatique du plugin WordPress.
+ * Copie les classes du moteur PHP, les assets JS et génère un ZIP prêt à être installé.
+ *
+ * Usage:
+ *   php src/php/WordPress/package.php
+ */
+
+if (!extension_loaded('zip')) {
+    fwrite(STDERR, "Erreur : L'extension PHP 'zip' est requise pour créer l'archive.\n");
+    exit(1);
+}
+
+$rootDir = dirname(__DIR__, 3);
+$phpSrcDir = $rootDir . '/src/php';
+$jsSrcDir = $rootDir . '/src/js';
+$wpDir = $phpSrcDir . '/WordPress';
+$distDir = $rootDir . '/public';
+$pluginSlug = 'fingerprint-wordpress';
+$buildDir = $distDir . '/' . $pluginSlug;
+$zipFile = $distDir . '/' . $pluginSlug . '.zip';
+
+echo "==> Début du packaging du plugin WordPress...\n";
+
+// 1. Nettoyage du répertoire de build précédent
+if (is_dir($buildDir)) {
+    $iterator = new RecursiveIteratorIterator(
+        new RecursiveDirectoryIterator($buildDir, FilesystemIterator::SKIP_DOTS),
+        RecursiveIteratorIterator::CHILD_FIRST
+    );
+    foreach ($iterator as $item) {
+        $item->isDir() ? rmdir($item->getPathname()) : unlink($item->getPathname());
+    }
+    rmdir($buildDir);
+}
+if (file_exists($zipFile)) {
+    unlink($zipFile);
+}
+
+@mkdir($buildDir . '/src', 0777, true);
+@mkdir($buildDir . '/assets', 0777, true);
+
+// 2. Copie des fichiers principaux du plugin WordPress
+copy($wpDir . '/fingerprint-wordpress.php', $buildDir . '/fingerprint-wordpress.php');
+copy($wpDir . '/WpDbStore.php', $buildDir . '/WpDbStore.php');
+
+// 3. Copie des assets clients nécessaires (solveur PoW)
+$solverSource = $jsSrcDir . '/pow.solver.inline.js';
+if (file_exists($solverSource)) {
+    copy($solverSource, $buildDir . '/assets/pow.solver.inline.js');
+}
+
+// 4. Copie récursive de la bibliothèque PHP (src/php -> build/src), en excluant les dossiers de dev
+$excludeDirs = ['WordPress', 'Tests', 'bin'];
+$phpIterator = new RecursiveIteratorIterator(
+    new RecursiveDirectoryIterator($phpSrcDir, FilesystemIterator::SKIP_DOTS),
+    RecursiveIteratorIterator::SELF_FIRST
+);
+
+foreach ($phpIterator as $item) {
+    $relativePath = substr($item->getPathname(), strlen($phpSrcDir) + 1);
+    $topDir = explode(DIRECTORY_SEPARATOR, str_replace('/', DIRECTORY_SEPARATOR, $relativePath))[0];
+
+    if (in_array($topDir, $excludeDirs, true)) {
+        continue;
+    }
+
+    $destPath = $buildDir . '/src/' . $relativePath;
+    if ($item->isDir()) {
+        if (!is_dir($destPath)) {
+            mkdir($destPath, 0777, true);
+        }
+    } else {
+        copy($item->getPathname(), $destPath);
+    }
+}
+
+echo "==> Fichiers copiés dans {$buildDir}\n";
+
+// 5. Création de l'archive ZIP
+$zip = new ZipArchive();
+if ($zip->open($zipFile, ZipArchive::CREATE | ZipArchive::OVERWRITE) !== true) {
+    fwrite(STDERR, "Erreur : Impossible de créer le fichier {$zipFile}\n");
+    exit(1);
+}
+
+$distIterator = new RecursiveIteratorIterator(
+    new RecursiveDirectoryIterator($buildDir, FilesystemIterator::SKIP_DOTS),
+    RecursiveIteratorIterator::LEAVES_ONLY
+);
+
+foreach ($distIterator as $file) {
+    if (!$file->isDir()) {
+        $filePath = $file->getPathname();
+        // Préserve le préfixe du dossier racine dans le ZIP : fingerprint-wordpress/...
+        $relativePath = $pluginSlug . '/' . substr($filePath, strlen($buildDir) + 1);
+        $zip->addFile($filePath, str_replace('\\', '/', $relativePath));
+    }
+}
+function removeDirectory(string $dir): void
+{
+    if (!is_dir($dir)) {
+        return;
+    }
+    $iterator = new RecursiveIteratorIterator(
+        new RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS),
+        RecursiveIteratorIterator::CHILD_FIRST
+    );
+    foreach ($iterator as $item) {
+        $item->isDir() ? rmdir($item->getPathname()) : unlink($item->getPathname());
+    }
+    rmdir($dir);
+}
+$zip->close();
+removeDirectory($buildDir);
+$sizeKb = round(filesize($zipFile) / 1024, 2);
+echo "==> Archive ZIP générée avec succès :\n";
+echo "    Fichier : {$zipFile} ({$sizeKb} Ko)\n";
+echo "    Prêt à être installé via wp-admin ou déployé en production !\n";