eslint-plugin-express-security 3.1.3 → 3.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +59 -61
- package/package.json +2 -2
- package/src/index.js +1 -1
- package/src/rules/no-express-unsafe-regex-route/index.js +1 -1
- package/src/rules/no-insecure-cookie-options/index.js +1 -1
- package/src/rules/no-permissive-trust-proxy/index.js +1 -1
- package/src/rules/no-user-controlled-render-locals/index.js +1 -1
- package/src/rules/require-case-insensitive-path-guard/index.js +1 -1
- package/src/rules/require-express-body-parser-limits/index.js +1 -1
- package/src/rules/require-rate-limiting/index.js +1 -1
- package/src/rules/require-route-authentication/index.js +1 -1
- package/src/utils/app-receiver.js +1 -0
package/README.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
<p align="center">
|
|
2
|
-
<a href="https://eslint.interlace.tools/?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-express-security" target="blank"><img src="https://eslint.interlace.tools/logos/interlace.svg" alt="Interlace" height="90" /></a>
|
|
2
|
+
<a href="https://eslint.interlace.tools/?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-express-security" target="blank"><picture><source media="(prefers-color-scheme: dark)" srcset="https://eslint.interlace.tools/logos/interlace-dark.svg"><img src="https://eslint.interlace.tools/logos/interlace-light.svg" alt="Interlace" height="90" /></picture></a>
|
|
3
3
|
|
|
4
4
|
<a href="https://expressjs.com" target="_blank"><img src="https://eslint.interlace.tools/logos/express.svg" alt="Express" height="90" /></a>
|
|
5
5
|
|
|
6
|
-
<a href="https://oxc.rs" target="_blank"><img src="https://eslint.interlace.tools/logos/oxlint.svg" alt="oxlint" height="90" /></a>
|
|
6
|
+
<a href="https://oxc.rs" target="_blank"><picture><source media="(prefers-color-scheme: dark)" srcset="https://eslint.interlace.tools/logos/oxlint-dark.svg"><img src="https://eslint.interlace.tools/logos/oxlint-light.svg" alt="oxlint" height="90" /></picture></a>
|
|
7
7
|
|
|
8
|
-
<a href="https://eslint.org" target="_blank"><img src="https://eslint.interlace.tools/logos/eslint.svg" alt="ESLint" height="90" /></a>
|
|
8
|
+
<a href="https://eslint.org" target="_blank"><picture><source media="(prefers-color-scheme: dark)" srcset="https://eslint.interlace.tools/logos/eslint-dark.svg"><img src="https://eslint.interlace.tools/logos/eslint-light.svg" alt="ESLint" height="90" /></picture></a>
|
|
9
9
|
</p>
|
|
10
10
|
|
|
11
11
|
<p align="center">
|
|
@@ -15,6 +15,7 @@
|
|
|
15
15
|
<p align="center">
|
|
16
16
|
<a href="https://www.npmjs.com/package/eslint-plugin-express-security" target="_blank"><img src="https://img.shields.io/npm/v/eslint-plugin-express-security.svg" alt="NPM Version" /></a>
|
|
17
17
|
<a href="https://www.npmjs.com/package/eslint-plugin-express-security" target="_blank"><img src="https://img.shields.io/npm/dm/eslint-plugin-express-security.svg" alt="NPM Downloads" /></a>
|
|
18
|
+
<a href="https://packagephobia.com/result?p=eslint-plugin-express-security" target="_blank"><img src="https://badgen.net/packagephobia/install/eslint-plugin-express-security" alt="Install Size" /></a>
|
|
18
19
|
<a href="https://opensource.org/licenses/MIT" target="_blank"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="Package License" /></a>
|
|
19
20
|
<a href="https://app.codecov.io/gh/ofri-peretz/eslint/components?components%5B0%5D=eslint-plugin-express-security" target="_blank"><img src="https://codecov.io/gh/ofri-peretz/eslint/graph/badge.svg?component=eslint-plugin-express-security" alt="Codecov" /></a>
|
|
20
21
|
<a href="https://github.com/ofri-peretz/eslint" target="_blank"><img src="https://img.shields.io/badge/Since-Dec_2025-blue?logo=rocket&logoColor=white" alt="Since Dec 2025" /></a>
|
|
@@ -27,57 +28,25 @@
|
|
|
27
28
|
|
|
28
29
|
This plugin provides Comprehensive security rules for Express.js applications, mapping to OWASP Top 10.
|
|
29
30
|
|
|
30
|
-
## Philosophy
|
|
31
|
-
|
|
32
|
-
**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.
|
|
33
|
-
|
|
34
31
|
<!-- AUTO-GENERATED:DOCTRINE:START - Do not edit manually -->
|
|
35
32
|
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
**
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
That is a trade, and it is made deliberately. It costs recall, and we measure what it
|
|
44
|
-
costs rather than assuming it is free.
|
|
45
|
-
|
|
46
|
-
## How the rules decide
|
|
33
|
+
- **Why** — a linter nobody reads protects nothing. We would rather miss a finding
|
|
34
|
+
than spend your attention on one that was never real.
|
|
35
|
+
- **How** — evidence, not names. A rule fires on what the code *does*, resolved
|
|
36
|
+
through the AST and ESLint's own scope analysis.
|
|
37
|
+
- **What** — every finding carries its fix, in prose for a human and as structured
|
|
38
|
+
JSON for an agent. Security rules add a CWE mapping and, where assigned, a CVSS score.
|
|
47
39
|
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
open-source projects and fixed with a test that fails on the unfixed rule.
|
|
53
|
-
|
|
54
|
-
Where a rule has known false-positive shapes, its page carries a **Not a finding**
|
|
55
|
-
section: what it deliberately stays quiet on, and what to check first when it fires
|
|
56
|
-
and you disagree.
|
|
57
|
-
|
|
58
|
-
## What you get
|
|
59
|
-
|
|
60
|
-
The rules below. Security rules carry a CWE mapping and, where one is assigned, a
|
|
61
|
-
CVSS score; every rule carries a fix on its message — in prose for a human and as
|
|
62
|
-
structured JSON for an agent. Install it, enable
|
|
63
|
-
`recommended`, and read the findings. If one of them is wrong,
|
|
64
|
-
[open an issue](https://github.com/ofri-peretz/eslint/issues) — a false positive is a
|
|
65
|
-
bug here, not a tuning exercise for you.
|
|
66
|
-
|
|
67
|
-
How that is measured, on which projects, and where it falls short:
|
|
68
|
-
[benchmark methodology](https://github.com/ofri-peretz/eslint/blob/main/BENCHMARK-METHODOLOGY.md)
|
|
69
|
-
and [results](https://github.com/ofri-peretz/eslint/blob/main/BENCHMARK-RESULTS.md).
|
|
40
|
+
That trade costs recall, and we measure it:
|
|
41
|
+
[methodology](https://github.com/ofri-peretz/eslint/blob/main/BENCHMARK-METHODOLOGY.md)
|
|
42
|
+
· [results](https://github.com/ofri-peretz/eslint/blob/main/BENCHMARK-RESULTS.md)
|
|
43
|
+
· [a false positive is a bug](https://github.com/ofri-peretz/eslint/issues).
|
|
70
44
|
|
|
71
45
|
<!-- AUTO-GENERATED:DOCTRINE:END -->
|
|
72
46
|
|
|
73
47
|
## Getting Started
|
|
74
48
|
|
|
75
49
|
- To check out the [guide](https://eslint.interlace.tools/docs/security/plugin-express-security?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-express-security), visit [eslint.interlace.tools](https://eslint.interlace.tools/?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-express-security). 📚
|
|
76
|
-
- 要查看中文 [指南](https://eslint.interlace.tools/docs/security/plugin-express-security?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-express-security), 请访问 [eslint.interlace.tools](https://eslint.interlace.tools/?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-express-security). 📚
|
|
77
|
-
- [가이드](https://eslint.interlace.tools/docs/security/plugin-express-security?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-express-security) 문서는 [eslint.interlace.tools](https://eslint.interlace.tools/?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-express-security)에서 확인하실 수 있습니다. 📚
|
|
78
|
-
- [ガイド](https://eslint.interlace.tools/docs/security/plugin-express-security?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-express-security)は [eslint.interlace.tools](https://eslint.interlace.tools/?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-express-security)でご確認ください。 📚
|
|
79
|
-
- Para ver la [guía](https://eslint.interlace.tools/docs/security/plugin-express-security?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-express-security), visita [eslint.interlace.tools](https://eslint.interlace.tools/?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-express-security). 📚
|
|
80
|
-
- للاطلاع على [الدليل](https://eslint.interlace.tools/docs/security/plugin-express-security?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-express-security)، قم بزيارة [eslint.interlace.tools](https://eslint.interlace.tools/?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-express-security). 📚
|
|
81
50
|
|
|
82
51
|
```bash
|
|
83
52
|
npm install eslint-plugin-express-security --save-dev
|
|
@@ -160,23 +129,52 @@ See the [ESLint Version Support Policy](../../docs/ESLINT_VERSION_SUPPORT.md)
|
|
|
160
129
|
| [require-strict-transport-security](https://eslint.interlace.tools/docs/security/plugin-express-security/rules/require-strict-transport-security?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-express-security) | CWE-319 | A02:2021 | | This rule detects HSTS configurations that leave a downgrade window open — the header disabled, a max-age b… | 🟢 | 💼 | | | | |
|
|
161
130
|
<!-- AUTO-GENERATED:RULES_TABLE:END -->
|
|
162
131
|
|
|
132
|
+
<!-- AUTO-GENERATED:ECOSYSTEM_TABLE:START - Do not edit manually -->
|
|
133
|
+
|
|
163
134
|
## 🔗 Related ESLint Plugins
|
|
164
135
|
|
|
165
|
-
Part of the **Interlace ESLint
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
|
170
|
-
|
|
|
171
|
-
| [`eslint-plugin-
|
|
172
|
-
| [`eslint-plugin-
|
|
173
|
-
| [`eslint-plugin-
|
|
174
|
-
| [`eslint-plugin-
|
|
175
|
-
| [`eslint-plugin-
|
|
176
|
-
| [`eslint-plugin-
|
|
177
|
-
| [`eslint-plugin-
|
|
178
|
-
| [`eslint-plugin-
|
|
179
|
-
| [`eslint-plugin-
|
|
136
|
+
Part of the **Interlace ESLint ecosystem** — AI-native rules with LLM-optimized error messages:
|
|
137
|
+
|
|
138
|
+
**Security**
|
|
139
|
+
|
|
140
|
+
| Plugin | Downloads | Description |
|
|
141
|
+
| :--- | :---: | :--- |
|
|
142
|
+
| [`eslint-plugin-anthropic-security`](https://www.npmjs.com/package/eslint-plugin-anthropic-security) | [](https://www.npmjs.com/package/eslint-plugin-anthropic-security) | Anthropic SDK security. |
|
|
143
|
+
| [`eslint-plugin-browser-security`](https://www.npmjs.com/package/eslint-plugin-browser-security) | [](https://www.npmjs.com/package/eslint-plugin-browser-security) | XSS, DOM security. |
|
|
144
|
+
| [`eslint-plugin-drizzle-security`](https://www.npmjs.com/package/eslint-plugin-drizzle-security) | [](https://www.npmjs.com/package/eslint-plugin-drizzle-security) | Drizzle security. |
|
|
145
|
+
| [`eslint-plugin-gemini-security`](https://www.npmjs.com/package/eslint-plugin-gemini-security) | [](https://www.npmjs.com/package/eslint-plugin-gemini-security) | Google Gemini SDK security. |
|
|
146
|
+
| [`eslint-plugin-jwt-security`](https://www.npmjs.com/package/eslint-plugin-jwt-security) | [](https://www.npmjs.com/package/eslint-plugin-jwt-security) | Token security. |
|
|
147
|
+
| [`eslint-plugin-knex-security`](https://www.npmjs.com/package/eslint-plugin-knex-security) | [](https://www.npmjs.com/package/eslint-plugin-knex-security) | Knex security. |
|
|
148
|
+
| [`eslint-plugin-lambda-security`](https://www.npmjs.com/package/eslint-plugin-lambda-security) | [](https://www.npmjs.com/package/eslint-plugin-lambda-security) | AWS Lambda hardening. |
|
|
149
|
+
| [`eslint-plugin-mcp-sdk-security`](https://www.npmjs.com/package/eslint-plugin-mcp-sdk-security) | [](https://www.npmjs.com/package/eslint-plugin-mcp-sdk-security) | MCP SDK security. |
|
|
150
|
+
| [`eslint-plugin-mongodb-security`](https://www.npmjs.com/package/eslint-plugin-mongodb-security) | [](https://www.npmjs.com/package/eslint-plugin-mongodb-security) | MongoDB injection. |
|
|
151
|
+
| [`eslint-plugin-mysql-security`](https://www.npmjs.com/package/eslint-plugin-mysql-security) | [](https://www.npmjs.com/package/eslint-plugin-mysql-security) | MySQL security. |
|
|
152
|
+
| [`eslint-plugin-nestjs-security`](https://www.npmjs.com/package/eslint-plugin-nestjs-security) | [](https://www.npmjs.com/package/eslint-plugin-nestjs-security) | NestJS framework hardening. |
|
|
153
|
+
| [`eslint-plugin-node-security`](https://www.npmjs.com/package/eslint-plugin-node-security) | [](https://www.npmjs.com/package/eslint-plugin-node-security) | Server-side patterns. |
|
|
154
|
+
| [`eslint-plugin-openai-security`](https://www.npmjs.com/package/eslint-plugin-openai-security) | [](https://www.npmjs.com/package/eslint-plugin-openai-security) | OpenAI SDK security. |
|
|
155
|
+
| [`eslint-plugin-postgresql-security`](https://www.npmjs.com/package/eslint-plugin-postgresql-security) | [](https://www.npmjs.com/package/eslint-plugin-postgresql-security) | PostgreSQL security. |
|
|
156
|
+
| [`eslint-plugin-prisma-security`](https://www.npmjs.com/package/eslint-plugin-prisma-security) | [](https://www.npmjs.com/package/eslint-plugin-prisma-security) | Prisma security. |
|
|
157
|
+
| [`eslint-plugin-secure-coding`](https://www.npmjs.com/package/eslint-plugin-secure-coding) | [](https://www.npmjs.com/package/eslint-plugin-secure-coding) | Injection prevention. |
|
|
158
|
+
| [`eslint-plugin-sequelize-security`](https://www.npmjs.com/package/eslint-plugin-sequelize-security) | [](https://www.npmjs.com/package/eslint-plugin-sequelize-security) | Sequelize ORM security. |
|
|
159
|
+
| [`eslint-plugin-sqlite-security`](https://www.npmjs.com/package/eslint-plugin-sqlite-security) | [](https://www.npmjs.com/package/eslint-plugin-sqlite-security) | SQLite security. |
|
|
160
|
+
| [`eslint-plugin-typeorm-security`](https://www.npmjs.com/package/eslint-plugin-typeorm-security) | [](https://www.npmjs.com/package/eslint-plugin-typeorm-security) | TypeORM security. |
|
|
161
|
+
| [`eslint-plugin-vercel-ai-security`](https://www.npmjs.com/package/eslint-plugin-vercel-ai-security) | [](https://www.npmjs.com/package/eslint-plugin-vercel-ai-security) | AI SDK security. |
|
|
162
|
+
|
|
163
|
+
**Code quality**
|
|
164
|
+
|
|
165
|
+
| Plugin | Downloads | Description |
|
|
166
|
+
| :--- | :---: | :--- |
|
|
167
|
+
| [`eslint-plugin-conventions`](https://www.npmjs.com/package/eslint-plugin-conventions) | [](https://www.npmjs.com/package/eslint-plugin-conventions) | Team-specific habits and styles. |
|
|
168
|
+
| [`eslint-plugin-import-next`](https://www.npmjs.com/package/eslint-plugin-import-next) | [](https://www.npmjs.com/package/eslint-plugin-import-next) | Fast cycle + import-graph analysis. |
|
|
169
|
+
| [`eslint-plugin-maintainability`](https://www.npmjs.com/package/eslint-plugin-maintainability) | [](https://www.npmjs.com/package/eslint-plugin-maintainability) | Cognitive load and clean-code patterns. |
|
|
170
|
+
| [`eslint-plugin-modernization`](https://www.npmjs.com/package/eslint-plugin-modernization) | [](https://www.npmjs.com/package/eslint-plugin-modernization) | ESNext migration + syntax evolution. |
|
|
171
|
+
| [`eslint-plugin-modularity`](https://www.npmjs.com/package/eslint-plugin-modularity) | [](https://www.npmjs.com/package/eslint-plugin-modularity) | Structural integrity and DDD patterns. |
|
|
172
|
+
| [`eslint-plugin-operability`](https://www.npmjs.com/package/eslint-plugin-operability) | [](https://www.npmjs.com/package/eslint-plugin-operability) | Production readiness and resource health. |
|
|
173
|
+
| [`eslint-plugin-react-a11y`](https://www.npmjs.com/package/eslint-plugin-react-a11y) | [](https://www.npmjs.com/package/eslint-plugin-react-a11y) | React accessibility / WCAG. |
|
|
174
|
+
| [`eslint-plugin-react-features`](https://www.npmjs.com/package/eslint-plugin-react-features) | [](https://www.npmjs.com/package/eslint-plugin-react-features) | React best practices and optimization. |
|
|
175
|
+
| [`eslint-plugin-reliability`](https://www.npmjs.com/package/eslint-plugin-reliability) | [](https://www.npmjs.com/package/eslint-plugin-reliability) | Runtime stability and error safety. |
|
|
176
|
+
|
|
177
|
+
<!-- AUTO-GENERATED:ECOSYSTEM_TABLE:END -->
|
|
180
178
|
|
|
181
179
|
<!-- INTERLACE:STAR_CTA:START -->
|
|
182
180
|
|
|
@@ -197,5 +195,5 @@ MIT © [Ofri Peretz](https://github.com/ofri-peretz)
|
|
|
197
195
|
</p>
|
|
198
196
|
|
|
199
197
|
<p align="center">
|
|
200
|
-
<a href="https://eslint.interlace.tools/?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-express-security" target="blank"><img src="https://eslint.interlace.tools/
|
|
198
|
+
<a href="https://eslint.interlace.tools/?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-express-security" target="blank"><picture><source media="(prefers-color-scheme: dark)" srcset="https://eslint.interlace.tools/logos/interlace-dark.svg"><img src="https://eslint.interlace.tools/logos/interlace-light.svg" alt="Interlace" height="70" /></picture></a>
|
|
201
199
|
</p>
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "eslint-plugin-express-security",
|
|
3
|
-
"version": "3.1
|
|
3
|
+
"version": "3.2.1",
|
|
4
4
|
"description": "ESLint plugin for Express.js security — detects permissive CORS, missing CSRF protection, missing helmet headers, insecure cookies, and GraphQL introspection in production.",
|
|
5
5
|
"type": "commonjs",
|
|
6
6
|
"main": "./src/index.js",
|
|
@@ -76,7 +76,7 @@
|
|
|
76
76
|
"node": ">=18.0.0"
|
|
77
77
|
},
|
|
78
78
|
"dependencies": {
|
|
79
|
-
"@interlace/eslint-devkit": "^1.
|
|
79
|
+
"@interlace/eslint-devkit": "^1.18.2"
|
|
80
80
|
},
|
|
81
81
|
"peerDependencies": {
|
|
82
82
|
"eslint": "^8.40.0 || ^9.0.0 || ^10.0.0",
|
package/src/index.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.configs=exports.plugin=exports.rules=void 0;const eslint_devkit_1=require("@interlace/eslint-devkit");exports.rules={get"require-helmet"(){return require("./rules/require-helmet").requireHelmet},get"no-permissive-cors"(){return require("./rules/no-permissive-cors").noPermissiveCors},get"require-csrf-protection"(){return require("./rules/require-csrf-protection").requireCsrfProtection},get"no-insecure-cookie-options"(){return require("./rules/no-insecure-cookie-options").noInsecureCookieOptions},get"require-rate-limiting"(){return require("./rules/require-rate-limiting").requireRateLimiting},get"no-graphql-introspection-production"(){return require("./rules/no-graphql-introspection-production").noGraphqlIntrospectionProduction},get"no-cors-credentials-wildcard"(){return require("./rules/no-cors-credentials-wildcard").noCorsCredentialsWildcard},get"require-express-body-parser-limits"(){return require("./rules/require-express-body-parser-limits").requireExpressBodyParserLimits},get"no-express-unsafe-regex-route"(){return require("./rules/no-express-unsafe-regex-route").noExpressUnsafeRegexRoute},get"no-exposed-debug-endpoints"(){return require("./rules/no-exposed-debug-endpoints").noExposedDebugEndpoints},get"no-missing-cors-check"(){return require("./rules/no-missing-cors-check").noMissingCorsCheck},get"no-missing-csrf-protection"(){return require("./rules/no-missing-csrf-protection").noMissingCsrfProtection},get"no-missing-security-headers"(){return require("./rules/no-missing-security-headers").noMissingSecurityHeaders},get"no-user-controlled-redirect"(){return require("./rules/no-user-controlled-redirect").noUserControlledRedirect},get"no-host-header-in-links"(){return require("./rules/no-host-header-in-links").noHostHeaderInLinks},get"no-error-details-in-response"(){return require("./rules/no-error-details-in-response").noErrorDetailsInResponse},get"no-sensitive-data-in-query"(){return require("./rules/no-sensitive-data-in-query").noSensitiveDataInQuery},get"no-user-controlled-render-locals"(){return require("./rules/no-user-controlled-render-locals").noUserControlledRenderLocals},get"no-static-root-exposure"(){return require("./rules/no-static-root-exposure").noStaticRootExposure},get"require-case-insensitive-path-guard"(){return require("./rules/require-case-insensitive-path-guard").requireCaseInsensitivePathGuard},get"require-query-type-guard"(){return require("./rules/require-query-type-guard").requireQueryTypeGuard},get"no-disabled-helmet-protections"(){return require("./rules/no-disabled-helmet-protections").noDisabledHelmetProtections},get"require-strict-transport-security"(){return require("./rules/require-strict-transport-security").requireStrictTransportSecurity},get"no-unsafe-csp-directives"(){return require("./rules/no-unsafe-csp-directives").noUnsafeCspDirectives},get"no-permissive-trust-proxy"(){return require("./rules/no-permissive-trust-proxy").noPermissiveTrustProxy},get"require-route-authentication"(){return require("./rules/require-route-authentication").requireRouteAuthentication},get"no-client-controlled-authorization"(){return require("./rules/no-client-controlled-authorization").noClientControlledAuthorization},get"no-idor-resource-access"(){return require("./rules/no-idor-resource-access").noIdorResourceAccess}};(0,eslint_devkit_1.withCanonicalDocsUrls)("plugin-express-security",exports.rules);exports.plugin={meta:{name:"eslint-plugin-express-security",version:"3.1
|
|
1
|
+
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.configs=exports.plugin=exports.rules=void 0;const eslint_devkit_1=require("@interlace/eslint-devkit");exports.rules={get"require-helmet"(){return require("./rules/require-helmet").requireHelmet},get"no-permissive-cors"(){return require("./rules/no-permissive-cors").noPermissiveCors},get"require-csrf-protection"(){return require("./rules/require-csrf-protection").requireCsrfProtection},get"no-insecure-cookie-options"(){return require("./rules/no-insecure-cookie-options").noInsecureCookieOptions},get"require-rate-limiting"(){return require("./rules/require-rate-limiting").requireRateLimiting},get"no-graphql-introspection-production"(){return require("./rules/no-graphql-introspection-production").noGraphqlIntrospectionProduction},get"no-cors-credentials-wildcard"(){return require("./rules/no-cors-credentials-wildcard").noCorsCredentialsWildcard},get"require-express-body-parser-limits"(){return require("./rules/require-express-body-parser-limits").requireExpressBodyParserLimits},get"no-express-unsafe-regex-route"(){return require("./rules/no-express-unsafe-regex-route").noExpressUnsafeRegexRoute},get"no-exposed-debug-endpoints"(){return require("./rules/no-exposed-debug-endpoints").noExposedDebugEndpoints},get"no-missing-cors-check"(){return require("./rules/no-missing-cors-check").noMissingCorsCheck},get"no-missing-csrf-protection"(){return require("./rules/no-missing-csrf-protection").noMissingCsrfProtection},get"no-missing-security-headers"(){return require("./rules/no-missing-security-headers").noMissingSecurityHeaders},get"no-user-controlled-redirect"(){return require("./rules/no-user-controlled-redirect").noUserControlledRedirect},get"no-host-header-in-links"(){return require("./rules/no-host-header-in-links").noHostHeaderInLinks},get"no-error-details-in-response"(){return require("./rules/no-error-details-in-response").noErrorDetailsInResponse},get"no-sensitive-data-in-query"(){return require("./rules/no-sensitive-data-in-query").noSensitiveDataInQuery},get"no-user-controlled-render-locals"(){return require("./rules/no-user-controlled-render-locals").noUserControlledRenderLocals},get"no-static-root-exposure"(){return require("./rules/no-static-root-exposure").noStaticRootExposure},get"require-case-insensitive-path-guard"(){return require("./rules/require-case-insensitive-path-guard").requireCaseInsensitivePathGuard},get"require-query-type-guard"(){return require("./rules/require-query-type-guard").requireQueryTypeGuard},get"no-disabled-helmet-protections"(){return require("./rules/no-disabled-helmet-protections").noDisabledHelmetProtections},get"require-strict-transport-security"(){return require("./rules/require-strict-transport-security").requireStrictTransportSecurity},get"no-unsafe-csp-directives"(){return require("./rules/no-unsafe-csp-directives").noUnsafeCspDirectives},get"no-permissive-trust-proxy"(){return require("./rules/no-permissive-trust-proxy").noPermissiveTrustProxy},get"require-route-authentication"(){return require("./rules/require-route-authentication").requireRouteAuthentication},get"no-client-controlled-authorization"(){return require("./rules/no-client-controlled-authorization").noClientControlledAuthorization},get"no-idor-resource-access"(){return require("./rules/no-idor-resource-access").noIdorResourceAccess}};(0,eslint_devkit_1.withCanonicalDocsUrls)("plugin-express-security",exports.rules);exports.plugin={meta:{name:"eslint-plugin-express-security",version:"3.2.1"},rules:exports.rules};const recommendedRules={"express-security/require-helmet":"error","express-security/no-permissive-cors":"error","express-security/require-csrf-protection":"warn","express-security/no-insecure-cookie-options":"error","express-security/require-rate-limiting":"error","express-security/no-graphql-introspection-production":"warn","express-security/no-cors-credentials-wildcard":"error","express-security/require-express-body-parser-limits":"warn","express-security/no-express-unsafe-regex-route":"error","express-security/no-exposed-debug-endpoints":"error","express-security/no-user-controlled-redirect":"error","express-security/no-host-header-in-links":"error","express-security/no-error-details-in-response":"error","express-security/no-sensitive-data-in-query":"warn","express-security/no-user-controlled-render-locals":"error","express-security/no-static-root-exposure":"error","express-security/require-case-insensitive-path-guard":"warn","express-security/require-query-type-guard":"warn","express-security/no-disabled-helmet-protections":"error","express-security/require-strict-transport-security":"error","express-security/no-unsafe-csp-directives":"error","express-security/no-permissive-trust-proxy":"error","express-security/require-route-authentication":"warn","express-security/no-client-controlled-authorization":"warn","express-security/no-idor-resource-access":"warn"};exports.configs={recommended:{plugins:{"express-security":exports.plugin},rules:recommendedRules},strict:{plugins:{"express-security":exports.plugin},rules:Object.fromEntries(Object.keys(exports.rules).map(ruleName=>[`express-security/${ruleName}`,"error"]))},api:{plugins:{"express-security":exports.plugin},rules:{"express-security/require-helmet":"error","express-security/no-disabled-helmet-protections":"error","express-security/require-strict-transport-security":"error","express-security/no-unsafe-csp-directives":"error","express-security/no-permissive-trust-proxy":"error","express-security/no-permissive-cors":"error","express-security/require-csrf-protection":"error","express-security/no-insecure-cookie-options":"error","express-security/require-rate-limiting":"error"}},graphql:{plugins:{"express-security":exports.plugin},rules:{"express-security/no-graphql-introspection-production":"error"}}};exports.default=exports.plugin;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.noExpressUnsafeRegexRoute=void 0;const express_evidence_1=require("../../utils/express-evidence");const eslint_devkit_1=require("@interlace/eslint-devkit");const HTTP_METHODS=new Set(["get","post","put","patch","delete","all","use"]);const VULNERABLE_PATTERNS=[/\([^)]*[+*][^)]*\)[+*]/,/\([^)]*\|[^)]*\)[+*]/,/[+*]{2,}/,/\([^)]+\)[+*].*\\[1-9]/];const VULNERABLE_PARAM_PATTERNS=[/:[a-zA-Z_][a-zA-Z0-9_]*\+/,/:[a-zA-Z_][a-zA-Z0-9_]*\*/];function isVulnerableRegex(pattern){return VULNERABLE_PATTERNS.some(regex=>regex.test(pattern))}function hasVulnerableParamPattern(route){return VULNERABLE_PARAM_PATTERNS.some(regex=>regex.test(route))}exports.noExpressUnsafeRegexRoute=(0,eslint_devkit_1.createRule)({name:"no-express-unsafe-regex-route",meta:{type:"problem",docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-express-security/docs/rules/no-express-unsafe-regex-route.md",description:"Disallow ReDoS-vulnerable regular expressions in Express.js route patterns",cwe:"CWE-1333",cvss:7.5},messages:{unsafeRegexRoute:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.SECURITY,issueName:"ReDoS Vulnerable Route Pattern",cwe:"CWE-1333",description:"Route uses a regular expression vulnerable to Regular Expression Denial of Service (ReDoS). Malicious input can cause catastrophic backtracking.",severity:"HIGH",fix:"Simplify the regex pattern. Avoid nested quantifiers like (a+)+ and overlapping alternatives. Consider using a string route with explicit parameters.",documentationLink:"https://owasp.org/www-community/attacks/Regular_expression_Denial_of_Service_-_ReDoS"}),unsafeParamPattern:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.SECURITY,issueName:"Unsafe Route Parameter Pattern",cwe:"CWE-1333",description:"Route parameter uses + or * quantifier which can match multiple path segments, potentially causing ReDoS or unexpected behavior.",severity:"MEDIUM",fix:"Use explicit path segments instead of :param+ or :param*. For example: /api/:id/details instead of /api/:path+",documentationLink:"https://expressjs.com/en/guide/routing.html"})},schema:[{type:"object",properties:{allowInTests:{type:"boolean",default:false,description:"Allow in test files"}},additionalProperties:false}]},defaultOptions:[{allowInTests:false}],create(context,[options]){if(!(0,express_evidence_1.fileUsesExpress)(context.sourceCode.ast))return{};const{allowInTests=false}=options;const filename=context.filename;const isTestFile=allowInTests&&(0,eslint_devkit_1.isTestFilePath)(filename);if(isTestFile){return{}}return{CallExpression(node){const callee=node.callee;if(callee.type!=="MemberExpression"){return}const property=callee.property;if(property.type!=="Identifier"){return}if(!HTTP_METHODS.has(property.name)){return}const routeArg=node.arguments[0];if(!routeArg){return}if(routeArg.type==="Literal"&&"regex"in routeArg&&routeArg.regex){const regexNode=routeArg;const pattern=regexNode.regex.pattern;if(isVulnerableRegex(pattern)){context.report({node:routeArg,messageId:"unsafeRegexRoute"})}return}if(routeArg.type==="NewExpression"&&routeArg.callee.type==="Identifier"&&routeArg.callee.name==="RegExp"){const patternArg=routeArg.arguments[0];if(patternArg&&patternArg.type==="Literal"&&typeof patternArg.value==="string"){if(isVulnerableRegex(patternArg.value)){context.report({node:routeArg,messageId:"unsafeRegexRoute"})}}return}
|
|
1
|
+
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.noExpressUnsafeRegexRoute=void 0;const express_evidence_1=require("../../utils/express-evidence");const eslint_devkit_1=require("@interlace/eslint-devkit");const HTTP_METHODS=new Set(["get","post","put","patch","delete","all","use"]);const VULNERABLE_PATTERNS=[/\([^)]*[+*][^)]*\)[+*]/,/\([^)]*\|[^)]*\)[+*]/,/[+*]{2,}/,/\([^)]+\)[+*].*\\[1-9]/];const VULNERABLE_PARAM_PATTERNS=[/:[a-zA-Z_][a-zA-Z0-9_]*\+/,/:[a-zA-Z_][a-zA-Z0-9_]*\*/];function isVulnerableRegex(pattern){return VULNERABLE_PATTERNS.some(regex=>regex.test(pattern))}function hasVulnerableParamPattern(route){return VULNERABLE_PARAM_PATTERNS.some(regex=>regex.test(route))}exports.noExpressUnsafeRegexRoute=(0,eslint_devkit_1.createRule)({name:"no-express-unsafe-regex-route",meta:{type:"problem",docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-express-security/docs/rules/no-express-unsafe-regex-route.md",description:"Disallow ReDoS-vulnerable regular expressions in Express.js route patterns",cwe:"CWE-1333",cvss:7.5},messages:{unsafeRegexRoute:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.SECURITY,issueName:"ReDoS Vulnerable Route Pattern",cwe:"CWE-1333",description:"Route uses a regular expression vulnerable to Regular Expression Denial of Service (ReDoS). Malicious input can cause catastrophic backtracking.",severity:"HIGH",fix:"Simplify the regex pattern. Avoid nested quantifiers like (a+)+ and overlapping alternatives. Consider using a string route with explicit parameters.",documentationLink:"https://owasp.org/www-community/attacks/Regular_expression_Denial_of_Service_-_ReDoS"}),unsafeParamPattern:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.SECURITY,issueName:"Unsafe Route Parameter Pattern",cwe:"CWE-1333",description:"Route parameter uses + or * quantifier which can match multiple path segments, potentially causing ReDoS or unexpected behavior.",severity:"MEDIUM",fix:"Use explicit path segments instead of :param+ or :param*. For example: /api/:id/details instead of /api/:path+",documentationLink:"https://expressjs.com/en/guide/routing.html"})},schema:[{type:"object",properties:{allowInTests:{type:"boolean",default:false,description:"Allow in test files"}},additionalProperties:false}]},defaultOptions:[{allowInTests:false}],create(context,[options]){if(!(0,express_evidence_1.fileUsesExpress)(context.sourceCode.ast))return{};const{allowInTests=false}=options;const filename=context.filename;const isTestFile=allowInTests&&(0,eslint_devkit_1.isTestFilePath)(filename);if(isTestFile){return{}}return{CallExpression(node){const callee=node.callee;if(callee.type!=="MemberExpression"){return}const property=callee.property;if(property.type!=="Identifier"){return}if(!HTTP_METHODS.has(property.name)){return}const routeArg=node.arguments[0];if(!routeArg){return}if(routeArg.type==="Literal"&&"regex"in routeArg&&routeArg.regex){const regexNode=routeArg;const pattern=regexNode.regex.pattern;if(isVulnerableRegex(pattern)){context.report({node:routeArg,messageId:"unsafeRegexRoute"})}return}if(routeArg.type==="NewExpression"&&routeArg.callee.type==="Identifier"&&routeArg.callee.name==="RegExp"){const patternArg=routeArg.arguments[0];if(patternArg&&patternArg.type==="Literal"&&typeof patternArg.value==="string"){if(isVulnerableRegex(patternArg.value)){context.report({node:routeArg,messageId:"unsafeRegexRoute"})}}return}const staticText=(0,eslint_devkit_1.staticString)(routeArg);if(staticText!==null){if(hasVulnerableParamPattern(staticText)){context.report({node:routeArg,messageId:"unsafeParamPattern"})}}}}}});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.noInsecureCookieOptions=void 0;exports.checkCookieOptions=checkCookieOptions;const express_evidence_1=require("../../utils/express-evidence");const eslint_devkit_1=require("@interlace/eslint-devkit");function propertyName(property){if(property.type!=="Property")return void 0;if(property.key.type==="Identifier"&&!property.computed){return property.key.name.toLowerCase()}
|
|
1
|
+
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.noInsecureCookieOptions=void 0;exports.checkCookieOptions=checkCookieOptions;const express_evidence_1=require("../../utils/express-evidence");const eslint_devkit_1=require("@interlace/eslint-devkit");function propertyName(property){if(property.type!=="Property")return void 0;if(property.key.type==="Identifier"&&!property.computed){return property.key.name.toLowerCase()}const staticText=(0,eslint_devkit_1.staticString)(property.key);if(staticText!==null){return staticText.toLowerCase()}return void 0}function flagState(node,name,hasSpread){const property=[...node.properties].reverse().find(p=>propertyName(p)===name);if(property===void 0)return hasSpread?"unknown":"absent";const value=property.value;if(value.type!=="Literal")return"unknown";return value.value===true?"on":"off"}function checkCookieOptions(node,options){const issues=[];const hasSpread=node.properties.some(p=>p.type==="SpreadElement");if(options.requireHttpOnly!==false){const state=flagState(node,"httponly",hasSpread);if(state==="absent"||state==="off"){issues.push("missing httpOnly flag (prevents XSS access to cookie)")}}if(options.requireSecure!==false){const state=flagState(node,"secure",hasSpread);if(state==="absent"||state==="off"){issues.push("missing secure flag (cookie sent over HTTPS only)")}}if(options.requireSameSite!==false){const acceptableValues=options.acceptableSameSiteValues||["strict","lax"];const property=[...node.properties].reverse().find(p=>propertyName(p)==="samesite");if(property===void 0){if(!hasSpread)issues.push("missing sameSite flag (prevents CSRF)")}else if(property.value.type==="Literal"&&typeof property.value.value==="string"){const value=property.value.value;if(!acceptableValues.includes(value.toLowerCase())){issues.push(`sameSite should be 'strict' or 'lax', not '${value}'`)}}}return{issues,hasSuggestions:issues.length>0}}exports.noInsecureCookieOptions=(0,eslint_devkit_1.createRule)({name:"no-insecure-cookie-options",meta:{type:"problem",docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-express-security/docs/rules/no-insecure-cookie-options.md",description:"Require secure cookie flags (httpOnly, secure, sameSite) in Express.js",cwe:"CWE-614",cvss:5.3},hasSuggestions:true,messages:{insecureCookie:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.SECURITY,issueName:"Insecure Cookie Configuration",cwe:"CWE-614",description:"{{issues}}",severity:"HIGH",fix:'Set httpOnly: true, secure: true, sameSite: "strict"',documentationLink:"https://owasp.org/www-community/controls/SecureCookieAttribute"}),addSecureFlags:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Add Secure Cookie Flags",description:"Add missing security flags to cookie options",severity:"LOW",fix:'{ httpOnly: true, secure: true, sameSite: "strict" }',documentationLink:"https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies#security"})},schema:[{type:"object",properties:{allowInTests:{type:"boolean",default:false},requireHttpOnly:{type:"boolean",default:true},requireSecure:{type:"boolean",default:true},requireSameSite:{type:"boolean",default:true},acceptableSameSiteValues:{type:"array",items:{type:"string"},default:["strict","lax"]}},additionalProperties:false}]},defaultOptions:[{allowInTests:false,requireHttpOnly:true,requireSecure:true,requireSameSite:true,acceptableSameSiteValues:["strict","lax"]}],create(context,[options]){if(!(0,express_evidence_1.fileUsesExpress)(context.sourceCode.ast))return{};const{allowInTests=false}=options;const filename=context.filename;const isTestFile=allowInTests&&(0,eslint_devkit_1.isTestFilePath)(filename);if(isTestFile){return{}}return{CallExpression(node){const callee=node.callee;if(callee.type==="MemberExpression"&&callee.property.type==="Identifier"&&callee.property.name==="cookie"){const optionsArg=node.arguments[2];if(!optionsArg){context.report({node,messageId:"insecureCookie",data:{issues:"Cookie set without options - missing httpOnly, secure, sameSite flags"},suggest:[{messageId:"addSecureFlags",fix:fixer=>{const lastArg=node.arguments[node.arguments.length-1];return fixer.insertTextAfter(lastArg,', { httpOnly: true, secure: true, sameSite: "strict" }')}}]});return}if(optionsArg.type==="ObjectExpression"){const{issues}=checkCookieOptions(optionsArg,options);if(issues.length>0){context.report({node:optionsArg,messageId:"insecureCookie",data:{issues:issues.join("; ")}})}}}}}}});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.noPermissiveTrustProxy=void 0;const express_evidence_1=require("../../utils/express-evidence");const eslint_devkit_1=require("@interlace/eslint-devkit");const TRUST_PROXY="trust proxy";
|
|
1
|
+
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.noPermissiveTrustProxy=void 0;const express_evidence_1=require("../../utils/express-evidence");const app_receiver_1=require("../../utils/app-receiver");const eslint_devkit_1=require("@interlace/eslint-devkit");const TRUST_PROXY="trust proxy";function isAppMethodCall(node,method,appReceiverNames){const callee=node.callee;if(callee.type!==eslint_devkit_1.AST_NODE_TYPES.MemberExpression)return false;if(callee.property.type!==eslint_devkit_1.AST_NODE_TYPES.Identifier)return false;if(callee.computed)return false;if(callee.property.name!==method)return false;if(callee.object.type!==eslint_devkit_1.AST_NODE_TYPES.Identifier)return false;return(0,app_receiver_1.isAppReceiver)(callee.object.name,appReceiverNames)}function isTrustProxyLiteral(node){return node!==void 0&&node.type===eslint_devkit_1.AST_NODE_TYPES.Literal&&node.value===TRUST_PROXY}exports.noPermissiveTrustProxy=(0,eslint_devkit_1.createRule)({name:"no-permissive-trust-proxy",meta:{type:"problem",hasSuggestions:true,docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-express-security/docs/rules/no-permissive-trust-proxy.md",description:"Disallow unconditional 'trust proxy' \u2014 it makes req.ip client-controlled",cwe:"CWE-348",cvss:5.3,confidence:"high"},messages:{permissiveTrustProxy:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.SECURITY,issueName:"Unconditional Proxy Trust (CWE-348)",cwe:"CWE-348",cvss:5.3,description:"'trust proxy' is enabled unconditionally, so Express takes the left-most X-Forwarded-For entry as req.ip. A client can send any address it likes \u2014 rate-limit buckets, IP allowlists and audit logs all follow the forged value.",severity:"MEDIUM",fix:"Set the number of proxies you actually run behind \u2014 app.set('trust proxy', {{hops}}) \u2014 or a subnet/'loopback'/predicate that names them.",documentationLink:"https://expressjs.com/en/guide/behind-proxies.html"}),useHopCount:"Trust exactly {{hops}} proxy hop(s) instead"},schema:[{type:"object",properties:{...app_receiver_1.APP_RECEIVER_SCHEMA,hopCount:{type:"number",minimum:1,description:"Number of reverse proxies used in the suggested fix"}},additionalProperties:false}]},defaultOptions:[{}],create(context,[options]){if(!(0,express_evidence_1.fileUsesExpress)(context.sourceCode.ast))return{};const{hopCount,appReceiverNames}=options;const hops=hopCount??1;function report(node,replacement){context.report({node,messageId:"permissiveTrustProxy",data:{hops:String(hops)},suggest:[{messageId:"useHopCount",data:{hops:String(hops)},fix:fixer=>fixer.replaceText(node,replacement)}]})}return{CallExpression(node){if(isAppMethodCall(node,"enable",appReceiverNames)){if(!isTrustProxyLiteral(node.arguments[0]))return;const receiver=context.sourceCode.getText(node.callee.object);report(node,`${receiver}.set('trust proxy', ${hops})`);return}if(!isAppMethodCall(node,"set",appReceiverNames))return;if(!isTrustProxyLiteral(node.arguments[0]))return;const value=node.arguments[1];if(!value||value.type!==eslint_devkit_1.AST_NODE_TYPES.Literal||value.value!==true){return}report(value,String(hops))}}}});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.noUserControlledRenderLocals=void 0;const express_evidence_1=require("../../utils/express-evidence");const eslint_devkit_1=require("@interlace/eslint-devkit");const USER_SOURCE_PROPS=new Set(["body","query","params"]);
|
|
1
|
+
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.noUserControlledRenderLocals=void 0;const express_evidence_1=require("../../utils/express-evidence");const eslint_devkit_1=require("@interlace/eslint-devkit");const USER_SOURCE_PROPS=new Set(["body","query","params"]);exports.noUserControlledRenderLocals=(0,eslint_devkit_1.createRule)({name:"no-user-controlled-render-locals",meta:{type:"problem",hasSuggestions:true,docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-express-security/docs/rules/no-user-controlled-render-locals.md",description:"Disallow res.render() with locals or view names sourced wholesale from req.body / req.query / req.params",cwe:"CWE-73",cvss:7.3},messages:{unsafeRenderLocals:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.SECURITY,issueName:"Template Object Injection (CWE-73)",cwe:"CWE-73",description:'res.render() receives locals wholly controlled by {{source}}. Express merges locals into the view-engine options, so keys like "layout", "settings" or "cache" can point the engine at an attacker-chosen file.',severity:"HIGH",fix:"Pick only the fields the template needs into an explicit object literal ({ title: req.body.title }) instead of forwarding the whole request object.",documentationLink:"https://cwe.mitre.org/data/definitions/73.html"}),userControlledView:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.SECURITY,issueName:"User-Controlled View Path (CWE-73)",cwe:"CWE-73",description:"The view name passed to res.render() derives from {{source}}. An attacker can traverse into unintended templates or files within the views directory.",severity:"HIGH",fix:"Map user input to a fixed set of view names via an allowlist; never build the template path from request data.",documentationLink:"https://cwe.mitre.org/data/definitions/73.html"}),pickFieldsExplicitly:"Remove the request-object spread and pick the required fields explicitly"},schema:[{type:"object",properties:{allowSanitizers:{type:"array",items:{type:"string"},description:'Callee names that sanitize locals (e.g. ["pick", "sanitizeLocals"]); calls to them are not flagged'}},additionalProperties:false}]},defaultOptions:[{}],create(context,[options]){if(!(0,express_evidence_1.fileUsesExpress)(context.sourceCode.ast))return{};const{allowSanitizers}=options;const sanitizers=new Set(allowSanitizers??[]);const trackedVars=new Map;function resolveVariable(node){let scope=context.sourceCode.getScope(node);while(scope){const found=scope.variables.find(v=>v.name===node.name);if(found)return found;scope=scope.upper}return null}function getTracked(node){const variable=resolveVariable(node);return variable?trackedVars.get(variable):void 0}function isParameter(node){const variable=resolveVariable(node);return variable?.defs.some(d=>d.type==="Parameter")??false}function getWholeSource(node){if(node.type!==eslint_devkit_1.AST_NODE_TYPES.MemberExpression)return null;const{object,property}=node;if(object.type!==eslint_devkit_1.AST_NODE_TYPES.Identifier)return null;if(property.type!==eslint_devkit_1.AST_NODE_TYPES.Identifier)return null;if(node.computed)return null;if(!USER_SOURCE_PROPS.has(property.name))return null;if(!(0,eslint_devkit_1.readsRequestShape)(node,context.sourceCode,{bodyNeedsDepth:false})){return null}return`req.${property.name}`}function isSanitizerCall(node){const callee=node.callee;if(callee.type===eslint_devkit_1.AST_NODE_TYPES.Identifier){return sanitizers.has(callee.name)}if(callee.type===eslint_devkit_1.AST_NODE_TYPES.MemberExpression&&callee.property.type===eslint_devkit_1.AST_NODE_TYPES.Identifier){return sanitizers.has(callee.property.name)}return false}function getUnsafeLocalsSource(node){const direct=getWholeSource(node);if(direct)return direct;if(node.type===eslint_devkit_1.AST_NODE_TYPES.Identifier){const tracked=getTracked(node);if(tracked&&tracked.whole)return tracked.source;return null}if(node.type===eslint_devkit_1.AST_NODE_TYPES.CallExpression){if(isSanitizerCall(node))return null;for(const arg of node.arguments){const argSource=getWholeSource(arg);if(argSource)return argSource}}return null}function getDerivedSource(node){const whole=getWholeSource(node);if(whole)return whole;if(node.type===eslint_devkit_1.AST_NODE_TYPES.MemberExpression){return getDerivedSource(node.object)}if(node.type===eslint_devkit_1.AST_NODE_TYPES.TemplateLiteral){for(const expr of node.expressions){const inner=getDerivedSource(expr);if(inner)return inner}return null}if(node.type===eslint_devkit_1.AST_NODE_TYPES.BinaryExpression){if(node.operator!=="+")return null;const left=getDerivedSource(node.left);if(left)return left;return getDerivedSource(node.right)}if(node.type===eslint_devkit_1.AST_NODE_TYPES.Identifier){const tracked=getTracked(node);if(tracked)return tracked.source;return null}return null}function isRenderCall(node){const callee=node.callee;if(callee.type!==eslint_devkit_1.AST_NODE_TYPES.MemberExpression)return false;if(callee.property.type!==eslint_devkit_1.AST_NODE_TYPES.Identifier)return false;if(callee.property.name!=="render")return false;const obj=callee.object;if(obj.type!==eslint_devkit_1.AST_NODE_TYPES.Identifier)return false;return isParameter(obj)}function buildRemoveSpreadFix(spread){return fixer=>{const sourceCode=context.sourceCode;const tokenAfter=sourceCode.getTokenAfter(spread);const tokenBefore=sourceCode.getTokenBefore(spread);if(tokenAfter.value===","){return fixer.removeRange([spread.range[0],tokenAfter.range[1]])}if(tokenBefore.value===","){return fixer.removeRange([tokenBefore.range[0],spread.range[1]])}return fixer.remove(spread)}}function checkLocalsArg(node){const source=getUnsafeLocalsSource(node);if(source){context.report({node,messageId:"unsafeRenderLocals",data:{source}});return}if(node.type!==eslint_devkit_1.AST_NODE_TYPES.ObjectExpression)return;for(const prop of node.properties){if(prop.type!==eslint_devkit_1.AST_NODE_TYPES.SpreadElement)continue;const spreadSource=getUnsafeLocalsSource(prop.argument);if(!spreadSource)continue;context.report({node:prop,messageId:"unsafeRenderLocals",data:{source:spreadSource},suggest:[{messageId:"pickFieldsExplicitly",fix:buildRemoveSpreadFix(prop)}]})}}function trackDeclarator(declared,init){const unsafe=getUnsafeLocalsSource(init);if(unsafe){trackedVars.set(declared,{source:unsafe,whole:true});return}if(init.type===eslint_devkit_1.AST_NODE_TYPES.ObjectExpression){for(const prop of init.properties){if(prop.type!==eslint_devkit_1.AST_NODE_TYPES.SpreadElement)continue;const spreadSource=getUnsafeLocalsSource(prop.argument);if(spreadSource){trackedVars.set(declared,{source:spreadSource,whole:true});return}}return}const derived=getDerivedSource(init);if(derived){trackedVars.set(declared,{source:derived,whole:false})}}return{VariableDeclarator(node){if(node.id.type!==eslint_devkit_1.AST_NODE_TYPES.Identifier)return;const init=node.init;if(!init)return;for(const declared of context.sourceCode.getDeclaredVariables(node)){trackDeclarator(declared,init)}},CallExpression(node){if(!isRenderCall(node))return;const viewArg=node.arguments[0];if(!viewArg)return;const viewSource=getDerivedSource(viewArg);if(viewSource){context.report({node:viewArg,messageId:"userControlledView",data:{source:viewSource}})}const localsArg=node.arguments[1];if(!localsArg)return;checkLocalsArg(localsArg)}}}});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.requireCaseInsensitivePathGuard=void 0;const express_evidence_1=require("../../utils/express-evidence");const eslint_devkit_1=require("@interlace/eslint-devkit");const PATH_PROPS=new Set(["path","url","originalUrl"]);const GUARD_METHODS=new Set(["startsWith","endsWith","includes","indexOf","match"]);const EQUALITY_OPS=new Set(["===","==","!==","!="]);function quoteLiteral(value){const json=JSON.stringify(value.toLowerCase());const inner=json.slice(1,-1);return/['\\]/.test(inner)?json:`'${inner}'`}const DEFAULT_PROTECTED_PATHS=["admin","api","dashboard","internal","private"];exports.requireCaseInsensitivePathGuard=(0,eslint_devkit_1.createRule)({name:"require-case-insensitive-path-guard",meta:{type:"problem",hasSuggestions:true,docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-express-security/docs/rules/require-case-insensitive-path-guard.md",description:"Require case-insensitive comparison when guarding protected paths via req.path / req.url / req.originalUrl",cwe:"CWE-178",cvss:7.3},messages:{caseSensitivePathGuard:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.SECURITY,issueName:"Case-Sensitive Path Guard (CWE-178)",cwe:"CWE-178",description:"{{pathExpr}} is compared case-sensitively against '{{value}}', but Express routes can match case-insensitively. A request to an upper-cased variant (e.g. /Admin) reaches the handler without ever hitting this guard.",severity:"HIGH",fix:"Normalize the path with .toLowerCase() before comparing (and lower-case the compared literal), or add the /i flag to the guard regex.",documentationLink:"https://cwe.mitre.org/data/definitions/178.html"}),addToLowerCase:"Normalize with .toLowerCase() before comparing",addIgnoreCaseFlag:"Add the i flag to the guard regex"},schema:[{type:"object",properties:{protectedPaths:{type:"array",items:{type:"string"},description:"Substrings that mark a compared value as a protected path"},checkAllPaths:{type:"boolean",description:"Flag every case-sensitive path guard regardless of the compared value"}},additionalProperties:false}]},defaultOptions:[{}],create(context,[options]){if(!(0,express_evidence_1.fileUsesExpress)(context.sourceCode.ast))return{};const{protectedPaths,checkAllPaths}=options;const patterns=(protectedPaths??DEFAULT_PROTECTED_PATHS).map(p=>p.toLowerCase());const flagAll=checkAllPaths??false;const sourceCode=context.sourceCode;function isRequestIdent(name){const lower=name.toLowerCase();return lower==="req"||lower==="request"}function isPathAccess(node){return node.type===eslint_devkit_1.AST_NODE_TYPES.MemberExpression&&!node.computed&&node.object.type===eslint_devkit_1.AST_NODE_TYPES.Identifier&&isRequestIdent(node.object.name)&&node.property.type===eslint_devkit_1.AST_NODE_TYPES.Identifier&&PATH_PROPS.has(node.property.name)}function isProtectedValue(value){if(flagAll)return true;const lower=value.toLowerCase();return patterns.some(p=>lower.includes(p))}function isStringLiteral(node){return
|
|
1
|
+
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.requireCaseInsensitivePathGuard=void 0;const express_evidence_1=require("../../utils/express-evidence");const eslint_devkit_1=require("@interlace/eslint-devkit");const PATH_PROPS=new Set(["path","url","originalUrl"]);const GUARD_METHODS=new Set(["startsWith","endsWith","includes","indexOf","match"]);const EQUALITY_OPS=new Set(["===","==","!==","!="]);function quoteLiteral(value){const json=JSON.stringify(value.toLowerCase());const inner=json.slice(1,-1);return/['\\]/.test(inner)?json:`'${inner}'`}const DEFAULT_PROTECTED_PATHS=["admin","api","dashboard","internal","private"];exports.requireCaseInsensitivePathGuard=(0,eslint_devkit_1.createRule)({name:"require-case-insensitive-path-guard",meta:{type:"problem",hasSuggestions:true,docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-express-security/docs/rules/require-case-insensitive-path-guard.md",description:"Require case-insensitive comparison when guarding protected paths via req.path / req.url / req.originalUrl",cwe:"CWE-178",cvss:7.3},messages:{caseSensitivePathGuard:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.SECURITY,issueName:"Case-Sensitive Path Guard (CWE-178)",cwe:"CWE-178",description:"{{pathExpr}} is compared case-sensitively against '{{value}}', but Express routes can match case-insensitively. A request to an upper-cased variant (e.g. /Admin) reaches the handler without ever hitting this guard.",severity:"HIGH",fix:"Normalize the path with .toLowerCase() before comparing (and lower-case the compared literal), or add the /i flag to the guard regex.",documentationLink:"https://cwe.mitre.org/data/definitions/178.html"}),addToLowerCase:"Normalize with .toLowerCase() before comparing",addIgnoreCaseFlag:"Add the i flag to the guard regex"},schema:[{type:"object",properties:{protectedPaths:{type:"array",items:{type:"string"},description:"Substrings that mark a compared value as a protected path"},checkAllPaths:{type:"boolean",description:"Flag every case-sensitive path guard regardless of the compared value"}},additionalProperties:false}]},defaultOptions:[{}],create(context,[options]){if(!(0,express_evidence_1.fileUsesExpress)(context.sourceCode.ast))return{};const{protectedPaths,checkAllPaths}=options;const patterns=(protectedPaths??DEFAULT_PROTECTED_PATHS).map(p=>p.toLowerCase());const flagAll=checkAllPaths??false;const sourceCode=context.sourceCode;function isRequestIdent(name){const lower=name.toLowerCase();return lower==="req"||lower==="request"}function isPathAccess(node){return node.type===eslint_devkit_1.AST_NODE_TYPES.MemberExpression&&!node.computed&&node.object.type===eslint_devkit_1.AST_NODE_TYPES.Identifier&&isRequestIdent(node.object.name)&&node.property.type===eslint_devkit_1.AST_NODE_TYPES.Identifier&&PATH_PROPS.has(node.property.name)}function isProtectedValue(value){if(flagAll)return true;const lower=value.toLowerCase();return patterns.some(p=>lower.includes(p))}function isStringLiteral(node){return(0,eslint_devkit_1.staticString)(node)!==null}function reportWithLowerCaseSuggestion(node,pathNode,literalNode){const value=literalNode.value;context.report({node,messageId:"caseSensitivePathGuard",data:{pathExpr:sourceCode.getText(pathNode),value},suggest:[{messageId:"addToLowerCase",fix(fixer){const fixes=[fixer.insertTextAfter(pathNode,".toLowerCase()")];if(/[A-Z]/.test(value)){fixes.push(fixer.replaceText(literalNode,quoteLiteral(value)))}return fixes}}]})}return{CallExpression(node){const callee=node.callee;if(callee.type!==eslint_devkit_1.AST_NODE_TYPES.MemberExpression)return;if(callee.property.type!==eslint_devkit_1.AST_NODE_TYPES.Identifier)return;if(!GUARD_METHODS.has(callee.property.name))return;if(!isPathAccess(callee.object))return;const arg=node.arguments[0];if(!arg)return;if(arg.type!==eslint_devkit_1.AST_NODE_TYPES.Literal)return;if("regex"in arg){if(arg.regex.flags.includes("i"))return;if(!isProtectedValue(arg.regex.pattern))return;context.report({node,messageId:"caseSensitivePathGuard",data:{pathExpr:sourceCode.getText(callee.object),value:arg.regex.pattern},suggest:[{messageId:"addIgnoreCaseFlag",fix:fixer=>fixer.insertTextAfter(arg,"i")}]});return}if(typeof arg.value!=="string")return;if(!isProtectedValue(arg.value))return;reportWithLowerCaseSuggestion(node,callee.object,arg)},BinaryExpression(node){if(!EQUALITY_OPS.has(node.operator))return;let pathNode;let literalNode;if(isPathAccess(node.left)&&isStringLiteral(node.right)){pathNode=node.left;literalNode=node.right}else if(isPathAccess(node.right)&&isStringLiteral(node.left)){pathNode=node.right;literalNode=node.left}else{return}if(!isProtectedValue(literalNode.value))return;reportWithLowerCaseSuggestion(node,pathNode,literalNode)}}}});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.requireExpressBodyParserLimits=void 0;const express_evidence_1=require("../../utils/express-evidence");const eslint_devkit_1=require("@interlace/eslint-devkit");const DEFAULT_MAX_LIMIT=5*1024*1024;const DEFAULT_EXCESSIVE_LIMITS=["10mb","50mb","100mb","500mb","1gb","1GB","10MB","50MB","100MB","500MB"];const BODY_PARSER_METHODS=new Set(["json","urlencoded","raw","text"]);function getLimitOption(properties){for(const prop of properties){if(prop.type==="Property"&&prop.key.type==="Identifier"&&prop.key.name==="limit"){return prop}}return null}const UNITS={b:1,kb:1024,mb:1024**2,gb:1024**3,tb:1024**4};function limitInBytes(value){if(value.type
|
|
1
|
+
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.requireExpressBodyParserLimits=void 0;const express_evidence_1=require("../../utils/express-evidence");const eslint_devkit_1=require("@interlace/eslint-devkit");const DEFAULT_MAX_LIMIT=5*1024*1024;const DEFAULT_EXCESSIVE_LIMITS=["10mb","50mb","100mb","500mb","1gb","1GB","10MB","50MB","100MB","500MB"];const BODY_PARSER_METHODS=new Set(["json","urlencoded","raw","text"]);function getLimitOption(properties){for(const prop of properties){if(prop.type==="Property"&&prop.key.type==="Identifier"&&prop.key.name==="limit"){return prop}}return null}const UNITS={b:1,kb:1024,mb:1024**2,gb:1024**3,tb:1024**4};function limitInBytes(value){if(value.type==="Literal"&&typeof value.value==="number")return value.value;const text=(0,eslint_devkit_1.staticString)(value);if(text===null)return null;const parsed=/^\s*(\d+(?:\.\d+)?)\s*(b|kb|mb|gb|tb)?\s*$/i.exec(text);if(!parsed)return null;return Number(parsed[1])*UNITS[(parsed[2]??"b").toLowerCase()]}function isExcessiveLimit(value,excessiveLimits,maxLimit){const staticText=(0,eslint_devkit_1.staticString)(value);if(staticText!==null){const named=excessiveLimits.some(limit=>staticText.toLowerCase()===limit.toLowerCase());if(named)return true}const bytes=limitInBytes(value);return bytes!==null&&bytes>maxLimit}exports.requireExpressBodyParserLimits=(0,eslint_devkit_1.createRule)({name:"require-express-body-parser-limits",meta:{type:"problem",docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-express-security/docs/rules/require-express-body-parser-limits.md",description:"Require size limits on Express.js body parsers to prevent DoS attacks",cwe:"CWE-400",cvss:7.5},messages:{excessiveLimit:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.SECURITY,issueName:"Excessive Body Parser Limit",cwe:"CWE-400",description:"This body parser raises the limit above Express's 100kb default, so a single request can pin that much memory per connection.",severity:"MEDIUM",fix:"Reduce the limit to a reasonable size: '100kb' for JSON APIs, '1mb' for file uploads with proper handling",documentationLink:"https://expressjs.com/en/4x/api.html#express.json"})},schema:[{type:"object",properties:{allowInTests:{type:"boolean",default:false,description:"Allow in test files"},maxLimit:{type:"number",default:DEFAULT_MAX_LIMIT,description:"Largest explicit body-parser limit, in bytes, that is not reported"},excessiveLimits:{type:"array",items:{type:"string"},default:DEFAULT_EXCESSIVE_LIMITS,description:"Limits considered excessive"}},additionalProperties:false}]},defaultOptions:[{allowInTests:false,maxLimit:DEFAULT_MAX_LIMIT,excessiveLimits:DEFAULT_EXCESSIVE_LIMITS}],create(context,[options]){if(!(0,express_evidence_1.fileUsesExpress)(context.sourceCode.ast))return{};const{allowInTests=false,maxLimit=DEFAULT_MAX_LIMIT,excessiveLimits=DEFAULT_EXCESSIVE_LIMITS}=options;const filename=context.filename;const isTestFile=allowInTests&&(0,eslint_devkit_1.isTestFilePath)(filename);if(isTestFile){return{}}return{CallExpression(node){const callee=node.callee;if(callee.type!=="MemberExpression"){return}const object=callee.object;const property=callee.property;if(object.type!=="Identifier"){return}if(object.name!=="express"&&object.name!=="bodyParser"){return}if(property.type!=="Identifier"){return}if(!BODY_PARSER_METHODS.has(property.name)){return}const firstArg=node.arguments[0];if(firstArg?.type!=="ObjectExpression")return;const limitProp=getLimitOption(firstArg.properties);if(!limitProp)return;if(isExcessiveLimit(limitProp.value,excessiveLimits,maxLimit)){context.report({node:limitProp,messageId:"excessiveLimit"})}}}}});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.requireRateLimiting=void 0;const express_evidence_1=require("../../utils/express-evidence");const app_composition_1=require("../../utils/app-composition");const eslint_devkit_1=require("@interlace/eslint-devkit");const STATE_CHANGING_METHODS=new Set(["post","put","patch","delete"]);const
|
|
1
|
+
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.requireRateLimiting=void 0;const express_evidence_1=require("../../utils/express-evidence");const app_receiver_1=require("../../utils/app-receiver");const app_composition_1=require("../../utils/app-composition");const eslint_devkit_1=require("@interlace/eslint-devkit");const STATE_CHANGING_METHODS=new Set(["post","put","patch","delete"]);const CREDENTIAL_PATH=/(^|[^a-z0-9])(login|log-in|signin|sign-in|signup|sign-up|register|authenticate|auth|authorize|token|password|passwd|credential|otp|mfa|2fa|totp|verify|verification|confirm|reset|forgot|recover|unlock|challenge|session|invite|redeem|coupon|promo)([^a-z0-9]|$)/i;const RATE_LIMIT_PACKAGES=["ratelimit","rateLimit","rateLimiter","limiter","expressRateLimit","slowDown","expressBrute"];function isRateLimitMiddleware(node,alternatives){const allPatterns=[...RATE_LIMIT_PACKAGES,...alternatives];for(const arg of node.arguments){if(arg.type==="CallExpression"&&arg.callee.type==="Identifier"){const calleeName=arg.callee.name.toLowerCase();if(allPatterns.some(p=>calleeName.includes(p.toLowerCase()))){return true}}if(arg.type==="Identifier"){if(allPatterns.some(p=>arg.name.toLowerCase().includes(p.toLowerCase()))){return true}}}return false}exports.requireRateLimiting=(0,eslint_devkit_1.createRule)({name:"require-rate-limiting",meta:{type:"problem",docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-express-security/docs/rules/require-rate-limiting.md",description:"Require rate-limiting middleware in Express.js applications",cwe:"CWE-770",cvss:7.5},messages:{missingRateLimiting:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.SECURITY,issueName:"Unthrottled Credential Endpoint",cwe:"CWE-770",description:"{{method}} {{path}} accepts a secret to be checked and this app mounts no rate limiter. An attacker can run the guess-and-retry loop at full speed.",severity:"HIGH",fix:"Add rate limiting: npm install express-rate-limit; app.use(rateLimit({ windowMs: 15*60*1000, max: 100 }))",documentationLink:"https://www.npmjs.com/package/express-rate-limit"})},schema:[{type:"object",properties:{...app_receiver_1.APP_RECEIVER_SCHEMA,allowInTests:{type:"boolean",default:false},alternativeMiddleware:{type:"array",items:{type:"string"},default:[],description:"Extra middleware names that count as rate limiting"},assumeRateLimiting:{type:"boolean",default:false,description:"Skip if rate limiting is provided by infrastructure (API Gateway, nginx, etc.)"}},additionalProperties:false}]},defaultOptions:[{allowInTests:false,alternativeMiddleware:[],assumeRateLimiting:false}],create(context,[options]){const{appReceiverNames}=options;if(!(0,express_evidence_1.fileUsesExpress)(context.sourceCode.ast))return{};const{allowInTests=false,alternativeMiddleware=[],assumeRateLimiting=false}=options;if(assumeRateLimiting){return{}}const filename=context.filename;const isTestFile=allowInTests&&(0,eslint_devkit_1.isTestFilePath)(filename);if(isTestFile){return{}}let hasExpressApp=false;let hasRateLimiting=false;let credentialRoute=null;let appBinding=null;let appEscapes=false;return{[app_composition_1.RELEASE_SELECTOR](node){if(appBinding!==null&&(0,app_composition_1.nodeReleasesBinding)(node,appBinding)){appEscapes=true}},CallExpression(node){const callee=node.callee;if(appBinding!==null&&(0,app_composition_1.nodeReleasesBinding)(node,appBinding)){appEscapes=true}if(callee.type==="Identifier"&&callee.name==="express"){hasExpressApp=true;if(node.parent?.type==="VariableDeclarator"&&node.parent.id.type==="Identifier"){appBinding=node.parent.id.name}return}if(callee.type!=="MemberExpression"||callee.property.type!=="Identifier"){return}const method=callee.property.name.toLowerCase();if(isRateLimitMiddleware(node,alternativeMiddleware)){hasRateLimiting=true;return}if(!STATE_CHANGING_METHODS.has(method))return;if(callee.object.type!=="Identifier"||!(0,app_receiver_1.isAppReceiver)(callee.object.name,appReceiverNames)){return}const[pathArg,...rest]=node.arguments;if(rest.length===0||pathArg?.type!=="Literal"||typeof pathArg.value!=="string"){return}if(!CREDENTIAL_PATH.test(pathArg.value))return;credentialRoute??={node,method:method.toUpperCase(),path:pathArg.value}},"Program:exit"(){if(hasExpressApp&&!hasRateLimiting&&!appEscapes&&credentialRoute){context.report({node:credentialRoute.node,messageId:"missingRateLimiting",data:{method:credentialRoute.method,path:credentialRoute.path}})}}}}});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.requireRouteAuthentication=void 0;const eslint_devkit_1=require("@interlace/eslint-devkit");const utils_1=require("../../utils");const auth_evidence_1=require("../../utils/auth-evidence");const express_evidence_1=require("../../utils/express-evidence");const DEFAULT_CRITICAL_PATHS=["password","credential","secret","apikey","api-key","user","account","profile","role","permission","grant","payment","billing","invoice","charge","refund","transfer","withdraw","order","config","setting","export","import","mfa","2fa","otp","deploy","migrate","backup","restore","internal","private"];const DEFAULT_PUBLIC_PATHS=["login","signin","sign-in","logout","signup","sign-up","register","forgot","reset","confirm","verify","recover","recovery","unlock","challenge","enroll","enrol","enrollment","activate","activation","resend","consent","webhook","hook","health","healthz","readyz","livez","ping","status","public","static","assets","favicon","robots","callback","oauth","sso","docs","swagger","openapi"];const ROUTE_METHODS=new Set(["get","post","put","patch","delete","all"]);
|
|
1
|
+
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.requireRouteAuthentication=void 0;const eslint_devkit_1=require("@interlace/eslint-devkit");const utils_1=require("../../utils");const app_receiver_1=require("../../utils/app-receiver");const auth_evidence_1=require("../../utils/auth-evidence");const express_evidence_1=require("../../utils/express-evidence");const DEFAULT_CRITICAL_PATHS=["password","credential","secret","apikey","api-key","user","account","profile","role","permission","grant","payment","billing","invoice","charge","refund","transfer","withdraw","order","config","setting","export","import","mfa","2fa","otp","deploy","migrate","backup","restore","internal","private"];const DEFAULT_PUBLIC_PATHS=["login","signin","sign-in","logout","signup","sign-up","register","forgot","reset","confirm","verify","recover","recovery","unlock","challenge","enroll","enrol","enrollment","activate","activation","resend","consent","webhook","hook","health","healthz","readyz","livez","ping","status","public","static","assets","favicon","robots","callback","oauth","sso","docs","swagger","openapi"];const ROUTE_METHODS=new Set(["get","post","put","patch","delete","all"]);function matchesFragment(path,fragment){const escaped=fragment.replace(/[.*+?^${}()|[\]\\]/g,"\\$&");return new RegExp(`(^|[^a-z0-9])${escaped}s?([^a-z0-9]|$)`).test(path)}function asFunction(node){return node?.type===eslint_devkit_1.AST_NODE_TYPES.FunctionDeclaration||node?.type===eslint_devkit_1.AST_NODE_TYPES.FunctionExpression||node?.type===eslint_devkit_1.AST_NODE_TYPES.ArrowFunctionExpression?node:void 0}function isDelegatingHandler(fn){let callsNext=false;let touchesResponse=false;(0,utils_1.walk)(fn.body,node=>{if(node.type===eslint_devkit_1.AST_NODE_TYPES.CallExpression&&node.callee.type===eslint_devkit_1.AST_NODE_TYPES.Identifier&&node.callee.name==="next"){callsNext=true;return}if(node.type===eslint_devkit_1.AST_NODE_TYPES.MemberExpression&&node.object.type===eslint_devkit_1.AST_NODE_TYPES.Identifier&&RESPONSE_RECEIVER.test(node.object.name)){touchesResponse=true}});return callsNext&&!touchesResponse}const RESPONSE_RECEIVER=/^(res|response)$/i;exports.requireRouteAuthentication=(0,eslint_devkit_1.createRule)({name:"require-route-authentication",meta:{type:"problem",docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-express-security/docs/rules/require-route-authentication.md",description:"Require authentication on routes that expose a critical function (account, credential, payment, configuration)",cwe:"CWE-306",cvss:8.2,confidence:"medium"},messages:{missingAuthentication:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.SECURITY,issueName:"Critical Route Without Authentication (CWE-306)",cwe:"CWE-306",cvss:8.2,description:"{{method}} {{path}} exposes a critical function but its chain has no authentication middleware and the handler never reads an authenticated principal. Anyone who can reach the port can call it.",severity:"HIGH",fix:"Mount an authentication middleware on the route \u2014 app.{{method}}('{{path}}', requireAuth, handler) \u2014 or app.use(requireAuth) for the whole router.",documentationLink:"https://cwe.mitre.org/data/definitions/306.html"})},schema:[{type:"object",properties:{...app_receiver_1.APP_RECEIVER_SCHEMA,criticalPaths:{type:"array",items:{type:"string"},description:"Path fragments that mark a route as critical"},publicPaths:{type:"array",items:{type:"string"},description:"Path fragments that are public by design"},authMiddleware:{type:"array",items:{type:"string"},description:"Extra middleware names accepted as authentication"}},additionalProperties:false}]},defaultOptions:[{}],create(context,[options]){if(!(0,express_evidence_1.fileUsesExpress)(context.sourceCode.ast))return{};const{criticalPaths,publicPaths,authMiddleware,appReceiverNames}=options;const critical=(criticalPaths??DEFAULT_CRITICAL_PATHS).map(p=>p.toLowerCase());const publics=(publicPaths??DEFAULT_PUBLIC_PATHS).map(p=>p.toLowerCase());const extraAuth=new Set(authMiddleware??[]);const topLevelFunctions=new Map;for(const stmt of context.sourceCode.ast.body){if(stmt.type===eslint_devkit_1.AST_NODE_TYPES.FunctionDeclaration&&stmt.id){topLevelFunctions.set(stmt.id.name,stmt);continue}if(stmt.type!==eslint_devkit_1.AST_NODE_TYPES.VariableDeclaration)continue;for(const decl of stmt.declarations){if(decl.id.type===eslint_devkit_1.AST_NODE_TYPES.Identifier&&decl.init){topLevelFunctions.set(decl.id.name,decl.init)}}}const candidates=[];let hasGlobalAuth=false;function routeMethodOf(node){const callee=node.callee;if(callee.type!==eslint_devkit_1.AST_NODE_TYPES.MemberExpression)return null;if(callee.property.type!==eslint_devkit_1.AST_NODE_TYPES.Identifier)return null;if(callee.computed)return null;if(callee.object.type!==eslint_devkit_1.AST_NODE_TYPES.Identifier)return null;if(!(0,app_receiver_1.isAppReceiver)(callee.object.name,appReceiverNames))return null;return callee.property.name}return{CallExpression(node){const method=routeMethodOf(node);if(!method)return;if(method==="use"){const[first]=node.arguments;const pathScoped=first?.type===eslint_devkit_1.AST_NODE_TYPES.Literal&&typeof first.value==="string";if(!pathScoped){for(const arg of node.arguments){if(arg.type!==eslint_devkit_1.AST_NODE_TYPES.Literal&&(0,auth_evidence_1.isAuthMiddlewareArg)(arg,extraAuth)){hasGlobalAuth=true}}}return}if(!ROUTE_METHODS.has(method))return;const[pathArg,...rest]=node.arguments;if(!pathArg||pathArg.type!==eslint_devkit_1.AST_NODE_TYPES.Literal||typeof pathArg.value!=="string"){return}if(rest.length===0)return;const path=pathArg.value.toLowerCase();if(publics.some(fragment=>matchesFragment(path,fragment)))return;if(!critical.some(fragment=>matchesFragment(path,fragment)))return;const handler=rest[rest.length-1];if((0,auth_evidence_1.routeIsAuthenticated)(rest.slice(0,-1),handler,extraAuth)){return}const fn=asFunction(handler)??(handler.type===eslint_devkit_1.AST_NODE_TYPES.Identifier?asFunction(topLevelFunctions.get(handler.name)):void 0);if(fn&&isDelegatingHandler(fn))return;candidates.push({node:pathArg,method,path:pathArg.value})},"Program:exit"(){if(hasGlobalAuth)return;for(const candidate of candidates){context.report({node:candidate.node,messageId:"missingAuthentication",data:{method:candidate.method,path:candidate.path}})}}}}});
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.APP_RECEIVER_SCHEMA=exports.DEFAULT_APP_RECEIVER_NAMES=void 0;exports.isAppReceiver=isAppReceiver;exports.DEFAULT_APP_RECEIVER_NAMES=["app","server","router","express","api","apiRouter","routes"];exports.APP_RECEIVER_SCHEMA={appReceiverNames:{type:"array",items:{type:"string"},default:[...exports.DEFAULT_APP_RECEIVER_NAMES],description:"Identifiers that hold the Express app or a router. Replaces the default."}};function isAppReceiver(name,appReceiverNames){const names=appReceiverNames??exports.DEFAULT_APP_RECEIVER_NAMES;return names.some(candidate=>candidate.toLowerCase()===name.toLowerCase())}
|