updated readme and implemented custom_auth hook

.luacheckrc

@@ -1,4 +1,3 @@
-unused_args = false
 allow_defined_top = true
 
 globals = {

auth.lua

@@ -14,6 +14,11 @@ local function auth_handler(auth)
 	local banned = false
 	local message = ""
 
+	local custom_auth_success, custom_msg = auth_proxy.custom_handler(auth.name)
+	if not custom_auth_success and custom_msg then
+		message = custom_msg
+	end
+
 	if auth_proxy.disallow_banned_players and has_xban2_mod then
 		-- check xban db
 		local xbanentry = xban.find_entry(auth.name)
@@ -23,7 +28,7 @@ local function auth_handler(auth)
 		end
 	end
 
-	if not banned then
+	if not banned and custom_auth_success then
 		-- check tan
 		local tan = auth_proxy.tan[auth.name]
 		if tan ~= nil then

init.lua

@@ -1,7 +1,10 @@
 auth_proxy = {
   disallow_banned_players = true,
   url = minetest.settings:get("auth_proxy.url"),
-  tan = {}
+  tan = {},
+  custom_handler = function()
+    return true
+  end
 }
 
 

readme.md

@@ -3,7 +3,7 @@ Authorization mod for minetest
 =================
 
 
-To be used with https://github.com/thomasrudin-mt/auth_proxy_app
+To be used with https://github.com/minetest-auth-proxy/auth_proxy_app
 
 # Overview
 
@@ -12,7 +12,29 @@ Lets third-party apps query username and password of ingame players
 # Installing
 
 * Copy/Clone the files into the `worldmods` folder
-* Install and start https://github.com/thomasrudin-mt/auth_proxy_app
+* Install and start https://github.com/minetest-auth-proxy/auth_proxy_app
+
+# compatibility
+
+If `xban2` is available, the `banned` flag on the xban-database is additionally
+checked on login
+
+# API
+
+## Custom auth handler
+
+Additional checks besides the user/password can be implemented with a custom handler function
+
+**Example**: require a priv to login:
+```lua
+auth_proxy.custom_handler = function(name)
+  if minetest.check_player_privs(name, "mypriv") then
+    return true
+  else
+    return false, "Missing priv: 'mypriv'"
+  end
+end
+```
 
 ## minetest.conf
 

util/channel.lua

@@ -65,7 +65,7 @@ local function Channel(http, url, cfg)
 			extra_headers = post_headers,
 			timeout = timeout,
 			post_data = minetest.write_json(data)
-		}, function(res)
+		}, function()
 			-- TODO: error-handling
 		end)
 	end