eslint-plugin-lambda-security
v1.2.5
Published
Security-focused ESLint plugin for AWS Lambda and Middy applications. Detects insecure API Gateway responses, missing security headers, CORS misconfigurations, input validation issues, and more.
Downloads
441
Maintainers
Readme
⭐ 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 best practices for AWS Lambda functions (IAM, timeouts, environment).
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-lambda-security --save-dev⚙️ Configuration Presets
| Preset | Description |
| :------------ | :--------------------------------------------------------------------- |
| recommended | Balanced security for Lambda projects (critical as error, others warn) |
| strict | Maximum security enforcement (all rules as errors) |
📚 Supported Libraries
| Library | npm | Downloads | Detection |
| :----------------------- | :---------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------- |
| aws-lambda | |
| IAM, Logging, Timeouts |
|
@aws-sdk/client-lambda | |
| Credential Safety |
|
middy | |
| Middleware Security |
🤖 AI-Optimized Messages
Every security rule produces a structured 2-line error message:
src/handlers/api.ts
18:5 error 🔒 CWE-798 OWASP:SAS-2 CVSS:9.8 | Hardcoded AWS credentials detected | CRITICAL [SOC2,PCI-DSS]
Fix: Use credential provider chain or Lambda execution role | https://owasp.org/...Each message includes:
- 🔒 CWE reference - vulnerability classification
- 📋 OWASP category - Serverless Top 10 mapping
- 📊 CVSS score - severity rating (0.0-10.0)
- 🏢 Compliance tags - affected frameworks (SOC2, PCI-DSS, HIPAA)
- ✅ Fix instruction - exact code to write
- 📚 Documentation link - learn more
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.
💡 What You Get
- Serverless-focused coverage: 5 rules targeting Lambda-specific vulnerabilities (credentials, CORS, secrets, logging).
- LLM-optimized & MCP-ready: Structured 2-line messages with CWE + OWASP + CVSS + concrete fixes so humans and AI auto-fixers stay aligned.
- Standards aligned: OWASP Serverless Top 10, CWE tagging, CVSS scoring in every finding for compliance mapping.
- Tiered presets:
recommended,strictfor fast policy rollout. - Framework-aware: Detects Middy middleware, API Gateway response patterns, AWS SDK v3 clients.
- Low false positive rate: Context-aware detection with production heuristics.
⚙️ Configuration Options
All rules accept these common options:
{
rules: {
'lambda-security/no-hardcoded-credentials-sdk': ['error', {
allowInTests: true // Default: true - skip test files
}],
'lambda-security/no-secrets-in-env': ['error', {
allowInTests: true,
additionalPatterns: ['CUSTOM_SECRET_*'] // Additional patterns to detect
}]
}
}📦 Compatibility
| Package | Version |
| :--- | :--- |
| ESLint | ^8.0.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-env-logging | CWE-532 | A09:2021 | | Detect logging of process.env which may expose secrets | 🟢 | | ⚠️ | | | | | no-error-swallowing | CWE-390 | A09:2021 | | Detect empty catch blocks and missing error logging | 🟢 | | ⚠️ | | | | | no-exposed-debug-endpoints | CWE-489 | A05:2021 | | Detect debug endpoints without authentication in Lambda handlers | 🟢 | 💼 | | | | | | no-exposed-error-details | CWE-209 | A01:2021 | | Detect Lambda handlers exposing internal error details in responses | 🟢 | | ⚠️ | | | | | no-hardcoded-credentials-sdk | CWE-798 | | | Detects hardcoded AWS credentials in SDK client configurations | 🟢 | 💼 | | | | | | no-missing-authorization-check | | | | Security rule for lambda-security. This rule is part of eslint-plugin-lambda-security and provides LLM-opti… | 🟢 | | ⚠️ | | | | | no-overly-permissive-iam-policy | CWE-732 | | | Security rule for lambda-security. This rule is part of eslint-plugin-lambda-security and provides LLM-opti… | 🟢 | 💼 | | | | | | no-permissive-cors-middy | CWE-942 | | | Detects permissive CORS configurations in Middy middleware | 🟢 | 💼 | | | | | | no-permissive-cors-response | CWE-942 | | | Detects permissive CORS headers in Lambda API Gateway responses | 🟢 | 💼 | | | | | | no-secrets-in-env | CWE-798 | | | Detects secrets defined directly in environment variable configurations | 🟢 | 💼 | | | | | | no-unbounded-batch-processing | CWE-770 | | | Detect processing batch records without size validation | 🟢 | | ⚠️ | | | | | no-unvalidated-event-body | CWE-20 | A03:2021 | | Detect Lambda handlers using event body without validation | 🟢 | | ⚠️ | | | | | no-user-controlled-requests | CWE-918 | A10:2021 | | Detect HTTP requests with user-controlled URLs (SSRF) | 🟢 | 💼 | | | | | | require-timeout-handling | CWE-400 | | | Require timeout handling in Lambda handlers with external calls | 🟢 | | ⚠️ | | | |
🔗 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
