You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@james.apache.org by "quantranhong1999 (via GitHub)" <gi...@apache.org> on 2023/02/14 09:44:34 UTC

[GitHub] [james-project] quantranhong1999 commented on a diff in pull request #1437: JAMES-3881 Set a JMX password

quantranhong1999 commented on code in PR #1437:
URL: https://github.com/apache/james-project/pull/1437#discussion_r1105543138


##########
server/apps/distributed-app/docs/modules/ROOT/pages/configure/jmx.adoc:
##########
@@ -22,3 +22,37 @@ in GIT to get some examples and hints.
 
 To access from a remote location, it has been reported that `-Dcom.sun.management.jmxremote.ssl=false` is needed as
 a JVM argument.
+
+
+== JMX Security
+
+In order to set up JMX authentication, we need to put `jmxremote.password` and `jmxremote.access` file
+to `/conf` directory.
+
+- `jmxremote.password`: define the username and password, that will be used by the client (here is james-cli)
+
+File's content example:
+```
+james-admin pass1
+```
+
+- `jmxremote.access`: define the pair of username and access permission
+
+File's content example:
+```
+james-admin readWrite
+```
+
+When James runs with option `-Djames.jmx.credential.generation=true`, James will automatically generate `jmxremote.password` if the file does not exist.
+Then the default username is `james-admin` and a random password.

Review Comment:
   Could we document that by default the option `-Djames.jmx.credential.generation` is false and JMX authentication is off? And recommend operators turn it on instead.
   
   If I do not read the code, I am not sure what happens if this option is false or I don't specify it, is it a breaking change or not...



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@james.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@james.apache.org
For additional commands, e-mail: notifications-help@james.apache.org