blackveil-dns 2.13.0 → 3.100.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/LICENSE +1 -1
- package/README.md +237 -62
- package/dist/cli.js +1098 -0
- package/dist/cli.js.map +1 -0
- package/dist/index.js +10011 -2433
- package/dist/index.js.map +1 -1
- package/dist/stdio.js +33244 -9766
- package/dist/stdio.js.map +1 -1
- package/package.json +101 -21
- package/.claude/settings.json +0 -61
- package/.cursorrules +0 -1
- package/.devcontainer/Dockerfile +0 -17
- package/.devcontainer/devcontainer.json +0 -18
- package/.editorconfig +0 -12
- package/.gitattributes +0 -24
- package/.githooks/blocked-patterns +0 -13
- package/.githooks/pre-commit +0 -127
- package/.github/CODEOWNERS +0 -11
- package/.github/ISSUE_TEMPLATE/bug_report.yml +0 -99
- package/.github/ISSUE_TEMPLATE/config.yml +0 -11
- package/.github/ISSUE_TEMPLATE/feature_request.yml +0 -51
- package/.github/PULL_REQUEST_TEMPLATE.md +0 -30
- package/.github/copilot-instructions.md +0 -73
- package/.github/dependabot.yml +0 -22
- package/.github/instructions/scan-orchestration.instructions.md +0 -56
- package/.github/instructions/schemas.instructions.md +0 -52
- package/.github/instructions/security.instructions.md +0 -77
- package/.github/instructions/tests.instructions.md +0 -31
- package/.github/instructions/tools.instructions.md +0 -55
- package/.github/workflows/auto-deploy-main.yml.disabled +0 -145
- package/.github/workflows/ci-contract.yml +0 -47
- package/.github/workflows/ci.yml +0 -53
- package/.github/workflows/deploy-hook.yml +0 -113
- package/.github/workflows/dns-security.yml +0 -32
- package/.github/workflows/publish.yml +0 -275
- package/.github/workflows/repo-hygiene.yml +0 -121
- package/.github/workflows/security.yml +0 -62
- package/.github/workflows/triage-issues.yml +0 -82
- package/.gitleaks.toml +0 -190
- package/.intent/.gitignore +0 -5
- package/.intent/config.json +0 -88
- package/.nvmrc +0 -1
- package/.phase2-queue/baseline.txt +0 -1
- package/.prettierrc +0 -6
- package/CHANGELOG.md +0 -793
- package/CLAUDE.md +0 -580
- package/CODE_OF_CONDUCT.md +0 -133
- package/CONTRIBUTING.md +0 -63
- package/SECURITY.md +0 -66
- package/SUPPORT.md +0 -17
- package/assets/brave-score.png +0 -0
- package/assets/bv-logo-full.png +0 -0
- package/assets/bv-logo-mark.png +0 -0
- package/assets/our-listing-final.png +0 -0
- package/assets/smithery-listing.png +0 -0
- package/assets/smithery-score-2.png +0 -0
- package/assets/smithery-score-hover.png +0 -0
- package/assets/smithery-score.png +0 -0
- package/assets/supabase-score.png +0 -0
- package/conductor/index.md +0 -1
- package/conductor/registrar-commercial-models.md +0 -64
- package/crates/bv-wasm-core/Cargo.lock +0 -177
- package/crates/bv-wasm-core/Cargo.toml +0 -12
- package/crates/bv-wasm-core/src/compact.rs +0 -60
- package/crates/bv-wasm-core/src/lib.rs +0 -116
- package/crates/bv-wasm-core/src/permissions.rs +0 -106
- package/dist/index.d.ts +0 -500
- package/dist/stdio.d.ts +0 -12
- package/docs/client-setup.md +0 -587
- package/docs/scoring.md +0 -245
- package/docs/style-guide.md +0 -69
- package/docs/tenant-Capacity-and-Discovery-Design.md +0 -267
- package/docs/tenant-Scalable-Architecture-Design.md +0 -639
- package/docs/tenant-ops-runbook.md +0 -191
- package/docs/troubleshooting.md +0 -392
- package/eslint.config.mjs +0 -21
- package/examples/slack-discord-webhook/README.md +0 -38
- package/examples/slack-discord-webhook/worker.ts +0 -133
- package/examples/slack-discord-webhook/wrangler.toml +0 -11
- package/extensions/vscode/.vscodeignore +0 -2
- package/extensions/vscode/CHANGELOG.md +0 -8
- package/extensions/vscode/LICENSE +0 -76
- package/extensions/vscode/README.md +0 -105
- package/extensions/vscode/icon.png +0 -0
- package/extensions/vscode/package.json +0 -49
- package/packages/dns-checks/LICENSE +0 -76
- package/packages/dns-checks/README.md +0 -61
- package/packages/dns-checks/package.json +0 -39
- package/packages/dns-checks/src/__tests__/check-utils.test.ts +0 -188
- package/packages/dns-checks/src/__tests__/checks/check-dkim.test.ts +0 -54
- package/packages/dns-checks/src/__tests__/checks/check-dmarc.test.ts +0 -70
- package/packages/dns-checks/src/__tests__/checks/check-dnssec.test.ts +0 -56
- package/packages/dns-checks/src/__tests__/checks/check-remaining.test.ts +0 -244
- package/packages/dns-checks/src/__tests__/checks/check-spf.test.ts +0 -114
- package/packages/dns-checks/src/__tests__/scoring/generic-engine.spec.ts +0 -858
- package/packages/dns-checks/src/__tests__/scoring/score-determinism.spec.ts +0 -73
- package/packages/dns-checks/src/__tests__/scoring/scoring-config.spec.ts +0 -194
- package/packages/dns-checks/src/__tests__/scoring/scoring-engine.spec.ts +0 -137
- package/packages/dns-checks/src/__tests__/scoring/scoring-model.spec.ts +0 -46
- package/packages/dns-checks/src/__tests__/scoring/scoring-profiles.spec.ts +0 -316
- package/packages/dns-checks/src/__tests__/scoring-schemas.test.ts +0 -307
- package/packages/dns-checks/src/check-utils.ts +0 -44
- package/packages/dns-checks/src/checks/caa-analysis.ts +0 -126
- package/packages/dns-checks/src/checks/check-bimi.ts +0 -305
- package/packages/dns-checks/src/checks/check-caa.ts +0 -63
- package/packages/dns-checks/src/checks/check-dane-https.ts +0 -88
- package/packages/dns-checks/src/checks/check-dane.ts +0 -110
- package/packages/dns-checks/src/checks/check-dkim.ts +0 -261
- package/packages/dns-checks/src/checks/check-dmarc.ts +0 -370
- package/packages/dns-checks/src/checks/check-dnssec.ts +0 -131
- package/packages/dns-checks/src/checks/check-http-security.ts +0 -187
- package/packages/dns-checks/src/checks/check-mta-sts.ts +0 -195
- package/packages/dns-checks/src/checks/check-mx.ts +0 -130
- package/packages/dns-checks/src/checks/check-ns.ts +0 -133
- package/packages/dns-checks/src/checks/check-spf.ts +0 -271
- package/packages/dns-checks/src/checks/check-ssl.ts +0 -95
- package/packages/dns-checks/src/checks/check-subdomailing.ts +0 -77
- package/packages/dns-checks/src/checks/check-subdomain-takeover.ts +0 -45
- package/packages/dns-checks/src/checks/check-svcb-https.ts +0 -246
- package/packages/dns-checks/src/checks/check-tlsrpt.ts +0 -112
- package/packages/dns-checks/src/checks/dane-analysis.ts +0 -203
- package/packages/dns-checks/src/checks/dkim-analysis.ts +0 -102
- package/packages/dns-checks/src/checks/dmarc-utils.ts +0 -126
- package/packages/dns-checks/src/checks/dnssec-analysis.ts +0 -237
- package/packages/dns-checks/src/checks/http-security-analysis.ts +0 -230
- package/packages/dns-checks/src/checks/index.ts +0 -36
- package/packages/dns-checks/src/checks/mta-sts-analysis.ts +0 -259
- package/packages/dns-checks/src/checks/mx-analysis.ts +0 -63
- package/packages/dns-checks/src/checks/ns-analysis.ts +0 -171
- package/packages/dns-checks/src/checks/spf-analysis.ts +0 -211
- package/packages/dns-checks/src/checks/spf-trust-surface.ts +0 -141
- package/packages/dns-checks/src/checks/ssl-analysis.ts +0 -111
- package/packages/dns-checks/src/checks/subdomailing-analysis.ts +0 -262
- package/packages/dns-checks/src/checks/subdomain-takeover-analysis.ts +0 -217
- package/packages/dns-checks/src/index.ts +0 -73
- package/packages/dns-checks/src/schemas/scoring.ts +0 -52
- package/packages/dns-checks/src/scoring/config.ts +0 -346
- package/packages/dns-checks/src/scoring/engine.ts +0 -293
- package/packages/dns-checks/src/scoring/generic.ts +0 -317
- package/packages/dns-checks/src/scoring/index.ts +0 -56
- package/packages/dns-checks/src/scoring/model.ts +0 -133
- package/packages/dns-checks/src/scoring/profiles.ts +0 -332
- package/packages/dns-checks/src/types.ts +0 -172
- package/packages/dns-checks/tsconfig.json +0 -15
- package/packages/dns-checks/tsup.config.ts +0 -14
- package/packages/dns-checks/vitest.config.ts +0 -8
- package/public/index.html +0 -45
- package/scripts/benchmark-doh.mjs +0 -216
- package/scripts/benchmark.sh +0 -151
- package/scripts/chaos/chaos-run.py +0 -393
- package/scripts/chaos/chaos-test-clients.py +0 -884
- package/scripts/chaos/chaos-test-msp.py +0 -745
- package/scripts/chaos/chaos-test-v205.py +0 -829
- package/scripts/chaos/chaos-test-v210.py +0 -2038
- package/scripts/chaos/chaos-test-wasm.py +0 -65
- package/scripts/chaos/chaos-test.py +0 -952
- package/scripts/chaos/score-stability-test.py +0 -298
- package/scripts/chaos/tenant-chaos-v3.py +0 -119
- package/scripts/context-usage-test.py +0 -281
- package/scripts/conversation-sim.py +0 -421
- package/scripts/deploy-private.mjs +0 -22
- package/scripts/generate-report.sh +0 -42
- package/scripts/inject-private-config.cjs +0 -41
- package/scripts/maintenance/dispatch_all.sh +0 -26
- package/scripts/maintenance/fix_wrangler.py +0 -32
- package/scripts/maintenance/run_rescan_prod.py +0 -34
- package/scripts/maintenance/run_sync_batches.py +0 -56
- package/scripts/maintenance/run_sync_test.py +0 -27
- package/scripts/maintenance/run_test_msg.py +0 -22
- package/scripts/maintenance/test_analytics_stream.js +0 -3
- package/scripts/maintenance/update_wrangler.cjs +0 -22
- package/scripts/maintenance/update_wrangler.js +0 -22
- package/scripts/maintenance/validate-internal-deps.mjs +0 -49
- package/scripts/oauth/README.md +0 -101
- package/scripts/oauth/prod-probe.py +0 -329
- package/scripts/output-usage-test.py +0 -221
- package/scripts/pressure-chaos-test.mjs +0 -481
- package/scripts/tenants/add_consumer.js +0 -17
- package/scripts/tenants/calibrate.mjs +0 -206
- package/scripts/tenants/provision-tenant.mjs +0 -578
- package/scripts/tenants/register_domains.py +0 -27
- package/scripts/tenants/sql/register_0.sql +0 -1
- package/scripts/tenants/sql/register_1.sql +0 -1
- package/scripts/tenants/sql/register_2.sql +0 -1
- package/scripts/tenants/sql/register_3.sql +0 -1
- package/scripts/tenants/sql/register_4.sql +0 -1
- package/scripts/tenants/sql/register_5.sql +0 -1
- package/scripts/tenants/sql/register_6.sql +0 -1
- package/scripts/tenants/sql/register_7.sql +0 -1
- package/scripts/tenants/sql/register_8.sql +0 -1
- package/scripts/tenants/sql/register_9.sql +0 -1
- package/scripts/tranco-deep-2026-04-05_12h42m.json +0 -47002
- package/scripts/tranco-deep-scan.mjs +0 -307
- package/scripts/tranco-scan-2026-04-05_12h14m.json +0 -6002
- package/scripts/tranco-scan-2026-04-06_02h49m.json +0 -602
- package/scripts/tranco-scan-2026-04-07_13h30m.json +0 -1202
- package/scripts/tranco-scan.mjs +0 -253
- package/scripts/trial-key.mjs +0 -346
- package/server.json +0 -35
- package/smithery.yaml +0 -13
- package/src/handlers/prompts.ts +0 -279
- package/src/handlers/resources.ts +0 -283
- package/src/handlers/tool-args.ts +0 -150
- package/src/handlers/tool-execution.ts +0 -107
- package/src/handlers/tool-formatters.ts +0 -94
- package/src/handlers/tool-schemas.ts +0 -9
- package/src/handlers/tools.ts +0 -529
- package/src/index.ts +0 -794
- package/src/internal.ts +0 -666
- package/src/lib/adaptive-weights.ts +0 -246
- package/src/lib/alerting.ts +0 -103
- package/src/lib/analytics-engine.ts +0 -33
- package/src/lib/analytics-queries.ts +0 -399
- package/src/lib/analytics.ts +0 -310
- package/src/lib/audit.ts +0 -56
- package/src/lib/auth.ts +0 -52
- package/src/lib/badge.ts +0 -94
- package/src/lib/cache.ts +0 -310
- package/src/lib/category-interactions.ts +0 -154
- package/src/lib/circuit-breaker.ts +0 -101
- package/src/lib/client-detection.ts +0 -31
- package/src/lib/config.ts +0 -370
- package/src/lib/context-profiles.ts +0 -16
- package/src/lib/db/schema.ts +0 -77
- package/src/lib/dns-multi-resolver.ts +0 -218
- package/src/lib/dns-query-adapter.ts +0 -18
- package/src/lib/dns-records.ts +0 -233
- package/src/lib/dns-transport.ts +0 -237
- package/src/lib/dns-types.ts +0 -91
- package/src/lib/dns.ts +0 -27
- package/src/lib/fuzzing-counter.ts +0 -79
- package/src/lib/fuzzing-detector.ts +0 -115
- package/src/lib/hooks/analytics-stream.ts +0 -28
- package/src/lib/ip-utils.ts +0 -70
- package/src/lib/json-rpc.ts +0 -67
- package/src/lib/legacy-sse.ts +0 -185
- package/src/lib/log.ts +0 -113
- package/src/lib/output-sanitize.ts +0 -40
- package/src/lib/profile-accumulator.ts +0 -830
- package/src/lib/provider-signature-source.ts +0 -191
- package/src/lib/provider-signatures.ts +0 -134
- package/src/lib/public-suffix.ts +0 -131
- package/src/lib/quota-coordinator.ts +0 -446
- package/src/lib/rate-limiter-memory.ts +0 -163
- package/src/lib/rate-limiter.ts +0 -528
- package/src/lib/safe-fetch.ts +0 -42
- package/src/lib/sanitize.ts +0 -245
- package/src/lib/scoring-config.ts +0 -36
- package/src/lib/scoring-engine.ts +0 -15
- package/src/lib/scoring-model.ts +0 -26
- package/src/lib/scoring.ts +0 -58
- package/src/lib/semaphore.ts +0 -101
- package/src/lib/server-version.ts +0 -4
- package/src/lib/session-memory.ts +0 -177
- package/src/lib/session.ts +0 -295
- package/src/lib/sse.ts +0 -174
- package/src/lib/tier-auth.ts +0 -237
- package/src/lib/trial-keys.ts +0 -217
- package/src/mcp/dispatch.ts +0 -222
- package/src/mcp/execute.ts +0 -680
- package/src/mcp/request.ts +0 -152
- package/src/mcp/route-gates.ts +0 -119
- package/src/oauth/authorize.ts +0 -268
- package/src/oauth/discovery.ts +0 -48
- package/src/oauth/entitlements.ts +0 -77
- package/src/oauth/jwt.ts +0 -142
- package/src/oauth/register.ts +0 -72
- package/src/oauth/storage.ts +0 -66
- package/src/oauth/token.ts +0 -171
- package/src/package.ts +0 -59
- package/src/scheduled.ts +0 -310
- package/src/schemas/alerting.ts +0 -49
- package/src/schemas/audit.ts +0 -39
- package/src/schemas/auth.ts +0 -27
- package/src/schemas/dns.ts +0 -49
- package/src/schemas/internal.ts +0 -26
- package/src/schemas/json-rpc.ts +0 -20
- package/src/schemas/oauth.ts +0 -120
- package/src/schemas/primitives.ts +0 -58
- package/src/schemas/session.ts +0 -9
- package/src/schemas/tenant-alerts.ts +0 -118
- package/src/schemas/tenant-internal.ts +0 -143
- package/src/schemas/tool-args.ts +0 -270
- package/src/schemas/tool-definitions.ts +0 -452
- package/src/stdio.ts +0 -183
- package/src/tenants/adapters/tenant-d1.ts +0 -51
- package/src/tenants/adapters/tenant-kv.ts +0 -64
- package/src/tenants/adapters/tenant-r2.ts +0 -69
- package/src/tenants/alerts/diff.ts +0 -201
- package/src/tenants/alerts/index.ts +0 -12
- package/src/tenants/alerts/webhook.ts +0 -141
- package/src/tenants/analytics-stream.ts +0 -26
- package/src/tenants/audit.ts +0 -123
- package/src/tenants/db/drizzle.registry.config.ts +0 -18
- package/src/tenants/db/drizzle.tenant.config.ts +0 -21
- package/src/tenants/db/index.ts +0 -19
- package/src/tenants/db/migrations/registry/0000_minor_skaar.sql +0 -46
- package/src/tenants/db/migrations/registry/0001_wet_warhawk.sql +0 -23
- package/src/tenants/db/migrations/registry/0002_big_speedball.sql +0 -17
- package/src/tenants/db/migrations/registry/meta/0000_snapshot.json +0 -330
- package/src/tenants/db/migrations/registry/meta/0001_snapshot.json +0 -498
- package/src/tenants/db/migrations/registry/meta/0002_snapshot.json +0 -624
- package/src/tenants/db/migrations/registry/meta/_journal.json +0 -27
- package/src/tenants/db/migrations/tenant/0000_clear_clea.sql +0 -54
- package/src/tenants/db/migrations/tenant/0001_clumsy_master_mold.sql +0 -3
- package/src/tenants/db/migrations/tenant/meta/0000_snapshot.json +0 -375
- package/src/tenants/db/migrations/tenant/meta/0001_snapshot.json +0 -397
- package/src/tenants/db/migrations/tenant/meta/_journal.json +0 -20
- package/src/tenants/db/schema/registry.ts +0 -154
- package/src/tenants/db/schema/tenant.ts +0 -106
- package/src/tenants/discovery/dkim-key-reuse.ts +0 -250
- package/src/tenants/discovery/dmarc-rua-miner.ts +0 -186
- package/src/tenants/discovery/index.ts +0 -31
- package/src/tenants/discovery/ns-correlator.ts +0 -155
- package/src/tenants/discovery/san-correlator.ts +0 -212
- package/src/tenants/dns-fingerprint.ts +0 -313
- package/src/tenants/monitoring/index.ts +0 -17
- package/src/tenants/per-tenant-rate-limit.ts +0 -148
- package/src/tenants/queue-consumer.ts +0 -375
- package/src/tenants/routes.ts +0 -1014
- package/src/tenants/scheduled-handlers.ts +0 -550
- package/src/tenants/tenant-resolver.ts +0 -143
- package/src/tools/analyze-drift.ts +0 -235
- package/src/tools/assess-spoofability.ts +0 -224
- package/src/tools/batch-scan.ts +0 -163
- package/src/tools/caa-analysis.ts +0 -72
- package/src/tools/check-bimi.ts +0 -30
- package/src/tools/check-caa.ts +0 -23
- package/src/tools/check-cymru-asn.ts +0 -175
- package/src/tools/check-dane-https.ts +0 -29
- package/src/tools/check-dane.ts +0 -29
- package/src/tools/check-dbl.ts +0 -251
- package/src/tools/check-dkim.ts +0 -98
- package/src/tools/check-dmarc.ts +0 -25
- package/src/tools/check-dnssec-chain.ts +0 -284
- package/src/tools/check-dnssec.ts +0 -171
- package/src/tools/check-fast-flux.ts +0 -168
- package/src/tools/check-http-security.ts +0 -339
- package/src/tools/check-lookalikes.ts +0 -379
- package/src/tools/check-mta-sts.ts +0 -24
- package/src/tools/check-mx-reputation.ts +0 -174
- package/src/tools/check-mx.ts +0 -117
- package/src/tools/check-ns.ts +0 -30
- package/src/tools/check-nsec-walkability.ts +0 -173
- package/src/tools/check-rbl.ts +0 -235
- package/src/tools/check-rdap-lookup.ts +0 -333
- package/src/tools/check-resolver-consistency.ts +0 -151
- package/src/tools/check-shadow-domains.ts +0 -517
- package/src/tools/check-spf.ts +0 -48
- package/src/tools/check-srv.ts +0 -75
- package/src/tools/check-ssl.ts +0 -18
- package/src/tools/check-subdomailing.ts +0 -22
- package/src/tools/check-subdomain-takeover.ts +0 -24
- package/src/tools/check-svcb-https.ts +0 -22
- package/src/tools/check-tlsrpt.ts +0 -23
- package/src/tools/check-txt-hygiene.ts +0 -364
- package/src/tools/check-zone-hygiene.ts +0 -154
- package/src/tools/compare-baseline.ts +0 -199
- package/src/tools/compare-domains.ts +0 -182
- package/src/tools/dane-analysis.ts +0 -172
- package/src/tools/discover-brand-domains.ts +0 -377
- package/src/tools/discover-subdomains.ts +0 -487
- package/src/tools/dkim-analysis.ts +0 -86
- package/src/tools/dmarc-utils.ts +0 -114
- package/src/tools/dnssec-analysis.ts +0 -123
- package/src/tools/explain-finding-data.ts +0 -766
- package/src/tools/explain-finding.ts +0 -181
- package/src/tools/generate-fix-plan.ts +0 -196
- package/src/tools/generate-records.ts +0 -412
- package/src/tools/generate-rollout-plan.ts +0 -342
- package/src/tools/http-security-analysis.ts +0 -192
- package/src/tools/intelligence.ts +0 -331
- package/src/tools/lookalike-analysis.ts +0 -176
- package/src/tools/map-compliance.ts +0 -243
- package/src/tools/map-supply-chain.ts +0 -458
- package/src/tools/mta-sts-analysis.ts +0 -250
- package/src/tools/mx-analysis.ts +0 -55
- package/src/tools/mx-reputation-analysis.ts +0 -205
- package/src/tools/ns-analysis.ts +0 -162
- package/src/tools/provider-guides.ts +0 -404
- package/src/tools/resolve-spf-chain.ts +0 -254
- package/src/tools/scan/format-report.ts +0 -248
- package/src/tools/scan/maturity-staging.ts +0 -166
- package/src/tools/scan/post-processing.ts +0 -270
- package/src/tools/scan-domain.ts +0 -664
- package/src/tools/simulate-attack-paths.ts +0 -513
- package/src/tools/spf-analysis.ts +0 -203
- package/src/tools/spf-trust-surface.ts +0 -138
- package/src/tools/srv-analysis.ts +0 -118
- package/src/tools/ssl-analysis.ts +0 -102
- package/src/tools/subdomain-takeover-analysis.ts +0 -202
- package/src/tools/txt-hygiene-analysis.ts +0 -87
- package/src/tools/validate-fix.ts +0 -219
- package/src/tools/zone-hygiene-analysis.ts +0 -217
- package/src/types/env.d.ts +0 -6
- package/test/.!52131!.DS_Store +0 -0
- package/test/adaptive-weights.spec.ts +0 -359
- package/test/alerting.spec.ts +0 -91
- package/test/analytics-ip-hash.spec.ts +0 -90
- package/test/analytics-queries.spec.ts +0 -197
- package/test/analytics-stream.spec.ts +0 -32
- package/test/analytics.spec.ts +0 -205
- package/test/analyze-drift.spec.ts +0 -82
- package/test/assess-spoofability.spec.ts +0 -186
- package/test/audit.spec.ts +0 -250
- package/test/audits/fuzzing-config.audit.test.ts +0 -76
- package/test/audits/no-tracked-secrets.audit.test.ts +0 -166
- package/test/audits/oauth-readiness-gate.audit.test.ts +0 -83
- package/test/audits/tenant-capacity-readiness.audit.test.ts +0 -92
- package/test/audits/tenant-scale-quota.audit.test.ts +0 -35
- package/test/audits/tool-quota-coverage.audit.test.ts +0 -41
- package/test/audits/workflow-secret-check.audit.test.ts +0 -79
- package/test/auth.spec.ts +0 -94
- package/test/badge.spec.ts +0 -112
- package/test/batch-scan.spec.ts +0 -141
- package/test/caa-analysis.spec.ts +0 -24
- package/test/cache.spec.ts +0 -421
- package/test/category-interactions.spec.ts +0 -172
- package/test/chaos/fuzzing-degradation.chaos.test.ts +0 -50
- package/test/chaos/invariants.spec.ts +0 -181
- package/test/chaos/oauth-misconfiguration.chaos.test.ts +0 -132
- package/test/chaos/tenant-cron.chaos.test.ts +0 -276
- package/test/chaos/tenant-queue.chaos.test.ts +0 -272
- package/test/check-bimi.spec.ts +0 -160
- package/test/check-caa.spec.ts +0 -144
- package/test/check-cymru-asn.spec.ts +0 -239
- package/test/check-dane-https.spec.ts +0 -203
- package/test/check-dane.spec.ts +0 -234
- package/test/check-dbl.spec.ts +0 -214
- package/test/check-dkim.spec.ts +0 -413
- package/test/check-dmarc.spec.ts +0 -377
- package/test/check-dnssec-catch.spec.ts +0 -48
- package/test/check-dnssec-chain.spec.ts +0 -196
- package/test/check-dnssec.spec.ts +0 -271
- package/test/check-fast-flux.spec.ts +0 -201
- package/test/check-http-security.spec.ts +0 -420
- package/test/check-lookalikes.spec.ts +0 -860
- package/test/check-mta-sts.spec.ts +0 -196
- package/test/check-mx-reputation.spec.ts +0 -395
- package/test/check-mx.spec.ts +0 -183
- package/test/check-ns.spec.ts +0 -172
- package/test/check-nsec-walkability.spec.ts +0 -107
- package/test/check-rbl.spec.ts +0 -283
- package/test/check-rdap-lookup.spec.ts +0 -235
- package/test/check-resolver-consistency.spec.ts +0 -117
- package/test/check-shadow-domains.spec.ts +0 -883
- package/test/check-spf.spec.ts +0 -399
- package/test/check-srv.spec.ts +0 -160
- package/test/check-ssl.spec.ts +0 -192
- package/test/check-subdomailing.spec.ts +0 -308
- package/test/check-subdomain-takeover.spec.ts +0 -366
- package/test/check-svcb-https.spec.ts +0 -247
- package/test/check-tlsrpt.spec.ts +0 -70
- package/test/check-txt-hygiene.spec.ts +0 -414
- package/test/check-zone-hygiene.spec.ts +0 -234
- package/test/circuit-breaker.spec.ts +0 -171
- package/test/client-detection.spec.ts +0 -73
- package/test/compare-baseline.spec.ts +0 -221
- package/test/compare-domains.spec.ts +0 -46
- package/test/config.spec.ts +0 -216
- package/test/context-profiles.spec.ts +0 -215
- package/test/contracts/fuzzing-alert.contract.test.ts +0 -58
- package/test/contracts/oauth-tier.contract.test.ts +0 -53
- package/test/contracts/tenant-alerts.contract.test.ts +0 -79
- package/test/dane-analysis.spec.ts +0 -165
- package/test/data/batch_test.json +0 -1
- package/test/data/domains.json +0 -26976
- package/test/data/rescan_batch.json +0 -1
- package/test/data/sync_test.json +0 -1
- package/test/data/temp_sync_batch.json +0 -1
- package/test/discover-brand-domains.spec.ts +0 -215
- package/test/discover-subdomains.spec.ts +0 -382
- package/test/dispatch-reinitialize.spec.ts +0 -101
- package/test/dkim-analysis.spec.ts +0 -48
- package/test/dmarc-utils.spec.ts +0 -27
- package/test/dns-multi-resolver.spec.ts +0 -109
- package/test/dns-records-new.spec.ts +0 -244
- package/test/dns-records.spec.ts +0 -20
- package/test/dns-semaphore.spec.ts +0 -184
- package/test/dns-transport.spec.ts +0 -669
- package/test/dns.spec.ts +0 -118
- package/test/dnssec-analysis.spec.ts +0 -48
- package/test/env.d.ts +0 -3
- package/test/explain-finding.spec.ts +0 -578
- package/test/format-report.spec.ts +0 -273
- package/test/format-scan-report.spec.ts +0 -160
- package/test/freemium-limits.spec.ts +0 -102
- package/test/freemium-model.spec.ts +0 -143
- package/test/fuzzing-alert-dedup.test.ts +0 -82
- package/test/fuzzing-counter.integration.test.ts +0 -75
- package/test/fuzzing-detector.test.ts +0 -87
- package/test/fuzzing-e2e.integration.test.ts +0 -114
- package/test/generate-discovery-report.spec.ts +0 -337
- package/test/generate-fix-plan.spec.ts +0 -219
- package/test/generate-records.spec.ts +0 -241
- package/test/generate-rollout-plan.spec.ts +0 -261
- package/test/handlers-prompts.spec.ts +0 -96
- package/test/handlers-resources.spec.ts +0 -85
- package/test/handlers-tools.spec.ts +0 -1042
- package/test/helpers/dns-mock.ts +0 -155
- package/test/http-security-analysis.spec.ts +0 -242
- package/test/index.spec.ts +0 -1721
- package/test/intelligence.spec.ts +0 -217
- package/test/internal-guard.spec.ts +0 -34
- package/test/internal-tools-analytics-auth.test.ts +0 -102
- package/test/internal-tools-call-body-limit.test.ts +0 -45
- package/test/internal-trial-keys-auth.spec.ts +0 -99
- package/test/internal.spec.ts +0 -411
- package/test/ip-utils.spec.ts +0 -127
- package/test/kv-fallback-logging.spec.ts +0 -220
- package/test/legacy-session-validation.spec.ts +0 -113
- package/test/legacy-sse.spec.ts +0 -140
- package/test/log-cf-ip-redaction.test.ts +0 -30
- package/test/log.spec.ts +0 -189
- package/test/lookalike-analysis.spec.ts +0 -67
- package/test/map-compliance.spec.ts +0 -284
- package/test/map-supply-chain.spec.ts +0 -584
- package/test/maturity-staging.spec.ts +0 -312
- package/test/mcp-dispatch.spec.ts +0 -123
- package/test/mcp-execute.spec.ts +0 -1259
- package/test/mcp-request.spec.ts +0 -115
- package/test/mcp-route-gates.spec.ts +0 -88
- package/test/mta-sts-analysis.spec.ts +0 -74
- package/test/mx-analysis.spec.ts +0 -32
- package/test/mx-reputation-analysis.spec.ts +0 -116
- package/test/ns-analysis.spec.ts +0 -49
- package/test/oauth/authorize-get.spec.ts +0 -170
- package/test/oauth/authorize-post.spec.ts +0 -286
- package/test/oauth/authorize-zod-leak.test.ts +0 -40
- package/test/oauth/bearer-jwt.spec.ts +0 -152
- package/test/oauth/discovery.spec.ts +0 -51
- package/test/oauth/e2e.spec.ts +0 -141
- package/test/oauth/entitlements.spec.ts +0 -110
- package/test/oauth/internal-grant.spec.ts +0 -183
- package/test/oauth/jwt.spec.ts +0 -91
- package/test/oauth/pkce.spec.ts +0 -57
- package/test/oauth/register.spec.ts +0 -79
- package/test/oauth/storage.spec.ts +0 -74
- package/test/oauth/token.spec.ts +0 -270
- package/test/output-sanitize.spec.ts +0 -450
- package/test/package-api.spec.ts +0 -35
- package/test/profile-accumulator.spec.ts +0 -567
- package/test/provider-guides.spec.ts +0 -74
- package/test/provider-signature-source.spec.ts +0 -68
- package/test/provider-signatures.spec.ts +0 -112
- package/test/public-suffix.spec.ts +0 -197
- package/test/queue-consumer-analytics.spec.ts +0 -65
- package/test/quota-coordinator.spec.ts +0 -74
- package/test/rate-limit-chaos.spec.ts +0 -529
- package/test/rate-limiter-kv-reset.test.ts +0 -62
- package/test/rate-limiter-memory.spec.ts +0 -31
- package/test/rate-limiter-ttl.spec.ts +0 -100
- package/test/rate-limiter.spec.ts +0 -491
- package/test/resolve-spf-chain.spec.ts +0 -183
- package/test/safe-fetch.test.ts +0 -45
- package/test/sanitize.spec.ts +0 -233
- package/test/scan-domain-cache-status.test.ts +0 -128
- package/test/scan-domain-provider-inference.spec.ts +0 -93
- package/test/scan-domain-safe-check.spec.ts +0 -91
- package/test/scan-domain.spec.ts +0 -1063
- package/test/scan-post-processing.spec.ts +0 -663
- package/test/scheduled.spec.ts +0 -104
- package/test/schemas/audit.test.ts +0 -140
- package/test/schemas/auth.spec.ts +0 -36
- package/test/schemas/dns.spec.ts +0 -48
- package/test/schemas/internal.spec.ts +0 -50
- package/test/schemas/json-rpc.spec.ts +0 -63
- package/test/schemas/oauth.spec.ts +0 -104
- package/test/schemas/primitives.spec.ts +0 -131
- package/test/schemas/session.spec.ts +0 -21
- package/test/schemas/tenant-alerts.test.ts +0 -126
- package/test/schemas/tenant-internal.test.ts +0 -128
- package/test/schemas/tool-args.spec.ts +0 -166
- package/test/schemas/tool-definitions.spec.ts +0 -67
- package/test/scoring-config-cached.spec.ts +0 -63
- package/test/scoring-config.spec.ts +0 -177
- package/test/scoring-determinism.spec.ts +0 -162
- package/test/scoring-engine.spec.ts +0 -134
- package/test/scoring-model.spec.ts +0 -44
- package/test/scoring-profiles.spec.ts +0 -235
- package/test/scoring.spec.ts +0 -197
- package/test/security-hardening.spec.ts +0 -58
- package/test/session-degradation-event.spec.ts +0 -66
- package/test/session-keepalive.spec.ts +0 -347
- package/test/session-kv-failure-logging.spec.ts +0 -99
- package/test/session-memory.spec.ts +0 -111
- package/test/session-recovery.spec.ts +0 -260
- package/test/session.spec.ts +0 -266
- package/test/simulate-attack-paths.spec.ts +0 -888
- package/test/spf-analysis.spec.ts +0 -29
- package/test/spf-trust-surface.spec.ts +0 -62
- package/test/srv-analysis.spec.ts +0 -151
- package/test/sse.spec.ts +0 -44
- package/test/ssl-analysis.spec.ts +0 -27
- package/test/stdio.spec.ts +0 -71
- package/test/streaming-sse.spec.ts +0 -419
- package/test/subdomain-takeover-analysis.spec.ts +0 -104
- package/test/tenants/alerts/diff.test.ts +0 -127
- package/test/tenants/alerts/webhook.test.ts +0 -129
- package/test/tenants/audit.test.ts +0 -220
- package/test/tenants/cron.integration.test.ts +0 -117
- package/test/tenants/db/registry-schema.spec.ts +0 -254
- package/test/tenants/db/tenant-schema.spec.ts +0 -202
- package/test/tenants/discovery/dkim-key-reuse.test.ts +0 -213
- package/test/tenants/discovery/dmarc-rua-miner.test.ts +0 -179
- package/test/tenants/discovery/ns-correlator.test.ts +0 -186
- package/test/tenants/discovery/san-correlator.test.ts +0 -128
- package/test/tenants/discovery-route.integration.test.ts +0 -135
- package/test/tenants/dns-fingerprint.test.ts +0 -321
- package/test/tenants/hammer-stress.integration.test.ts +0 -136
- package/test/tenants/per-tenant-rate-limit.test.ts +0 -119
- package/test/tenants/phase6-fingerprint.integration.test.ts +0 -147
- package/test/tenants/provision-tenant.test.ts +0 -351
- package/test/tenants/queue-consumer.integration.test.ts +0 -355
- package/test/tenants/queue-producer.integration.test.ts +0 -219
- package/test/tenants/routes.integration.test.ts +0 -783
- package/test/tenants/scheduled-handlers.integration.test.ts +0 -713
- package/test/tenants/tenant-d1.spec.ts +0 -78
- package/test/tenants/tenant-kv.spec.ts +0 -104
- package/test/tenants/tenant-r2.spec.ts +0 -103
- package/test/tier-auth-jwt-enum.test.ts +0 -55
- package/test/tier-auth-owner-jwt-ip.test.ts +0 -80
- package/test/tier-auth.spec.ts +0 -191
- package/test/tool-args.spec.ts +0 -101
- package/test/tool-execution.spec.ts +0 -421
- package/test/tool-formatters.spec.ts +0 -84
- package/test/tool-metadata.spec.ts +0 -25
- package/test/tool-schemas.spec.ts +0 -113
- package/test/trial-keys.spec.ts +0 -367
- package/test/tsconfig.json +0 -8
- package/test/txt-hygiene-analysis.spec.ts +0 -118
- package/test/validate-fix.spec.ts +0 -71
- package/test/validate-outbound-url.test.ts +0 -63
- package/test/wasm-integration.test.ts +0 -32
- package/test/zone-hygiene-analysis.spec.ts +0 -172
- package/tsconfig.json +0 -40
- package/tsup.config.ts +0 -42
- package/vitest.config.mts +0 -33
- package/wrangler.jsonc +0 -70
- package/wrangler.private.example.jsonc +0 -31
package/src/tools/mx-analysis.ts
DELETED
|
@@ -1,55 +0,0 @@
|
|
|
1
|
-
// SPDX-License-Identifier: BUSL-1.1
|
|
2
|
-
|
|
3
|
-
import type { Finding } from '../lib/scoring';
|
|
4
|
-
import { createFinding } from '../lib/scoring';
|
|
5
|
-
|
|
6
|
-
export type ParsedMxRecord = {
|
|
7
|
-
priority: number;
|
|
8
|
-
exchange: string;
|
|
9
|
-
raw: string;
|
|
10
|
-
};
|
|
11
|
-
|
|
12
|
-
export function parseMxRecords(answers: string[]): ParsedMxRecord[] {
|
|
13
|
-
return answers.map((answer) => {
|
|
14
|
-
const parts = answer.split(' ');
|
|
15
|
-
const priority = parseInt(parts[0], 10);
|
|
16
|
-
const exchange = (parts.slice(1).join(' ') || '').replace(/\.$/, '').toLowerCase();
|
|
17
|
-
return { priority, exchange, raw: answer };
|
|
18
|
-
});
|
|
19
|
-
}
|
|
20
|
-
|
|
21
|
-
export function isNullMxRecord(record: ParsedMxRecord): boolean {
|
|
22
|
-
return record.exchange === '' || record.exchange === '.';
|
|
23
|
-
}
|
|
24
|
-
|
|
25
|
-
export function getNullMxFinding(): Finding {
|
|
26
|
-
return createFinding('mx', 'Null MX record (RFC 7505)', 'info', 'Domain explicitly declares it does not accept email via null MX record.');
|
|
27
|
-
}
|
|
28
|
-
|
|
29
|
-
export function getPresenceFinding(mxRecords: ParsedMxRecord[]): Finding {
|
|
30
|
-
return createFinding('mx', 'MX records found', 'info', `${mxRecords.length} mail exchange record(s) present.`);
|
|
31
|
-
}
|
|
32
|
-
|
|
33
|
-
export function getIpTargetFindings(mxRecords: ParsedMxRecord[]): Finding[] {
|
|
34
|
-
const ipPattern = /^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/;
|
|
35
|
-
return mxRecords.flatMap((mxRecord) =>
|
|
36
|
-
ipPattern.test(mxRecord.exchange)
|
|
37
|
-
? [
|
|
38
|
-
createFinding(
|
|
39
|
-
'mx',
|
|
40
|
-
'MX points to IP address',
|
|
41
|
-
'medium',
|
|
42
|
-
`MX record "${mxRecord.raw}" points to an IP address. MX targets must be hostnames per RFC 5321.`,
|
|
43
|
-
),
|
|
44
|
-
]
|
|
45
|
-
: [],
|
|
46
|
-
);
|
|
47
|
-
}
|
|
48
|
-
|
|
49
|
-
export function getSingleMxFinding(mxRecords: ParsedMxRecord[]): Finding | null {
|
|
50
|
-
if (mxRecords.length !== 1) {
|
|
51
|
-
return null;
|
|
52
|
-
}
|
|
53
|
-
|
|
54
|
-
return createFinding('mx', 'Single MX record', 'low', 'Only one MX record found. Consider adding a backup MX for redundancy.');
|
|
55
|
-
}
|
|
@@ -1,205 +0,0 @@
|
|
|
1
|
-
// SPDX-License-Identifier: BUSL-1.1
|
|
2
|
-
|
|
3
|
-
/**
|
|
4
|
-
* Pure analysis functions for MX reputation checking.
|
|
5
|
-
* Handles PTR record validation, FCrDNS verification, and DNSBL result interpretation.
|
|
6
|
-
*/
|
|
7
|
-
|
|
8
|
-
import type { Finding } from '../lib/scoring';
|
|
9
|
-
import { createFinding } from '../lib/scoring';
|
|
10
|
-
|
|
11
|
-
/** Pattern matching generic/residential PTR hostnames */
|
|
12
|
-
const GENERIC_PTR_PATTERN = /^(ip-|host-|static-|dynamic-|dhcp|dsl|cable|pool|customer|client|user|broadband)/i;
|
|
13
|
-
|
|
14
|
-
/**
|
|
15
|
-
* Known shared email provider MX hostname suffixes.
|
|
16
|
-
* IPs behind these hostnames are shared infrastructure — DNSBL listings reflect
|
|
17
|
-
* the platform's aggregate traffic, not any individual customer domain's reputation.
|
|
18
|
-
*/
|
|
19
|
-
const SHARED_PROVIDER_MX_SUFFIXES: Array<{ suffix: string; provider: string }> = [
|
|
20
|
-
{ suffix: '.google.com', provider: 'Google Workspace' },
|
|
21
|
-
{ suffix: '.googlemail.com', provider: 'Google Workspace' },
|
|
22
|
-
{ suffix: '.1e100.net', provider: 'Google Workspace' },
|
|
23
|
-
{ suffix: '.outlook.com', provider: 'Microsoft 365' },
|
|
24
|
-
{ suffix: '.protection.outlook.com', provider: 'Microsoft 365' },
|
|
25
|
-
{ suffix: '.pphosted.com', provider: 'Proofpoint' },
|
|
26
|
-
{ suffix: '.mimecast.com', provider: 'Mimecast' },
|
|
27
|
-
{ suffix: '.mailgun.org', provider: 'Mailgun' },
|
|
28
|
-
{ suffix: '.sendgrid.net', provider: 'SendGrid' },
|
|
29
|
-
{ suffix: '.amazonses.com', provider: 'Amazon SES' },
|
|
30
|
-
{ suffix: '.messagelabs.com', provider: 'Symantec/Broadcom' },
|
|
31
|
-
{ suffix: '.fireeyecloud.com', provider: 'Trellix' },
|
|
32
|
-
{ suffix: '.iphmx.com', provider: 'Cisco IronPort' },
|
|
33
|
-
];
|
|
34
|
-
|
|
35
|
-
/**
|
|
36
|
-
* Check if an MX hostname belongs to a known shared email provider.
|
|
37
|
-
*
|
|
38
|
-
* @param mxHost - The MX exchange hostname (e.g., "smtp-in.l.google.com")
|
|
39
|
-
* @returns The provider name if matched, or null if the host is dedicated infrastructure
|
|
40
|
-
*/
|
|
41
|
-
export function detectSharedMxProvider(mxHost: string): string | null {
|
|
42
|
-
const normalized = mxHost.trim().toLowerCase().replace(/\.$/, '');
|
|
43
|
-
if (!normalized) return null;
|
|
44
|
-
for (const { suffix, provider } of SHARED_PROVIDER_MX_SUFFIXES) {
|
|
45
|
-
if (normalized === suffix.slice(1) || normalized.endsWith(suffix)) {
|
|
46
|
-
return provider;
|
|
47
|
-
}
|
|
48
|
-
}
|
|
49
|
-
return null;
|
|
50
|
-
}
|
|
51
|
-
|
|
52
|
-
/**
|
|
53
|
-
* Analyze PTR (reverse DNS) records for an MX server IP.
|
|
54
|
-
*
|
|
55
|
-
* Checks for:
|
|
56
|
-
* - Missing PTR records (no reverse DNS)
|
|
57
|
-
* - Forward-confirmed reverse DNS (FCrDNS) failure
|
|
58
|
-
* - Generic/residential PTR hostnames
|
|
59
|
-
* - Valid PTR matching forward DNS
|
|
60
|
-
*
|
|
61
|
-
* @param ip - The MX server IP address
|
|
62
|
-
* @param ptrHostnames - PTR record hostnames for the IP
|
|
63
|
-
* @param forwardIps - IPs resolved from PTR hostnames (for FCrDNS verification)
|
|
64
|
-
* @returns Array of findings from PTR analysis
|
|
65
|
-
*/
|
|
66
|
-
export function analyzePtrRecords(ip: string, ptrHostnames: string[], forwardIps: string[]): Finding[] {
|
|
67
|
-
const findings: Finding[] = [];
|
|
68
|
-
|
|
69
|
-
if (ptrHostnames.length === 0) {
|
|
70
|
-
findings.push(
|
|
71
|
-
createFinding(
|
|
72
|
-
'mx_reputation',
|
|
73
|
-
`No PTR record for MX server ${ip}`,
|
|
74
|
-
'medium',
|
|
75
|
-
`IP ${ip} has no reverse DNS (PTR) record. Mail servers without PTR records are frequently rejected by receiving servers.`,
|
|
76
|
-
{ ip },
|
|
77
|
-
),
|
|
78
|
-
);
|
|
79
|
-
return findings;
|
|
80
|
-
}
|
|
81
|
-
|
|
82
|
-
// Check FCrDNS — PTR hostname must resolve back to the original IP
|
|
83
|
-
const hasFcrDns = forwardIps.includes(ip);
|
|
84
|
-
|
|
85
|
-
if (!hasFcrDns) {
|
|
86
|
-
findings.push(
|
|
87
|
-
createFinding(
|
|
88
|
-
'mx_reputation',
|
|
89
|
-
`PTR does not match forward DNS for ${ip}`,
|
|
90
|
-
'medium',
|
|
91
|
-
`IP ${ip} has PTR record(s) (${ptrHostnames.join(', ')}), but none resolve back to ${ip}. Forward-confirmed reverse DNS (FCrDNS) failure reduces deliverability.`,
|
|
92
|
-
{ ip, ptrHostnames, forwardIps },
|
|
93
|
-
),
|
|
94
|
-
);
|
|
95
|
-
}
|
|
96
|
-
|
|
97
|
-
// Check for generic/residential PTR patterns
|
|
98
|
-
for (const hostname of ptrHostnames) {
|
|
99
|
-
if (GENERIC_PTR_PATTERN.test(hostname)) {
|
|
100
|
-
findings.push(
|
|
101
|
-
createFinding(
|
|
102
|
-
'mx_reputation',
|
|
103
|
-
'MX uses generic PTR hostname',
|
|
104
|
-
'low',
|
|
105
|
-
`PTR hostname "${hostname}" for IP ${ip} matches a generic/residential naming pattern. This may reduce email deliverability.`,
|
|
106
|
-
{ ip, hostname },
|
|
107
|
-
),
|
|
108
|
-
);
|
|
109
|
-
}
|
|
110
|
-
}
|
|
111
|
-
|
|
112
|
-
// If FCrDNS passed and no generic PTR, add info finding
|
|
113
|
-
if (hasFcrDns && !ptrHostnames.some((h) => GENERIC_PTR_PATTERN.test(h))) {
|
|
114
|
-
findings.push(
|
|
115
|
-
createFinding(
|
|
116
|
-
'mx_reputation',
|
|
117
|
-
`Reverse DNS valid for ${ip}`,
|
|
118
|
-
'info',
|
|
119
|
-
`IP ${ip} has valid PTR record (${ptrHostnames.join(', ')}) that matches forward DNS.`,
|
|
120
|
-
{ ip, ptrHostnames },
|
|
121
|
-
),
|
|
122
|
-
);
|
|
123
|
-
}
|
|
124
|
-
|
|
125
|
-
return findings;
|
|
126
|
-
}
|
|
127
|
-
|
|
128
|
-
/**
|
|
129
|
-
* Analyze DNSBL lookup results for an MX server IP.
|
|
130
|
-
*
|
|
131
|
-
* When the MX host belongs to a known shared email provider (e.g., Google Workspace,
|
|
132
|
-
* Microsoft 365), DNSBL listings are downgraded from `high` to `info` because the
|
|
133
|
-
* listed IPs are shared infrastructure — their blocklist status reflects aggregate
|
|
134
|
-
* platform traffic, not the individual domain's sending reputation.
|
|
135
|
-
*
|
|
136
|
-
* @param ip - The MX server IP address
|
|
137
|
-
* @param listings - Array of DNSBL zone check results
|
|
138
|
-
* @param sharedProvider - If non-null, the name of the shared provider (triggers downgrade)
|
|
139
|
-
* @returns Array of findings from DNSBL analysis
|
|
140
|
-
*/
|
|
141
|
-
export function analyzeDnsblResults(
|
|
142
|
-
ip: string,
|
|
143
|
-
listings: Array<{ zone: string; listed: boolean }>,
|
|
144
|
-
sharedProvider?: string | null,
|
|
145
|
-
): Finding[] {
|
|
146
|
-
const findings: Finding[] = [];
|
|
147
|
-
const listedZones = listings.filter((l) => l.listed);
|
|
148
|
-
|
|
149
|
-
if (listedZones.length > 0) {
|
|
150
|
-
for (const listing of listedZones) {
|
|
151
|
-
if (sharedProvider) {
|
|
152
|
-
findings.push(
|
|
153
|
-
createFinding(
|
|
154
|
-
'mx_reputation',
|
|
155
|
-
`Shared ${sharedProvider} IP listed on ${listing.zone} (informational)`,
|
|
156
|
-
'info',
|
|
157
|
-
`IP ${ip} is listed on DNSBL ${listing.zone}, but this is a shared ${sharedProvider} IP. DNSBL listings on shared email infrastructure reflect the provider's aggregate traffic, not your domain's individual reputation. Your sending reputation is managed at the account level by ${sharedProvider}.`,
|
|
158
|
-
{ ip, zone: listing.zone, sharedProvider },
|
|
159
|
-
),
|
|
160
|
-
);
|
|
161
|
-
} else {
|
|
162
|
-
findings.push(
|
|
163
|
-
createFinding(
|
|
164
|
-
'mx_reputation',
|
|
165
|
-
`MX server IP listed on ${listing.zone}`,
|
|
166
|
-
'high',
|
|
167
|
-
`IP ${ip} is listed on DNSBL ${listing.zone}. Blacklisted mail servers will have significantly degraded email deliverability.`,
|
|
168
|
-
{ ip, zone: listing.zone },
|
|
169
|
-
),
|
|
170
|
-
);
|
|
171
|
-
}
|
|
172
|
-
}
|
|
173
|
-
} else {
|
|
174
|
-
findings.push(
|
|
175
|
-
createFinding(
|
|
176
|
-
'mx_reputation',
|
|
177
|
-
`MX reputation clean for ${ip}`,
|
|
178
|
-
'info',
|
|
179
|
-
`IP ${ip} is not listed on any checked DNSBLs (${listings.map((l) => l.zone).join(', ')}).`,
|
|
180
|
-
{ ip, zones: listings.map((l) => l.zone) },
|
|
181
|
-
),
|
|
182
|
-
);
|
|
183
|
-
}
|
|
184
|
-
|
|
185
|
-
return findings;
|
|
186
|
-
}
|
|
187
|
-
|
|
188
|
-
/**
|
|
189
|
-
* Return the list of DNSBL zones to check.
|
|
190
|
-
* These are well-known, reliable blocklists with publicly queryable DNS interfaces.
|
|
191
|
-
*/
|
|
192
|
-
export function buildDnsblZones(): string[] {
|
|
193
|
-
return ['zen.spamhaus.org', 'bl.spamcop.net', 'b.barracudacentral.org'];
|
|
194
|
-
}
|
|
195
|
-
|
|
196
|
-
/**
|
|
197
|
-
* Reverse IPv4 octets for DNSBL lookup.
|
|
198
|
-
* Example: `192.0.2.1` becomes `1.2.0.192`
|
|
199
|
-
*
|
|
200
|
-
* @param ip - IPv4 address string
|
|
201
|
-
* @returns Reversed octet string
|
|
202
|
-
*/
|
|
203
|
-
export function reverseIpForDnsbl(ip: string): string {
|
|
204
|
-
return ip.split('.').reverse().join('.');
|
|
205
|
-
}
|
package/src/tools/ns-analysis.ts
DELETED
|
@@ -1,162 +0,0 @@
|
|
|
1
|
-
// SPDX-License-Identifier: BUSL-1.1
|
|
2
|
-
|
|
3
|
-
import type { Finding } from '../lib/scoring';
|
|
4
|
-
import { createFinding } from '../lib/scoring';
|
|
5
|
-
|
|
6
|
-
const RESILIENT_NS_PROVIDERS: Record<string, string> = {
|
|
7
|
-
'cloudflare.com':
|
|
8
|
-
"Cloudflare's anycast network provides built-in geographic redundancy, so this is lower risk than single-provider setups on traditional DNS hosts.",
|
|
9
|
-
'awsdns.com': "AWS Route 53's anycast network provides built-in geographic redundancy, so this is lower risk than single-provider setups on traditional DNS hosts.",
|
|
10
|
-
'google.com':
|
|
11
|
-
'Google Cloud DNS uses globally distributed authoritative infrastructure, so this is lower risk than single-provider setups on traditional DNS hosts.',
|
|
12
|
-
};
|
|
13
|
-
|
|
14
|
-
export type ParsedSoaValues = {
|
|
15
|
-
refresh: number | null;
|
|
16
|
-
retry: number | null;
|
|
17
|
-
expire: number | null;
|
|
18
|
-
minimum: number | null;
|
|
19
|
-
};
|
|
20
|
-
|
|
21
|
-
export function normalizeNsRecords(nsRecords: string[]): string[] {
|
|
22
|
-
return nsRecords.map((record) => record.replace(/\.$/, '').toLowerCase());
|
|
23
|
-
}
|
|
24
|
-
|
|
25
|
-
export function getNsVisibilityFinding(domain: string, domainResolves: boolean): Finding {
|
|
26
|
-
if (domainResolves) {
|
|
27
|
-
return createFinding(
|
|
28
|
-
'ns',
|
|
29
|
-
'NS records not directly visible',
|
|
30
|
-
'low',
|
|
31
|
-
`No NS records returned for ${domain} directly, but the domain resolves. NS records may be managed at a parent zone.`,
|
|
32
|
-
);
|
|
33
|
-
}
|
|
34
|
-
|
|
35
|
-
return createFinding(
|
|
36
|
-
'ns',
|
|
37
|
-
'No NS records found',
|
|
38
|
-
'critical',
|
|
39
|
-
`No nameserver records found for ${domain}. Without NS records, the domain cannot resolve.`,
|
|
40
|
-
);
|
|
41
|
-
}
|
|
42
|
-
|
|
43
|
-
export function getSingleNsFinding(nsRecords: string[]): Finding | null {
|
|
44
|
-
if (nsRecords.length !== 1) {
|
|
45
|
-
return null;
|
|
46
|
-
}
|
|
47
|
-
|
|
48
|
-
return createFinding(
|
|
49
|
-
'ns',
|
|
50
|
-
'Single nameserver (violates RFC 1035 §2.2)',
|
|
51
|
-
'high',
|
|
52
|
-
`Only one nameserver found (${nsRecords[0]}). RFC 1035 §2.2 mandates at least two nameservers for every zone to ensure redundancy and availability.`,
|
|
53
|
-
);
|
|
54
|
-
}
|
|
55
|
-
|
|
56
|
-
export function getNameserverDiversityFinding(nsRecords: string[]): Finding | null {
|
|
57
|
-
const providerDomains = new Set(
|
|
58
|
-
nsRecords.map((record) => {
|
|
59
|
-
const parts = record.split('.');
|
|
60
|
-
return parts.slice(-2).join('.');
|
|
61
|
-
}),
|
|
62
|
-
);
|
|
63
|
-
|
|
64
|
-
if (providerDomains.size !== 1 || nsRecords.length <= 1) {
|
|
65
|
-
return null;
|
|
66
|
-
}
|
|
67
|
-
|
|
68
|
-
const providerDomain = [...providerDomains][0];
|
|
69
|
-
const providerContext =
|
|
70
|
-
RESILIENT_NS_PROVIDERS[providerDomain] ?? 'Consider using nameservers from different providers for better resilience.';
|
|
71
|
-
|
|
72
|
-
return createFinding(
|
|
73
|
-
'ns',
|
|
74
|
-
'Low nameserver diversity',
|
|
75
|
-
'low',
|
|
76
|
-
`All nameservers are under ${providerDomain}. ${providerContext} For maximum independence, a secondary DNS provider can be added.`,
|
|
77
|
-
);
|
|
78
|
-
}
|
|
79
|
-
|
|
80
|
-
export function parseSoaValues(soaData: string): ParsedSoaValues | null {
|
|
81
|
-
const soaParts = soaData.trim().split(/\s+/);
|
|
82
|
-
if (soaParts.length < 7) {
|
|
83
|
-
return null;
|
|
84
|
-
}
|
|
85
|
-
|
|
86
|
-
const refresh = parseInt(soaParts[3], 10);
|
|
87
|
-
const retry = parseInt(soaParts[4], 10);
|
|
88
|
-
const expire = parseInt(soaParts[5], 10);
|
|
89
|
-
const minimum = parseInt(soaParts[6], 10);
|
|
90
|
-
|
|
91
|
-
return {
|
|
92
|
-
refresh: Number.isNaN(refresh) ? null : refresh,
|
|
93
|
-
retry: Number.isNaN(retry) ? null : retry,
|
|
94
|
-
expire: Number.isNaN(expire) ? null : expire,
|
|
95
|
-
minimum: Number.isNaN(minimum) ? null : minimum,
|
|
96
|
-
};
|
|
97
|
-
}
|
|
98
|
-
|
|
99
|
-
export function getSoaValidationFindings(soaValues: ParsedSoaValues): Finding[] {
|
|
100
|
-
const findings: Finding[] = [];
|
|
101
|
-
|
|
102
|
-
if (soaValues.refresh !== null) {
|
|
103
|
-
if (soaValues.refresh < 300) {
|
|
104
|
-
findings.push(
|
|
105
|
-
createFinding(
|
|
106
|
-
'ns',
|
|
107
|
-
'SOA refresh interval too short',
|
|
108
|
-
'low',
|
|
109
|
-
`SOA refresh interval is ${soaValues.refresh}s (< 300s / 5 min). Very short refresh intervals increase DNS traffic and load on nameservers.`,
|
|
110
|
-
),
|
|
111
|
-
);
|
|
112
|
-
} else if (soaValues.refresh > 86400) {
|
|
113
|
-
findings.push(
|
|
114
|
-
createFinding(
|
|
115
|
-
'ns',
|
|
116
|
-
'SOA refresh interval too long',
|
|
117
|
-
'low',
|
|
118
|
-
`SOA refresh interval is ${soaValues.refresh}s (> 86400s / 1 day). Long refresh intervals delay propagation of zone changes to secondary nameservers.`,
|
|
119
|
-
),
|
|
120
|
-
);
|
|
121
|
-
}
|
|
122
|
-
}
|
|
123
|
-
|
|
124
|
-
if (soaValues.retry !== null && soaValues.refresh !== null && soaValues.retry > soaValues.refresh) {
|
|
125
|
-
findings.push(
|
|
126
|
-
createFinding(
|
|
127
|
-
'ns',
|
|
128
|
-
'SOA retry exceeds refresh interval',
|
|
129
|
-
'low',
|
|
130
|
-
`SOA retry interval (${soaValues.retry}s) exceeds refresh interval (${soaValues.refresh}s). Retry should be shorter than refresh to allow timely recovery after failed zone transfers.`,
|
|
131
|
-
),
|
|
132
|
-
);
|
|
133
|
-
}
|
|
134
|
-
|
|
135
|
-
if (soaValues.expire !== null && soaValues.expire < 604800) {
|
|
136
|
-
findings.push(
|
|
137
|
-
createFinding(
|
|
138
|
-
'ns',
|
|
139
|
-
'SOA expire too short',
|
|
140
|
-
'medium',
|
|
141
|
-
`SOA expire value is ${soaValues.expire}s (< 604800s / 1 week). If secondary nameservers cannot reach the primary for this duration, they will stop serving the zone.`,
|
|
142
|
-
),
|
|
143
|
-
);
|
|
144
|
-
}
|
|
145
|
-
|
|
146
|
-
if (soaValues.minimum !== null && soaValues.minimum > 86400) {
|
|
147
|
-
findings.push(
|
|
148
|
-
createFinding(
|
|
149
|
-
'ns',
|
|
150
|
-
'SOA negative cache TTL too long',
|
|
151
|
-
'low',
|
|
152
|
-
`SOA minimum (negative cache TTL) is ${soaValues.minimum}s (> 86400s / 1 day). This means NXDOMAIN responses will be cached for extended periods, delaying visibility of new records.`,
|
|
153
|
-
),
|
|
154
|
-
);
|
|
155
|
-
}
|
|
156
|
-
|
|
157
|
-
return findings;
|
|
158
|
-
}
|
|
159
|
-
|
|
160
|
-
export function getNsConfiguredFinding(nsRecords: string[]): Finding {
|
|
161
|
-
return createFinding('ns', 'Nameservers properly configured', 'info', `${nsRecords.length} nameservers found: ${nsRecords.join(', ')}`);
|
|
162
|
-
}
|