Mercurial > prosody-modules
annotate mod_extdisco/README.markdown @ 4942:e7b9bc629ecc
mod_rest: Add special handling to catch MAM results from remote hosts
Makes MAM queries to remote hosts works.
As the comment says, MAM results from users' local archives or local
MUCs are returned via origin.send() which is provided in the event and
thus already worked. Results from remote hosts go via normal stanza
routing and events, which need this extra handling to catch.
This pattern of iq-set, message+, iq-result is generally limited to MAM.
Closest similar thing might be MUC join, but to really handle that you
would need the webhook callback mechanism.
| author | Kim Alvefur <zash@zash.se> |
|---|---|
| date | Mon, 16 May 2022 19:47:09 +0200 |
| parents | 4b47c8eeca22 |
| children |
| rev | line source |
|---|---|
| 1889 | 1 --- |
| 2 summary: External Service Discovery | |
| 3 ... | |
| 4 | |
| 5 Introduction | |
| 6 ============ | |
| 7 | |
| 8 This module adds support for [XEP-0215: External Service Discovery], | |
| 9 which lets Prosody advertise non-XMPP services. | |
| 10 | |
| 11 Configuration | |
| 12 ============= | |
| 13 | |
| 14 Example services from the XEP: | |
| 15 | |
| 16 ``` {.lua} | |
| 17 modules_enabled = { | |
| 18 -- other modules ... | |
| 19 "extdisco"; | |
| 20 } | |
| 21 | |
| 22 external_services = { | |
| 23 ["stun.shakespeare.lit"] = { | |
| 24 port="9998"; | |
| 25 transport="udp"; | |
| 26 type="stun"; | |
| 27 }; | |
| 28 ["relay.shakespeare.lit"] = { | |
| 29 password="jj929jkj5sadjfj93v3n"; | |
| 30 port="9999"; | |
| 31 transport="udp"; | |
| 32 type="turn"; | |
| 33 username="nb78932lkjlskjfdb7g8"; | |
| 34 }; | |
| 35 ["192.0.2.1"] = { | |
| 36 port="8888"; | |
| 37 transport="udp"; | |
| 38 type="stun"; | |
| 39 }; | |
| 40 ["192.0.2.1"] = { | |
| 41 port="8889"; | |
| 42 password="93jn3bakj9s832lrjbbz"; | |
| 43 transport="udp"; | |
| 44 type="turn"; | |
| 45 username="auu98sjl2wk3e9fjdsl7"; | |
| 46 }; | |
| 47 ["ftp.shakespeare.lit"] = { | |
| 48 name="Shakespearean File Server"; | |
| 49 password="guest"; | |
| 50 port="20"; | |
| 51 transport="tcp"; | |
| 52 type="ftp"; | |
| 53 username="guest"; | |
| 54 }; | |
| 55 } | |
| 56 ``` | |
|
4020
4b47c8eeca22
mod_extdisco, mod_turncredentials: Note incompatibility in readmes.
tastytea <tastytea@tastytea.de>
parents:
1889
diff
changeset
|
57 |
|
4b47c8eeca22
mod_extdisco, mod_turncredentials: Note incompatibility in readmes.
tastytea <tastytea@tastytea.de>
parents:
1889
diff
changeset
|
58 Compatibility |
|
4b47c8eeca22
mod_extdisco, mod_turncredentials: Note incompatibility in readmes.
tastytea <tastytea@tastytea.de>
parents:
1889
diff
changeset
|
59 ============= |
|
4b47c8eeca22
mod_extdisco, mod_turncredentials: Note incompatibility in readmes.
tastytea <tastytea@tastytea.de>
parents:
1889
diff
changeset
|
60 |
|
4b47c8eeca22
mod_extdisco, mod_turncredentials: Note incompatibility in readmes.
tastytea <tastytea@tastytea.de>
parents:
1889
diff
changeset
|
61 Incompatible with |
|
4b47c8eeca22
mod_extdisco, mod_turncredentials: Note incompatibility in readmes.
tastytea <tastytea@tastytea.de>
parents:
1889
diff
changeset
|
62 [mod_turncredentials](https://modules.prosody.im/mod_turncredentials). |