Previous Next JavaScript must be enabled to correctly display this content

## Guidelines for Disabling TLSv1.1 and TLSv1 Protocols

Update TLS protocol configuration to TLSv1.2 only

NoSQL Database has disabled TLSv1 and TLSv1.1 protocols in the default security configuration, the only protocol enabled is TLSv1.2.

Upgrade Implication:

This change doesn't remove the support of TLSv1.1 and TLSv1.2 but only disable them in the default security configuration. Upgrading to 24.1.11 release with security configuration created by previous release won't have compatibility issue, but it's recommended to disable the TLSv1.1 and TLSv1 in the existing NoSQL Database installation.

Prerequisite:

Before updating the TLS protocol to TLSv1.2 only, you must ensure the existing security configuration has already enabled the TLSv1.2 protocol, otherwise your NoSQL Database server won't be functional during the update.

1. . Check if protocol settings in the security configuration of your NoSQL Database server has enabled TLSv1.2 protocol. Run `securityconfig` utility to verify if protocols have TLSv1.2 included.

       java -jar $KVHOME/lib/kvstore.jar securityconfig config show -secdir
             $KVROOT/security

   If protocols in the security configuration don't have TLSv1.2, follow the section "Enable TLSv1.2 protocol" to enable TLSv1.2 first.

2. Check the client application login properties. Verify if the following NoSQL login property has TLSv1.2.
   For example:

       oracle.kv.ssl.protocols="TLSv1.2,TLSv1.1,TLSv1"

   Add TLSv1.2 and restart the client application if it wasn't specified in this security property.

Enable TLSv1.2 protocol

This is the procedure to enable TLSv1.2 in the NoSQL Database security configuration. It assumes the existing security configuration only has enabled TLSv1.1 and TLSv1.

1. Make two copies of the existing security configuration directory. Keep one as backup, and use the other for updating the protocols.
2. Update the SSL protocols in the copied security configuration directory.

       java -jar $KVHOME/lib/kvstore.jar securityconfig \
        config update -secdir security \
        -param "allowProtocols=TLSv1.2,TLSv1.1,TLSv1" \
        -param "clientAllowProtocols=TLSv1.2,TLSv1.1,TLSv1"

3. Verify if protocols in the updated security configuration has TLSv1.2 enabled.

       java -jar $KVHOME/lib/kvstore.jar securityconfig config show -secdir
             $KVROOT/security

   Verify if the protocol has TLSv1.2.

4. Copy the updated security directory to each Storage Node, and replace the old security configuration directory. Then, check that all Replication Nodes (RN) are online and restart each Storage Node, one by one, using the following command.

       java -jar $KVHOME/lib/kvstore.jar stop -root $KVROOT
       java -jar $KVHOME/lib/kvstore.jar start -root $KVROOT&

5. Start the Admin CLI, and check that all Replication Nodes (RNs) are up using the `ping` command:

       java -jar $KVHOME/lib/kvstore.jar runadmin -host localhost -port 5000 -security
       $KVROOT/security/client.security

   Output:

       Logged in admin as anonymous

       kv-> ping

Update TLS protocol to TLSv1.2 only

This is the procedure to update the existing security configuration to only enable protocol TLSv1.2. It assumes the TLSv1.2 is already enabled in the security configuration.

1. Update login properties of the client application. Update oracle.kv.ssl.protocols to have TLSv1.2 only (if it exists).
2. Make two copies of existing security configuration directory. Keep one as backup, and use the other one for updating the protocols.
3. Update the SSL protocols in the copied security configuration directory.

       java -jar $KVHOME/lib/kvstore.jar securityconfig \
       config update -secdir security \
       -param "allowProtocols=TLSv1.2" -param "clientAllowProtocols=TLSv1.2"

4. Verify if protocols in the updated security configuration has only TLSv1.2.

       java -jar $KVHOME/lib/kvstore.jar securityconfig config show -secdir
             $KVROOT/security

   Verify if protocols has TLSv1.2 only.

5. Copy the updated security directory to each server node (Storage Node), and replace the old security configuration directory. Then, check that all Replication Nodes are online and restart each Storage Node, one by one, using the following command:

       java -jar $KVHOME/lib/kvstore.jar stop -root $KVROOT
       java -jar $KVHOME/lib/kvstore.jar start -root KVROOT&

6. Start the Admin CLI, and check that all Replication Nodes (RNs) are up using the `ping` command:

       java -jar $KVHOME/lib/kvstore.jar runadmin -host localhost -port 5000 -security
       $KVROOT/security/client.security

   Output:

       Logged in admin as anonymous

       kv-> ping