ejabberd-contrib/mod_deny_omemo
Holger Weiss 7d2a7aa418 mod_deny_omemo: Fix hook_result() type 2018-03-27 00:21:35 +02:00
..
conf Import mod_deny_omemo 2018-03-19 22:58:32 +01:00
src mod_deny_omemo: Fix hook_result() type 2018-03-27 00:21:35 +02:00
COPYING Import mod_deny_omemo 2018-03-19 22:58:32 +01:00
README.txt Import mod_deny_omemo 2018-03-19 22:58:32 +01:00
mod_deny_omemo.spec Import mod_deny_omemo 2018-03-19 22:58:32 +01:00

README.txt

	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.


	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 returns 'allow'.