HomeDocumentation > User's guide > Administration > Administrative Tasks > Configuring security > Configuring SSL client authentication

Starting from Geronimo 2.1.5, users can connect to a running server through a SSL tunnel by specifying the location of the trusted keystore file to org.apache.geronimo.keyStoreTrustStorePasswordFile. The default SSL keystore of the Geronimo server is geronimo-default, which locates at /var/security/keystores/ directory.

Follow the instructions below to complete a SSL connection to the Geronimo server.

  1. Enable a system plug-in named org.apache.geronimo.framework/jmx-security/2.1.5/car using start sub-command or via the administration console on the server.
  2. Create a key file containing the password pairs used to connect to the server, which will be like:

    keystorePasswordfile.key

    keyStorePassword=secret
    trustStorePassword=secret

    Where secret is the default password of keystore geronimo-default in the server. For better security, use encrypt sub-command to encrypt the plain text password in the file. By default, the content of keystorePasswordfile.key file is from /var/config/config-substitutions.properties file.
  3. Save the file to your preferred location such as myDir and then export the location of keystorePasswordfile.key file to org.apache.geronimo.keyStoreTrustStorePasswordFile.

    export JAVA_OPTS="-Dorg.apache.geronimo.keyStoreTrustStorePasswordFile=$myDir/KeystoreTrustSotrePasswordFile.key"

    or

    set JAVA_OPTS="-Dorg.apache.geronimo.keyStoreTrustStorePasswordFile=%myDir%/KeystoreTrustSotrePasswordFile.key"

  4. Initiate a connecting request to the server via SSL, then you will see the connection is successfully acquired. For example, using available commands on the server that support --secure option.