@defen.so/scan

@defen.so/scan

Fast, template-based web security scanner for the terminal and CI. Scan any URL for exposed secrets, weak security headers, missing HSTS/CSP, insecure cookies, exposed .env/.git files and TLS issues — graded, with SARIF and JSON output for GitHub code scanning. Zero config, no account to start.

npx @defen.so/scan example.com

defenso-scan v0.1.0  https://example.com/
28 templates · 200 · https
Grade  B     0 crit  0 high 2 med 2 low 1 info

 MED   Content-Security-Policy missing CWE-1021
      No Content-Security-Policy header — reflected/stored XSS is harder to contain.
      fix Add a Content-Security-Policy, starting with "default-src 'self'".

 MED   HSTS not set CWE-319
      No Strict-Transport-Security header on an HTTPS response.
      fix Add "Strict-Transport-Security: max-age=63072000; includeSubDomains".
 ...

Why

A public one-off scanner only sees the anonymous view of a site, and most CLI scanners are heavy to set up. @defen.so/scan is a single command: it runs a set of deterministic, evidence-based templates locally (nothing about your target leaves your machine for the local checks) and augments the result with the Defenso hosted grade. Every finding is real, carries a severity, a CWE, the evidence that matched, and a concrete fix — nothing is hallucinated.

Install

# run without installing
npx @defen.so/scan example.com

# or install globally
npm i -g @defen.so/scan
defenso-scan example.com

Requires Node 18+.

Usage

defenso-scan <url> [url2 ...] [options]

Option	What it does
--json	Full report as JSON
--sarif	SARIF 2.1.0 for GitHub code scanning / CI
--fail-on <sev>	Exit non-zero if a finding at/above <sev> exists (info|low|medium|high|critical)
--crawl <n>	Also scan up to n same-origin pages
--active	Run the safe active checks (error-based SQLi probe)
--cookie <str>	Send a Cookie header — scan behind your login
--bearer <token>	Send Authorization: Bearer <token>
--basic <u:p>	HTTP Basic auth
--auth-header <h>	Add a raw request header "Name: value" (repeatable)
--no-paths	Skip probing sensitive files (.env/.git/…)
--no-deep	Skip deep surface checks
--offline	Local checks only; skip the hosted grade
--timeout <ms>	Per-request timeout (default 12000)
-q, --quiet	Only print findings
-v, -h	Version / help

Runs from your machine — no WAF/Cloudflare to configure

Because the scanner runs from your network, a WAF or Cloudflare that would block an external scanner doesn't block it — and you can point it behind your own login with --cookie / --bearer, reaching the authenticated pages an outside pentest never sees:

# scan the app behind your session
npx @defen.so/scan https://app.example.com --cookie "session=…" --crawl 10

What it checks

Templates are grouped by class, each with a severity and CWE:

• Security headers — HSTS, Content-Security-Policy (missing + unsafe-inline), X-Content-Type-Options, X-Frame-Options / clickjacking, Referrer-Policy, server-version disclosure, CORS wildcard-with-credentials.
• Cookies — session cookies missing Secure, HttpOnly, SameSite.
• Exposed secrets in page source — AWS, Stripe, GitHub, Slack, OpenAI, Anthropic, SendGrid, Twilio, Mailgun keys, private-key blocks, Supabase service_role, JWTs, credentials in URLs (public-by-design keys like Firebase/Maps are noted, not falsely alarmed).
• Exposed files — .env, .git/config, .git/HEAD, .env.bak, config.json, .DS_Store, Dockerfile, SQL backups (verified as real files, not SPA fallbacks).
• Surface & misconfig — missing security.txt, directory listing enabled, exposed JavaScript source maps (leaked original source).
• Active (opt-in --active) — a safe, error-based SQL-injection probe (appends a quote, looks for a reflected DB error — never extracts data).
• Tech fingerprint — detects WordPress, Next.js, Laravel, Nuxt, React, PHP so findings are in context.

Findings are graded A–F, with a multi-page crawl (--crawl) and authenticated scanning (--cookie/--bearer). Add DEFENSO_TOKEN (get one at app.defen.so/developer) for the full hosted report; without it you still get every local check plus a free daily hosted grade.

CI / GitHub code scanning

Emit SARIF and upload it so findings show in the Security tab:

# .github/workflows/security-scan.yml
name: Security scan
on: [push, pull_request]
jobs:
  scan:
    runs-on: ubuntu-latest
    permissions:
      security-events: write
    steps:
      - run: npx @defen.so/scan ${{ vars.TARGET_URL }} --sarif > results.sarif
      - uses: github/codeql-action/upload-sarif@v3
        with:
          sarif_file: results.sarif

Or gate a pipeline directly:

npx @defen.so/scan example.com --fail-on high   # exit 1 if any high/critical

Programmatic use

import { scan } from '@defen.so/scan';

const report = await scan('https://example.com', { paths: true, hosted: false });
console.log(report.grade, report.findings);

The Defenso platform

This scanner is one entry point. The full platform adds continuous pentests, a managed WAF with API rate limiting, uptime + SSL/domain-expiry monitoring, GitHub/GitLab repo secret scanning, a compliance generator, and an MCP server that gives Claude Code, Cursor and Windsurf the same checks inside your editor.

• Website: https://defen.so
• Scanner page: https://defen.so/online-website-security-scanner
• MCP for AI editors: npx @defen.so/mcp
• One-line WAF install: npx @defen.so/init

License

MIT © Next Lab LLC