securenow 6.0.2 → 6.1.0
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/CONSUMING-APPS-GUIDE.md +455 -0
- package/NPM_README.md +2029 -0
- package/README.md +297 -40
- package/SKILL-API.md +634 -0
- package/SKILL-CLI.md +454 -0
- package/cidr.js +83 -0
- package/cli/apps.js +585 -0
- package/cli/auth.js +280 -0
- package/cli/client.js +115 -0
- package/cli/config.js +173 -0
- package/cli/diagnostics.js +387 -0
- package/cli/firewall.js +100 -0
- package/cli/fp.js +638 -0
- package/cli/init.js +201 -0
- package/cli/monitor.js +440 -0
- package/cli/run.js +148 -0
- package/cli/security.js +980 -0
- package/cli/ui.js +386 -0
- package/cli/utils.js +127 -0
- package/cli.js +466 -455
- package/console-instrumentation.js +147 -136
- package/docs/ALL-FRAMEWORKS-QUICKSTART.md +1377 -455
- package/docs/API-KEYS-GUIDE.md +233 -0
- package/docs/ARCHITECTURE.md +3 -3
- package/docs/AUTO-BODY-CAPTURE.md +1 -1
- package/docs/AUTO-SETUP-SUMMARY.md +331 -0
- package/docs/AUTO-SETUP.md +4 -4
- package/docs/AUTOMATIC-IP-CAPTURE.md +5 -5
- package/docs/BODY-CAPTURE-FIX.md +261 -0
- package/docs/BODY-CAPTURE-QUICKSTART.md +2 -2
- package/docs/CHANGELOG-NEXTJS.md +1 -35
- package/docs/COMPLETION-REPORT.md +408 -0
- package/docs/CUSTOMER-GUIDE.md +16 -16
- package/docs/EASIEST-SETUP.md +5 -5
- package/docs/ENVIRONMENT-VARIABLES.md +880 -652
- package/docs/EXPRESS-BODY-CAPTURE.md +13 -12
- package/docs/EXPRESS-SETUP-GUIDE.md +719 -720
- package/docs/FINAL-SOLUTION.md +335 -0
- package/docs/FIREWALL-GUIDE.md +426 -0
- package/docs/IMPLEMENTATION-SUMMARY.md +410 -0
- package/docs/INDEX.md +22 -4
- package/docs/LOGGING-GUIDE.md +701 -708
- package/docs/LOGGING-QUICKSTART.md +234 -255
- package/docs/NEXTJS-BODY-CAPTURE-COMPARISON.md +323 -0
- package/docs/NEXTJS-BODY-CAPTURE.md +2 -2
- package/docs/NEXTJS-GUIDE.md +14 -14
- package/docs/NEXTJS-QUICKSTART.md +1 -1
- package/docs/NEXTJS-SETUP-COMPLETE.md +795 -0
- package/docs/NEXTJS-WRAPPER-APPROACH.md +1 -1
- package/docs/NUXT-GUIDE.md +166 -0
- package/docs/QUICKSTART-BODY-CAPTURE.md +2 -2
- package/docs/REDACTION-EXAMPLES.md +1 -1
- package/docs/REQUEST-BODY-CAPTURE.md +19 -10
- package/docs/SOLUTION-SUMMARY.md +312 -0
- package/docs/VERCEL-OTEL-MIGRATION.md +3 -3
- package/examples/README.md +6 -6
- package/examples/instrumentation-with-auto-capture.ts +1 -1
- package/examples/nextjs-env-example.txt +2 -2
- package/examples/nextjs-instrumentation.js +1 -1
- package/examples/nextjs-instrumentation.ts +1 -1
- package/examples/nextjs-with-logging-example.md +6 -6
- package/examples/nextjs-with-options.ts +1 -1
- package/examples/test-nextjs-setup.js +1 -1
- package/firewall-cloud.js +212 -0
- package/firewall-iptables.js +139 -0
- package/firewall-only.js +38 -0
- package/firewall-tcp.js +74 -0
- package/firewall.js +720 -0
- package/free-trial-banner.js +174 -0
- package/nextjs-auto-capture.js +199 -207
- package/nextjs-middleware.js +186 -181
- package/nextjs-webpack-config.js +88 -53
- package/nextjs-wrapper.js +158 -158
- package/nextjs.d.ts +1 -1
- package/nextjs.js +639 -647
- package/nuxt-server-plugin.mjs +423 -0
- package/nuxt.d.ts +60 -0
- package/nuxt.mjs +75 -0
- package/package.json +186 -164
- package/postinstall.js +6 -6
- package/register.d.ts +1 -1
- package/register.js +39 -4
- package/resolve-ip.js +77 -0
- package/tracing.d.ts +2 -1
- package/tracing.js +295 -34
- package/web-vite.mjs +239 -156
- package/LICENSE +0 -15
|
@@ -55,7 +55,7 @@ Create `.env` or set in PM2 ecosystem file:
|
|
|
55
55
|
|
|
56
56
|
```bash
|
|
57
57
|
SECURENOW_APPID=my-express-api
|
|
58
|
-
SECURENOW_INSTANCE=http://your-
|
|
58
|
+
SECURENOW_INSTANCE=http://your-otlp-backend:4318
|
|
59
59
|
SECURENOW_CAPTURE_BODY=1
|
|
60
60
|
SECURENOW_MAX_BODY_SIZE=10240
|
|
61
61
|
```
|
|
@@ -192,6 +192,7 @@ import express from 'express';
|
|
|
192
192
|
| `SECURENOW_CAPTURE_BODY` | Enable body capture (`1` or `true`) | `0` (disabled) |
|
|
193
193
|
| `SECURENOW_MAX_BODY_SIZE` | Max body size in bytes | `10240` (10KB) |
|
|
194
194
|
| `SECURENOW_SENSITIVE_FIELDS` | Comma-separated additional sensitive fields | (see below) |
|
|
195
|
+
| `SECURENOW_CAPTURE_MULTIPART` | Enable multipart/form-data streaming capture (`1` or `true`) | `0` (disabled) |
|
|
195
196
|
|
|
196
197
|
### Default Sensitive Fields
|
|
197
198
|
|
|
@@ -227,7 +228,7 @@ module.exports = {
|
|
|
227
228
|
env: {
|
|
228
229
|
NODE_ENV: 'production',
|
|
229
230
|
SECURENOW_APPID: 'express-api',
|
|
230
|
-
SECURENOW_INSTANCE: 'http://
|
|
231
|
+
SECURENOW_INSTANCE: 'http://otel-collector:4318',
|
|
231
232
|
SECURENOW_CAPTURE_BODY: '1',
|
|
232
233
|
SECURENOW_NO_UUID: '1', // Same service.name
|
|
233
234
|
SECURENOW_STRICT: '1', // Fail if APPID missing
|
|
@@ -274,10 +275,10 @@ pm2 logs express-api --lines 100
|
|
|
274
275
|
| `application/json` | ✅ Yes | ✅ Yes | ✅ Yes |
|
|
275
276
|
| `application/graphql` | ✅ Yes | ✅ Yes | ✅ Yes |
|
|
276
277
|
| `application/x-www-form-urlencoded` | ✅ Yes | ✅ Yes | ✅ Yes |
|
|
277
|
-
| `multipart/form-data` |
|
|
278
|
+
| `multipart/form-data` | ✅ Metadata | ✅ Streaming | ✅ Yes |
|
|
278
279
|
| `text/plain` | ❌ No | N/A | N/A |
|
|
279
280
|
|
|
280
|
-
**Note**:
|
|
281
|
+
**Note**: Multipart capture requires `SECURENOW_CAPTURE_MULTIPART=1` (v5.8.0+). Uses a streaming parser — text field values and file metadata (name, filename, content-type, size) are captured; file binary content is never buffered or stored.
|
|
281
282
|
|
|
282
283
|
## 🔍 Example: Complete Express + PM2 Setup
|
|
283
284
|
|
|
@@ -419,7 +420,7 @@ module.exports = {
|
|
|
419
420
|
NODE_ENV: 'production',
|
|
420
421
|
PORT: 3000,
|
|
421
422
|
SECURENOW_APPID: 'express-api',
|
|
422
|
-
SECURENOW_INSTANCE: 'http://
|
|
423
|
+
SECURENOW_INSTANCE: 'http://otel-collector.company.com:4318',
|
|
423
424
|
SECURENOW_CAPTURE_BODY: '1',
|
|
424
425
|
SECURENOW_MAX_BODY_SIZE: '10240',
|
|
425
426
|
SECURENOW_NO_UUID: '1',
|
|
@@ -451,7 +452,7 @@ module.exports = {
|
|
|
451
452
|
NODE_ENV: 'production',
|
|
452
453
|
PORT: 3000,
|
|
453
454
|
SECURENOW_APPID: 'express-api',
|
|
454
|
-
SECURENOW_INSTANCE: 'http://
|
|
455
|
+
SECURENOW_INSTANCE: 'http://otel-collector.company.com:4318',
|
|
455
456
|
SECURENOW_CAPTURE_BODY: '1',
|
|
456
457
|
SECURENOW_MAX_BODY_SIZE: '10240',
|
|
457
458
|
SECURENOW_NO_UUID: '1',
|
|
@@ -541,7 +542,7 @@ curl -X POST http://localhost:3000/api/login \
|
|
|
541
542
|
|
|
542
543
|
### Expected Trace Attributes
|
|
543
544
|
|
|
544
|
-
In your
|
|
545
|
+
In your SecureNow dashboard, you should see:
|
|
545
546
|
|
|
546
547
|
```json
|
|
547
548
|
{
|
|
@@ -612,14 +613,14 @@ app.post('/api/upload', (req, res) => {
|
|
|
612
613
|
|
|
613
614
|
- Add custom sensitive fields: `SECURENOW_SENSITIVE_FIELDS`
|
|
614
615
|
- Test with production-like data
|
|
615
|
-
- Review traces in
|
|
616
|
+
- Review traces in SecureNow
|
|
616
617
|
|
|
617
618
|
### 2. Body Size Limits
|
|
618
619
|
|
|
619
620
|
**Large bodies can cause:**
|
|
620
621
|
- Memory issues
|
|
621
622
|
- Performance degradation
|
|
622
|
-
- Storage costs in
|
|
623
|
+
- Storage costs in SecureNow
|
|
623
624
|
|
|
624
625
|
**Recommendation:**
|
|
625
626
|
- Keep `SECURENOW_MAX_BODY_SIZE` under 20KB
|
|
@@ -861,7 +862,7 @@ module.exports = {
|
|
|
861
862
|
NODE_ENV: 'production',
|
|
862
863
|
PORT: 3000,
|
|
863
864
|
SECURENOW_APPID: 'express-ts-api',
|
|
864
|
-
SECURENOW_INSTANCE: 'http://
|
|
865
|
+
SECURENOW_INSTANCE: 'http://otel-collector.company.com:4318',
|
|
865
866
|
SECURENOW_CAPTURE_BODY: '1',
|
|
866
867
|
SECURENOW_MAX_BODY_SIZE: '10240',
|
|
867
868
|
SECURENOW_NO_UUID: '1',
|
|
@@ -1001,7 +1002,7 @@ Currently not customizable. Default fields are comprehensive.
|
|
|
1001
1002
|
|
|
1002
1003
|
SecureNow uses OpenTelemetry standard, so it works with:
|
|
1003
1004
|
|
|
1004
|
-
- ✅
|
|
1005
|
+
- ✅ SecureNow (recommended)
|
|
1005
1006
|
- ✅ Jaeger
|
|
1006
1007
|
- ✅ Zipkin
|
|
1007
1008
|
- ✅ Any OTLP-compatible backend
|
|
@@ -1019,7 +1020,7 @@ If you encounter issues:
|
|
|
1019
1020
|
1. Check [Troubleshooting](#-troubleshooting) section
|
|
1020
1021
|
2. Enable debug logs: `OTEL_LOG_LEVEL=debug`
|
|
1021
1022
|
3. Check PM2 logs: `pm2 logs express-api`
|
|
1022
|
-
4. Review your
|
|
1023
|
+
4. Review your SecureNow dashboard for traces
|
|
1023
1024
|
|
|
1024
1025
|
---
|
|
1025
1026
|
|