AWS Security ChangesHomeSearch

AWS keyspaces medium security documentation change

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

File: keyspaces/latest/devguide/workbench.commit.md

Summary

Updated certificate download instructions to include multiple Amazon Root CAs (1-4) and Starfield CA, with commands to combine into a bundle file.

Security assessment

This change supports the same certificate authority migration as the Python driver documentation, ensuring secure TLS connections by requiring trust in updated root certificates. Prevents potential man-in-the-middle attacks that could occur if clients don't trust the new certificate authorities.

Diff

diff --git a/keyspaces/latest/devguide/workbench.commit.md b/keyspaces/latest/devguide/workbench.commit.md
index 41dda5472..de0ccbc22 100644
--- a//keyspaces/latest/devguide/workbench.commit.md
+++ b//keyspaces/latest/devguide/workbench.commit.md
@@ -32 +32 @@ 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.
@@ -34 +34,17 @@ Amazon Keyspaces requires the use of Transport Layer Security (TLS) to help secu
-        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
@@ -38 +54,3 @@ Amazon Keyspaces requires the use of Transport Layer Security (TLS) to help secu
-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.
@@ -40 +58,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