mod_restrict_xmpp

Introduction

This module enforces access policies using Prosody’s new roles and permissions framework. It can be used to grant restricted access to an XMPP account or services.

This module is still in its early stages, and prone to change. Feedback from testers is welcome. At this early stage, it should not be solely relied upon for account security purposes.

Configuration

There is no configuration, apart from Prosody’s normal roles and permissions configuration.

Permissions

xmpp:federate
Communicate with other users and services on other hosts on the XMPP network
xmpp:account:messages:read
Read incoming messages
xmpp:account:messages:write
Send outgoing messages
xmpp:account:presence:write
Update presence for the account
xmpp:account:contacts:read/xmpp:account:contacts:write
Controls access to the contact list (roster)
xmpp:account:bookmarks:read/xmpp:account:bookmarks:write
Controls access to the bookmarks (group chats list)
xmpp:account:profile:read/xmpp:account:profile:write
Controls access to the user’s profile (e.g. vCard/avatar)
xmpp:account:omemo:read/xmpp:account:omemo:write
Controls access to the user’s OMEMO data
xmpp:account:blocklist:read/xmpp:account:blocklist:write
Controls access to the user’s block list
xmpp:account:disco:read
Controls access to the user’s service discovery information

Compatibility

Requires Prosody trunk 72f431b4dc2c (build 1444) or later.


Installation

With the plugin installer in Prosody 0.12 you can use:

sudo prosodyctl install --server=https://modules.prosody.im/rocks/ mod_restrict_xmpp

For earlier versions see the documentation for installing 3rd party modules