eslint-plugin-lambda-security

v1.2.3

Published

a month ago

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.

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

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:

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

📚 Supported Libraries

⚙️ 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
    }]
  }
}

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 | 💼 | ⚠️ | | | |