31 lines
1.1 KiB
Markdown
31 lines
1.1 KiB
Markdown
# Setting up matrix-ldap-registration-proxy (optional)
|
|
|
|
The playbook can install and configure [matrix-ldap-registration-proxy](https://gitlab.com/activism.international/matrix_ldap_registration_proxy) for you.
|
|
|
|
This proxy handles Matrix registration requests and forwards them to LDAP.
|
|
|
|
**Please note:** This does support the full Matrix specification for registrations. It only provide a very coarse
|
|
implementation of a basic password registration.
|
|
|
|
## Quickstart
|
|
|
|
Add the following configuration to your `inventory/host_vars/matrix.DOMAIN/vars.yml` file:
|
|
|
|
```yaml
|
|
matrix_ldap_registration_proxy_enabled: true
|
|
```
|
|
|
|
That is enough if you use the synapse external password provider via LDAP.
|
|
If you want to use your own credentials add the following to your `inventory/host_vars/matrix.DOMAIN/vars.yml`:
|
|
|
|
|
|
|
|
# LDAP credentials
|
|
```yaml
|
|
matrix_ldap_registration_proxy_ldap_uri: <URI>
|
|
matrix_ldap_registration_proxy_ldap_base_dn: <DN>
|
|
matrix_ldap_registration_proxy_ldap_user: <USER>
|
|
matrix_ldap_registration_proxy_ldap_password: <password>
|
|
```
|
|
TODO: is the block above correct? Else indicate that it can only be used with the LDAP password provider for Synapse
|