25 lines
994 B
Markdown
25 lines
994 B
Markdown
# ppfun-auth-module for matrix-synapse
|
|
|
|
Allows pixelplanet users to login with their credentials on matrix.
|
|
|
|
## Installation
|
|
|
|
Put `ppfun_auth.py` into the python PATH of synapse, sometimes it is `/usr/local/lib/python3.8/site-packages/ppfun_auth.py` or in Debian / Ubuntu distribution in `/opt/venvs/matrix-synapse/...`.
|
|
|
|
## Configuration (`homeserver.yml`):
|
|
|
|
```yaml
|
|
modules:
|
|
- module: ppun_auth.PPfunAuthProvider
|
|
config:
|
|
apisocketkey: "APISOCKETKEY_CONFIGURED_IN_PIXELPLANET"
|
|
ppfunurl: "http://local.pixelplanet.url:port"
|
|
# if true, only mail-verified users can log in
|
|
verified: true
|
|
```
|
|
## References
|
|
|
|
- [synapse documentation about Pluggable Modules](https://matrix-org.github.io/synapse/latest/modules/index.html)
|
|
- [synapse ModuleAPI class](https://github.com/matrix-org/synapse/blob/master/synapse/module_api/__init__.py)
|
|
- [matrix-synapse-ldap3](https://github.com/matrix-org/matrix-synapse-ldap3/blob/main/ldap_auth_provider.py) as a different example
|