Adding Google ReCaptcha

1. Ensure you comply with the pre-requisites at Pre-Requisites (Virtual Networks) and Pre-Requisites (in that order) and you have access to the Google Developer Console.

2. Login with your Google account and navigate to the ReCaptcha Admin Console for your site.

3. Copy the Site Key and Secret Key to a secure place, you will need these later.

4. Add the domain of your current SmartDocumentor instance to the ReCaptcha configuration (do not include http:// or https://):

   1. If you have a Custom Domain set according to Adding a Custom Domain, set "my.domain.net" to that value.

   2. If you do not have a Custom Domain, use the default domain Azure assigned to the smart-documentor Container App. You can find this by navigating to the smart-documentor resource and copying the URL in the Initial/Overwiew page in the top right under Application Url

5. With these two values copied, navigate to the resource group and find the Key Vault resource with the name kv-app-config-xxxxxx , where the last 6 characters are unique to your deployment.

   1. Click the "Secrets" tab under "Objects" on the left.

   2. Add the following three secrets with the following parameters:

      1. Name: Recaptcha--Active , with value true.

      2. Name: Recaptcha--Settings--SecretKeyV3 , with the value set to the Secret Key you copied in the previous step.

      3. Name: Recaptcha--Settings--SiteKeyV3 , with the value set to the Site Key you copied in the previous step.

6. Navigate to the smart-documentor Container App and click the "Containers" tab under "Application". In this page, click "Save as a new revision" and wait until the revision is applied. If "Save as a new revision" is not available, simply disable and re-enable the container in the "Overview" tab.

7. If your open SmartDocumentor in your browser and try to register a new account, the register page should display a ReCaptcha badge at the bottom right corner.

"Save as a new revision" is equivalent to an application restart. For configuration secrets to be applied, a restart is always necessary.