2021-04-15 14:10:56 +00:00
# Ansible Collection - `famedly.matrix`
2020-08-01 17:24:50 +00:00
2021-10-19 12:06:31 +00:00
2020-08-10 09:40:58 +00:00
## Modules
2021-04-15 14:10:56 +00:00
This collection contains modules for managing matrix rooms
and more via ansible. They can modify room membership,
aliases, server signing keys and even send messages into
rooms from within ansible.
2020-08-10 09:40:58 +00:00
2021-04-15 14:10:56 +00:00
- [`matrix_login` (source) ](plugins/modules/matrix_login.py ):
Create an access token for a matrix account.
- [`matrix_login` (source) ](plugins/modules/matrix_login.py ):
Create an access token for a matrix account.
Logs in with user and password to obtain a matrix access token
- [`matrix_uia_login` (source) ](plugins/modules/matrix_uia_login.py ):
Logs in with user and password to obtain a matrix access token, while
implementing [user-interactive authentication ](https://spec.matrix.org/unstable/client-server-api/#user-interactive-authentication-api )
on the `_matrix/client/r0/login` endpoint (see [MSC2835 ](https://github.com/Sorunome/matrix-doc/blob/soru/uia-on-login/proposals/2835-uia-on-login.md )).
- [`matrix_logout` (source) ](plugins/modules/matrix_logout.py ):
Invalidates an access token.
- [`matrix_notification` (source) ](plugins/modules/matrix_notification.py ):
Sends a message to a matrix room.
- [`matrix_room` (source) ](plugins/modules/matrix_room.py ):
Idempotently joins/creates a room with a given alias.
- [`matrix_state` (source) ](plugins/modules/matrix_state.py ):
Can be used to set matrix state events to a room.
- [`matrix_member` (source) ](plugins/modules/matrix_member.py ):
Can be used to manipulate matrix room membership.
- [`matrix_signing_key` (source) ](plugins/modules/matrix_signing_key.py ):
Creates a server signing key.
- [`synapse_register` (source) ](plugins/modules/synapse_register.py ):
Registers a user using synapse's admin API.
2021-05-05 05:32:06 +00:00
- [`synapse_ratelimit` (source) ](plugins/modules/synapse_ratelimit.py ):
Gets / Sets / Deletes a (local) users ratelimits
2021-04-15 14:10:56 +00:00
For more information on how to use the modules to manage matrix rooms
via ansible, the [README in `./plugins/modules/` ](plugins/modules/README.md )
provides more detailed information and an example playbook.
2020-10-03 01:02:10 +00:00
2020-08-10 09:40:58 +00:00
## Roles
In addition to the modules, this role *also* contains a few roles for
deploying commonly used matrix services:
2021-04-15 14:10:56 +00:00
- [`synapse` ](roles/synapse/README.md ): synapse, a reference matrix homeserver
implementation in python, maintained mostly by element.
- [`element` ](roles/element/README.md ): element-web, a reference matrix client implementation,
able to run in the browser, maintained by element.
- [`hedwig` ](roles/hedwig/README.md ): Hedwig, a push-gateway server alternative
to `sygnal` , developed by Famedly.
2023-07-06 20:40:17 +00:00
- [`barad_dur` ](roles/barad_dur/README.md ): Barad-dûr, a matrix phone-home stats collector alternative, developed by Famedly.
2021-10-21 10:28:58 +00:00
### Unmaintained roles
2021-10-21 10:00:44 +00:00
- [`sygnal` ](roles/sygnal/README.md ): reference implementation of a matrix push gateway, unmaintained and no longer in use
2021-10-21 10:28:15 +00:00
- [`panopticon` ](roles/panopticon/README.md ): matrix phone-home stats collector, created by element, role unmaintained
