Minor change, documented the content of config files

distribution/src/main/resources/acl.conf

@@ -1 +1,5 @@
+#*********************************************
+# ACL Format:
+#   topic [read|write|readwrite] <topic name>
+#*********************************************
 topic write /sensors/anemometer

distribution/src/main/resources/moquette.conf

@@ -11,10 +11,26 @@ websocket_port 8080
 
 host 0.0.0.0
 
-#Password file
-password_file config/password_file.conf
-acl_file config/acl.conf
+#*********************************************************************
+# acl_file:
+#    defines the path to the ACL file relative to moquette home dir
+#    contained in the moquette.path system property
+#*********************************************************************
+#acl_file config/acl.conf
 
-#false to accept only client connetions with credentials
-#true to accept client connection without credentails, validating only the one that provides
-allow_anonymous true
+#*********************************************************************
+# allow_anonymous is used to accept MQTT connections also from not
+# authenticated clients.
+#   - false to accept ONLY client connetions with credentials.
+#   - true to accept client connection without credentails, validating
+#       only against the password_file, the ones that provides.
+#*********************************************************************
+allow_anonymous true
+
+#*********************************************************************
+# password_file:
+#    defines the path to the file that contains the credentials for
+#    authenticated client connection. It's relative to moquette home dir
+#    defined by the system property moquette.path
+#*********************************************************************
+password_file config/password_file.conf

distribution/src/main/resources/password_file.conf

@@ -1 +1,6 @@
-testuser:passwd
+#*********************************************
+# Each line define a user login in the format
+#   <username>:sha256(<password>)
+#*********************************************
+#NB this password is sha256(passwd)
+testuser:36767030e79073783c8e9b299d9f8f1d4cd66baa82cd8869caad8dbb55204099