AWS Security ChangesHomeSearch

AWS keyspaces medium security documentation change

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

File: keyspaces/latest/devguide/using_go_driver.md

Summary

Updated TLS certificate requirements to include multiple Amazon Root CAs (1-4) and deprecated Starfield CA with backward compatibility. Added instructions to download and combine certificates into a bundle.

Security assessment

The change addresses TLS certificate trust chain updates, explicitly migrating from Starfield CA to Amazon Trust Services CAs. This ensures continued secure connectivity and prevents potential TLS handshake failures during the transition. The inclusion of multiple root CAs and backward compatibility guidance directly relates to maintaining secure communication standards.

Diff

diff --git a/keyspaces/latest/devguide/using_go_driver.md b/keyspaces/latest/devguide/using_go_driver.md
index da9db5a21..273f0ac24 100644
--- a//keyspaces/latest/devguide/using_go_driver.md
+++ b//keyspaces/latest/devguide/using_go_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 @@ 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.
@@ -43,0 +63 @@ You can also use the Amazon digital certificate to connect to Amazon Keyspaces a
+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 +65,7 @@ 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
@@ -84 +110,2 @@ You can also use the Amazon digital certificate to connect to Amazon Keyspaces a
-        // provide the path to the sf-class2-root.crt
+    
+        // provide the path to the keyspaces-bundle.pem
@@ -86 +113 @@ You can also use the Amazon digital certificate to connect to Amazon Keyspaces a
-                CaPath: "path_to_file/sf-class2-root.crt",
+                CaPath: "path_to_file/keyspaces-bundle.pem",
@@ -114 +141 @@ 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.
@@ -164 +191,2 @@ In this code example, the Amazon Keyspaces endpoint is represented by the `Clust
-                CaPath: "path_to_file/sf-class2-root.crt",
+    
+                CaPath: "path_to_file/keyspaces-bundle.pem",
@@ -190 +218 @@ 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 file saved in the first step.