This guide will show you how to generate your own Google reCAPTCHA v2 Site Key and Secret Key, and how to add them to your Super Admin page to enable CAPTCHA protection for login pages.
Prerequisites
- A Google account (any Gmail account will do)
- Access to Google reCAPTCHA admin panel
- Super Admin access to your Cockpit Panel
Steps
1. Register Your Site with Google
- Go to https://www.google.com/recaptcha/admin/create
- Under Label, enter a name like Cockpit Panel for your own reference.
- Select reCAPTCHA v2 and choose "I'm not a robot" Checkbox.
- Under Domains, enter the domain or IP address of your Cockpit Panel installation (e.g.
panel.example.comor your server IP). - Accept the reCAPTCHA Terms of Service.
- Click Submit.
2. Copy Your Keys
- After submission, you’ll see two keys:
Site Key: 6LcAxxxx... (used in the frontend) Secret Key: 6LcBxxxx... (used in backend verification)
3. Add the Keys to the Cockpit Panel
- Log in to your Cockpit Panel as a Super Admin.
- Navigate to the Admin Settings or Settings > Security section.
- Scroll down until you find the CAPTCHA / Google reCAPTCHA Settings area.
- Paste your keys in the appropriate fields:
reCAPTCHA Site Key: 6LcAxxxx... reCAPTCHA Secret Key: 6LcBxxxx...
- Enable the toggle or checkbox to Enable CAPTCHA on login pages.
- Click Save.
4. Test the Login Page
- Log out and visit the login page.
- You should now see a Google reCAPTCHA checkbox under the login form.
- Attempt a test login to ensure everything works as expected.
That’s it! You’ve now successfully added Google reCAPTCHA v2 to your Cockpit Panel login page, helping prevent bot abuse and login mischief.
If you have made a mistake along the way you can clear the reCAPTCHA settings using the following article here.