twenty/packages/twenty-docs
Deepak Kumar dc576d0818
GH-3546 Recaptcha on login form (#4626)
## Description

This PR adds recaptcha on login form. One can add any one of three
recaptcha vendor -
1. Google Recaptcha -
https://developers.google.com/recaptcha/docs/v3#programmatically_invoke_the_challenge
2. HCaptcha -
https://docs.hcaptcha.com/invisible#programmatically-invoke-the-challenge
3. Turnstile -
https://developers.cloudflare.com/turnstile/get-started/client-side-rendering/#execution-modes

### Issue
- #3546 

### Environment variables - 
1. `CAPTCHA_DRIVER` - `google-recaptcha` | `hcaptcha` | `turnstile`
2. `CAPTCHA_SITE_KEY` - site key
3. `CAPTCHA_SECRET_KEY` - secret key

### Engineering choices
1. If some of the above env variable provided, then, backend generates
an error -
<img width="990" alt="image"
src="https://github.com/twentyhq/twenty/assets/60139930/9fb00fab-9261-4ff3-b23e-2c2e06f1bf89">
    Please note that login/signup form will keep working as expected.
2. I'm using a Captcha guard that intercepts the request. If
"captchaToken" is present in the body and all env is set, then, the
captcha token is verified by backend through the service.
3. One can use this guard on any resolver to protect it by the captcha.
4. On frontend, two hooks `useGenerateCaptchaToken` and
`useInsertCaptchaScript` is created. `useInsertCaptchaScript` adds the
respective captcha JS script on frontend. `useGenerateCaptchaToken`
returns a function that one can use to trigger captcha token generation
programatically. This allows one to generate token keeping recaptcha
invisible.

### Note
This PR contains some changes in unrelated files like indentation,
spacing, inverted comma etc. I ran "yarn nx fmt:fix twenty-front" and
"yarn nx lint twenty-front -- --fix".

### Screenshots

<img width="869" alt="image"
src="https://github.com/twentyhq/twenty/assets/60139930/a75f5677-9b66-47f7-9730-4ec916073f8c">

---------

Co-authored-by: Félix Malfait <felix.malfait@gmail.com>
Co-authored-by: Charles Bochet <charles@twenty.com>
2024-04-25 23:52:28 +02:00
..
docs GH-3546 Recaptcha on login form (#4626) 2024-04-25 23:52:28 +02:00
src Fix playground (#5043) 2024-04-19 18:18:08 +02:00
static Docs: light icon fix (#4272) 2024-03-04 10:58:00 +01:00
.gitignore Migrate to a monorepo structure (#2909) 2023-12-10 18:10:54 +01:00
babel.config.js Migrate to a monorepo structure (#2909) 2023-12-10 18:10:54 +01:00
docusaurus.config.js Improve Documentation (#3795) 2024-02-05 15:01:37 +01:00
package.json fix: fix root start script (#5032) 2024-04-19 18:28:02 +02:00
README.md Migrate to a monorepo structure (#2909) 2023-12-10 18:10:54 +01:00
sidebars.js feat: adding metadata open-api endpoints and updating docs (#4170) 2024-03-05 11:37:16 +01:00
tsconfig.json 2915 rest api documentation (#3020) 2023-12-15 18:13:13 +01:00

Documentation

The docs here are managed through Docusaurus 2.

We recommend you go directly to the statically generated website rather than read them here.