2015-03-30 19:27:42 +02:00
|
|
|
Captcha can be enabled for this home server. This file explains how to do that.
|
2015-03-30 19:18:19 +02:00
|
|
|
The captcha mechanism used is Google's ReCaptcha. This requires API keys from Google.
|
|
|
|
|
|
|
|
|
|
Getting keys
|
|
|
|
|
------------
|
|
|
|
|
Requires a public/private key pair from:
|
|
|
|
|
|
|
|
|
|
https://developers.google.com/recaptcha/
|
|
|
|
|
|
2019-05-29 05:04:24 +02:00
|
|
|
Must be a reCAPTCHA v2 key using the "I'm not a robot" Checkbox option
|
2015-03-30 19:18:19 +02:00
|
|
|
|
2015-03-30 19:27:42 +02:00
|
|
|
Setting ReCaptcha Keys
|
|
|
|
|
----------------------
|
2016-12-01 13:01:54 +01:00
|
|
|
The keys are a config option on the home server config. If they are not
|
|
|
|
|
visible, you can generate them via --generate-config. Set the following value::
|
2015-03-30 19:18:19 +02:00
|
|
|
|
2015-03-30 19:27:42 +02:00
|
|
|
recaptcha_public_key: YOUR_PUBLIC_KEY
|
2015-03-30 19:18:19 +02:00
|
|
|
recaptcha_private_key: YOUR_PRIVATE_KEY
|
2016-12-01 13:01:54 +01:00
|
|
|
|
|
|
|
|
In addition, you MUST enable captchas via::
|
2015-03-30 19:18:19 +02:00
|
|
|
|
|
|
|
|
enable_registration_captcha: true
|
|
|
|
|
|
|
|
|
|
Configuring IP used for auth
|
|
|
|
|
----------------------------
|
|
|
|
|
The ReCaptcha API requires that the IP address of the user who solved the
|
|
|
|
|
captcha is sent. If the client is connecting through a proxy or load balancer,
|
|
|
|
|
it may be required to use the X-Forwarded-For (XFF) header instead of the origin
|
2017-02-09 06:21:02 +01:00
|
|
|
IP address. This can be configured using the x_forwarded directive in the
|
|
|
|
|
listeners section of the homeserver.yaml configuration file.
|
