Skip to content

docs(security): design PostgreSQL datasource TLS trust - #337

Draft
dviejokfs wants to merge 2 commits into
mainfrom
design/adr-postgres-datasource-tls-trust
Draft

docs(security): design PostgreSQL datasource TLS trust#337
dviejokfs wants to merge 2 commits into
mainfrom
design/adr-postgres-datasource-tls-trust

Conversation

@dviejokfs

Copy link
Copy Markdown
Contributor

Summary

  • defines an explicit per-service PostgreSQL TLS policy using the existing encrypted ssl_mode parameter
  • removes handshake-driven TLS-to-plaintext downgrade from the proposed connector design
  • distinguishes plaintext, encryption-only self-signed TLS, and fully verified platform-trust TLS
  • specifies race-safe policy generations, real stale-transport shutdown, strict input/provenance rules, and partial-commit auditing

Security finding

Addresses the design for finding #9: PostgreSQL data-explorer TLS failure silently falls back to plaintext.

Validation

  • document whitespace and placeholder checks pass
  • repository commit hooks pass
  • security-auditor sign-off granted for the ADR design

This PR is documentation only. The eventual implementation remains subject to the ADR regression suite and a separate security review.

@github-actions

github-actions Bot commented Jul 13, 2026

Copy link
Copy Markdown

📓 Changelog preview

This is what your commits will add to the generated CHANGELOG.md at release time (via git-cliff). Do not edit CHANGELOG.md by hand — it is generated from your Conventional Commit messages.

## [Unreleased]

### Documentation

- **security:** Design PostgreSQL datasource TLS trust
- **security:** Require TLS at postgres driver layer

@dviejokfs
dviejokfs marked this pull request as draft July 31, 2026 20:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant