Skip to content

[Use Cases] Solution guide: Stop malicious bots while allowing legitimate traffic#29531

Open
codyanthony850 wants to merge 97 commits intoproductionfrom
canthony/stop-malicious-bots-guide
Open

[Use Cases] Solution guide: Stop malicious bots while allowing legitimate traffic#29531
codyanthony850 wants to merge 97 commits intoproductionfrom
canthony/stop-malicious-bots-guide

Conversation

@codyanthony850
Copy link
Copy Markdown
Contributor

@codyanthony850 codyanthony850 commented Apr 1, 2026

First solution guide for the use-cases section. A solution guide is a cross-product content type that starts from a customer's goal and walks through achieving it using multiple Cloudflare products together. For the full content type definition, refer to Solution guide — Style guide.

This guide covers layered bot defense using Bot Fight Mode, Turnstile, Application Security custom rules, and rate limiting. Scoped to Free, Pro, and Business plans with Enterprise features in callouts.

  • New file: src/content/docs/use-cases/application-security/bots/stop-malicious-bots.mdx
  • Nested under the bots/ discovery page per agreed IA with Daniel
  • 3 shared partials created: enable-bfm.mdx, create-widget-dashboard.mdx, bot-score-baseline-rules.mdx
  • Updated source pages to use shared partials: bot-fight-mode.mdx, dashboard.mdx, challenge-bad-bots.mdx
  • Updated block-attacks.mdx with cross-reference to this guide
  • Updated bots/index.mdx (discovery page) to link to this guide
  • All expressions verified against source docs
  • All feature descriptions aligned with source docs language
  • Dashboard paths verified on Free plan; Business-tier procedures match source docs

Related: PCX-21341

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 1, 2026

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/bots/ @patriciasantaana, @cloudflare/pcx-technical-writing, @cloudflare/product-owners
/src/content/docs/turnstile/ @migueldemoura, @punkeel, @patriciasantaana, @cloudflare/pcx-technical-writing, @cloudflare/product-owners
* @cloudflare/pcx-technical-writing, @cloudflare/product-owners
/src/content/docs/waf/ @pedrosousa, @cloudflare/firewall, @cloudflare/pcx-technical-writing, @cloudflare/product-owners

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 1, 2026

Preview URL: https://a7583100.preview.developers.cloudflare.com
Preview Branch URL: https://canthony-stop-malicious-bots-guide.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/use-cases/application-security/bots/stop-malicious-bots/ https://canthony-stop-malicious-bots-guide.preview.developers.cloudflare.com/use-cases/application-security/bots/stop-malicious-bots/
https://developers.cloudflare.com/use-cases/application-security/bots/ https://canthony-stop-malicious-bots-guide.preview.developers.cloudflare.com/use-cases/application-security/bots/
https://developers.cloudflare.com/use-cases/application-security/bots/ https://canthony-stop-malicious-bots-guide.preview.developers.cloudflare.com/use-cases/application-security/bots/
https://developers.cloudflare.com/waf/custom-rules/use-cases/challenge-bad-bots/ https://canthony-stop-malicious-bots-guide.preview.developers.cloudflare.com/waf/custom-rules/use-cases/challenge-bad-bots/
https://developers.cloudflare.com/bots/get-started/bot-fight-mode/ https://canthony-stop-malicious-bots-guide.preview.developers.cloudflare.com/bots/get-started/bot-fight-mode/
https://developers.cloudflare.com/turnstile/get-started/widget-management/dashboard/ https://canthony-stop-malicious-bots-guide.preview.developers.cloudflare.com/turnstile/get-started/widget-management/dashboard/
https://developers.cloudflare.com/waf/custom-rules/create-dashboard/ https://canthony-stop-malicious-bots-guide.preview.developers.cloudflare.com/waf/custom-rules/create-dashboard/
https://developers.cloudflare.com/use-cases/application-security/block-attacks/ https://canthony-stop-malicious-bots-guide.preview.developers.cloudflare.com/use-cases/application-security/block-attacks/

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 3, 2026

This PR requires additional review attention because it affects the following areas:

Redirects

This PR changes current filenames or deletes current files. Make sure you have redirects set up to cover the following paths:

  • /use-cases/application-security/bots/

@codyanthony850 codyanthony850 marked this pull request as ready for review April 9, 2026 22:15
…olution guides do not duplicate source content
@codyanthony850 codyanthony850 force-pushed the canthony/stop-malicious-bots-guide branch from d977bab to b3cc6b9 Compare April 9, 2026 22:21
codyanthony850 and others added 9 commits April 10, 2026 11:51
…cious-bots.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…cious-bots.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…cious-bots.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…cious-bots.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…cious-bots.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…stom rules description, verified bots links, allowlisting guidance
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.

4 participants