⭐ If this plugin caught a real bug for you, star the repo — it's the signal that keeps these rules maintained.

Description

This plugin provides Security rules for MongoDB queries and interactions (NoSQL injection).

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

⚙️ Configuration Presets

| Preset | Description | | :------------ | :------------------------------------------------ | | recommended | Critical rules as errors, high as warnings | | strict | All rules as errors | | mongoose | Specialized rules for Mongoose ODM usage patterns |

📚 Supported Libraries

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

🏢 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) } });

📦 Compatibility

| Package | Version | | :--- | :--- | | ESLint | ^8.40.0 \|\| ^9.0.0 \|\| ^10.0.0 | | Node.js | >=18.0.0 |

See the ESLint Version Support Policy — current ecosystem share data, the 20% gate, and the forward-looking exception that covers v10.

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. | | 🟢 | Type-unaware: AST-only, runs in oxlint JS-plugin tier. | | 🟡 | Type-aware (refining): pure-AST primary path; types refine precision. | | 🟠 | Type-aware (graceful): requires TS program; silent without it. |

| Rule | CWE | OWASP | CVSS | Description | 🧠 | 💼 | ⚠️ | 🔧 | 💡 | 🚫 | | :--- | :---: | :---: | :---: | :--- | :---: | :---: | :---: | :---: | :---: | :---: | | no-bypass-middleware | CWE-284 | A01:2021 | | Detects Mongoose operations that bypass middleware hooks (pre/post hooks). | 🟢 | | ⚠️ | | | | | no-debug-mode-production | CWE-489 | A05:2021 | | Detects Mongoose debug mode that could expose sensitive query information in production. | 🟢 | 💼 | | | 💡 | | | no-hardcoded-connection-string | CWE-798 | A07:2021 | | Detects hardcoded MongoDB connection strings containing credentials in source code. | 🟢 | 💼 | | | | | | no-hardcoded-credentials | CWE-798 | A07:2021 | | Detects hardcoded MongoDB authentication credentials in connection options. | 🟢 | 💼 | | | | | | no-operator-injection | CWE-943 | A03:2021 | | Detects MongoDB operator injection attacks where user input is passed directly as query values, allowing at… | 🟢 | 💼 | | | | | | no-select-sensitive-fields | CWE-200 | A01:2021 | | Detects queries that may return sensitive fields like passwords, tokens, or API keys. | 🟢 | | ⚠️ | | | | | no-unbounded-find | CWE-400 | A04:2021 | | Requires limit() on find queries to prevent resource exhaustion from unbounded result sets. | 🟢 | | ⚠️ | | 💡 | | | no-unsafe-populate | CWE-943 | A03:2021 | | Detects user-controlled populate() paths that could lead to data exposure or injection. | 🟢 | 💼 | | | | | | no-unsafe-query | CWE-943 | A03:2021 | | Prevents NoSQL injection by detecting direct use of user input in MongoDB query objects. | 🟢 | 💼 | | | 💡 | | | no-unsafe-regex-query | CWE-400 | A03:2021 | | Detects user input in MongoDB $regex operators that could cause ReDoS (Regular Expression Denial of Service… | 🟢 | 💼 | | | | | | no-unsafe-where | CWE-943 | A01:2021 | | Prevents use of the dangerous $where operator which executes JavaScript on the MongoDB server, enabling Rem… | 🟢 | 💼 | | | | | | require-auth-mechanism | CWE-287 | A07:2021 | | Requires explicit authentication mechanism specification for MongoDB connections. | 🟢 | | ⚠️ | | | | | require-lean-queries | CWE-400 | A04:2021 | | Suggests using .lean() for read-only Mongoose queries to reduce memory usage. | 🟢 | | | | 💡 | | | require-projection | CWE-200 | A01:2021 | | Requires field projection on queries to minimize data exposure. | 🟢 | | | | | | | require-schema-validation | CWE-20 | A04:2021 | | Requires validation options on Mongoose schema fields to prevent invalid or malicious data. | 🟢 | | ⚠️ | | | | | require-tls-connection | CWE-295 | A02:2021 | | Requires TLS/SSL encryption for MongoDB connections in production environments. | 🟢 | | ⚠️ | | 💡 | |

🔗 Related ESLint Plugins

Part of the Interlace ESLint Ecosystem — AI-native security plugins with LLM-optimized error messages:

| Plugin | Downloads | Description | | :--- | :---: | :--- | | eslint-plugin-secure-coding | | General security rules & OWASP guidelines. | | eslint-plugin-pg | | PostgreSQL security & best practices. | | eslint-plugin-node-security | | Node.js core-module security (fs, child_process, vm, crypto, Buffer). | | eslint-plugin-jwt | | JWT security & best practices. | | eslint-plugin-browser-security | | Browser-specific security & XSS prevention. | | eslint-plugin-express-security | | Express.js security hardening rules. | | eslint-plugin-lambda-security | | AWS Lambda security best practices. | | eslint-plugin-nestjs-security | | NestJS security rules & patterns. | | eslint-plugin-mongodb-security | | MongoDB security best practices. | | eslint-plugin-vercel-ai-security | | Vercel AI SDK security hardening. | | eslint-plugin-import-next | | Next-gen import sorting & architecture. |

⭐ Support & follow

If this plugin caught a real bug for you, star the repo — stars are the signal that keeps the Interlace ESLint ecosystem maintained — and follow the writeups on Dev.to for the benchmarks and security research behind these rules.

📄 License

MIT © Ofri Peretz