ejabberd-contrib/mod_deny_omemo/README.md

1.3 KiB

mod_deny_omemo - Prevent OMEMO sessions from being established

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