No description
Find a file
transcaffeine 8f7924cb32
feat(modules): add uia-based matrix login module
Test the module with: `PASSWORD=abc echo '{"ANSIBLE_MODULE_ARGS": {"hs_url": "https://test-sp-gen-1.famedly.de","user_id": "admin","password": "$PASSWORD"}}' | python ansible_collections/famedly/matrix/plugins/modules/matrix_uia_login.py`
2020-12-10 12:43:01 +01:00
plugins/modules feat(modules): add uia-based matrix login module 2020-12-10 12:43:01 +01:00
roles update(element): bump version to 1.7.15 2020-12-09 12:59:38 +01:00
.editorconfig Make the ansible linter happy 2019-02-18 00:27:45 +01:00
.gitignore chore: ignore built collection artifact 2020-08-10 13:11:08 +02:00
.gitlab-ci.yml ci: build/publish collection from CI 2020-08-10 13:11:08 +02:00
CHANGELOG.md chore: bump version to 0.2.2 and update changelog 2020-11-18 22:37:43 +01:00
CODEOWNERS docs: add README for collection 2020-08-10 11:40:58 +02:00
galaxy.yml chore: bump version to 0.2.2 and update changelog 2020-11-18 22:37:43 +01:00
LICENSE.md add README, LICENSE and CODEOWNER 2020-02-14 01:49:48 +01:00
README.md feat(modules): add synapse_register module 2020-10-09 17:35:06 +02:00

Ansible Collection - famedly.matrix

Modules

This collection contains a few modules for managing matrix rooms and servers, as well as sending notifications from ansible to matrix.

  • matrix_login: Create an access token for a matrix account.
  • matrix_logout: Invalidates an access token.
  • matrix_notification: Sends a message to a matrix room.
  • matrix_room: Idempotently joins/creates a room with a given alias.
  • matrix_state: Ensures room state has a given content.
  • matrix_member: Ensures room memberships are correct.
  • matrix_signing_key: Creates a server signing key.
  • synapse_register: Registers a user using synapse's admin API.

You can find more information and a sample playbook for these modules in the README in ./plugins/modules/

Roles

In addition to the modules, this role also contains a few roles for deploying commonly used matrix services:

  • synapse: Homeserver, this is where your accounts live.
  • element: Web client, for using your accounts.

For details on using these, look at the README.md in the respective role directory.