CAPTCHA

CAPTCHA



CAPTCHA

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

Description


DBC: Image is a step in the Utilty PluginDBC: 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.


Description


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

Description

DBC: reCAPTCHA v2 Checkbox step, gets the token to solve reCAPTCHA v2 Checkbox. 


References:

  1. How  to use token to solve reCAPTCHA

https://www.deathbycaptcha.com/user/api/newtokenrecaptcha


Notes:

  1. To solve reCAPTCHA pass the Token Text received in response, to an Inject JavaScript step to complete action of handling the output Token to process reCAPTCHA.



Description


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-

  1. When the DBC service is temporarily unavailable
  2. 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

Description

DBC: reCAPTCHA v3 step gets the token to solve reCAPTCHA v3.



Notes:

How  to use token to solve reCAPTCHA
To solve reCAPTCHA using plugin step pass the Token Text received in response to - Inject JavaScript step and complete action.


Description


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-

  1. When the DBC service is temporarily unavailable
  2. 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





      Links to better reach 

            Bot Store

             EPD