diff options
| author | Richard van der Hoff <richard@matrix.org> | 2016-12-03 13:08:53 +0000 |
|---|---|---|
| committer | Richard van der Hoff <richard@matrix.org> | 2016-12-03 13:08:53 +0000 |
| commit | 59984e9f5872348e709fd52a729084b722bf8828 (patch) | |
| tree | b79d0ef4b9f00385a442527eb098f1e9d7413dd4 /docs/CAPTCHA_SETUP.rst | |
| parent | Merge pull request #1664 from kyrias/preview-url-resource-encoding (diff) | |
| parent | Merge pull request #1667 from matrix-org/rav/update_readme (diff) | |
| download | synapse-59984e9f5872348e709fd52a729084b722bf8828.tar.xz | |
Merge remote-tracking branch 'origin/master' into develop
Diffstat (limited to 'docs/CAPTCHA_SETUP.rst')
| -rw-r--r-- | docs/CAPTCHA_SETUP.rst | 30 |
1 files changed, 30 insertions, 0 deletions
diff --git a/docs/CAPTCHA_SETUP.rst b/docs/CAPTCHA_SETUP.rst new file mode 100644 index 0000000000..db621aedfc --- /dev/null +++ b/docs/CAPTCHA_SETUP.rst @@ -0,0 +1,30 @@ +Captcha can be enabled for this home server. This file explains how to do that. +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/ + + +Setting ReCaptcha Keys +---------------------- +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:: + + recaptcha_public_key: YOUR_PUBLIC_KEY + recaptcha_private_key: YOUR_PRIVATE_KEY + +In addition, you MUST enable captchas via:: + + 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 +IP address. This can be configured as an option on the home server like so:: + + captcha_ip_origin_is_x_forwarded: true |