diff options
author | Trumeet <yuuta@yuuta.moe> | 2021-10-17 22:20:58 -0700 |
---|---|---|
committer | Trumeet <yuuta@yuuta.moe> | 2021-10-17 22:20:58 -0700 |
commit | fa3455054c084fea618f6f236ff867cb38a43a23 (patch) | |
tree | b37c5d7106e836682607a28bf2227a1e0c95da73 /README.md | |
download | safelog-fa3455054c084fea618f6f236ff867cb38a43a23.tar safelog-fa3455054c084fea618f6f236ff867cb38a43a23.tar.gz safelog-fa3455054c084fea618f6f236ff867cb38a43a23.tar.bz2 safelog-fa3455054c084fea618f6f236ff867cb38a43a23.zip |
First Commit
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 38 |
1 files changed, 38 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..46c6370 --- /dev/null +++ b/README.md @@ -0,0 +1,38 @@ +# SafeLog + +A Minecraft server side Fabric mod that redacts IP addresses in logs for privacy and compliance purposes. + +## Places redacted + +* Player login: `[Server thread/INFO] (Minecraft) Notch[/[0:0:0:0:0:0:0:1%0]:56566] logged in with entity id 50 at (5.5, 64.0, 0.5)` +* Authentication error: `[Server thread/INFO] (Minecraft) /127.0.0.1:43832 lost connection: Failed to verify username!` + +## Effect + +IP addresses will be MD5 hashed with an optional and customizable salt. Leading slashes and port numbers are preserved. + +`[Server thread/INFO] (Minecraft) Notch[/[0:0:0:0:0:0:0:1%0]:56566] logged in with entity id 50 at (5.5, 64.0, 0.5)` will become `[Server thread/INFO] (Minecraft) Notch[/fec2cae1c0333d98b453058e9f6c99d9:56566] logged in with entity id 50 at (5.5, 64.0, 0.5)`. + +`[Server thread/INFO] (Minecraft) /127.0.0.1:43832 lost connection: Failed to verify username!` will become `[Server thread/INFO] (Minecraft) /f528764d624db129b32c21fbca0cb8d6:43832 lost connection: Failed to verify username!`. + +## Salting + +Edit `config/safelog.properties`: + +```properties +salt = 114514 +``` + +SafeLog will append real IP addresses after the salt before hashing. Default salt is empty. + +Warning: SafeLog will only hash raw IP addresses, so make sure to set a salt to prevent hash cracking. + +## Building + +Tested on Gradle 7.2. + +`gradle jar` + +## License + +GPL v2 only
\ No newline at end of file |