Changeset

989:7c04c5856daa

mod_register_json: major code overhaul into a token based registration & verification system.
author Marco Cirillo <maranda@lightwitch.org>
date Mon, 29 Apr 2013 22:53:39 +0200
parents 988:c15cea87036f
children 990:17ba2c59d661
files mod_register_json/mod_register_json.lua mod_register_json/register_json/mod_register_json.lua mod_register_json/register_json/template/css/style.css mod_register_json/register_json/template/fail_t.html mod_register_json/register_json/template/form_t.html mod_register_json/register_json/template/images/header.png mod_register_json/register_json/template/images/tile.png mod_register_json/register_json/template/success_t.html
diffstat 8 files changed, 398 insertions(+), 132 deletions(-) [+]
line wrap: on
line diff
--- a/mod_register_json/mod_register_json.lua	Thu Apr 25 17:37:33 2013 +0200
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,132 +0,0 @@
--- Expose a simple servlet to handle user registrations from web pages
--- via JSON.
---
--- A Good chunk of the code is from mod_data_access.lua by Kim Alvefur
--- aka Zash.
-
-local jid_prep = require "util.jid".prep
-local jid_split = require "util.jid".split
-local usermanager = usermanager
-local b64_decode = require "util.encodings".base64.decode
-local json_decode = require "util.json".decode
-local os_time = os.time
-local nodeprep = require "util.encodings".stringprep.nodeprep
-
-module:depends("http")
-
--- Pick up configuration.
-
-local secure = module:get_option_boolean("reg_servlet_secure", false)
-local set_realm_name = module:get_option_string("reg_servlet_realm", "Restricted")
-local base_path = module:get_option_string("reg_servlet_base", "/register_account/")
-local throttle_time = module:get_option_number("reg_servlet_ttime", nil)
-local whitelist = module:get_option_set("reg_servlet_wl", {})
-local blacklist = module:get_option_set("reg_servlet_bl", {})
-local recent_ips = {}
-
--- Begin
-
-local function http_response(event, code, message, headers)
-	local response = event.response
-
-	if headers then
-		for header, data in pairs(headers) do response.headers[header] = data end
-	end
-
-	response.headers.content_type = "application/json"
-	response.status_code = code
-	response:send(message)
-end
-
-local function handle_req(event)
-	local request = event.request
-	local body = request.body
-	if secure and not request.secure then return nil end
-
-	if request.method ~= "POST" then
-		return http_response(event, 405, "Bad method...", {["Allow"] = "POST"})
-	end
-	if not request.headers["authorization"] then
-		return http_response(event, 401, "No... No...", {["WWW-Authenticate"]='Basic realm="'.. set_realm_name ..'"'})
-	end
-	
-	local user, password = b64_decode(request.headers.authorization:match("[^ ]*$") or ""):match("([^:]*):(.*)")
-	user = jid_prep(user)
-	if not user or not password then return http_response(event, 400, "What's this..?") end
-	local user_node, user_host = jid_split(user)
-	if not hosts[user_host] then return http_response(event, 401, "Negative.") end
-	
-	module:log("warn", "%s is authing to submit a new user registration data", user)
-	if not usermanager.test_password(user_node, user_host, password) then
-		module:log("warn", "%s failed authentication", user)
-		return http_response(event, 401, "Who the hell are you?! Guards!")
-	end
-	
-	local req_body
-	-- We check that what we have is valid JSON wise else we throw an error...
-	if not pcall(function() req_body = json_decode(body) end) then
-		module:log("debug", "JSON data submitted for user registration by %s failed to Decode.", user)
-		return http_response(event, 400, "JSON Decoding failed.")
-	else
-		-- Decode JSON data and check that all bits are there else throw an error
-		if req_body["username"] == nil or req_body["password"] == nil or req_body["host"] == nil or req_body["ip"] == nil then
-			module:log("debug", "%s supplied an insufficent number of elements or wrong elements for the JSON registration", user)
-			return http_response(event, 400, "Invalid syntax.")
-		end
-		-- Check if user is an admin of said host
-		if not usermanager.is_admin(user, req_body["host"]) then
-			module:log("warn", "%s tried to submit registration data for %s but he's not an admin", user, req_body["host"])
-			return http_response(event, 401, "I obey only to my masters... Have a nice day.")
-		else	
-			-- Blacklist can be checked here.
-			if blacklist:contains(req_body["ip"]) then module:log("warn", "Attempt of reg. submission to the JSON servlet from blacklisted address: %s", req_body["ip"]) ; return http_response(403, "The specified address is blacklisted, sorry sorry.") end
-
-			-- We first check if the supplied username for registration is already there.
-			-- And nodeprep the username
-			local username = nodeprep(req_body["username"])
-			if not username then
-				module:log("debug", "An username containing invalid characters was supplied: %s", user)
-				return http_response(event, 406, "Supplied username contains invalid characters, see RFC 6122.")
-			else
-				if not usermanager.user_exists(username, req_body["host"]) then
-					-- if username fails to register successive requests shouldn't be throttled until one is successful.
-					if throttle_time and not whitelist:contains(req_body["ip"]) then
-						if not recent_ips[req_body["ip"]] then
-							recent_ips[req_body["ip"]] = os_time()
-						else
-							if os_time() - recent_ips[req_body["ip"]] < throttle_time then
-								recent_ips[req_body["ip"]] = os_time()
-								module:log("warn", "JSON Registration request from %s has been throttled.", req_body["ip"])
-								return http_response(event, 503, "Woah... How many users you want to register..? Request throttled, wait a bit and try again.")
-							end
-							recent_ips[req_body["ip"]] = os_time()
-						end
-					end
-
-					local ok, error = usermanager.create_user(username, req_body["password"], req_body["host"])
-					if ok then 
-						hosts[req_body["host"]].events.fire_event("user-registered", { username = username, host = req_body["host"], source = "mod_register_json", session = { ip = req_body["ip"] } })
-						module:log("debug", "%s registration data submission for %s@%s is successful", user, username, req_body["host"])
-						return http_response(event, 200, "Done.")
-					else
-						module:log("error", "user creation failed: "..error)
-						return http_response(event, 500, "Encountered server error while creating the user: "..error)
-					end
-				else
-					module:log("debug", "%s registration data submission for %s failed (user already exists)", user, username)
-					return http_response(event, 409, "User already exists.")
-				end
-			end
-		end
-	end
-end
-
--- Set it up!
-
-module:provides("http", {
-	default_path = base_path,
-        route = {
-                ["GET /"] = handle_req,
-		["POST /"] = handle_req
-        }
-})
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_register_json/register_json/mod_register_json.lua	Mon Apr 29 22:53:39 2013 +0200
@@ -0,0 +1,279 @@
+-- Expose a simple token based servlet to handle user registrations from web pages
+-- through Base64 encoded JSON.
+
+-- Copyright (C) 2010 - 2013, Marco Cirillo (LW.Org)
+
+local datamanager = datamanager
+local b64_decode = require "util.encodings".base64.decode
+local b64_encode = require "util.encodings".base64.encode
+local http_event = require "net.http.server".fire_event
+local jid_prep = require "util.jid".prep
+local jid_split = require "util.jid".split
+local json_decode = require "util.json".decode
+local nodeprep = require "util.encodings".stringprep.nodeprep
+local open, os_time, setmt, type = io.open, os.time, setmetatable, type
+local sha1 = require "util.hashes".sha1
+local urldecode = http.urldecode
+local usermanager = usermanager
+local uuid_gen = require "util.uuid".generate
+local timer = require "util.timer"
+
+module:depends("http")
+
+-- Pick up configuration and setup stores/variables.
+
+local auth_token = module:get_option_string("reg_servlet_auth_token")
+local secure = module:get_option_boolean("reg_servlet_secure", true)
+local base_path = module:get_option_string("reg_servlet_base", "/register_account/")
+local throttle_time = module:get_option_number("reg_servlet_ttime", nil)
+local whitelist = module:get_option_set("reg_servlet_wl", {})
+local blacklist = module:get_option_set("reg_servlet_bl", {})
+local fm_patterns = module:get_option("reg_servlet_filtered_mails", {})
+if type(fm_patterns) ~= "table" then fm_patterns = {} end
+
+local files_base = module.path:gsub("/[^/]+$","") .. "/template/"
+
+local recent_ips = {}
+local pending = {}
+local pending_node = {}
+
+-- Setup hashes data structure
+
+hashes = { _index = {} }
+local hashes_mt = {} ; hashes_mt.__index = hashes_mt
+function hashes_mt:add(node, mail)
+	local _hash = b64_encode(sha1(mail))
+	if not self:exists(_hash) then
+		self[_hash] = node ; self._index[node] = _hash ; self:save()
+		return true
+	else
+		return false
+	end
+end
+function hashes_mt:exists(hash)
+	if hashes[hash] then return true else return false end
+end
+function hashes_mt:remove(node)
+	local _hash = self._index[node]
+	if _hash then
+		self[_hash] = nil ; self._index[node] = nil ; self:save()
+	end
+end
+function hashes_mt:save()
+	if not datamanager.store("register_json", module.host, "hashes", hashes) then
+		module:log("error", "Failed to save the mail addresses' hashes store.")
+	end
+end
+
+local function check_mail(address)
+	for _, pattern in ipairs(fm_patterns) do 
+		if address:match(pattern) then return false end
+	end
+	return true
+end
+
+-- Begin
+
+local function handle(code, message) return http_event("http-error", { code = code, message = message }) end
+local function http_response(event, code, message, headers)
+	local response = event.response
+
+	if headers then
+		for header, data in pairs(headers) do response.headers[header] = data end
+	end
+
+	response.status_code = code
+	response:send(handle(code, message))
+end
+
+local function handle_req(event)
+	local response = event.response
+	local request = event.request
+	local body = request.body
+	if secure and not request.secure then return nil end
+
+	if request.method ~= "POST" then
+		return http_response(event, 405, "Bad method.", {["Allow"] = "POST"})
+	end
+	
+	local req_body
+	-- We check that what we have is valid JSON wise else we throw an error...
+	if not pcall(function() req_body = json_decode(b64_decode(body)) end) then
+		module:log("debug", "Data submitted for user registration by %s failed to Decode.", user)
+		return http_response(event, 400, "Decoding failed.")
+	else
+		-- Decode JSON data and check that all bits are there else throw an error
+		if req_body["username"] == nil or req_body["password"] == nil or req_body["ip"] == nil or req_body["mail"] == nil or
+		   req_body["auth_token"] == nil then
+			module:log("debug", "%s supplied an insufficent number of elements or wrong elements for the JSON registration", user)
+			return http_response(event, 400, "Invalid syntax.")
+		end
+		-- Set up variables
+		local username, password, ip, mail, token = req_body.username, req_body.password, req_body.ip, req_body.mail, req_body.auth_token
+
+		-- Check if user is an admin of said host
+		if token ~= auth_token then
+			module:log("warn", "%s tried to retrieve a registration token for %s@%s", request.ip, username, module.host)
+			return http_response(event, 401, "Auth token is invalid! The attempt has been logged.")
+		else	
+			-- Blacklist can be checked here.
+			if blacklist:contains(ip) then 
+				module:log("warn", "Attempt of reg. submission to the JSON servlet from blacklisted address: %s", ip)
+				return http_response(403, "The specified address is blacklisted, sorry.") 
+			end
+
+			if not check_mail(mail) then
+				module:log("warn", "%s attempted to use a mail address (%s) matching one of the forbidden patterns.", ip, mail)
+				return http_response(403, "Requesting to register using this E-Mail address is forbidden, sorry.")
+			end
+
+			-- We first check if the supplied username for registration is already there.
+			-- And nodeprep the username
+			username = nodeprep(username)
+			if not username then
+				module:log("debug", "An username containing invalid characters was supplied: %s", req_body["username"])
+				return http_response(event, 406, "Supplied username contains invalid characters, see RFC 6122.")
+			else
+				if pending_node[username] then
+					module:log("warn", "%s attempted to submit a registration request but another request for that user is pending")
+					return http_response(event, 401, "Another user registration by that username is pending.")
+				end
+
+				if not usermanager.user_exists(username, module.host) then
+					-- if username fails to register successive requests shouldn't be throttled until one is successful.
+					if throttle_time and not whitelist:contains(ip) then
+						if not recent_ips[ip] then
+							recent_ips[ip] = os_time()
+						else 
+							if os_time() - recent_ips[ip] < throttle_time then
+								recent_ips[ip] = os_time()
+								module:log("warn", "JSON Registration request from %s has been throttled.", req_body["ip"])
+								return http_response(event, 503, "Request throttled, wait a bit and try again.")
+							end
+							recent_ips[ip] = os_time()
+						end
+					end
+
+					local uuid = uuid_gen()
+					if not hashes:add(username, mail) then
+						module:log("warn", "%s (%s) attempted to register to the server with an E-Mail address we already possess the hash of.", username, ip)
+						return http_response(event, 409, "The E-Mail Address provided matches the hash associated to an existing account.")
+					end
+					pending[uuid] = { node = username, password = password, ip = ip }
+					pending_node[username] = uuid
+
+					timer.add_task(300, function()
+						if pending[uuid] then
+							pending[uuid] = nil
+							pending_node[username] = nil
+							hashes:remove(username)
+						end
+					end)
+					module:log("info", "%s (%s) submitted a registration request and is awaiting final verification", username, uuid)
+					return uuid
+				else
+					module:log("debug", "%s registration data submission failed (user already exists)", username)
+					return http_response(event, 409, "User already exists.")
+				end
+			end
+		end
+	end
+end
+
+local function open_file(file)
+	local f, err = open(file, "rb");
+	if not f then return nil end
+
+	local data = f:read("*a") ; f:close()
+	return data
+end
+
+local function r_template(event, type)
+	local response = event.response
+
+	local data = open_file(files_base..type.."_t.html")
+	if data then
+		data = data:gsub("%%REG%-URL", base_path.."verify/")
+		return data
+	else return http_response(event, 500, "Failed to obtain template.") end
+end
+
+local function handle_verify(event, path)
+	local response = event.response
+	local request = event.request
+	local body = request.body
+	if secure and not request.secure then return nil end
+
+	local valid_files = {
+		["css/style.css"] = files_base.."css/style.css",
+		["images/tile.png"] = files_base.."images/tile.png",
+		["images/header.png"] = files_base.."images/header.png"
+	}
+
+	if request.method == "GET" then
+		if path == "" then
+			return r_template(event, "form")
+		end		
+
+		if valid_files[path] then
+			local data = open_file(valid_files[path])
+			if data then return data
+			else return http_response(event, 404, "Not found.") end
+		end
+	elseif request.method == "POST" then
+		if path == "" then
+			if not request.body then return http_response(event, 400, "Bad Request.") end
+			local uuid = urldecode(request.body):match("^uuid=(.*)$")
+
+			if not pending[uuid] then
+				return r_template(event, "fail")
+			else
+				local username, password, ip = 
+				      pending[uuid].node, pending[uuid].password, pending[uuid].ip
+
+				local ok, error = usermanager.create_user(username, password, module.host)
+				if ok then 
+					module:fire_event(
+						"user-registered", 
+						{ username = username, host = module.host, source = "mod_register_json", session = { ip = ip } }
+					)
+					module:log("info", "Account %s@%s is successfully verified and activated", username, module.host)
+					-- we shall not clean the user from the pending lists as long as registration doesn't succeed.
+					pending[uuid] = nil ; pending_node[username] = nil
+					return r_template(event, "success")				
+				else
+					module:log("error", "User creation failed: "..error)
+					return http_response(event, 500, "Encountered server error while creating the user: "..error)
+				end
+			end
+		end	
+	else
+		return http_response(event, 405, "Invalid method.")
+	end
+end
+
+local function handle_user_deletion(event)
+	local user, hostname = event.username, event.host
+	if hostname == module.host then hashes:remove(user) end
+end
+
+-- Set it up!
+
+hashes = datamanager.load("register_json", module.host, "hashes") or hashes ; setmt(hashes, hashes_mt)
+
+module:provides("http", {
+	default_path = base_path,
+        route = {
+                ["GET /"] = handle_req,
+		["POST /"] = handle_req,
+		["GET /verify/*"] = handle_verify,
+		["POST /verify/*"] = handle_verify
+        }
+})
+
+module:hook_global("user-deleted", handle_user_deletion, 10);
+
+-- Reloadability
+
+module.save = function() return { hashes = hashes } end
+module.restore = function(data) hashes = data.hashes or { _index = {} } ; setmt(hashes, hashes_mt) end
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_register_json/register_json/template/css/style.css	Mon Apr 29 22:53:39 2013 +0200
@@ -0,0 +1,42 @@
+body {
+  margin: 0
+}
+
+a {
+  color: #0000FF
+}
+
+ul {
+  margin: 0
+}
+
+.btn {
+  margin-right: 0.3em
+}
+
+.btn:last {
+  margin-right: 0
+}
+
+#main {
+  padding: 10px
+}
+
+#main div {
+  margin-left: 14px
+}
+
+#main p {
+  margin-left: 14px
+}
+
+#top {
+  clear: both;
+  width: 100%;
+  padding: 0;
+}
+
+#header {
+  height: 172px;
+  background: url(../images/tile.png) repeat-x
+}
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_register_json/register_json/template/fail_t.html	Mon Apr 29 22:53:39 2013 +0200
@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
+	"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<title>Prosody User Registration Verification</title>
+<link rel="stylesheet" type="text/css" href="css/style.css" />
+<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=utf-8" />
+</head>
+
+<body>
+<div id='top'>
+  <div id='header'>
+    <img src="images/header.png" />
+  </div>
+</div>
+
+<div id='main'>
+  <p>The Account UUID you provided is either invalid or expired, please keep in mind
+  <br />that the tokens have a max validity of five minutes after which they will expire
+  <br />and you will have to repeat the registration process.</p>
+</div>
+
+</body>
+</html>
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_register_json/register_json/template/form_t.html	Mon Apr 29 22:53:39 2013 +0200
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
+	"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<title>Prosody User Registration Verification</title>
+<link rel="stylesheet" type="text/css" href="css/style.css" />
+<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=utf-8" />
+</head>
+
+<body>
+<div id='top'>
+  <div id='header'>
+    <img src="images/header.png" />
+  </div>
+</div>
+
+<div id='main'>
+  <p>Please input below the identification string you received by e-mail, to complete your
+  <br />xmpp account registration.</p>
+  <form action='%REG-URL' method='post' accept-charset='UTF-8' id='uuid'>
+    <div><label for='set-uuid'>UUID:</label></div>
+    <div><input type='text' name='uuid' id='set-uuid' value="" /></div>
+    <div><input type='submit' id='connect' value='Complete Registration' class='btn' /></div>
+  </form>
+</div>
+
+</body>
+</html>
Binary file mod_register_json/register_json/template/images/header.png has changed
Binary file mod_register_json/register_json/template/images/tile.png has changed
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_register_json/register_json/template/success_t.html	Mon Apr 29 22:53:39 2013 +0200
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
+	"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<title>Prosody User Registration Verification</title>
+<link rel="stylesheet" type="text/css" href="css/style.css" />
+<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=utf-8" />
+</head>
+
+<body>
+<div id='top'>
+  <div id='header'>
+    <img src="images/header.png" />
+  </div>
+</div>
+
+<div id='main'>
+  <p>Registration verified, account activated.</p>
+</div>
+
+</body>
+</html>