eslint-plugin-mongodb-security

v8.1.1

Published

17 days ago

Security-focused ESLint plugin for MongoDB & Mongoose. Detects NoSQL injection, operator attacks, credential exposure, and ODM-specific vulnerabilities with AI-optimized fix guidance.

Description

This plugin is essential for securing specific MongoDB interactions, primarily focusing on preventing NoSQL injection attacks. It analyzes your queries and database operations to flag potentially unsafe patterns that could be exploited by malicious actors. By adopting these rules, you can safeguard your data integrity and prevent unauthorized access through injection vulnerabilities.

Philosophy

Interlace fosters strength through integration. Instead of stacking isolated rules, we interlace security directly into your workflow to create a resilient fabric of code. We believe tools should guide rather than gatekeep, providing educational feedback that strengthens the developer with every interaction.

Getting Started

To check out the guide, visit eslint.interlace.tools. 📚
要查看中文指南, 请访问 eslint.interlace.tools. 📚
가이드 문서는 eslint.interlace.tools에서 확인하실 수 있습니다. 📚
ガイドは eslint.interlace.toolsでご確認ください。 📚
Para ver la guía, visita eslint.interlace.tools. 📚
للاطلاع على الدليل، قم بزيارة eslint.interlace.tools. 📚

npm install eslint-plugin-mongodb-security --save-dev

Usage Examples

Prevent NoSQL Injection (`no-operator-injection`)

// ❌ Incorrect (Vulnerable to { $ne: null })
User.findOne({ email: req.body.email, password: req.body.password });

// ✅ Correct (Safe execution)
User.findOne({ email: { $eq: email }, password: { $eq: password } });

Prevent JavaScript Injection (`no-unsafe-where`)

// ❌ Incorrect (Allows RCE)
User.find({ $where: `this.name === '${userInput}'` });

// ✅ Correct (Standard operators)
User.find({ name: { $eq: sanitize(userInput) } });

⚙️ Configuration Presets

📚 Supported Libraries

| Library | npm | Downloads | Detection | | ---------- | ------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | ---------------------------- | | mongodb | | | Injection, Unbounded Queries | | mongoose | | | Schema Safety, Leans |

AI-Optimized Messages

This plugin is optimized for ESLint's Model Context Protocol (MCP), enabling AI assistants like Cursor, GitHub Copilot, and Claude to:

Understand the exact vulnerability type via CWE references
Apply the correct fix using structured guidance
Provide educational context to developers

// .cursor/mcp.json
{
  "mcpServers": {
    "eslint": {
      "command": "npx",
      "args": ["@eslint/mcp@latest"]
    }
  }
}

By providing this structured context (CWE, OWASP, Fix), we enable AI tools to reason about the security flaw rather than hallucinating. This allows Copilot/Cursor to suggest the exact correct fix immediately.

Rules

Legend

| Icon | Description | | :--: | :----------------------------------------------------------------- | | 💼 | Recommended: Included in the recommended preset. | | ⚠️ | Warns: Set to warn in recommended preset. | | 🔧 | Auto-fixable: Automatically fixable by the --fix CLI option. | | 💡 | Suggestions: Providing code suggestions in IDE. | | 🚫 | Deprecated: This rule is deprecated. |

| Rule | CWE | OWASP | CVSS | Description | 💼 | ⚠️ | 🔧 | 💡 | 🚫 | | :---------------------------------------------------------------------------------------------------------------------------- | :------: | :------: | :--: | :----------------------------------------------------------------------------- | :-: | :-: | :-: | :-: | :-: | | no-bypass-middleware | CWE-284 | A01:2025 | 7.5 | no-bypass-middleware | 💼 | ⚠️ | | | | | no-debug-mode-production | CWE-489 | A05:2025 | 7.5 | no-debug-mode-production | 💼 | | | | | | no-hardcoded-connection-string | CWE-798 | A07:2025 | 9.8 | no-hardcoded-connection-string | 💼 | | 🔧 | | | | no-hardcoded-credentials | CWE-798 | A07:2025 | 9.8 | no-hardcoded-credentials | 💼 | | 🔧 | | | | no-operator-injection | CWE-943 | A03:2025 | 9.8 | no-operator-injection | 💼 | | | | | | no-select-sensitive-fields | CWE-200 | A01:2025 | 5.3 | no-select-sensitive-fields | 💼 | ⚠️ | | | | | no-unbounded-find | CWE-770 | A04:2025 | 5.3 | no-unbounded-find | 💼 | ⚠️ | | | | | no-unsafe-populate | CWE-284 | A01:2025 | 5.3 | no-unsafe-populate | 💼 | | | | | | no-unsafe-query | CWE-943 | A03:2025 | 9.8 | no-unsafe-query | 💼 | | | | | | no-unsafe-regex-query | CWE-1333 | A03:2025 | 7.5 | no-unsafe-regex-query | 💼 | | | | | | no-unsafe-where | CWE-943 | A03:2025 | 9.8 | no-unsafe-where | 💼 | | | | | | require-auth-mechanism | CWE-306 | A07:2025 | 7.5 | require-auth-mechanism | 💼 | ⚠️ | | | | | require-lean-queries | CWE-400 | A04:2025 | 5.3 | require-lean-queries | | | 🔧 | | | | require-projection | CWE-200 | A01:2025 | 5.3 | require-projection | | | | | | | require-schema-validation | CWE-20 | A04:2025 | 7.5 | require-schema-validation | 💼 | ⚠️ | | | | | require-tls-connection | CWE-319 | A02:2025 | 7.5 | require-tls-connection | 💼 | ⚠️ | | | |