Security posture
A plain-English summary of how Chart-Output handles authentication, signing, data, transport, and rate limits. Every claim below is backed by code or a migration file you can inspect.
Summary
- API keys are never stored in plaintext. Only SHA-256 hashes are persisted.
- Webhooks are signed with HMAC-SHA256 over the raw body and verified with constant-time comparison.
- All Supabase tables have row-level security enabled; users can only read their own resources.
- Logos referenced in card headers must be HTTPS URLs; HTTP is rejected at validation time.
- Requests are rate limited per API key (or per IP when anonymous), with the counters kept in Upstash Redis when it is configured.
- Output format and image size are checked against the account's plan before anything is rendered.
API keys
Keys are issued with a prefix that encodes the environment (pk_live_ or pk_test_) and a random suffix. Only the SHA-256 hash of the full key is stored in the api_keys.key_hash column (see migration 001_initial_schema.sql). The plaintext is shown once at creation and never again — if you lose it, you rotate.
Authentication is checked on every request in lib/middleware/auth.ts. Keys can be supplied via the Authorization: Bearer <key> header or the ?key= query parameter for email embeds.
Webhook signing
Every webhook delivery carries an X-Signature header — an HMAC-SHA256 hex digest of the exact JSON body using your per-webhook secret. Verify it on your end with a constant-time compare before trusting payload contents. Reference implementation and a Node.js verification snippet are in Webhooks guide.
The secret is shown once at webhook creation. Losing it requires creating a new webhook and retiring the old one. Events emitted today: render.success, render.failed, and render.complete (async jobs).
Row-level security
Every tenant-scoped table has Postgres row-level security enabled. Users can only read or write rows keyed to their own auth.uid(). Service-role access is restricted to server-side code paths and never exposed to the browser. You can audit the policies directly in supabase/migrations/*.sql; RLS has been on for every tenant table since migration 001.
Data retention
- Render metadata (chart type, dimensions, latency, success/failure) is retained in the
renderstable for analytics. - Image buffers uploaded via
returnUrlare content-addressed (md5 of the spec) and stored withCache-Control: public, max-age=31536000, immutable. They are never overwritten. - AI render inputs (descriptions, attached data) are not stored by Chart-Output. They are sent to OpenAI, the model provider, to write the chart spec. Render logs keep metadata only (chart type, format, size, latency).
- Incidents on the status page show the trailing 90 days.
Transport & URL validation
- The API is served over HTTPS at https://www.chart-output.com.
logoUrlin card compositions is validated to HTTPS inCardHeaderSchema(lib/validation/chart-spec.ts).- Response bodies include
X-Request-Idto correlate client errors with server logs.
Rate limiting
Authenticated requests are limited to 100 per 15 minutes per API key, and anonymous GET renders to 5 per 15 minutes per IP address. The sliding window runs on Upstash Redis when it is configured and falls back to per-instance memory otherwise. The limits are the same on every plan, and are surfaced in the response as X-RateLimit-* headers. Exceeding the limit returns 429 Too Many Requests; nothing is silently queued.
Responsible disclosure
Email security@chart-output.com with a description, reproduction steps, and the potential impact. We acknowledge within two business days and will coordinate a fix before public disclosure.