Google reCAPTCHA is a security service that protects your app from spam and abuse. It analyzes user behavior in the background using image verification, click-based checks or risk-based algorithms to determine if users are real.

This service prevents automated bots from logging in, ensuring that only real users have access.

In this tutorial, you will learn how to configure ReCAPTCHA verification settings in the Configuration Manager module.

Settings Required to Use Google reCAPTCHA

To make ReCAPTCHA settings, you must first use the Recaptcha element. You can find detailed information in our related content.
If you are going to use it for mobile applications, you need to create a mobile application first. You can access our related content to create a mobile application.
In order to use the reCAPTCHA element, different key information is required for each platform (Web, Android, iOS).
These keys from the Google reCAPTCHA service must be created platform-specific.
The key information received separately for Web, Android and iOS must be entered into the Google reCAPTCHA field in the Configuration Manager module to ensure the verification process.

Google Console reCAPTCHA Settings

Web Key Retrieval

Go to the Google reCAPTCHA Key Generation page.

Click on the Go to reCAPTCHA button.

Select a project by clicking Select a project or create a new project with New Project.
Enter the project name and click the Create button.

On the page that opens, click the Enable button.

Click the Create Key button.
Fill in the Display Name field and select Website as Choose Platform Type.
Enter the domain name of your web page and click the Done button.

‍

Select the relevant options from the Key Type field and click the Create Key button.

Take note of the generated Site Key and Secret Key information.

Android Key Retrieval

Click on the Create Key button.
Fill in the Display Name field and select Android app as Choose Platform Type.
Enter Bundle ID.
Save by clicking the Done button.
Click on the Create Key button to create a key and write down the information.

iOS Key Retrieval

Click on the Create Key button.
Fill in the Display Name field and select the iOS app as the Choose Platform Type.
Enter Bundle ID.
Save by clicking the Done button.

From the Keys tab, click the + button to create a new Private Key (.p8) file.

Enter the Key Name, click the Register button and click the Download button to download the .p8 file.

.p8 file can only be downloaded once.

Upload the Key Identifier and Team ID information to the reCAPTCHA page.

Click on the Create Key button to create a key and write down the information.

‍

ReCAPTCHA Settings in Configuration Manager Module

Web Integration

Go to the Configuration Manager module.
In the App Settings tab, locate the Google reCAPTCHA field.
Click the Add New button.
Fill in the Name field as desired.

Enter the Site Key and Secret Key information you created on the Google reCAPTCHA page.
Save by clicking the Save button.
Go back to the Google Recaptcha page and click the Key Details button in the web key we created.

On the Details page, go to the Integrations tab and click the “Integrate with a third-party service or plugin” button.
In the incoming window is the Secret Key.
- “ID” value -> “Site Key”
- “Secret Key” value -> “Secret Key”
After entering the required information, save it in the field in the Configuration Manager module. You can create a configuration for Android and iOS applications by following similar steps.

Android Integration

Go to the Configuration Manager module.
Switch to the Android tab and find the Google reCAPTCHA field.
Click the Add New button.
Fill in the Name field as desired.
Enter the ID value of the Android Key you created in the Site Key field.
Save by pressing the Save button.

iOS Integration

Go to the Configuration Manager module.
Switch to the iOS tab and locate the Google reCAPTCHA field.
Click the Add New button.
Fill in the Name field as desired.
Enter the ID value of the iOS Key you created in the Site Key field.
Save by pressing the Save button.

Error and Troubleshooting

If verification fails: Check key configurations in Google Console.
If you get errors in API calls: Make sure the Secret Key is entered correctly.
If the reCAPTCHA element is not visible: Check the integration on the UI side and complete the missing actions.

By following these steps, you can successfully integrate Google reCAPTCHA into the Kuika platform, increase the security of your application and ensure that only real users can log in.