1. Log in to the CAPTCHA Console, and select Manage CAPTCHAs in the left sidebar.
2. On the Manage CAPTCHAs page, click Create CAPTCHA.
Notes：
A maximum of 50 CAPTCHAs can be created. You can configure each CAPTCHA with different client types, security policies, and other parameters to suit your business requirements.
3. On the Create CAPTCHA page, configure the relevant parameters and click Save.
Parameter Description:
Parameter
Description
Display name
The display name for the new CAPTCHA.
Platform type
Set the platform type for integrating the CAPTCHA. Supports Web, iOS, and Android.
Web: Select Web, then configure Domain to add the CAPTCHA(domain name validation is not required).
iOS: Select iOS, then configure Bundle ID to add the CAPTCHA.
Android: Select Android, then configure Package name to add the CAPTCHA.
Notes:
Domain name: Click the + on the right. Up to 10 can be added.
CAPTCHA setting
CAPTCHA settings include Widget type, CAPTCHA behavior, Challenge type, and Security level.
Widget type: Supports Minimal, Basic and Invisible.
Minimal: Display the widget without brand.
Basic: Display the basic widget.
Invisible: Not display the widget.
CAPTCHA behavior: Supports One-Click, Always and Frictionless.
One-Click: Only suspicious users see challenge.
Always: All users see the challenge.
Frictionless: No users see the challenge.
Challenge type: Supports Slider, Graphical and Voice.
Slider: Drag the slider to complete the puzzle.
Graphical: Click the correct graphics in order according to the prompt.
Voice: Enter the CAPTCHA as prompted by the voice message.
Security level: Supports Loose, General and Strict. Loose has the lowest interception level, while Strict has the highest.
Auto-Block: When enabled, TencentCaptcha decides whether to block risky requests and require retry. Default OFF allows your site to take action in case of risk detected by TencentCaptcha.
Notes:
Invisible verification mechanism does not support managed interception policy settings.
WAF Service
Select whether to integrate the WAF service. After enabling the WAF service, users who use both CAPTCHA and WAF services can apply the CAPTCHA results to WAF security policies. For detailed instructions, please refer to Integration with WAF.
Tags are used to manage resources by category in different dimensions.
4. After completing creation, you can view the quick integration guide for CAPTCHA on the integration page.
5. Return to the Manage CAPTCHAs page to view created CAPTCHAs.
Notes：
CAPTCHAs with WAF service enabled will display a WAF label.
View CAPTCHA Details
1. Log in to the CAPTCHA Console, and select Manage CAPTCHAs in the left sidebar.
2. On the Manage CAPTCHAs page, click CAPTCHA DETAILS under the desired CAPTCHA.
3. On the Overview page, you can view data such as Total CAPTCHA loads, Verification requests, Requests to verify tickets, Verification requests over time, Blocking rate and Ticket verification requests.
Metric Description:
Metric Name
Description
Total CAPTCHA loads
Number of times the CAPTCHA was loaded by the client.
Verification requests
Number of times verification was initiated after the user answered the CAPTCHA challenge.
Passed verification requests
Number of times verification was passed.
Blocked verification requests
Number of times verification was blocked (failed).
Blocking rate
Rate of verification blocks (failures).
Incorrect answers
Rate of verification blocks due to incorrect answers.
Blocked insecure requests
Rate of verification blocks due to security policy enforcement.
Requests to verify tickets
Number of times ticket validation was initiated by the server.
Passed ticket verification requests
Number of times ticket validation was passed.
Blocked ticket verification requests
Number of times ticket validation was blocked (failed).
4. Select the Configuration tab to view Basic information, CAPTCHA keys, CAPTCHA settings, IP allowlist, and other configurations. Click Edit to modify the CAPTCHA configuration.
5. Select the Integration tab to view the CAPTCHA integration guide and migration guide.
Modifying CAPTCHA
1. Log in to the CAPTCHA Console, and select Manage CAPTCHAs in the left sidebar.
2. Click the Edit icon
next to the CAPTCHA you want to modify, or click CAPTCHA DETAILS under the desired CAPTCHA and then select the Configuration tab. On the configuration page, click Edit.
3. On the Edit CAPTCHA page, you can modify the CAPTCHA configuration. Click Save after completing the configuration.
Parameter Description:
Parameter
Description
Display name
The display name for the CAPTCHA.
Platform type
Set the platform type for integrating the CAPTCHA. Supports Web, iOS, and Android.
Web: Select Web, then configure Domain to add the CAPTCHA.
iOS: Select iOS, then configure Bundle ID to add the CAPTCHA.
Android: Select Android, then configure Package name to add the CAPTCHA.
CAPTCHA setting
CAPTCHA settings include Widget type, CAPTCHA behavior, Challenge type, and Security level.
Widget type: Supports Minimal, Basic and Invisible.
Minimal: Display the widget without brand.
Basic: Display the basic widget.
Invisible: Not display the widget.
CAPTCHA behavior: Supports One-Click, Always and Frictionless.
One-Click: Only suspicious users see challenge.
Always: All users see the challenge.
Frictionless: No users see the challenge.
Challenge type: Supports Slider, Graphical and Voice.
Slider: Drag the slider to complete the puzzle.
Graphical: Click the correct graphics in order according to the prompt.
Voice: Enter the CAPTCHA as prompted by the voice message.
Security level: Supports Loose, General and Strict. Loose has the lowest interception level, while Strict has the highest.
Auto-Block: When enabled, TencentCaptcha decides whether to block risky requests and require retry. Default OFF allows your site to take action in case of risk detected by TencentCaptcha.
Notes:
Invisible verification mechanism does not support managed interception policy settings.
IP Allowlist
After adding to the allowlist, risk control rules will not take effect for requests originating from IPs within this list. For detailed operations, please see Add Allowlist.
WAF Service
Modification is not supported, please create a new CAPTCHA if changes are needed.
