AWS Security ChangesHomeSearch

AWS keyspaces high security documentation change

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

File: keyspaces/latest/devguide/using_nodejs_driver.md

Summary

Updated TLS certificate configuration instructions to include multiple Amazon Root CAs (1-4) and combine certificates into a bundle for compatibility during AWS's certificate migration

Security assessment

The change addresses TLS certificate rotation by adding multiple Amazon Trust Services root CAs and deprecating reliance on Starfield CA. This ensures continued secure TLS connections during AWS's certificate migration, preventing potential TLS handshake failures or insecure connections if clients don't trust new CAs. Explicitly mentions security implications of certificate compatibility across regions.

Diff

diff --git a/keyspaces/latest/devguide/using_nodejs_driver.md b/keyspaces/latest/devguide/using_nodejs_driver.md
index 52fac4be4..c0cfacdaa 100644
--- a//keyspaces/latest/devguide/using_nodejs_driver.md
+++ b//keyspaces/latest/devguide/using_nodejs_driver.md
@@ -35 +35 @@ Amazon Keyspaces requires the use of Transport Layer Security (TLS) to help secu
-Download the Starfield digital certificate using the following command and save `sf-class2-root.crt` locally or in your home directory.
+Download the following digital certificates and save the files locally or in your home directory.
@@ -36,0 +37 @@ Download the Starfield digital certificate using the following command and save
+  1. AmazonRootCA1
@@ -38 +39,19 @@ Download the Starfield digital certificate using the following command and save
-    curl https://certs.secureserver.net/repository/sf-class2-root.crt -O
+  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
@@ -42 +61,3 @@ Download the Starfield digital certificate using the following command and save
-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.
+
+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.
@@ -45 +66,6 @@ You can also use the Amazon digital certificate to connect to Amazon Keyspaces a
-    curl https://certs.secureserver.net/repository/sf-class2-root.crt -O
+    cat AmazonRootCA1.pem \
+     AmazonRootCA2.pem \
+     AmazonRootCA3.pem \
+     AmazonRootCA4.pem \
+     sf-class2-root.crt \
+     > keyspaces-bundle.pem
@@ -49 +75 @@ You can also use the Amazon digital certificate to connect to Amazon Keyspaces a
-Configure your driver to use the Starfield digital certificate for TLS and authenticate using service-specific credentials. For example: 
+Configure your driver to use the combined certificate file `keyspaces-bundle.pem` for TLS and authenticate using service-specific credentials. For example: 
@@ -57 +83 @@ Configure your driver to use the Starfield digital certificate for TLS and authe
-                        fs.readFileSync('path_to_file/sf-class2-root.crt', 'utf-8')],      
+                        fs.readFileSync('path_to_file/keyspaces-bundle.pem', 'utf-8')],      
@@ -76 +102 @@ Usage notes:
-  1. Replace `"`path_to_file`/sf-class2-root.crt"` with the path to the certificate saved in the first step.
+  1. Replace `"`path_to_file/keyspaces-bundle.pem`"` with the path to the combined certificate file saved in the first step.
@@ -110 +136 @@ This code example shows how to set a Region-specific instance of `SigV4AuthProvi
-          fs.readFileSync('path_to_filecassandra/sf-class2-root.crt', 'utf-8')],
+          fs.readFileSync('path_to_file/keyspaces-bundle.pem', 'utf-8')],
@@ -133 +159 @@ Usage notes:
-  1. Replace `"`path_to_file`/sf-class2-root.crt"` with the path to the certificate saved in the first step.
+  1. Replace `"`path_to_file/keyspaces-bundle.pem`"` with the path to the certificate saved in the first step.