Diff

mod_http_admin_api/mod_http_admin_api.lua @ 4343:ee313922b8d1

mod_http_admin_api: HTTP API for managing users and invites
author Matthew Wild <mwild1@gmail.com>
date Sun, 17 Jan 2021 12:49:20 +0000
child 4345:1bb08e9ffa82
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_http_admin_api/mod_http_admin_api.lua	Sun Jan 17 12:49:20 2021 +0000
@@ -0,0 +1,112 @@
+local json = require "util.json";
+
+module:depends("http");
+
+local invites = module:depends("invites");
+local tokens = module:depends("tokenauth");
+
+local json_content_type = "application/json";
+
+local www_authenticate_header = ("Bearer realm=%q"):format(module.host.."/"..module.name);
+
+local function check_credentials(request)
+	local auth_type, auth_data = string.match(request.headers.authorization or "", "^(%S+)%s(.+)$");
+	if not (auth_type and auth_data) then
+		return false;
+	end
+
+	if auth_type == "Bearer" then
+		local token_info = tokens.get_token_info(auth_data);
+		if not token_info or not token_info.session then
+			return false;
+		end
+		return token_info.session;
+	end
+	return nil;
+end
+
+function check_auth(routes)
+	local function check_request_auth(event)
+		local session = check_credentials(event.request);
+		if not session then
+			event.response.headers.authorization = www_authenticate_header;
+			return false, 401;
+		elseif session.auth_scope ~= "prosody:scope:admin" then
+			return false, 403;
+		end
+		event.session = session;
+		return true;
+	end
+
+	for route, handler in pairs(routes) do
+		routes[route] = function (event, ...)
+			local permit, code = check_request_auth(event);
+			if not permit then
+				return code;
+			end
+			return handler(event, ...);
+		end;
+	end
+	return routes;
+end
+
+local function token_info_to_invite_info(token_info)
+	return {
+		id = token_info.token;
+		type = token_info.type;
+		inviter = token_info.inviter;
+		jid = token_info.jid;
+		landing_page = token_info.landing_page;
+		created_at = token_info.created_at;
+		expires = token_info.expires;
+	};
+end
+
+function list_invites(event)
+	local invites_list = {};
+	for token, invite in invites.pending_account_invites() do --luacheck: ignore 213/token
+		table.insert(invites_list, token_info_to_invite_info(invite));
+	end
+	table.sort(invites_list, function (a, b)
+		return a.created_at < b.created_at;
+	end);
+
+	event.response.headers["Content-Type"] = json_content_type;
+	return json.encode(invites_list);
+end
+
+function get_invite_by_id(event, invite_id)
+	local invite = invites.get_account_invite_info(invite_id);
+	if not invite then
+		return 404;
+	end
+
+	event.response.headers["Content-Type"] = json_content_type;
+	return json.encode(token_info_to_invite_info(invite));
+end
+
+function create_invite(event)
+	local invite = invites.create_account(nil, { source = "admin_api/"..event.session.username });
+	if not invite then
+		return 500;
+	end
+
+	event.response.headers["Content-Type"] = json_content_type;
+	return json.encode(token_info_to_invite_info(invite));
+end
+
+function delete_invite(event, invite_id) --luacheck: ignore 212/event
+	if not invites.delete_account_invite(invite_id) then
+		return 404;
+	end
+	return 200;
+end
+
+module:provides("http", {
+	route = check_auth {
+		["GET /invites"] = list_invites;
+		["GET /invites/*"] = get_invite_by_id;
+		["PUT /invites"] = create_invite;
+		["DELETE /invites/*"] = delete_invite;
+	};
+});