Configuring Cassandra Security

You can follow this procedure to activate the JMX anonymous authentication and see your FS Cassandra nodes status in the FS UI.
Note: This feature is not available for versions anterior to 8.1.201.82.

1. Edit the launcher.xml file and set the following parameters to true:
   -Dcom.sun.management.jmxremote.authenticate=true
2. If missing, add the following parameter:
   -Dcom.sun.management.jmxremote.password.file=./etc/jmxremote.password
3. Copy: jmxremote.password.template
   from: /jdk_install_location/jre/lib/management/
   to: <FS Installation directory>/etc/
   then rename it: jmxremote.password
4. Edit the <FS Installation directory>/etc/jmxremote.password file to add the following username:
   fsadmin yourpassword
5. Change the ownership of jmxremote.password to the user you run FS with and change permission to read only.
   For Linux,
   chown fsadmin:fsadmin <FS Installation directory>/etc/jmxremote.password
   chmod 400 <FS Installation directory>/etc/jmxremote.password
   For Windows, FLAT file system,
   cacls <FS Installation directory>/etc/jmxremote.password /P fsadmin:R
   or Follow
   https://docs.oracle.com/javase/8/docs/technotes/guides/management/security-windows.html
   
6. Enable read and write permission to the FS user /jdk_install_location/lib/management/jmxremote.access:
   fsadmin readwrite
   
7. Edit your FS configuration and create the following options in the Options tab:
   Section jmx
   username=fsadmin
   password=yourpassword
   
8. Start FS. You can see the status of the Cassandra nodes in:
   http://<FS_HOST>:<PORT>/fs/admin#system/cassandra/FS_JMX_Security_cluster.png

   Cassandra JMX TLS

   Cassandra monitoring and management can be done using a Java Management Extensions (JMX) tool. The JMX access must be protected to avoid any remote managing on the FS embedded Cassandra.
   

   1. To protect JMX access, edit the launcher.xml file and change the parameters as follows:
      
      -Dcom.sun.management.jmxremote.port=9192
      -Dcom.sun.management.jmxremote.ssl=true
      -Dcom.sun.management.jmxremote.authenticate=true
      -Dcom.sun.management.jmxremote.registry.ssl=true

      
      

   2. Set up Transport Layer Security (TLS). See Genesys Security Deployment Guide.
   3. Create keystore in <FS Installation directory>/etc/ and upload the custom-generated server certificates to keystore. See http://docs.oracle.com/javase/7/docs/technotes/guides/management/toc.html.
      Note: If FS HTTPS is enabled already with a server certificate, same keystore and certificate can be used to secure JMX port also.
      
   4. Edit and configure the following JVM options in launcher.xml.
      
      • /etc/keystore
        
      • Type trust store password: <trust store password>
        
      • ./etc/keystore
        
      • Type keystore password: <keystore password>
   5. Restart the FS to enable secure JMX connection with embedded Cassandra.