datadome-encryption

DataDome Encryption System: Reverse Engineering & Implementation

A comprehensive reverse engineering analysis of DataDome's client-side encryption algorithm used in their anti-bot protection system alongside a npm module

Documentation

This repository contains a complete analysis of DataDome's encryption system:

Document	Description
README.md	Project overview and introduction
ENCRYPTION.md	Detailed analysis of the encryption algorithm
DECRYPTION.md	Implementation of the decryption process
technical_analysis.md	Technical deep-dive into cryptographic properties
LEARN.md	Educational guide on reverse engineering techniques

Table of Contents

• DataDome Encryption System: Reverse Engineering & Implementation
  • Documentation
  • Table of Contents
  • Installation & Quick Start
    • Basic Usage Example
  • Project Overview
  • Reverse Engineering Process
    • Step 1: Original Code Extraction
    • Step 2: Core Function Identification
    • Step 3: Algorithmic Analysis
    • Step 4: Rewriting as a Clean Implementation
  • Decryption Implementation
  • Usage Examples
    • Encryption
    • Different Challenge Types
      • Technical differences between challenge types:
    • Decryption
  • Technical Deep Dive
  • Project Files
  • Learn from this Project
  • Conclusion
    • Critical Evaluation of DataDome's Encryption
  • Author
  • Contributing

Need DataDome Bypass Solutions?

If you need a reliable DataDome bypass solution for your project, turn to the experts who truly understand the technology. My company, TakionAPI, offers professional anti-bot bypass APIs with proven effectiveness against DataDome and other bot-defense systems.

No more worrying about understanding, reversing, and solving the challenge yourself, or about keeping it up to date every day. One simple API call does it all.

We provide free trials, example implementations, and setup assistance to make the entire process easy and smooth.

• 📄 Check our straightforward documentation
• 🚀 Start your trial
• 💬 Contact us on Discord for custom development and support.

Visit TakionAPI.tech for real, high-quality anti-bot bypass solutions — we know what we're doing.

Installation & Quick Start

Install the module from npm:

npm install datadome-encryption

Basic Usage Example

const { DataDomeEncryptor, DataDomeDecryptor } = require('datadome-encryption');

const cid = "YOUR_CLIENT_ID";
const hash = "YOUR_HASH_STRING";
const signals = [
  ["key1", "value1"],
  ["key2", 123],
  // ... more key-value pairs
];

// Encryption
const encryptor = new DataDomeEncryptor(hash, cid);
signals.forEach(([key, value]) => encryptor.add(key, value));
const encrypted = encryptor.encrypt();
console.log('Encrypted:', encrypted);

// Decryption
const decryptor = new DataDomeDecryptor(hash, cid);
const decrypted = decryptor.decrypt(encrypted);
console.log('Decrypted:', decrypted);

Replace YOUR_CLIENT_ID and YOUR_HASH_STRING with your actual values. The signals array should contain your key-value pairs to encrypt.

check out tests/validity_check.js for a better understanding.

Project Overview

DataDome is a cybersecurity company valued at $33M specializing in bot detection and mitigation. This project decomposes their proprietary encryption mechanism, transforming the heavily obfuscated original code into a well-structured, documented implementation with a working decryption counterpart.

The project consists of:

• Original Code Analysis (encryption_original.js) - The obfuscated implementation extracted from DataDome
• Clean Implementation (encryption_rewrite.js) - A structured, commented rewrite that maintains exact functionality
• Decryption Module (decryption.js) - A complete implementation that can decrypt DataDome payloads
• Technical Analysis (technical_analysis.md) - Deep-dive into the algorithm's cryptographic properties

Reverse Engineering Process

The reverse engineering process followed these steps (see ENCRYPTION.md for full details):

Step 1: Original Code Extraction

The first step involved isolating the encryption routine from DataDome's client-side JavaScript:

// Original obfuscated implementation (excerpt from encryption_original.js)
var Ea = function () {
    if (Ta && s[150][460] != s[467][62]) return ya;
    Math.ceil(4.1), Math.ceil(0.25), Ta = 1;
    var e = 1789537805,
        t = Math.floor(1.29),
        a = parseInt(1567.97),
        M = 9959949970,
        g = !0;
    // ... many more obfuscated lines
}

Step 2: Core Function Identification

We identified three key functions in the encryption process:

• Hash Function (d in the original) - A djb2 variant for input hashing
• Mixing Function (D in the original) - A non-linear bit mixing algorithm
• PRNG Generator (I in the original) - Creates stateful pseudo-random generators

Step 3: Algorithmic Analysis

Through careful tracing and testing, we determined that the encryption process follows these steps:

• Initialize PRNG with hash-derived seed and salt
• Create a buffer for storing encrypted data
• For each key-value pair:
  • Add a start marker (XORed '{' or ',')
  • Stringify and XOR-encrypt the key
  • Add a separator (XORed ':')
  • Stringify and XOR-encrypt the value
• Apply a second XOR pass using a PRNG seeded with the client ID
• Encode the result using a custom base64-like scheme

Step 4: Rewriting as a Clean Implementation

The rewrite process involved:

• Creating a proper class structure (DataDomeEncryptor)
• Renaming functions and variables for clarity
• Adding detailed comments explaining each step
• Removing unnecessary obfuscation
• Preserving exact functional equivalence

For a detailed walkthrough of the challenges encountered during this process, see Challenges and Methodologies in Reverse Engineering DataDome.

Decryption Implementation

Implementing the decryption solution involved several unique challenges (see DECRYPTION.md for full details):

• PRNG Sequence Replication - Exact reproduction of the encryption PRNG
• Custom Base64 Decoding - Reversing the non-standard encoding scheme
• Dual-XOR Reversal - Applying XOR operations in the correct sequence
• JSON-like Structure Parsing - Custom parser for the recovered buffer

For a detailed explanation of the decryption implementation challenges, see Practical Decryption Challenges and Solutions.

Usage Examples

Encryption

const { DataDomeEncryptor } = require('./encryption_rewrite.js');

// Initialize with hash and client ID
const encryptor = new DataDomeEncryptor(
    "14D062F60A4BDE8CE8647DFC720349",
    "client_identifier_here"
);

// Add signals (key-value pairs)
encryptor.add("screenWidth", 1920);
encryptor.add("userAgent", "Mozilla/5.0...");

// Generate encrypted payload
const encrypted = encryptor.encrypt();

Different Challenge Types

DataDome uses two primary challenge types with slightly different encryption parameters:

// CAPTCHA challenge (default)
const captchaEncryptor = new DataDomeEncryptor(
    "14D062F60A4BDE8CE8647DFC720349",
    "client_identifier_here",
    null,  // optional salt
    "captcha"  // challenge type
);

// Interstitial challenge
const interstitialEncryptor = new DataDomeEncryptor(
    "14D062F60A4BDE8CE8647DFC720349",  // can be the same hash
    "client_identifier_here",
    null,  // optional salt
    "interstitial"  // challenge type
);

// You can also switch challenge types dynamically:
encryptor.setChallengeType("interstitial");

Technical differences between challenge types:

• Interstitial challenges:

  • Use a different hash XOR constant (-883841716)
  • Use a fixed HSV value ("9E9FC74889F6")
  • Do not apply padding handling in base64 decoding
  • Typically used for DataDome's interstitial pages

• CAPTCHA challenges (default):

  • Use the standard hash XOR constant (-1748112727)
  • Generate a dynamic HSV value
  • Apply traditional padding handling in base64 encoding/decoding
  • Used for the standard CAPTCHA challenge responses

When decrypting data, make sure to specify the same challenge type that was used for encryption:

// Decrypting an interstitial challenge
const decryptor = new DataDomeDecryptor(
    "14D062F60A4BDE8CE8647DFC720349",
    "client_identifier_here",
    null,  // optional salt
    "interstitial"  // must match the challenge type used for encryption
);

The library automatically handles the differences in encryption/decryption algorithms between challenge types.

Decryption

const { DataDomeDecryptor } = require('./decryption.js');

// Initialize with same parameters
const decryptor = new DataDomeDecryptor(
    "14D062F60A4BDE8CE8647DFC720349",
    "client_identifier_here",
    null,  // optional salt
    "captcha"  // challenge type - must match the encryption
);

// Decrypt payload
const decrypted = decryptor.decrypt(encryptedString);
console.log(decrypted);
// [["screenWidth", 1920], ["userAgent", "Mozilla/5.0..."]]

Technical Deep Dive

For a comprehensive analysis of the encryption algorithm, including:

• Constants analysis and their cryptographic significance
• PRNG implementation details and statistical properties
• Buffer construction and transformation processes
• Custom encoding algorithm
• Security and performance assessment

See the Technical Analysis document.

Project Files

• encryption_original.js - The extracted, obfuscated original code
• encryption_rewrite.js - Clean, commented implementation
• decryption.js - Complete decryption implementation
• ENCRYPTION.md - Detailed explanation of the encryption process
• DECRYPTION.md - Detailed explanation of the decryption implementation
• technical_analysis.md - In-depth cryptographic and security analysis
• LEARN.md - Educational guide on JavaScript reverse engineering
• example.js - Working example demonstrating encryption and decryption
• Various test files for verification and debugging

Learn from this Project

If you're interested in learning more about reverse engineering techniques used in this project, check out the LEARN.md guide. It provides:

• Detailed explanations of JavaScript obfuscation techniques
• Tools and methodologies for effective reverse engineering
• Step-by-step examples using DataDome's code
• Common challenges and how to overcome them
• Ethical considerations and resources for further learning

Conclusion

This project demonstrates how even sophisticated obfuscation techniques can be methodically reversed through careful analysis. The clean implementation provides valuable insight into client-side security techniques and serves as an educational resource for understanding advanced JavaScript obfuscation patterns.

For legitimate security needs, standard cryptographic algorithms and WebCrypto APIs provide stronger protection than custom obfuscation techniques.

Critical Evaluation of DataDome's Encryption

Despite DataDome being a $33M cybersecurity company specializing in bot protection, their encryption system reveals several concerning issues:

• Unchanged Implementation: The encryption algorithm has remained virtually unchanged since the first release of their captcha challenge, making it a static target for reverse engineering efforts.

• Security Through Obscurity: The system relies primarily on code obfuscation rather than cryptographically secure algorithms, creating a false sense of security.

• Lack of Modern Cryptography: Instead of leveraging the Web Cryptography API or established encryption standards, DataDome uses a custom algorithm with questionable security properties.

• Predictable Patterns: Once the algorithm is understood, the same techniques can be applied to decrypt all of DataDome's protected communications, as demonstrated by this project.

• Insufficient Iteration: Serious security systems typically evolve over time to address vulnerabilities and strengthen protection. The static nature of this implementation suggests inadequate security review processes.

A more robust approach would involve:

• Using established cryptographic primitives (e.g., AES-GCM)
• Implementing proper key management with frequent rotation
• Adopting server-side verification of encryption integrity
• Regular security audits and cryptographic improvements

This reverse engineering project serves as a case study in why organizations should avoid proprietary cryptographic implementations and instead rely on peer-reviewed, standardized algorithms when handling sensitive data or security-critical functions.

Author

If you found this project helpful or interesting, consider starring the repo and following me for more security research and tools, or buy me a coffee to keep me up

Contributing

Contributions are welcome! Please open issues or pull requests on GitHub. For guidelines, see CONTRIBUTING.md if present.