---
title: "Configure reCAPTCHA - Lacuna PSC"
description: "Configuring Google reCAPTCHA in Lacuna PSC so API requests from the website come from a human, not a bot, using an invisible reCAPTCHA v2 site."
canonical: "https://docs.lacunasoftware.com/en-us/articles/psc/on-premises/configure-recaptcha"
locale: "en"
product: "PSC"
last_updated: "2026-07-14"
---

# Configure reCAPTCHA - Lacuna PSC

[Lacuna PSC](https://docs.lacunasoftware.com/en-us/articles/psc) uses [Google reCAPTCHA](https://developers.google.com/recaptcha) to protect the API from abuse by ensuring that API requests
claiming to have come from the website were indeed originated by a human operator and not an automated bot.

> **Note**
>
> Enabling both reCAPTCHA and [Firebase App Check](https://docs.lacunasoftware.com/en-us/articles/psc/on-premises/configure-firebase) is essential in production environments to protect the API from abuse

## Create a reCAPTCHA project

1. Sign in to the [Google reCAPTCHA admin console](https://www.google.com/recaptcha/admin)
1. On the *Register a new site* form, fill out:
   * A **label** of your choice, e.g. `My PSC`
   * Select **reCAPTCHA v2**, then **Invisible reCAPTCHA badge**
   * Type the **domain** of your Lacuna PSC instance, e.g. `psc.yourcompany.com`
   * Accept the terms of service
1. Click on **Submit**
1. Copy the **site key** and the **secret key**

## Configuring Lacuna PSC

Having both keys, edit the Lacuna PSC configuration file and fill the section **Recaptcha**, settings **SiteKey** and **SecretKey**.

Example (*.ini* or *.conf* file):

```ini
[Recaptcha]
SiteKey=6LdfItkZAAAAAIxxxxxxxxxxxxxxxxxxxxxxxxxx
SecretKey=6LdfItkZAAAAALxxxxxxxxxxxxxxxxxxxxxxxxxx
```

Example (environment variables):

```sh
Recaptcha__SiteKey=6LdfItkZAAAAAIxxxxxxxxxxxxxxxxxxxxxxxxxx
Recaptcha__SecretKey=6LdfItkZAAAAALxxxxxxxxxxxxxxxxxxxxxxxxxx
```

## See also

* [Configure Firebase](https://docs.lacunasoftware.com/en-us/articles/psc/on-premises/configure-firebase)
* [Lacuna PSC on-premises](https://docs.lacunasoftware.com/en-us/articles/psc/on-premises)