AWS Security ChangesHomeSearch

AWS keyspaces medium security documentation change

Service: keyspaces · 2025-10-28 · Security-related medium

File: keyspaces/latest/devguide/programmatic.cqlsh.md

Summary

Updated TLS certificate configuration steps to include multiple Amazon Root CAs (1-4) and combine them into a bundle, replacing the Starfield certificate. Added details about certificate migration for compatibility.

Security assessment

The change addresses migration to new root CAs, ensuring secure TLS connections by requiring trust in updated certificates. This prevents potential man-in-the-middle attacks if older CAs become compromised and maintains encryption integrity during transit.

Diff

diff --git a/keyspaces/latest/devguide/programmatic.cqlsh.md b/keyspaces/latest/devguide/programmatic.cqlsh.md
index 91463e35a..7489f04f0 100644
--- a//keyspaces/latest/devguide/programmatic.cqlsh.md
+++ b//keyspaces/latest/devguide/programmatic.cqlsh.md
@@ -15 +15 @@ To connect to Amazon Keyspaces using `cqlsh`, you can use the `cqlsh-expansion`.
-For general information about `cqlsh`, see [`cqlsh`: the CQL shell](http://cassandra.apache.org/doc/latest/tools/cqlsh.html).
+For general information about `cqlsh`, see [`cqlsh`: the CQL shell](https://cassandra.apache.org/doc/latest/cassandra/managing/tools/cqlsh.html).
@@ -90 +90 @@ The output should look like this.
-    3. Copy the Starfield digital certificate into the `.cassandra` directory. Amazon Keyspaces uses this certificate to configure the secure connection with Transport Layer Security (TLS). Encryption in transit provides an additional layer of data protection by encrypting your data as it travels to and from Amazon Keyspaces. 
+    3. Copy the combined certificate file into the `.cassandra` directory. Amazon Keyspaces uses this certificate to configure the secure connection with Transport Layer Security (TLS). Encryption in transit provides an additional layer of data protection by encrypting your data as it travels to and from Amazon Keyspaces. For more information about certificates, see How to manually configure cqlsh connections for TLS.
@@ -188 +188 @@ The `pip3 uninstall` command doesn't remove the directory and related files crea
-Amazon Keyspaces only accepts secure connections using Transport Layer Security (TLS). You can use the `cqlsh-expansion` utility that automatically downloads the certificate for you and installs a preconfigured `cqlshrc` configuration file. For more information, see Using the cqlsh-expansion to connect to Amazon Keyspaces on this page. 
+Amazon Keyspaces only accepts secure connections using Transport Layer Security (TLS). You can use the `cqlsh-expansion` utility that automatically downloads the certificates for you and installs a preconfigured `cqlshrc` configuration file. For more information, see Using the cqlsh-expansion to connect to Amazon Keyspaces on this page. 
@@ -190 +190 @@ Amazon Keyspaces only accepts secure connections using Transport Layer Security
-If you want to download the certificate and configure the connection manually, you can do so using the following steps. 
+If you want to download the certificates and configure the connection manually, you can do so using the following steps. 
@@ -192 +192 @@ If you want to download the certificate and configure the connection manually, y
-  1. Download the Starfield digital certificate using the following command and save `sf-class2-root.crt` locally or in your home directory.
+  1. Download the following digital certificates and save the files locally or in your home directory.
@@ -194 +194,17 @@ If you want to download the certificate and configure the connection manually, y
-        curl https://certs.secureserver.net/repository/sf-class2-root.crt -O
+    1. AmazonRootCA1
+
+    2. AmazonRootCA2
+
+    3. AmazonRootCA3
+
+    4. AmazonRootCA4
+
+    5. Starfield Class 2 Root (optional – for backward compatibility)
+
+To download the certificates, you can use the following commands.
+    
+        curl -O https://www.amazontrust.com/repository/AmazonRootCA1.pem
+    curl -O https://www.amazontrust.com/repository/AmazonRootCA2.pem
+    curl -O https://www.amazontrust.com/repository/AmazonRootCA3.pem
+    curl -O https://www.amazontrust.com/repository/AmazonRootCA4.pem
+    curl -O https://certs.secureserver.net/repository/sf-class2-root.crt
@@ -198 +214,10 @@ If you want to download the certificate and configure the connection manually, y
-You can also use the Amazon digital certificate to connect to Amazon Keyspaces and can continue to do so if your client is connecting to Amazon Keyspaces successfully. The Starfield certificate provides additional backwards compatibility for clients using older certificate authorities.
+Amazon Keyspaces previously used TLS certificates anchored to the Starfield Class 2 CA. AWS is migrating all AWS Regions to certificates issued under Amazon Trust Services (Amazon Root CAs 1–4). During this transition, configure clients to trust both Amazon Root CAs 1–4 and the Starfield root to ensure compatibility across all Regions.
+
+  2. Combine all downloaded certificates into a single `pem` file with the name `keyspaces-bundle.pem` in our examples. You can do this by running the following command. Take note of the path to the file, you need this later.
+    
+        cat AmazonRootCA1.pem \
+     AmazonRootCA2.pem \
+     AmazonRootCA3.pem \
+     AmazonRootCA4.pem \
+     sf-class2-root.crt \
+     > keyspaces-bundle.pem
@@ -200 +225 @@ You can also use the Amazon digital certificate to connect to Amazon Keyspaces a
-  2. Open the `cqlshrc` configuration file in the Cassandra home directory, for example `${HOME}/.cassandra/cqlshrc` and add the following lines.
+  3. Open the `cqlshrc` configuration file in the Cassandra home directory, for example `${HOME}/.cassandra/cqlshrc` and add the following lines.
@@ -208 +233 @@ You can also use the Amazon digital certificate to connect to Amazon Keyspaces a
-    certfile =  path_to_file/sf-class2-root.crt
+    certfile =  path_to_file/keyspaces-bundle.pem