opaque-logger 0.1.1

Deterministic Data Masking Engine with Mathematical Validation - No AI Guessing

🛡️ OPAQUE

Deterministic Data Masking Engine

Don't guess if it's a CPF. Prove it mathematically.

🇺🇸 English | 🇧🇷 Português | 🇪🇸 Español

---

The only data masking library that uses MATH, not AI

🎯 Why OPAQUE?

Unlike AI-based solutions that guess, OPAQUE validates using mathematical algorithms:

Feature	AI Solutions	OPAQUE
Validation	Neural networks (guessing)	Mathematical algorithms (proof)
False Positives	Common	Zero
Performance	Slow (GPU required)	Ultra-fast (pure math)
Debuggability	Black box	Deterministic hashing
Reversibility	No	Yes (Vault Mode)

✨ Key Features

🔐 Mathematical Validation CPF: Mod 11 algorithm CNPJ: Weighted Mod 11 Credit Cards: Luhn algorithm Pix: Format validation	🏦 Vault Mode AES-256 encryption Reversible for debugging CLI decryption tool Master key protection
🍯 Honeytokens Intrusion detection Bait data alerts Real-time monitoring Security integration	⚡ Circuit Breaker Flood protection Auto-recovery Resource optimization Server stability

🚀 Quick Start

Installation

pip install opaque-logger

Basic Usage

import logging
from opaque import OpaqueLogger, Validators

# Configure
OpaqueLogger.setup_defaults(
    rules=[Validators.BR.CPF, Validators.BR.CNPJ],
    obfuscation_method="HASH"
)

# Integrate
logging.setLoggerClass(OpaqueLogger)
logger = logging.getLogger("app")

# Log securely
logger.info("User CPF: 529.982.247-25")
# Output: User CPF: [HASH-3A4C]

📊 Performance Benchmarks

Sanitization:     1,000+ messages/sec
CPF Validation:   65,000+ ops/sec
CNPJ Validation:  68,000+ ops/sec
Credit Card:      122,000+ ops/sec
Vault Encryption: 22,000+ ops/sec

🧪 Test Coverage

pytest -v

Results: ✅ 24/24 tests passing (100% success rate)

📚 Examples

🔹 Vault Mode (Reversible Encryption)

OpaqueLogger.setup_defaults(
    obfuscation_method="VAULT",
    vault_key="your-master-key"
)

logger.info("Processing CPF 529.982.247-25")
# Output: Processing CPF [VAULT:gAAAAABl...]

# Decrypt later
python -m opaque.cli reveal "[VAULT:gAAAAABl...]" --key=your-master-key
# Output: 🔓 REVEALED DATA: 529.982.247-25

🔹 Honeytokens (Intrusion Detection)

OpaqueLogger.setup_defaults(
    honeytokens=["999.888.777-66"]  # Bait CPF
)

logger.info("Access with CPF 999.888.777-66")
# Stderr: 🚨 ALERTA VERMELHO: HONEYTOKEN DETECTED
# Output: Access with CPF [HONEYTOKEN TRIGGERED]

🔹 Crash Handler (Traceback Sanitization)

from opaque import install_crash_handler

install_crash_handler()

# Now all crashes sanitize sensitive data
password = "secret123"
cpf = "529.982.247-25"
raise ValueError(f"Error: {cpf}")
# Traceback shows: ValueError: Error: [HASH-3A4C]
# Locals show: password = [REDACTED_SECRET_KEY]

🔹 Compliance Scanning

python -m opaque.cli scan ./src --output=report.html
# Output: 🛡️ Security Score: 98%

🏗️ Architecture

┌─────────────────────────────────────────────────────┐
│                   OPAQUE Engine                     │
├─────────────────────────────────────────────────────┤
│  1. Regex Pattern Matching (Context-Aware)         │
│  2. Mathematical Validation (Mod 11, Luhn)         │
│  3. Honeytoken Detection                            │
│  4. Circuit Breaker Check                           │
│  5. Obfuscation (Hash/Vault/Mask)                  │
└─────────────────────────────────────────────────────┘

🌍 Supported Validators

🇧🇷 Brazil

• ✅ CPF - Individual taxpayer ID
• ✅ CNPJ - Company taxpayer ID
• ✅ Pix - Instant payment keys

💳 Finance

• ✅ Credit Cards - Visa, Mastercard, Amex, etc.

🔜 Coming Soon

• CNH (Driver's License)
• Renavam (Vehicle Registration)
• Mercosul License Plates

📖 Documentation

Language	Link
🇺🇸 English	Complete Guide
🇧🇷 Português	Guia Completo
🇪🇸 Español	Guía Completa

🤝 Contributing

We welcome contributions! See our Contributing Guide.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Links

• PyPI Package: opaque-logger
• Issues: GitHub Issues
• Changelog: CHANGELOG.md

---

Built with precision by Samuel Silva

Protecting data with mathematics, not magic ✨