Skip to content

[SSL] Add ERR_SSL_PROTOCOL_ERROR troubleshooting page#30929

Open
ngayerie wants to merge 2 commits into
cloudflare:productionfrom
ngayerie:ngayerie/SPM-3552
Open

[SSL] Add ERR_SSL_PROTOCOL_ERROR troubleshooting page#30929
ngayerie wants to merge 2 commits into
cloudflare:productionfrom
ngayerie:ngayerie/SPM-3552

Conversation

@ngayerie
Copy link
Copy Markdown
Collaborator

Summary

Adds a new troubleshooting page for ERR_SSL_PROTOCOL_ERROR and equivalent errors in Firefox/Safari.

Changes

  • New page at /ssl/troubleshooting/connection-resets.mdx
  • Covers disabling HTTP/3 for QUIC/UDP issues
  • Covers disabling TLS 1.3 for compatibility issues
  • Covers ISP and network interference (DPI, SSL inspection, content filters)
  • Quick checklist for common causes
  • Uses DashButton component for dashboard links

Related

Addresses SPM-3552

New page covering:
- Disabling HTTP/3 for QUIC/UDP issues
- Disabling TLS 1.3 for compatibility issues
- ISP and network interference (DPI, SSL inspection, content filters)
- Quick checklist for common causes

Addresses SPM-3552
@ngayerie ngayerie requested review from a team and elithrar as code owners May 19, 2026 15:09
@github-actions github-actions Bot added the product:ssl Related to SSL label May 19, 2026
@ngayerie ngayerie requested review from a team and kodster28 as code owners May 19, 2026 22:37
- Rename file to err-ssl-protocol-error.mdx (matches error name convention)
- Fix DashButton props (url instead of path/label)
- Quote description in frontmatter
- Frame disabling HTTP/3 and TLS 1.3 as diagnostic tests, not permanent fixes
- Add caution about security implications of disabling TLS 1.3
- Add cross-references to other common causes (certificate activation, multi-level subdomains, cipher suites)
- Replace third-party tools with Cloudflare's /cdn-cgi/trace
- Change 'whitelist' to 'allowlist'
- Add descriptive text before DashButton components

Addresses SPM-3552
@ngayerie ngayerie force-pushed the ngayerie/SPM-3552 branch from d5ff335 to c5f31c5 Compare May 19, 2026 22:42
Copy link
Copy Markdown
Contributor

@baubuchon-cf baubuchon-cf left a comment

Choose a reason for hiding this comment

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

Technical review LGTM — thanks for the thorough rewrite, Nicolas. All prior feedback is addressed

  • DashButton props corrected to use url
  • HTTP/3 and TLS 1.3 sections reframed as diagnostic tests with proper re-enable instructions
  • :::caution block added for TLS 1.3 security implications
  • File renamed to err-ssl-protocol-error.mdx
  • Third-party tools replaced with /cdn-cgi/trace
  • "Whitelist" → "Allowlist"
  • Cross-references added for other common causes

Approving from the SSL/TLS product side.

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

Labels

product:ssl Related to SSL size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants