Fingerprint anti-bot protection

NodeJS tests : Test NodeJS / PHP tests : PHP / Python tests : PHP

Release License GitHub commit activity

A multi-layered behavioral, cryptographic, and network analysis engine designed to identify and mitigate malicious requests (bots, scrapers, session hijacking) in real-time. Supports Node.js, Python and PHP environments.

illustration

• Multi-Layered Detection: Combines TLS/JA3/JA4 analysis, HTTP header consistency checks, IP reputation, and behavioral tracking (mouse movements, keystrokes).
• Adaptive Mitigation: Imposes progressive cryptographic Proof-of-Work (PoW) challenges to block automated clients without impacting legitimate human users.
• Predefined Profiles: Ready-to-use security profiles (balanced, strict, api, blog, ecommerce) tailored to your specific use case.

npm install @anonympins/fingerprint

composer require anonympins/fingerprint

pip install fingerprint-engine

To prevent documentation drift, all detailed guides and reference materials are maintained in the doc/ directory. Please refer to these resources to configure and integrate the engine:

1. Key Concepts & Suspicion Vectors : Learn how the engine calculates suspicion scores across the 15 distinct vectors and manages the Proof-of-Work mitigation layers.
2. Node.js Integration Guide : Step-by-step instructions for Express.js middleware and raw HTTP server integrations.
3. PHP Integration Guide : Configuration details for direct PHP integration, TLS fingerprinting forwarding via Nginx/Apache, and securing Prometheus metrics.
4. Python Integration Guide : Python middleware for ASGI and WSGI integration.
5. Full Configuration Options : Complete parameter list for fine-tuning weights, custom honeypots, and security profile overrides.
6. API Reference : Public API signatures and guides on substituting the in-memory datastore with Redis or MongoDB.

Start with the Documentation Portal for a complete index.

We welcome community contributions! Please read our Contributing Guidelines for information on:

• Setting up your local environment (Node.js and PHP).
• Running the test suites (Vitest and PHPUnit).
• Coding and pull request standards.

Thanks to our contributors :

• anonympins

• https://primals.net and sub-sites

This project is licensed under the MIT License.