[Spectrum] Document IP Access Rules blocking health checks#32137
Open
stechedo wants to merge 1 commit into
Open
[Spectrum] Document IP Access Rules blocking health checks#32137stechedo wants to merge 1 commit into
stechedo wants to merge 1 commit into
Conversation
Split out from cloudflare#30683 per reviewer request to allow more time to verify the allowlist/health-check mechanism. - Add troubleshooting section for health checks failing when IP Access Rules use an allowlist model - Add caution + note callouts in configuration-options.mdx - Add caution callout in the Load Balancing Spectrum setup guide
stechedo
requested review from
a team,
elithrar,
ncrouch-cflare and
steve-cloudflare
as code owners
July 17, 2026 13:49
Contributor
Review
Fix in your agentFix the following review findings in PR #32137 (https://github.com/cloudflare/cloudflare-docs/pull/32137).
Before making changes, review each finding and present a brief summary table:
- For each finding, state whether you agree, disagree, or need clarification
- If you disagree (e.g. the fix requires disproportionate effort for minimal benefit,
or the finding is factually incorrect), explain why
- If you need clarification before deciding, ask those questions
- Then share your plan for which issues to tackle and in what order
After triaging, fix all legitimate findings. For any you decide to skip,
post a comment on this PR with the finding ID and your reasoning.
---
## Code Review
### Warnings (1)
#### CR-589005d5775b · Technically misleading alternative
- **File:** `src/content/docs/spectrum/reference/troubleshooting.mdx` line 47
- **Issue:** The added paragraph suggests using a TCP health check type as an alternative to allowlisting Cloudflare IPs. Because IP Access Rules evaluate every incoming connection to the Spectrum application, switching the health check protocol from HTTP to TCP does not bypass the block; the TCP connection from a blocked Cloudflare health check probe will still be rejected.
- **Fix:** Clarify that the alternative requires removing or changing IP Access Rules, and that moving access control to the origin is what allows health checks to succeed—not changing the health check type. If IP Access Rules remain enabled with an allowlist, any health check type must still allow Cloudflare’s probe IPs.
Code ReviewThis code review is in beta and may not always be helpful — use your judgment. Warnings (1)
ConventionsNo convention issues found. Style Guide ReviewNo style-guide issues found. CommandsOnly codeowners can run commands. Post a comment with the command to trigger it.
|
stechedo
added a commit
to stechedo/cloudflare-docs
that referenced
this pull request
Jul 17, 2026
…split health checks Per review feedback on cloudflare#30683: - Move the 'Health checks fail when IP Access Rules are enabled' section and related callouts to a separate PR (cloudflare#32137) so this PR isn't blocked while the mechanism is verified. - Clarify that the DNS record conflict is specifically between a manually-created proxied record and a Spectrum application, not between Spectrum applications themselves. Multiple Spectrum applications (including a mix of HTTP/HTTPS and TCP/UDP) can share a hostname because Spectrum manages the DNS record for each. - Align the double-proxy caution in configuration-options.mdx with the troubleshooting page: TCP applications surface a failed origin TLS handshake as 521/522, not error 525, which is HTTP/HTTPS-app specific.
stechedo
added a commit
to stechedo/cloudflare-docs
that referenced
this pull request
Jul 17, 2026
…split health checks Per review feedback on cloudflare#30683: - Move the 'Health checks fail when IP Access Rules are enabled' section and related callouts to a separate PR (cloudflare#32137) so this PR isn't blocked while the mechanism is verified. - Clarify that the DNS record conflict is specifically between a manually-created proxied record and a Spectrum application, not between Spectrum applications themselves. Multiple Spectrum applications (including a mix of HTTP/HTTPS and TCP/UDP) can share a hostname because Spectrum manages the DNS record for each. - Align the double-proxy caution in configuration-options.mdx with the troubleshooting page: TCP applications surface a failed origin TLS handshake as 521/522, not error 525, which is HTTP/HTTPS-app specific.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Split out of #30683 at the reviewer's request — see this comment:
Changes
spectrum/reference/troubleshooting.mdx— New "Health checks fail when IP Access Rules are enabled" section (symptoms/cause/solution) covering the allowlist-model blocking Cloudflare's health check probes.spectrum/reference/configuration-options.mdx— Caution callout under IP Access rules warning about health check impact, plus a note that Custom Rules (WAF) do not apply to TCP/UDP Spectrum applications.load-balancing/additional-options/spectrum.mdx— Matching caution callout in the Monitors step of the Spectrum load balancing setup guide.Content area
Spectrum, Load Balancing