view mod_server_contact_info/README.md @ 6319:04c3273cb81f

mod_auth_cyrus: Add empty 'profile' table to SASL handler objects This is for compatibility with Prosody's built-in util.sasl objects. A SASL profile table usually includes methods supported by the backend, which can be used by SASL mechanism handlers to perform operations (such as testing the password). It also optionally contains a 'cb' field with channel binding method handlers. The Cyrus backend doesn't support channel binding, and doesn't have the same concept of auth backend methods (it handles all that internally, and Prosody has no insight or control over it). Thus, we create an empty profile which informs Prosody that the SASL handler does not support any of the auth or channel binding methods. Some features will not work, but they didn't work anyway. This just makes it explicit. This fixes a traceback in mod_sasl2_fast, which expected SASL handlers to always contain a 'profile' field.
author Matthew Wild <mwild1@gmail.com>
date Thu, 04 Sep 2025 10:14:46 +0100
parents 254a21a104aa
children
line wrap: on
line source

---
labels:
- 'Stage-Alpha'
summary: Backported mod_server_contact_info for Prosody 0.12
...

## Overview

In February 2024 we improved the internal API to allow multiple modules to
publish information about the server, this includes mod_pubsub_serverinfo.

Although Prosody 0.12 comes with its own mod_server_contact_info, this version
uses the new API so that 0.12 users can hopefully use mod_pubsub_serverinfo
and other modules which use the new API.

To use it, you must ensure that your Prosody 0.12 deployment is loading *both*
mod_server_contact_info **and** mod_server_info community modules.

Configuration of contact addresses is the same, whatever version of the module
you use. See the official documentation on [Prosody's mod_server_contact_info](https://prosody.im/doc/modules/mod_server_contact_info)
page.

## Compatibility

This module should be compatible with Prosody 0.12, and will fail to load in
later versions (which already provide the same functionality without community
modules).