How to Add Google reCAPTCHA v3 to the ADCS Plus Login Page

How to Add Google reCAPTCHA v3 to the ADCSP Login Page

Google reCAPTCHA v3 can be integrated into the ADCSP Login page to help protect the portal from spam, automated attacks, and other abusive activity. reCAPTCHA v3 uses Google’s risk-analysis engine to assess user interactions and assign a score without requiring users to complete interactive challenges in most cases. This helps legitimate users access the ADCSP Portal with minimal friction while providing an additional layer of security against automated activity.


Steps to Generate Google reCAPTCHA v3 for the ADCSP Portal Login Form

  1. Open the Google reCAPTCHA Admin Console

        Go to the Google reCAPTCHA Admin Console.

       

   2. Configure Your reCAPTCHA Settings

        Configure the following settings:

  • Label: Enter a descriptive name for the reCAPTCHA configuration e.g., ADCSP Portal
  • reCAPTCHA Type: Select Score based (v3). reCAPTCHA v3 assigns a risk score between 0.0 and 1.0, where lower scores generally indicate a higher likelihood of automated or suspicious activity.
  • Domains: Enter the domain used by your ADCSP Portal, for example, YourAdcspPortal.com. Do not include port numbers, paths, query parameters, or URL fragments.
  • Project Name: Select the appropriate Google Cloud Project name from drop down.
     

Click Submit. Google will generate the Site Key and Secret Key required to configure reCAPTCHA for the ADCSP Portal.
 
 A screenshot of a computerDescription automatically generated

Configure ADCSP with the Site Key and Secret Key

1. Add the Site Key

  • Open the PortalConfig.xml file located at:

        C:\Program Files\ADCS Plus Portal\Portal\wwwroot\Configs\PortalConfig.xml

  • Add the Site Key to the appropriate reCAPTCHA configuration field.
     
     

2. Add the Secret Key

  • Open the appsettings.json file located at:

        C:\Program Files\ADCS Plus Portal\Portal\appsettings.json

  • Add the Secret Key to the appropriate reCAPTCHA configuration field.

Important: Keep the Secret Key confidential. Do not expose it in client-side code, screenshots, documentation, or publicly accessible repositories.
 
 

Verify the Configuration:

Save the configuration changes and access the ADCSP Portal Login page.

If the configuration is correct, Google reCAPTCHA v3 will operate on the login page and provide an additional layer of protection against automated and abusive login activity.


If you need assistance configuring Google reCAPTCHA v3 for the ADCSP Portal, please contact the Hosting Controller Support team at support@hostingcontroller.com.