changeset 4679:f95a1e197a07

mod_auto_moved: New module implementing XEP-0283 r0.2.0
author Matthew Wild <mwild1@gmail.com>
date Sun, 12 Sep 2021 18:49:56 +0100 (2021-09-12)
parents 0bcbff950f14
children 59fdda04b87e
files mod_auto_moved/README.markdown mod_auto_moved/mod_auto_moved.lua mod_auto_moved/tests/moved.scs
diffstat 3 files changed, 305 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_auto_moved/README.markdown	Sun Sep 12 18:49:56 2021 +0100
@@ -0,0 +1,31 @@
+---
+summary: XEP-0283: Moved
+labels:
+- 'Stage-Alpha'
+...
+
+Introduction
+============
+
+This module implements [XEP-0283: Moved](http://xmpp.org/extensions/xep-0283.html),
+a way for contacts to notify you that they have moved to a new address.
+
+This module is not necessary to generate such notifications - that can be done
+by clients, for example. What this module does is automatically verify such
+notifications and, if verification is successful, automatically update your
+roster (contact list).
+
+Configuration
+=============
+
+There is no configuration for this module, just add it to
+modules\_enabled as normal.
+
+Compatibility
+=============
+
+  ----- -------
+  0.11  Does not work
+  ----- -------
+  trunk Works
+  ----- -------
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_auto_moved/mod_auto_moved.lua	Sun Sep 12 18:49:56 2021 +0100
@@ -0,0 +1,90 @@
+local id = require "util.id";
+local jid = require "util.jid";
+local promise = require "util.promise";
+local rm = require "core.rostermanager";
+local st = require "util.stanza";
+
+local errors = require "util.error".init(module.name, {
+	["statement-not-found"] = { type = "cancel", condition = "item-not-found" };
+	["statement-mismatch"] = { type = "cancel", condition = "conlict" };
+});
+
+module:hook("presence/bare", function (event)
+	local origin, stanza = event.origin, event.stanza;
+	if stanza.attr.type ~= "subscribe" then
+		return; -- We're only interested in subscription requests
+	end
+	local moved = stanza:get_child("moved", "urn:xmpp:moved:1");
+	if not moved then
+		return; -- We're only interested in stanzas with a moved notification
+	end
+
+	local verification = stanza:get_child("moved-verification", "https://prosody.im/protocol/moved");
+	if verification then
+		return; -- We already attempted to verify this stanza
+	end
+
+	module:log("debug", "Received moved notification from %s", stanza.attr.from);
+
+	local old_jid = moved:get_child_text("old-jid");
+	if not old_jid then
+		return; -- Failed to read old JID
+	end
+
+	local to_user = jid.node(stanza.attr.to);
+	local new_jid_unverified = jid.bare(stanza.attr.from);
+
+	if not rm.is_contact_subscribed(to_user, module.host, old_jid) then
+		return; -- Old JID was not an existing contact, ignore
+	end
+
+	if rm.is_contact_pending_in(to_user, module.host, new_jid_unverified)
+	or rm.is_contact_subscribed(to_user, module.host, new_jid_unverified) then
+		return; -- New JID already subscribed or pending, ignore
+	end
+
+	local moved_statement_query = st.iq({ to = old_jid, type = "get", id = id.short() })
+		:tag("pubsub", { xmlns = "http://jabber.org/protocol/pubsub" })
+			:tag("items", { node = "urn:xmpp:moved:1" })
+				:tag("item", { id = "current" }):up()
+			:up()
+		:up();
+	-- TODO: Catch and handle <gone/> errors per note in XEP-0283.
+	module:send_iq(moved_statement_query):next(function (reply)
+		module:log("debug", "Statement reply: %s", reply.stanza);
+		local moved_statement = reply.stanza:find("{http://jabber.org/protocol/pubsub}pubsub/items/{http://jabber.org/protocol/pubsub}item/{urn:xmpp:moved:1}moved");
+		if not moved_statement then
+			return promise.reject(errors.new("statement-not-found")); -- No statement found
+		end
+
+		local new_jid = jid.prep(moved_statement:get_child_text("new-jid"));
+		if new_jid ~= new_jid_unverified then
+			return promise.reject(errors.new("statement-mismatch")); -- Verification failed; JIDs do not match
+		end
+
+		-- Verified!
+		module:log("info", "Verified moved notification <%s> -> <%s>", old_jid, new_jid);
+
+		-- Add incoming subscription and respond
+		rm.set_contact_pending_in(to_user, module.host, new_jid);
+		rm.subscribed(to_user, module.host, new_jid);
+		module:send(st.presence({ to = new_jid, from = to_user.."@"..module.host, type = "subscribed" }));
+		rm.roster_push(to_user, module.host, new_jid);
+
+		-- Request outgoing subscription if old JID had one
+		if rm.is_user_subscribed(to_user, module.host, old_jid) then
+			module:log("debug", "Requesting subscription to new JID");
+			rm.set_contact_pending_out(to_user, module.host, new_jid);
+			module:send(st.presence({ to = new_jid, from = to_user.."@"..module.host, type = "subscribe" }));
+		end
+	end):catch(function (err)
+		module:log("debug", "Failed to verify moved statement for <%s> -> <%s>: %s", old_jid, new_jid_unverified, require "util.serialization".serialize(err, "debug"));
+		stanza:reset()
+			:tag("moved-verification", { xmlns = "https://prosody.im/protocol/moved", status = "failed" })
+			:up();
+		module:send(stanza, origin);
+	end);
+
+	-- Halt processing of the stanza, for now
+	return true;
+end, 1);
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_auto_moved/tests/moved.scs	Sun Sep 12 18:49:56 2021 +0100
@@ -0,0 +1,184 @@
+# XEP-0283: Moved
+
+[Client] Romeo
+	jid: romeo1@localhost
+	password: password
+
+[Client] RomeoNew
+	jid: romeo.new@localhost
+	password: password
+
+[Client] Juliet
+	jid: juliet.m@localhost
+	password: password
+
+-----
+
+# The parties connect
+Romeo connects
+
+Romeo sends:
+	<presence/>
+
+Romeo receives:
+	<presence from="${Romeo's full JID}"/>
+
+Juliet connects
+
+Juliet sends:
+	<presence/>
+
+Juliet receives:
+	<presence from="${Juliet's full JID}"/>
+
+RomeoNew connects
+
+RomeoNew sends:
+	<presence/>
+
+RomeoNew receives:
+	<presence from="${RomeoNew's full JID}"/>
+
+# They add each other
+Romeo sends:
+	<presence type="subscribe" to="${Juliet's JID}"/>
+
+Romeo receives:
+	<presence from="${Juliet's JID}" to="${Romeo's JID}" type="unavailable"/>
+
+Juliet receives:
+	<presence type="subscribe" to="${Juliet's JID}" from="${Romeo's JID}"/>
+
+Juliet sends:
+	<presence type="subscribed" to="${Romeo's JID}"/>
+
+Romeo receives:
+	<presence from="${Juliet's full JID}" to="${Romeo's JID}">
+	  <delay xmlns="urn:xmpp:delay" stamp="{scansion:any}" from="localhost"/>
+	</presence>
+
+Juliet sends:
+	<presence type="subscribe" to="${Romeo's JID}"/>
+
+Juliet receives:
+	<presence from="${Romeo's JID}" to="${Juliet's JID}" type="unavailable"/>
+
+Romeo receives:
+	<presence type="subscribe" to="${Romeo's JID}" from="${Juliet's JID}"/>
+
+Romeo sends:
+	<presence type="subscribed" to="${Juliet's JID}"/>
+
+Juliet receives:
+	<presence from="${Romeo's full JID}" to="${Juliet's JID}">
+	  <delay xmlns="urn:xmpp:delay" stamp="{scansion:any}" from="localhost"/>
+	</presence>
+
+Romeo receives:
+	<presence from="${Juliet's full JID}" to="${Romeo's JID}">
+	  <delay xmlns="urn:xmpp:delay" stamp="{scansion:any}" from="localhost"/>
+	</presence>
+
+# They request their rosters
+
+Juliet sends:
+	<iq type="get" id="roster1">
+		<query xmlns='jabber:iq:roster'/>
+	</iq>
+
+Juliet receives:
+	<iq type="result" id="roster1"/>
+
+RomeoNew sends:
+	<iq type="get" id="roster1">
+		<query xmlns='jabber:iq:roster'/>
+	</iq>
+
+RomeoNew receives:
+	<iq type="result" id="roster1"/>
+
+# They can now talk
+Juliet sends:
+	<message type="chat" to="${Romeo's JID}">
+	  <body>ohai</body>
+	</message>
+
+Romeo receives:
+	<message type="chat" to="${Romeo's JID}" from="${Juliet's full JID}">
+	  <body>ohai</body>
+	</message>
+
+# Romeo moves to a new account
+
+# Romeo publishes a moved statement
+
+Romeo sends:
+	<iq type='set' id='pub1'>
+		<pubsub xmlns='http://jabber.org/protocol/pubsub'>
+			<publish node='urn:xmpp:moved:1'>
+				<item id='current'>
+					<moved xmlns='urn:xmpp:moved:1'>
+						<new-jid>${RomeoNew's JID}</new-jid>
+					</moved>
+				</item>
+			</publish>
+			<publish-options>
+				<x xmlns='jabber:x:data' type='submit'>
+					<field var='FORM_TYPE' type='hidden'>
+						<value>http://jabber.org/protocol/pubsub#publish-options</value>
+					</field>
+					<field var='pubsub#access_model'>
+						<value>open</value>
+					</field>
+				</x>
+			</publish-options>
+		</pubsub>
+	</iq>
+
+Romeo receives:
+	<iq type="result" id="pub1">
+		<pubsub xmlns='http://jabber.org/protocol/pubsub'>
+			<publish node='urn:xmpp:moved:1'>
+				<item id='current'/>
+			</publish>
+		</pubsub>
+	</iq>
+
+
+
+# RomeoNew sends moved notification to Juliet
+RomeoNew sends:
+	<presence type="subscribe" to="${Juliet's JID}">
+		<moved xmlns="urn:xmpp:moved:1">
+			<old-jid>${Romeo's JID}</old-jid>
+		</moved>
+	</presence>
+
+RomeoNew receives:
+	<iq type='set' id="{scansion:any}">
+		<query ver="{scansion:any}" xmlns='jabber:iq:roster'>
+			<item jid="${Juliet's JID}" subscription='none' ask='subscribe'/>
+		</query>
+	</iq>
+
+# Juliet's server verifies and approves the subscription request
+
+RomeoNew receives:
+	<presence type="subscribed" from="${Juliet's JID}"/>
+
+RomeoNew receives:
+	<iq type='set' id="{scansion:any}">
+		<query ver="{scansion:any}" xmlns='jabber:iq:roster'>
+			<item jid="${Juliet's JID}" subscription='to' />
+		</query>
+	</iq>
+
+# Juliet's server notifies her via a roster push
+
+Juliet receives:
+	<iq type="set" id="{scansion:any}">
+		<query xmlns='jabber:iq:roster' ver='{scansion:any}'>
+			<item jid="${RomeoNew's JID}" subscription='from'/>
+		</query>
+	</iq>
+