Skip to content

Doc: OpenSSL API modernization (SparkPost/Momentum#1276)#850

Open
dkoerichbird wants to merge 3 commits into
mainfrom
Momentum#1276_OpenSSL_API_deprecation_cleanup
Open

Doc: OpenSSL API modernization (SparkPost/Momentum#1276)#850
dkoerichbird wants to merge 3 commits into
mainfrom
Momentum#1276_OpenSSL_API_deprecation_cleanup

Conversation

@dkoerichbird
Copy link
Copy Markdown
Contributor

@dkoerichbird dkoerichbird commented Jun 3, 2026

Note

Low Risk
Documentation-only changes with no runtime or configuration code; reviewers should verify technical accuracy against the actual 5.3.0 product behavior.

Overview
Documents OpenSSL API modernization (I-1276) for Momentum 5.3.0: supported OpenSSL is 1.1.1 through 3.5.x, with obsolete TLS settings called out across reference pages and the 5.3.0 changelog.

Removed or obsolete in 5.3.0 (silently ignored if left in config): ssl_lock_method, crypto_lock_method, and the tls rekey console command; summary tables now show these as 4.0 through 5.2 only. Dedicated pages add prominent removal notes and point operators to remove stale ecelerity.conf entries.

TLS behavior docs: tls_protocols explains that legacy tokens (SSLv2/SSLv3/TLSv1.0/TLSv1.1) may still parse but often do not negotiate under modern OpenSSL and OS crypto policy; example config and +ALL semantics are updated (e.g. typical RHEL 8 → TLS 1.2/1.3). tlsv13_ciphersuites broadens the stated OpenSSL range and switches CLI examples from openssl11 to openssl.

Version-dependent: crypto_engine is documented as ineffective on OpenSSL 3.x (ENGINE API removed); still relevant on 1.1.1 builds.

Reviewed by Cursor Bugbot for commit a228fe4. Bugbot is set up for automated code reviews on this repo. Configure here.

Signed-off-by: Doug Koerich <douglas.koerich@bird.com>
@netlify
Copy link
Copy Markdown

netlify Bot commented Jun 3, 2026

Deploy Preview for support-docs ready!

Name Link
🔨 Latest commit a228fe4
🔍 Latest deploy log https://app.netlify.com/projects/support-docs/deploys/6a26c4abe79b0d0008a0c4c5
😎 Deploy Preview https://deploy-preview-850--support-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

…um#1276)

Signed-off-by: Doug Koerich <douglas.koerich@bird.com>
Comment thread content/momentum/changelog/5/5-3-0.md Outdated
| Feature | I-1214 | Removed `msys-nodejs` RPM from the Momentum bundle, to be replaced with the 3rd-party `nodejs` package. Node.js LTS 24+ must be installed separately from the system or a vendor repository. |
| Feature | I-1216 | Added the [log_hires_timestamp](/momentum/4/config/ref-log-hires-timestamp) option to emit microsecond-resolution timestamps in the `mainlog`, `bouncelog`, `rejectlog`, `paniclog`, custom logs, chunk logs, and message generation logs, preserving event ordering when reading multiple log files together. |
| Feature | I-1225 | Added optional `--meta` / `--header` filtering to the [`reroute queue`](/momentum/4/console-commands/reroute-queue#reroute_queue_selective) console command, to selectively move queued messages by metadata or RFC822 header match. |
| Enhancement | I-1276 | The supported range of OpenSSL covers 1.1.1 (RHEL 8) through the 3.5.x series — all pre-1.1.1 compatibility code has been retired. No configuration changes are required — the removed options are silently ignored if still present. |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we also list the deprecated/now-removed config options so customers can get an overview of any potential config changes they might have to make to remove them as they review the changelog?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants