eslint-plugin-lambda-security

Security best practices for AWS Lambda functions (IAM, timeouts, environment).

Description

This plugin provides Security best practices for AWS Lambda functions (IAM, timeouts, environment).
By using this plugin, you can proactively identify and mitigate security risks across your entire codebase.

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. 📚

``bash
npm install eslint-plugin-lambda-security --save-dev
`

💡 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, strict for 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.

Every security rule produces a structured 2-line error message:

`bash
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

⚙️ 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 | ![npm](https://www.npmjs.com/package/aws-lambda) | ![downloads](https://www.npmjs.com/package/aws-lambda) | IAM, Logging, Timeouts |
| @aws-sdk/client-lambda | ![npm](https://www.npmjs.com/package/@aws-sdk/client-lambda) | ![downloads](https://www.npmjs.com/package/@aws-sdk/client-lambda) | Credential Safety |
| middy |  |  | Middleware Security |

---

⚙️ Configuration Options

All rules accept these common options:

`javascript
{
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
}]
}
}
`

---

Rules

Legend

| Icon | Description |
| :---: | :--- |
| 💼 | Recommended: Included in the recommended preset. |
| ⚠️ | Warns: Set towarn 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-env-logging | CWE-532 | | 7.5 | ESLint rule documentation for no-env-logging | 💼 | ⚠️ | | | |
| no-error-swallowing | CWE-391 | | 7.5 | ESLint rule documentation for no-error-swallowing | 💼 | ⚠️ | | | |
| no-exposed-debug-endpoints | | | | ESLint rule documentation for no-exposed-debug-endpoints | | | | | |
| no-exposed-error-details | CWE-209 | | 7.5 | ESLint rule documentation for no-exposed-error-details | 💼 | ⚠️ | | | |
| no-hardcoded-credentials-sdk | CWE-798 | | 9.8 | ESLint rule documentation for no-hardcoded-credentials-sdk | 💼 | | | | |
| no-missing-authorization-check | CWE-862 | | 7.5 | ESLint rule documentation for no-missing-authorization-check | 💼 | ⚠️ | | | |
| no-overly-permissive-iam-policy | CWE-732 | | 9.8 | ESLint rule documentation for no-overly-permissive-iam-policy | 💼 | | | | |
| no-permissive-cors-middy | CWE-942 | | 9.1 | ESLint rule documentation for no-permissive-cors-middy | 💼 | | | | |
| no-permissive-cors-response | CWE-942 | | 9.1 | ESLint rule documentation for no-permissive-cors-response | 💼 | | 🔧 | | |
| no-secrets-in-env | CWE-522 | | 9.8 | ESLint rule documentation for no-secrets-in-env | 💼 | | | | |
| no-unbounded-batch-processing | CWE-400 | | 7.5 | ESLint rule documentation for no-unbounded-batch-processing | 💼 | ⚠️ | | | |
| no-unvalidated-event-body | CWE-20 | | 7.5 | ESLint rule documentation for no-unvalidated-event-body | 💼 | ⚠️ | | | |
| no-user-controlled-requests | CWE-918 | | 9.8 | ESLint rule documentation for no-user-controlled-requests | 💼 | | | | |
| require-timeout-handling | CWE-703 | | 7.5 | ESLint rule documentation for require-timeout-handling | 💼 | ⚠️ | | | |

🔗 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 | ![downloads](https://www.npmjs.com/package/eslint-plugin-secure-coding) | General security rules & OWASP guidelines. |
| eslint-plugin-pg | ![downloads](https://www.npmjs.com/package/eslint-plugin-pg) | PostgreSQL security & best practices. |
| eslint-plugin-crypto | ![downloads](https://www.npmjs.com/package/eslint-plugin-crypto) | NodeJS Cryptography security rules. |
| eslint-plugin-jwt | ![downloads](https://www.npmjs.com/package/eslint-plugin-jwt) | JWT security & best practices. |
| eslint-plugin-browser-security | ![downloads](https://www.npmjs.com/package/eslint-plugin-browser-security) | Browser-specific security & XSS prevention. |
| eslint-plugin-express-security | ![downloads](https://www.npmjs.com/package/eslint-plugin-express-security) | Express.js security hardening rules. |
| eslint-plugin-lambda-security | ![downloads](https://www.npmjs.com/package/eslint-plugin-lambda-security) | AWS Lambda security best practices. |
| eslint-plugin-nestjs-security | ![downloads](https://www.npmjs.com/package/eslint-plugin-nestjs-security) | NestJS security rules & patterns. |
| eslint-plugin-mongodb-security | ![downloads](https://www.npmjs.com/package/eslint-plugin-mongodb-security) | MongoDB security best practices. |
| eslint-plugin-vercel-ai-security | ![downloads](https://www.npmjs.com/package/eslint-plugin-vercel-ai-security) | Vercel AI SDK security hardening. |
| eslint-plugin-import-next` |  | Next-gen import sorting & architecture. |

📄 License

MIT © Ofri Peretz