Creating a CAPTCHA

Written by

Updated at October 23, 2024

SmartCaptcha allows you to create CAPTCHAs of multiple difficulty levels for various incoming requests. The difficulty level is determined by the basic properties of the incoming traffic.

When creating a CAPTCHA, you can:

Connect a CAPTCHA to multiple websites.
Set up the CAPTCHA appearance, such as background, states, errors, and the I'm not a robot button style.
Select the type and difficulty level of a CAPTCHA challenge.
Show various CAPTCHA options based on the incoming request properties, such as use different CAPTCHA for the users from different countries.

Management console

In the management console, select the folder.
Select SmartCaptcha.
Click Create captcha.
Specify the Name of the CAPTCHA you are creating:
- It must be 2 to 63 characters long.
- It may contain lowercase Latin letters, numbers, and hyphens.
- The first character must be a letter, the last one cannot be a hyphen.
Optionally, select Disable domain check.
Specify Host list as IP addresses or domain names without http/https or/ at the end, e.g., example.com.

The CAPTCHA will also be valid for all subdomains of the specified domain names.
Set up the Style of the I'm not a robot button and the challenge window:
- Standard: Default appearance
- Gray
- Dark theme
- Blue
Under Сustomize style, you can set custom properties for the challenge window and other elements through the form or style description in JSON format.

All changes will be displayed in the preview window.
Configure the Challenge options. You can only specify the default CAPTCHA or add other options if you want to show different CAPTCHAs for different requests.
For the Default option, specify:
- Main challenge: Type of the main challenge that will be presented to the user.
- Additional challenge: Type of the additional challenge that will be presented to the user.
- Complexity: Difficulty level of the challenge that will be presented to the user:
- Easy: Simple challenge.
- Medium: Medium level challenge.
- Hard: Difficult challenge.
- Maximum: Difficult challenge with an additional question. The user is required to solve an additional challenge, regardless of the results of the main one.
  
  You can see a sample challenge in the preview window.
  
  Note
  
  The feature of challenge options and show rules is at the Preview stage.
To show different CAPTCHAs for different requests:
1. Click Add option and configure the settings as you would do for default CAPTCHA.
  
  To delete an option, click . If an option is used in the show rule, you cannot delete it.
2. Add the rules for incoming traffic that will determine which CAPTCHA option to show:
  - Click Add rule.
  - Specify the rule name and description.
  - Select a CAPTCHA option.
  - Specify the rule priority from 1 to 999999.
    
    Rules are checked in the ascending priority order, starting from 1, 2, etc. If the traffic matches multiple rules, the first rule to trigger will apply.
  - Specify one or more conditions for the incoming traffic:
    - IP: IP address, IP address range, or IP address region.
    - HTTP header: HTTP header string.
    - URI: Path of the incoming request to the website.
    - Host: Domain receiving the request.
  - Click Add.
    
    To delete a rule, click . You cannot delete a default rule.
3. Add other CAPTCHA options and rules for incoming traffic in a similar way.
Click Create.

The CAPTCHA will appear on the service page under Captcha list.

Creating a CAPTCHA

Was the article helpful?