CAPTCHA Plugin resolves CAPTCHA using ‘Death By Captcha’ service. ‘Death By Captcha’ may be referred to as DBC at times in this document.
Sometimes CAPTCHA may not get resolved, this may be due to incorrect response from ‘Death By Captcha’ service. If you observe such issue frequently, then please contact ‘Death By Captcha’ support.
DBC: Image is a step in the Utilty Plugin. DBC: Image workflow step retrieves the text from a word CAPTCHA image. It uses ‘Death By Captcha’ (DBC) REST APIs to resolve CAPTCHA text. User needs to have DBC: Image account in order to use their services. The DBC REST API base URL is http://api.dbcapi.me/api/captcha.
General Tab:
No.
Field Name
Description
DBC Account Details:
1
URL
Specify the REST API http URL of your DBC account (http://api.dbcapi.me/api/captcha).
2
Username
Specify the username of your DBC account.
3
Password
Specify the password.
Input:
1
Captcha image filepath
CAPTCHA image file path.
The data type is String. This field is mandatory.
2
Button: Browse
Click Browse button to select CAPTCHA image file. The supported image formats are JPG, PNG, GIF and BMP.
Retry if DBC Service is Temporarily Unavailable:
3
Retry Count
Specify Number of times the server is expected to retry if the DBC service is temporarily unavailable.
The data type is integer. The default value of Retry Count is 5.
Note:
When the DBC service is temporarily unavailable, the value in the 'Retry Count' field specifies the number of times the server should retry uploading the image and calling the API after every specified interval in seconds.
4
Retry Interval in Seconds
Specify a Retry time interval (in seconds) between every retry attempt (Polling repeat interval) in case DBC server is temporarily unavailable or CAPTCHA is not resolved.
The data type is integer. The default value is 2.
Note:
If at first attempt, the API fails to retrieve the CAPTCHA text i.e. the result returned by the API is blank, it will internally retry polling for maximum of 10 times after every specified interval in seconds until it gets the CAPTCHA text.
Output:
1
Captcha Output
Output field to hold the resolved CAPTCHA text.
List of Validations:
Sr. No.
Validation
1
CAPTCHA image file should be of one of the supported formats i.e. JPG, PNG, GIF and BMP
2
CAPTCHA image file size is limited to less than 180 KB
4
Minimum Retry Interval should not be less than 2 seconds.
5
Execution should fail if CAPTCHA is not yet resolved after polling 10 times with specified Interval in Seconds
DBC: reCAPTCHA v2 Checkbox step, gets the token to solve reCAPTCHA v2 Checkbox.
References:
https://www.deathbycaptcha.com/user/api/newtokenrecaptcha
Notes:
General Tab:
No.
Field Name
Description
DBC Account Details:
1
URL
Specify the REST API http URL of your DBC account
‘Death By Captcha’ API URL (http://api.dbcapi.me/api/captcha). The URL is defined in the field and is non-editable.
2
Username
Specify the username of your DBC account.
Password:
3
Accept value as variable/static
Enable checkbox for Password field to appear as Text box. Else, leave checkbox unchecked to accept Password value from a field in the previous steps of the stream using a drop down list.
4
Password
Specify the password of the DBC account.
If checkbox above is enabled Password field appears as Text box to enter password. Else if checkbox above is disabled Password field appears as a drop down to select fields from previous steps.
The data type is String. This field is mandatory.
Input Tab
No.
Field Name
Description
Input Fields:
1
Page URL
Specify URL of the page on which the re CAPTCHA with Checkbox is to be resolved.
The data type of the field is String. This field is mandatory.
2
Site Key
Site Key is a web-based security system, which provides a type of mutual authentication between end-users and websites. Its primary purpose is to deter phishing.
The data type of the field is String. This field is mandatory.
Fetch data-sitekey or sitekey from page source (by right clicking on web page and click to view page source).
Retry if DBC Service is temporarily unavailable:
3
Max Retry Count
Max Retry Count is used for-
- When the DBC service is temporarily unavailable
- When API fails to retrieve the output i.e token text
If the value is not provided or less than 10, then it will retry for maximum 10 times internally.
The data type of the field is Integer. This field is optional. The default value is 10.
4
Retry Interval (seconds)
Time interval (in seconds) between every retry attempt (Polling repeat interval).
If value is not provided, default value 2 is considered. Minimum Retry Interval should not be less than 2 seconds.
The data type of the field is integer. This field is optional.
Output Tab
No.
Field Name
Description
Token Text:
1
Token Text
Specify an output field to hold the retrieved token text on successful plugin execution. Default label value for this field is “TokenText”.
Steps to handle Token Text to resolve reCAPTCHA with Checkbox:
In the following JavaScript code substitute <'Paste String here'> with the Token Text,
document.getElementById('g-recaptcha-response').innerHTML=<'Paste String here'>;
document.forms[0].submit();
Manual Steps:
You need to right click on Page URL and click Inspect.
On the Inspect page navigate to the Console tab and paste this code and Enter. This enables the CAPTCHA checkbox.
However, this is a manual activity. Hence you may create a workflow to automate this activity as mentioned in the next point.
Automation:
After the reCAPTCHA v2 Checkbox step in the workflow you may put,
A single Plugin step Inject Java Script. with the above JavaScript in an Inject JavaScript step or else,
A combination of RPA Plugin steps to right click and inspect the page set the JavaScript code above as a variable in Modified Java Script step Web Set Value on console and Press Enter with Robot Handling step.
Common Buttons:
No.
Field Name
Description
Buttons:
1
OK
On click of this button. It will check the field values. If any required field values are missing then it will display validation error message.
If all the required field values are provided then it will save the field values.
2
Cancel
On click of this button, it will cancel the window and do not save any values
DBC: reCAPTCHA v3 step gets the token to solve reCAPTCHA v3.
Notes:
General Tab:
No.
Field Name
Description
DBC Account Details:
1
URL
‘Death By Captcha’ API URL (http://api.dbcapi.me/api/captcha). The URL is defined in the field and the value is non- editable.
2
Username
Specify the username of your DBC account.
Password:
3
Accept value as variable/static
Enable checkbox for Password field to appear as Text box. Else, leave checkbox unchecked to accept Password value from a field in the previous steps of the stream using a drop down list.
4
Password
Specify the password.
If checkbox above is enabled Password field appears as Text box to enter password. Else if checkbox above is disabled Password field appears as a drop down to select fields from previous steps.
This field is mandatory.
Input Tab
No.
Field Name
Description
Input Fields:
1
Page URL
Specify URL of the page on which the reCAPTCHA is to be resolved.
The data type of the field is String. This field is mandatory.
2
Site Key
Site Key is a web-based security system, which provides a type of mutual authentication between end-users and websites. Its primary purpose is to deter phishing.
The data type of the field is String. This field is mandatory.
Fetch data-sitekey or sitekey from page source (right clicking on web page and click to view page source).
3
Action
The action parameter at reCAPTCHA v3 is additional data used to separate different CAPTCHA validations like login, register, sales, etc.
The data type of the field is String. This field is mandatory.
Action value can be obtained from page source. It is the Action associated with the data-sitekey/sitekey
4
Min. Score
The minimal score needed for the CAPTCHA resolution. We recommend using the 0.3 min-score value, scores higher than 0.3 are hard to get.
The data type of the field is String. This field is mandatory.
Retry if DBC Service is temporarily unavailable:
5
Max Retry Count
Max Retry Count is used for-
- When the DBC service is temporarily unavailable
- When API fails to retrieve the output i.e token text
If the value is not provided or less than 10, then it will retry for maximum 10 times internally.
The data type of the field is Integer. This field is optional. The default value is 10.
6
Retry Interval (seconds)
Time interval (in seconds) between every retry attempt (Polling repeat interval). If value is not provided, default value ‘2’ will be considered.
The data type of the field is integer. This field is optional.
The default value is 2. Minimum Retry Interval should not be less than 2 seconds.
Output Tab
No.
Field Name
Description
Token Text:
Specify an output field to hold the retrieved token text on successful plugin execution. Default label value for this field is “TokenText”.
Steps to handle Token Text to resolve reCAPTCHA:
In the following JavaScript code substitute <'Paste String here'> with the Token Text,
document.getElementById('g-recaptcha-response').innerHTML=<'Paste String here'>;
document.forms[0].submit();
Manual Steps:
You need to right click on Page URL and click Inspect.
On the Inspect page navigate to the Console tab and paste this code and Enter. This enables the CAPTCHA checkbox.
However, this is a manual activity. Hence you may create a workflow to automate this activity as mentioned in the next point.
Automation:
After the reCAPTCHA v3 step in the workflow you may put,
A single Plugin step Inject Java Script, with the above JavaScript in an Inject JavaScript step or else,
A combination of RPA Plugin steps to right click and inspect the page set the JavaScript code above as a variable in Modified Java Script step Web Set Value on console and perform Action specified in the Input Tab.
Common Buttons:
No.
Field Name
Description
Buttons:
1
OK
On click of this button. It will check the field values. If any required field values are missing then it will display validation error message.
If all the required field values are provided then it will save the field values.
2
Cancel
On click of this button, it will cancel the window and do not save any values