|
| 1 | +--- |
| 2 | +pcx_content_type: concept |
| 3 | +title: Challenge pages |
| 4 | +sidebar: |
| 5 | + order: 1 |
| 6 | +--- |
| 7 | + |
| 8 | +The types of available challenge pages function similarly. The main difference between the challenges are when and if an interaction is presented to the visitor. |
| 9 | + |
| 10 | +- Managed challenges will rarely present the visitor with an interactive challenge, except in cases where Cloudflare cannot verify the legitimacy of the visitor. |
| 11 | +- JavaScript challenges never present the visitor with an interactive challenge. |
| 12 | +- Interactive challenges present the visitor with a simple and solvable challenge, such as selecting a checkbox, to verify their legitimacy. |
| 13 | + |
| 14 | +Refer to the information below for more details on available challenges. |
| 15 | + |
| 16 | +## Available challenges |
| 17 | + |
| 18 | +### Managed challenge (recommended) |
| 19 | + |
| 20 | +Managed challenges are where Cloudflare dynamically chooses the appropriate type of challenge based on the characteristics of a request. This helps avoid [CAPTCHAs](https://www.cloudflare.com/learning/bots/how-captchas-work/), which also reduces the lifetimes of human time spent solving CAPTCHAs across the Internet. |
| 21 | + |
| 22 | +Unless there are specific compatibility issues or other reasons to use other types of challenges, you should use managed challenges for your various custom rules. |
| 23 | + |
| 24 | +:::caution |
| 25 | +Using Cloudflare challenges along with Rules features may cause challenge loops. Refer to [Rules troubleshooting](/rules/reference/troubleshooting/) for more information. |
| 26 | +::: |
| 27 | + |
| 28 | +### JavaScript challenge |
| 29 | + |
| 30 | +With a JavaScript (JS) challenge, Cloudflare presents a challenge page that requires no interaction from a visitor except the JavaScript processed by their browser. |
| 31 | + |
| 32 | +The visitor must wait until their browser finishes processing the JavaScript, which should be less than five seconds. |
| 33 | + |
| 34 | +### Interactive challenge |
| 35 | + |
| 36 | +Interactive challenges require a visitor to interact with the interstitial challenge page, presenting the visitor with an interactive challenge to solve. Cloudflare does not recommend using Interactive Challenges. |
| 37 | +For more on why Cloudflare does not recommend using Interactive Challenge, in favor of Managed Challenge, refer to our [blog post](https://blog.cloudflare.com/end-cloudflare-captcha/). |
| 38 | + |
| 39 | +--- |
| 40 | + |
| 41 | +## Detect a challenge page response |
| 42 | + |
| 43 | +When a request encounters a Cloudflare challenge page instead of the originally anticipated response, the challenge page response (regardless of the challenge page type) will have the `cf-mitigated` header present and set to `challenge`. This header can be leveraged to detect if a response was challenged when making fetch/XHR requests. This header provides a reliable way to identify whether a response is a challenge or not, enabling a web application to take appropriate action based on the result. For example, a front-end application encountering a response from the backend may check the presence of this header value to handle cases where challenge pages encountered unexpectedly. |
| 44 | + |
| 45 | +:::note |
| 46 | +Regardless of the requested resource-type, the content-type of a challenge will be `text/html`. |
| 47 | +::: |
| 48 | + |
| 49 | +For the `cf-mitigated` header, `challenge` is the only valid value. The header is set for all challenge page types. |
| 50 | + |
| 51 | +To illustrate, here is a JavaScript code snippet that demonstrates how to use the `cf-mitigated` header to detect whether a response was challenged: |
| 52 | + |
| 53 | +```js |
| 54 | +fetch("/my-api-endpoint").then((response) => { |
| 55 | + if (response.headers.get("cf-mitigated") === "challenge") { |
| 56 | + // Handle challenged response |
| 57 | + } else { |
| 58 | + // Process response as usual |
| 59 | + } |
| 60 | +}); |
| 61 | +``` |
| 62 | + |
| 63 | +For additional help, refer to our [FAQ](/cloudflare-challenges/troubleshooting/frequently-asked-questions/). |
| 64 | + |
| 65 | +--- |
| 66 | + |
| 67 | +## Resolve a challenge |
| 68 | + |
| 69 | +If a visitor encounters a challenge, Cloudflare employees cannot remove that challenge. Only the website owner can configure their Cloudflare settings to stop the challenge being presented. |
| 70 | + |
| 71 | +When observing a Cloudflare Challenge page, a visitor could: |
| 72 | + |
| 73 | +- Successfully pass the challenge to visit the website. |
| 74 | +- Request the website owner to allow their IP address. |
| 75 | +- Scan their computer for malicious programs (it may be infected). |
| 76 | +- Check their antivirus or firewall service to make sure it is not blocking access to the challenge resources (for example, images). |
| 77 | + |
| 78 | +:::note |
| 79 | +Visitors must enable JavaScript and cookies on their browser to be able to pass any type of challenge. |
| 80 | +::: |
| 81 | + |
| 82 | +--- |
| 83 | + |
| 84 | +## Challenge Passage |
| 85 | + |
| 86 | +When a visitor solves a [Cloudflare challenge](/cloudflare-challenges/) - as part of a [WAF custom rule](/waf/custom-rules/) or [IP Access rule](/waf/tools/ip-access-rules/) - you can set the **Challenge Passage** to prevent them from having to solve future challenges for a specified period of time. |
| 87 | + |
| 88 | +### How it works |
| 89 | + |
| 90 | +When a visitor successfully solves a challenge, Cloudflare sets a [`cf_clearance` cookie](/fundamentals/reference/policies-compliances/cloudflare-cookies/#additional-cookies-used-by-the-challenge-platform) in their browser. This cookie specifies the duration your website is accessible to that visitor. |
| 91 | + |
| 92 | +When that visitor tries to access other parts of your website, Cloudflare evaluates the cookie before presenting another challenge. If the cookie is still valid, no challenges will be shown. |
| 93 | + |
| 94 | +When Cloudflare evaluates a `cf_clearance` cookie, a few extra minutes are included to account for clock skew. For XmlHTTP requests, an extra hour is added to the validation time to prevent breaking XmlHTTP requests for pages that set short lifetimes. |
| 95 | + |
| 96 | +### Customize the Challenge Passage |
| 97 | + |
| 98 | +By default, the `cf_clearance` cookie has a lifetime of 30 minutes. Cloudflare recommends a setting between 15 and 45 minutes. |
| 99 | + |
| 100 | +To update the Challenge Passage (and the value of the `cf_clearance` cookie): |
| 101 | + |
| 102 | +1. Log into the [Cloudflare dashboard](https://dash.cloudflare.com). |
| 103 | +2. Select your account and domain. |
| 104 | +3. Go to **Security** > **Settings**. |
| 105 | +4. For **Challenge Passage**, select a duration. |
| 106 | + |
| 107 | +### Limitations |
| 108 | + |
| 109 | +The Challenge Passage does not apply to challenges issued by WAF managed rules. Also, Challenge Passage does not apply to rate limiting rules unless the rate limit is configured to issue a challenge. |
| 110 | + |
| 111 | +--- |
| 112 | + |
| 113 | +## Additional configuration |
| 114 | + |
| 115 | +### Multi-language support |
| 116 | + |
| 117 | +Refer to [supported languages](/cloudflare-challenges/reference/supported-languages/) for more information. |
| 118 | + |
| 119 | +### Favicon customization |
| 120 | + |
| 121 | +Cloudflare challenges take the favicon of your website using `GET /favicon.ico` and displays it on the challenge page. |
| 122 | + |
| 123 | +You can customize your favicon by using the HTML snippet below. |
| 124 | + |
| 125 | +```html title="HTML element" |
| 126 | +<link rel="shortcut icon" href="<FAVICON_LINK>" /> |
| 127 | +``` |
0 commit comments