Skip to main content
← Back to list
01Issue
FeatureShippedSwamp Club
AssigneesNone

Relationships

#509 Docs: TLS behind inspecting proxies / private CAs (system trust store, DENO_CERT, SSL_CERT_FILE)

Opened by keeb · 6/1/2026· Shipped 6/1/2026

Follow-up to issue #503 (swamp now honors the OS/system CA trust store by default).

The compiled binary's startup shim (src/infrastructure/runtime/tls_trust.ts) sets, before any network call:

  • DENO_TLS_CA_STORE=system,mozilla when unset — merges the OS trust store with Deno's bundled Mozilla roots.
  • DENO_CERT=$SSL_CERT_FILE when DENO_CERT is unset — honors the conventional OpenSSL SSL_CERT_FILE (Deno itself reads DENO_CERT, not SSL_CERT_FILE). User-set DENO_TLS_CA_STORE / DENO_CERT are always respected.

Documentation gap: there is no manual page covering TLS behavior. Add a reference/explanation page under content/manual/ documenting:

  • swamp now consults the OS trust store by default (works behind corporate TLS-inspecting proxies and private/internal CAs without extra config).
  • The environment variables: DENO_TLS_CA_STORE (e.g. system, mozilla, or system,mozilla), DENO_CERT=, and the SSL_CERT_FILE mapping.
  • Limitation: SSL_CERT_DIR (the OpenSSL cert-directory convention) is intentionally NOT supported — DENO_CERT accepts a single PEM file only. Users with a cert directory are covered by the system store default instead.

Suggested placement: content/manual/reference/tls-and-proxies.md (or an explanation page), cross-linked from troubleshooting/networking docs.

Filed as a follow-up to keep the code-fix PR focused (adversarial finding ADV-2).

02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPEDTRIAGE+ 4 MOREREVIEW+ 3 MOREPR_MERGED+ 1 MORENOTIFICATION_SKIPPED

Shipped

6/1/2026, 10:47:05 PM

Click a lifecycle step above to view its details.

03Sludge Pulse

Sign in to post a ripple.