Skip to content

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

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

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

Conversation

@dkoerichbird

@dkoerichbird dkoerichbird commented Jun 3, 2026

Copy link
Copy Markdown
Contributor

Note

Low Risk
Documentation-only changes with no runtime or code impact; operators should note that scripts calling tls rekey will fail on 5.3.0+.

Overview
Documents Momentum 5.3.0 (I-1276) OpenSSL 1.1.1–3.x cleanup for operators and module authors.

5.3.0 changelog adds the I-1276 enhancement and a dedicated note on config/console impact: ssl_lock_method and crypto_lock_method are deprecated (accepted but ignored with warnings), tls rekey is removed (automation gets an error), legacy tls_protocols tokens are inert, and crypto_engine only works on OpenSSL 1.1.1 (not 3.x ENGINE API).

Config and console pages get matching callouts and summary-table version caps (through 5.2 for the lock options and tls rekey). tls_protocols is rewritten around real negotiation (TLS_method(), OS crypto policy, typical RHEL 8 = TLS 1.2/1.3). tlsv13_ciphersuites updates CLI examples from openssl11 to openssl and states support across 1.1.1–3.x.

ec_ssl_SSL_CTX_fixup gains a 5.3.0+ note: hook unchanged; temp-RSA already no-op; ENGINE-based SSL_CTX tweaks need review on OpenSSL 3.x.

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

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

netlify Bot commented Jun 3, 2026

Copy link
Copy Markdown

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

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.

@deepakpn Can you provide your latest review, please?

@netlify

netlify Bot commented Jun 25, 2026

Copy link
Copy Markdown

Deploy Preview for support-docs ready!

Name Link
🔨 Latest commit 4db5750
🔍 Latest deploy log https://app.netlify.com/projects/support-docs/deploys/6a3e77f4b2bec500089c4e52
😎 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.

Signed-off-by: Doug Koerich <douglas.koerich@bird.com>
Signed-off-by: Doug Koerich <douglas.koerich@bird.com>
…m#1276)

Signed-off-by: Doug Koerich <douglas.koerich@bird.com>
Signed-off-by: Doug Koerich <douglas.koerich@bird.com>
Signed-off-by: Doug Koerich <douglas.koerich@bird.com>
Signed-off-by: Doug Koerich <douglas.koerich@bird.com>
Signed-off-by: Doug Koerich <douglas.koerich@bird.com>
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