mod_admin_blocklist/README.markdown
author Matthew Wild <mwild1@gmail.com>
Wed, 19 Jun 2024 16:54:52 +0100
changeset 5928 2b80188448d1
parent 5021 96e83b4a93f7
permissions -rw-r--r--
mod_cloud_notify_encrypted: Add runtime dependency on mod_cloud_notify

---
summary: Block s2s connections based on admin blocklists
...

This module uses the blocklists set by admins for blocking s2s
connections.

So if an admin blocks a bare domain using [Blocking Command][xep191]
via [mod\_blocklist][doc:modules:mod_blocklist] then no s2s connections
will be allowed to or from that domain.

# Configuring

## Prosody 0.12

Starting with Prosody 0.12, the role or roles that determine whether a
particular users blocklist is used can be configured:

```lua
-- This is the default:
admin_blocklist_roles = { "prosody:operator", "prosody:admin" }
```

## Prosody 0.11

In Prosody 0.11 the [`admins`][doc:admins] setting is used.