Whitelisting Kajoo User Agent on CloudFlare

Developers

Purpose

Kajoo uses a headless browser with the user agent Kajoo to access your website's frontend code. This is required for services like the migration service (Convert Site to Jamstack) and other integrations to work properly.

If you're using a Web Application Firewall (WAF) like Cloudflare, it may block unknown user agents by default. To ensure Kajoo can access your site without issues, you need to whitelist the Kajoo user agent.

Note: These instructions are for Cloudflare. If you use a different WAF, follow a similar process to allow the Kajoo user agent.

How to Whitelist Kajoo User Agent on CloudFlare

  1. Sign in to your Cloudflare account.

  2. Select the site where you use the Kajoo application.

  3. Navigate to Security > WAF.

    A screenshot captured from Cloudflare to display Security > WAF page

    A screenshot from Cloudflare showing the Security > WAF page

  4. Click the Create rule button and begin filling out the form as described in the following steps and illustrated in the screenshot below.

    A screenshot captured from Cloudflare to display the WAF rule configuration to whitelist Kajoo

    A screenshot showing Cloudflare's WAF rule configuration for whitelisting Kajoo

  5. Assign a descriptive name to the Firewall rule.

  6. From the dropdown menus, select User Agent for Field and contains for Operator. Then, set the Value to Kajoo. (Note: the value is case-sensitive, so enter Kajoo exactly as shown)

  7. Select Skip as the action from the dropdown menu and check the All remaining custom rules option.

  8. Finally, click the Deploy button in the bottom-right corner. Congratulations! You've now successfully configured Kajoo in Cloudflare.