Skip to content

Security: elkimek/get-based

SECURITY.md

Security Policy

Reporting a Vulnerability

If you discover a security vulnerability in getbased, please report it privately via GitHub Security Advisories.

Do not open a public issue for security vulnerabilities.

I'll acknowledge receipt within 48 hours and aim to release a fix within 7 days for critical issues.

Scope

  • Application code (HTML, CSS, TypeScript, and generated JavaScript)
  • Data handling (localStorage, encryption, PII obfuscation)
  • AI API key management
  • Cross-device sync (Evolu relay)
  • Operated compatibility proxy (integrations.getbased.health)
  • Operated encrypted profile-share service (shares.getbased.health)
  • PDF import pipeline

Out of Scope

  • Third-party AI provider APIs (report directly to the provider)
  • Self-hosted relay infrastructure (report to the relay operator)
  • Browser vulnerabilities

Data Architecture

getbased is local-first. Health data stays in browser storage by default; optional network features activate only when the user chooses them. Cross-device sync uses end-to-end encrypted CRDT replication, so its relay sees ciphertext. Profile sharing encrypts a selected export in the browser before upload. The operated profile-share service stores only the opaque envelope and minimal expiry, deletion, and keyed abuse-control metadata in an isolated SQLite database; it never receives the share password or decrypted profile. The initial operated service keeps no retained database backup so a restore cannot resurrect stopped or expired links; an infrastructure loss may invalidate these temporary copies without affecting the browser-held source profile. Existing Blob records are served only through a fixed, at-most-31-day transition window and are not copied into the new database.

Supported AI, voice, local-server, Knowledge Base, Cashu, and weather credentials are never deliberately persisted as plaintext. With passphrase protection off, encryptedSetCredentialItem wraps them with AES-256-GCM under a non-exportable, browser-device key; if that protection is unavailable, new credentials remain memory-only. With passphrase protection on, sensitive profile data and supported credentials use the PBKDF2-derived AES-256-GCM key. Wearable OAuth tokens use a separate per-profile device-local vault and are excluded from sync and backups.

The operated compatibility proxy accepts only policy-classified wearable, CAMS, NRAS, and credential-free public-page operations. It is not a generic AI, voice, or Custom API proxy and does not intentionally persist or log forwarded payloads.

Companion updates

Companion in-app updates verify the exact downloaded bundle with a pinned Ed25519 public key before inspecting its version or installing it. Release builds pin the public key through GETBASED_COMPANION_UPDATE_PUBLIC_KEY and produce the detached getbased-companion.mjs.sig artifact when the corresponding GETBASED_COMPANION_SIGNING_PRIVATE_KEY is available to the release build. Publish the bundle and signature together. Builds without a pinned update key use the manual installation path.

Dependency Monitoring

The Svelte build plugin's deepmerge import is overridden with the private @getbased/svelte-config-merge compatibility package under scripts/vendor-packages/. It derives from deepmerge 4.3.1 and retains its MIT license and config-merge behavior while rejecting prototype-related keys from both inputs before writing own properties. This addresses CVE-2026-93753 without claiming an upstream patched release. Its regression tests cover poisoned target and source objects, null placeholders, nested arrays and the plugin's actual dependency resolution. Keep this override until the plugin removes the affected dependency or adopts an upstream fix.

vendor/components.json is the machine-readable inventory for browser libraries and assets committed under vendor/. npm run supply-chain:check fails when a vendored file is unowned, multiply owned, or missing the package metadata required for its monitoring mode.

npm run sbom combines that inventory with package-lock.json into artifacts/getbased.cdx.json in CycloneDX 1.5 format. The Supply chain GitHub Actions workflow uploads the SBOM and submits the versioned npm vendor components to GitHub's dependency graph, where supported packages receive Dependabot vulnerability alerts. Non-npm components such as SQLite and venice-e2ee remain visible in the SBOM; unversioned font assets are inventory checked but are not eligible for version-based advisory matching.

There aren't any published security advisories