Mercurial > prosody-modules

comparison mod_firewall/README.markdown @ 2342:6848297cf40a

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
mod_firewall: Add conditions for testing whether a sender of a stanza is in the recipient's roster (or in a certain roster group)
author Matthew Wild <mwild1@gmail.com>
date Fri, 04 Nov 2016 12:46:11 +0000
parents ce3dd93f30d9
children 97e63e8f0f32
comparison
equal deleted inserted replaced
2341:52dd2a51dac8 2342:6848297cf40a
201 201
202 **Note:** Some chains execute before Prosody has performed any 202 **Note:** Some chains execute before Prosody has performed any
203 normalisation or validity checks on the to/from JIDs on an incoming 203 normalisation or validity checks on the to/from JIDs on an incoming
204 stanza. It is not advisable to perform access control or similar rules 204 stanza. It is not advisable to perform access control or similar rules
205 on JIDs in these chains (see the chain documentation for more info). 205 on JIDs in these chains (see the chain documentation for more info).
206
207 ### Roster
208
209 These functions access the roster of the recipient (only). Therefore they cannot (currently)
210 be used in some chains, such as for outgoing messages (the recipient may be on another server).
211
212 Performance note: this check can potentially cause storage access (especially if the recipient
213 is currently offline), so you may want to limit its use in high-traffic situations, and place
214 it below other checks (such as a rate limiter).
215
216 #### IN_ROSTER
217
218 Tests whether the sender is in the recipient's roster.
219
220 IN_ROSTER: yes
221
222 #### IN_ROSTER_GROUP
223
224 Tests whether the sender is in the recipient's roster, and in the named group.
225
226 IN_ROSTER_GROUP: Friends
206 227
207 ### Time and date 228 ### Time and date
208 229
209 #### TIME 230 #### TIME
210 231