Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

 

Table of Contents

Introduction

Invisible reCAPTCHA Form Plugin Element is developed by Chun Zhe to protect the the apps Element Plugin is used to protect forms developed in Joget DX platform from spams or abuse .The plugin can prevent hackers from using from malicious automated bots that are programmed to :

...

enter false or irrelevant information into a

...

Above are only some of the examples of what a bot (or spambot) could do to make disruptions to apps or websites. To further elaborate on the importance of a reCAPTCHA using a sample scenario: Malicious bot attacks can get abusive by gathering personal information of end-users that are being scammed into providing their private details to scam messages spammed by hackers.form, while being as transparent as possible to legitimate users of the platform.

Info
titleAbout reCAPTCHA

reCAPTCHA is a free Google service with the acronym of "Completely Automated Public Turing test to tell Computers and Humans Apart".

It can identify whether a Form is form is submitted by a real human or a bot.

For more information about reCAPTCHA, see: https://www.google.com/recaptcha/about/

Installing the plugin in Joget DX

You can follow the steps below, or refer to Manage Plugins to read more about managing the plugins:

  1. Download invisible-recaptcha-field-7.0.0.jar into your computer
  2. In the Joget DX platform, go to System Settings > Manage Plugins > Upload Plugin
  3. Click on Choose File and upload the File, select the .jar file you just downloadedClick , and click Upload

...

Using the plugin in a Form

In the Form Builder, open up any Form you have created before.

In this example, a Quick Request Form is being used for demonstration purposes.

Figure 1

that you wish to implement this feature for.

Search the Form Element Palette for Scroll your Palette until you find the Invisible reCAPTCHA element under the Marketplace section.

Drag and drop this element into your Form.


Click on the element in your form and the Edit Invisible reCAPTCHA board panel appears (on the right hand side).

Under In the Edit Invisible reCAPTCHA boardconfiguration, you are required to insert the information for the following fields:

...

Your ID can be any meaningful name you want (e.g.: invisible_recaptcha).

The next section will explain how to generate the required reCAPTCHA site key and reCAPTCHA secret key for the Invisible reCAPTCHAthis plugin.

Generating important keys for the plugin

You can follow the steps below, or refer to https://help.salesforce.com/s/articleView?id=sf.workdotcom_quemgmt_set_up_captcha_googlekeys.htm&type=5: this related guide online:

  1. Go to https://www.google.com/recaptcha/about/
  2. Click on v3 Admin Console at the navigation bar
  3. Give your Label a meaningful name (e.g.: recaptcha_test)

  4. For the reCAPTCHA Type, tick select reCAPTCHA v2 > Invisible reCAPTCHA badge

  5. Under Domains, put the domain name that your Joget DX instance is hosted on.

    Info
    titleSetting a domain name

    If you are using Joget DX on a local computer for development purposes, you can put your "localhost" as your domain name.

  6. Tick Accept the reCAPTCHA Terms of Service
  7. Click Submit

...


Image Added

Copy the generated reCAPTCHA site keys and reCAPTCHA secret keys.

Image Removed

Paste , and paste them into their respective fields in the Edit Invisible reCAPTCHA board configuration.

Remember to click Apply Change and Save in save the Form Builderform.

Info
titleImportant reCAPTCHA keys
  • Site keys can actually be shown publicly, but it is censored in this example.
  • Secret keys should must never be shown or shared with anyone, because the server uses it to verify reCAPTCHA responses upon form submission.

Testing out the plugin

...

Try submitting the Form form where you added the Invisible reCAPTCHA plugin.

If the bottom right corner of your Form page form shows the protected by reCAPTCHA pop-up, it means that the Invisible reCAPTCHA plugin is working as intended.

Info
titleEdit Invisible reCAPTCHA: Other configurations
  • Custom error text is returned when there is a plugin validation error
  • Debug mode can be enabled to help users find app designers indicate what the problem or error is

You can refer to Custom error text and Debug mode sections.

Tips: Hover on top of the tooltips (? icons icon) in Edit Invisible reCAPTCHA board configuration to read what each configuration properties mean and does.

Custom error text


Debug mode

...