annotate mod_s2soutinjection/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 4cc3d3de74a7
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1999
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
1 ---
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
2 summary: S2S connection override
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
3 ...
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
4
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
5 # Introduction
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
6
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
7 This module is similar to [mod\_srvinjection] but less of an hack.
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
8
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
9 # Configuration
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
10
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
11 ``` lua
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
12 -- In the global section
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
13
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
14 modules_enabled = {
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
15 --- your other modules
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
16 "s2soutinjection";
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
17 }
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
18
4931
f4a9e804c457 mod_s2soutinjection: Rewrite based on mod_onions for 0.12 compat (thanks Zash)
moparisthebest <admin@moparisthebest.com>
parents: 1999
diff changeset
19 -- targets must be IPs, not hostnames
1999
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
20 s2s_connect_overrides = {
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
21 -- This one will use the default port, 5269
4931
f4a9e804c457 mod_s2soutinjection: Rewrite based on mod_onions for 0.12 compat (thanks Zash)
moparisthebest <admin@moparisthebest.com>
parents: 1999
diff changeset
22 ["example.com"] = "1.2.3.4";
1999
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
23
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
24 -- To set a different port:
4931
f4a9e804c457 mod_s2soutinjection: Rewrite based on mod_onions for 0.12 compat (thanks Zash)
moparisthebest <admin@moparisthebest.com>
parents: 1999
diff changeset
25 ["another.example"] = { "127.0.0.1", 9999 };
1999
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
26 }
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
27 ```
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
28
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
29 # Compatibility
e3e76e9693a1 mod_s2soutinjection: Add a README
Kim Alvefur <zash@zash.se>
parents:
diff changeset
30
6246
5955ec5c173e mod_s2soutinjection: Update compatibility info
Kim Alvefur <zash@zash.se>
parents: 5975
diff changeset
31 Prosody version Status
5955ec5c173e mod_s2soutinjection: Update compatibility info
Kim Alvefur <zash@zash.se>
parents: 5975
diff changeset
32 ----------------- ---------------
6313
4cc3d3de74a7 mod_s2soutinjection: Update to override resolver for 13.0 compatibility
Kim Alvefur <zash@zash.se>
parents: 6246
diff changeset
33 13.0.x Should work
4cc3d3de74a7 mod_s2soutinjection: Update to override resolver for 13.0 compatibility
Kim Alvefur <zash@zash.se>
parents: 6246
diff changeset
34 0.12.4 and later Works
4cc3d3de74a7 mod_s2soutinjection: Update to override resolver for 13.0 compatibility
Kim Alvefur <zash@zash.se>
parents: 6246
diff changeset
35 0.12.3 and older Does not work