use whitelist command directly, read in whitelist.json for listing, readme with usage / info

Author: jackharrhy

README.md

@@ -2,4 +2,31 @@
 
 Enable Minecraft whitelist management from an exposed HTTP endpoint
 
-_wip_
+---
+
+`GET / -> [] of {uuid: "...", name: "..."}` - Returns the `whitelist.json` of the server.
+`POST / ({name: "..."}) -> 201` - Adds a user to the whitelist via username.
+`DELETE / ({name: "..."}) -> 201` - Removes a user from the whitelist via username.
+
+---
+
+- Interfacing with the whitelist via Bukkit's API doesn't seem to work properly, so this plugin just calls the `whitelist` command directly, as you would via the server console.
+- Even if the server fails to whitelist a player, the response will still be a `201`, so it is assumed you hand the server a valid Minecraft username.
+- Default port is 7500, configurable via `<server dir>/plugins/<plugin dir>/config.yml`.
+- Everything is `application/json`.
+- Authentication is done via Bearer Tokens, any request must contain a valid Bearer Token to be served anything but a 403.
+
+> `<server dir>/plugins/<plugin dir>/config.yml`:
+>
+> ```
+> bearer_token: <token>
+> ```
+>
+> Example HTTP request w/valid header:
+>
+> ```
+> GET / HTTP/x.x
+> Content-Type: application/json
+> Authorization: WHA <token>
+> Host: <host>:<port>
+> ```

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>com.jackharrhy.whitelist</groupId>
     <artifactId>whitelist</artifactId>
-    <version>1.0-SNAPSHOT</version>
+    <version>1.0</version>
     <packaging>jar</packaging>
 
     <name>Whitelist HTTP API</name>

src/main/kotlin/com/jackharrhy/whitelist/WebServer.kt

@@ -1,17 +1,19 @@
 package com.jackharrhy.whitelist
 
+import com.fasterxml.jackson.databind.ObjectMapper
 import io.javalin.Javalin
-import io.javalin.http.BadRequestResponse
 import io.javalin.http.UnauthorizedResponse
 import org.bukkit.Bukkit
-import java.util.*
-import kotlin.collections.HashSet
+import java.io.File
+import java.lang.Integer.parseInt
 
-class WebServer(plugin: Whitelist, bearerToken: String) {
-    private data class User(val uuid: UUID)
+
+class WebServer(plugin: Whitelist) {
+    private data class User(val name: String)
 
     init {
-        val port = 7500
+        val port = parseInt(plugin.config.getString("port"))
+        val bearerToken = plugin.config.getString("bearer_token")!!
 
         val classLoader = Thread.currentThread().contextClassLoader
         Thread.currentThread().contextClassLoader = Whitelist::class.java.classLoader
@@ -30,34 +32,27 @@ class WebServer(plugin: Whitelist, bearerToken: String) {
             }
         }
 
+        val whitelistPath = plugin.dataFolder.absolutePath + "/../../whitelist.json"
         app.get("/") { ctx ->
-            val players = HashSet<UUID>()
-            for (player in Bukkit.getWhitelistedPlayers()) {
-                players.add(player.uniqueId)
-            }
-            ctx.json(players)
+            val whitelist = File(whitelistPath).readText()
+            val mapper = ObjectMapper()
+            ctx.json(mapper.readTree(whitelist))
         }
 
         app.post("/") { ctx ->
-            val uuid = ctx.body<User>().uuid
-            val player = Bukkit.getOfflinePlayer(uuid)
-            if (player.isWhitelisted) {
-                throw BadRequestResponse("Already whitelisted!")
-            } else {
-                player.isWhitelisted = true
-                ctx.status(201).result("")
+            val name = ctx.body<User>().name
+            Bukkit.getScheduler().callSyncMethod(plugin) {
+                Bukkit.dispatchCommand(Bukkit.getConsoleSender(), "whitelist add $name")
             }
+            ctx.status(201).result("")
         }
 
         app.delete("/") { ctx ->
-            val uuid = ctx.body<User>().uuid
-            val player = Bukkit.getOfflinePlayer(uuid)
-            if (player.isWhitelisted) {
-                player.isWhitelisted = false
-                ctx.status(201).result("")
-            } else {
-                throw BadRequestResponse("Not whitelisted!")
+            val name = ctx.body<User>().name
+            Bukkit.getScheduler().callSyncMethod(plugin) {
+                Bukkit.dispatchCommand(Bukkit.getConsoleSender(), "whitelist remove $name")
             }
+            ctx.status(201).result("")
         }
 
         plugin.logger.info("WebServer now running on port $port")

src/main/kotlin/com/jackharrhy/whitelist/Whitelist.kt

@@ -11,7 +11,7 @@ class Whitelist : JavaPlugin() {
         if (bearerToken.isNullOrEmpty() || bearerToken.equals("unset")) {
             logger.warning("bearer_token is unset, plugin useless!")
         } else {
-            WebServer(this, bearerToken)
+            WebServer(this)
         }
     }
 

src/main/resources/config.yml

@@ -1 +1,2 @@
 bearer_token: unset
+port: 7500