Cloudflare Configuration Guide
Complete step-by-step guide to configure Cloudflare Turnstile and integrate it with your Rise CRM application.
Prerequisites
- Turnstile plugin already installed and activated in Rise CRM
- Your website domain name
- Internet access to create/access Cloudflare account
Important: You'll need both the Site Key (public) and Secret Key (private) from Cloudflare to complete the integration.
Part 1: Cloudflare Account Setup
Step 1: Create or Access Cloudflare Account
Go to https://dash.cloudflare.com and either sign in to your existing account or create a new free account.
[IMAGE: Cloudflare homepage with Sign Up/Login buttons]
Step 2: Navigate to Turnstile Dashboard
Once logged in, find Turnstile in the left sidebar or use the search function to locate it.
[IMAGE: Cloudflare dashboard with Turnstile option in sidebar]
Step 3: Access Turnstile Sites
Click on Turnstile to open the Turnstile management interface.
[IMAGE: Turnstile dashboard main page with sites list]
Part 2: Creating a Turnstile Site
Step 4: Add New Site
Click the Add Site button to create a new Turnstile configuration for your website.
[IMAGE: Add Site button prominently displayed]
Step 5: Configure Site Details
Fill in the required information:
- Site name: A descriptive name for your site (e.g., "My Rise CRM")
- Domain: Your website domain (e.g., "example.com" or "mysite.com")
- Widget mode: Select "Managed" (recommended for best user experience)
[IMAGE: Site configuration form with fields filled out]
Step 6: Choose Widget Settings
Configure the widget appearance and behavior:
- Widget mode: Managed (recommended) or Non-interactive
- Pre-clearance: Leave default settings
[IMAGE: Widget configuration options with Managed selected]
Step 7: Create the Site
Click Create to generate your Turnstile site configuration.
[IMAGE: Create button and confirmation of site creation]
Part 3: Obtaining Your Keys
Step 8: Copy Site Key
After creation, you'll see your Site Key (public key). Click the copy button to copy it to your clipboard.
[IMAGE: Site key displayed with copy button]
Site Key Example:
0x4AAAAAAABkMYinukE_FoOZ
This is your public key - it's safe to include in your web pages.
Step 9: Copy Secret Key
Find and copy your Secret Key (private key). This is used for server-side verification.
[IMAGE: Secret key displayed with copy button and warning about keeping it private]
Secret Key Example:
0x4AAAAAAABkMYinukE_FoOZ-ABC123XYZ
Keep this private! Never share your secret key publicly.
Step 10: Configure Domain Settings
Verify that your domain is correctly configured in the allowed domains list. Add additional domains if needed.
[IMAGE: Domain configuration section showing allowed domains]
Part 4: Rise CRM Integration
Now that you have your Cloudflare keys, let's integrate them with your Rise CRM Turnstile plugin.
Step 11: Access Rise CRM Settings
In your Rise CRM application, navigate to Settings from the left sidebar menu.
[IMAGE: Rise CRM left sidebar with Settings highlighted]
Step 12: Open Turnstile Settings
Find and click on Turnstile in the settings menu to access the plugin configuration.
[IMAGE: Settings page showing Turnstile option in the menu]
Step 13: Enter Site Key
Paste your Cloudflare Site Key into the Site Key field.
[IMAGE: Turnstile settings page with Site Key field highlighted]
Step 14: Enter Secret Key
Paste your Cloudflare Secret Key into the Secret Key field.
[IMAGE: Turnstile settings page with Secret Key field highlighted]
Step 15: Configure Theme and Size
Choose your preferred widget appearance:
- Theme: Light, Dark, or Auto (matches your site theme)
- Size: Normal or Compact
[IMAGE: Theme and size dropdown options]
Step 16: Enable Turnstile
Toggle the Enable Turnstile switch to activate the plugin.
[IMAGE: Enable Turnstile toggle switch in ON position]
Step 20: Save Settings
Click Save Settings to apply all your configuration changes.
[IMAGE: Save Settings button with success confirmation message]
Verification and Testing
- Visit a form on your website (login, contact, etc.)
- Verify that the Turnstile widget appears instead of reCAPTCHA
- Complete a form submission to test end-to-end functionality
- Check that form submissions are processed correctly
Success! Your Cloudflare Turnstile is now configured and integrated with Rise CRM. The plugin will automatically handle CAPTCHA protection on all supported forms.
Troubleshooting
- Widget not appearing: Check that your Site Key is correct and Turnstile is enabled
- Validation failing: Verify your Secret Key and ensure your domain is in Cloudflare's allowed list
- Test connection fails: Confirm both keys are copied correctly without extra spaces
- Forms not working: Clear browser cache and ensure JavaScript is enabled
Need Help? If you encounter issues, double-check that your domain in Cloudflare matches your actual website domain exactly (including subdomain if applicable).