CRMJettyBack to crmjetty.comContact us
Menu
Docs / Guides

CRMJetty Portal

Works with
Docs / Dynamics 365

Dynamics 365 Customer Portalv6.3.0

Docs / Salesforce

Salesforce Customer Portalv6.3.0

Docs / Business Central

Business Central Portal

Guides / Login and security

How to Add reCAPTCHA to Portal Forms

4 min readUpdated
Short answerRegister your portal domain with Google reCAPTCHA to get a site key and secret key. In Settings → Portal Settings → Site Management, edit your site, turn on Enable reCAPTCHA, choose V2 or V3 and enter both keys. Then turn on Enable reCAPTCHA in each widget you want to protect and publish the page.

Google reCAPTCHA checks that a person, not a bot, is using your portal. Turn it on for your site once, then switch it on in the forms and widgets you want to protect, such as login, registration, forgot password and public forms.

Before you start

Choose reCAPTCHA V2 or V3

reCAPTCHA V2 reCAPTCHA V3
What portal users see An “I’m not a robot” checkbox at the end of the form or widget. They must select it before they submit. Nothing to select. A reCAPTCHA badge shows in the corner of the screen, and the check runs in the background using a score.
Where it applies Form, Login, Registration and Forgot Password widgets, and sub-grid forms in the Form Builder. Pages, and the Form, Login, Registration, Forgot Password, List, Recent Activity, Case Deflection, Chart, Counter, Knowledge Base and Search widgets, and sub-grid forms in the Form Builder.
Keys Site key and secret key Site key and secret key

Choose V2 for a visible check on forms. Choose V3 to protect more of the portal without asking portal users to do anything.

Get your reCAPTCHA keys

  1. Open the Google reCAPTCHA admin console and register a new site.
  2. Choose the reCAPTCHA version you picked.
  3. Add your portal domain.
  4. Copy the site key and the secret key.
Key What it does
Site key Shows reCAPTCHA on the portal page. It is public.
Secret key Lets the portal validate the response on the server. Keep it private.

Turn on reCAPTCHA for your site

  1. Go to Settings → Portal Settings → Site Management.
  2. Open your site for editing.
  3. Go to reCAPTCHA Configuration.
  4. Turn on Enable reCAPTCHA.
  5. Select the version: V2 or V3.
  6. Enter the Site Key.
  7. Enter the Secret Key.
  8. Select Save.
Site Management → reCAPTCHA Configuration with Enable reCAPTCHA turned on, V2 selected and the Site Key and Secret Key fields filled in
Site Management → reCAPTCHA Configuration with Enable reCAPTCHA turned on, V2 selected and the Site Key and Secret Key fields filled in
Site Management → reCAPTCHA Configuration with Enable reCAPTCHA turned on, V2 selected and the Site Key and Secret Key fields filled in
Site Management → reCAPTCHA Configuration with Enable reCAPTCHA turned on, V2 selected and the Site Key and Secret Key fields filled in

If you run several sites, set up reCAPTCHA for each site. See How to Create and Manage Multiple Portal Sites.

Turn on reCAPTCHA in a widget

The site setting makes reCAPTCHA available. Each widget then has its own Enable reCAPTCHA setting, and uses the version you chose for the site.

  1. Go to Design → Page Builder and edit the page.
  2. Select the Settings icon on the widget.
  3. Turn on Enable reCAPTCHA.
  4. Select Save.
  5. Select Publish.
Login widget settings panel with Enable reCAPTCHA turned on
Login widget settings panel with Enable reCAPTCHA turned on
Login widget settings panel with Enable reCAPTCHA turned on
Login widget settings panel with Enable reCAPTCHA turned on

These widgets have an Enable reCAPTCHA setting:

Widget What reCAPTCHA protects
Login Sign-in.
Registration New portal user sign-up.
Forgot Password Password reset requests.
Forgot Username Username recovery requests.
Form Form submissions.
Profile Profile updates.
List Sub-grids in the list.

Tip: Always turn on reCAPTCHA for forms on public pages, which anyone can submit. See How to Create Public Forms Without Login.

Troubleshooting

reCAPTCHA doesn’t appear on the page: Check that Enable reCAPTCHA is on for the site and in the widget, then publish the page again.

reCAPTCHA shows an error or portal users can’t submit: Check that the keys were created for the version selected in the site settings and for your portal domain. Re-enter the Site Key and Secret Key and save.

Did this solve it?No, contact support