35d05f2925 | ||
---|---|---|
.. | ||
conf | ||
src | ||
COPYING | ||
README.md | ||
mod_deny_omemo.spec |
README.md
mod_deny_omemo - Prevent OMEMO sessions from being established
- Author: Holger Weiss holger@zedat.fu-berlin.de
Description
Unless the configured access rule (called omemo
by default) returns
allow
, this module prevents OMEMO sessions from being established.
Requests to query the devicelist from other users are rejected. Requests
to publish a devicelist are also rejected, and all OMEMO nodes referenced
in that devicelist are removed. Incoming devicelist updates are silently
dropped. OMEMO-encrypted messages are bounced with an error message.
Configuration
In order to use this module, add configuration snippets such as the following:
access_rules:
# [...]
omemo:
- deny:
- user: "alice@example.com"
- user: "bob@example.com"
- allow # Permit OMEMO except for the JIDs above.
modules:
# [...]
mod_deny_omemo: {}
The configurable mod_deny_omemo
options are:
-
access
(default:omemo
)This option defines the access rule to control who will be able to establish OMEMO sessions. The default value is
omemo
. Establishing OMEMO sessions is only permitted if an access rule of that name exists and returnsallow
.