AWS Security ChangesHomeSearch

AWS keyspaces medium security documentation change

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

File: keyspaces/latest/devguide/using_python_driver.md

Summary

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

Security assessment

The change addresses certificate authority migration to Amazon Trust Services, requiring clients to trust new root CAs to maintain secure TLS connections. This prevents potential TLS handshake failures and ensures continued encryption security during AWS's certificate authority transition.

Diff

diff --git a/keyspaces/latest/devguide/using_python_driver.md b/keyspaces/latest/devguide/using_python_driver.md
index 5e4afe19f..38b5be579 100644
--- a//keyspaces/latest/devguide/using_python_driver.md
+++ b//keyspaces/latest/devguide/using_python_driver.md
@@ -33 +33 @@ You need to complete the following task before you can start.
-Amazon Keyspaces requires the use of Transport Layer Security (TLS) to help secure connections with clients. To connect to Amazon Keyspaces using TLS, you need to download an Amazon digital certificate and configure the Python driver to use TLS. 
+Amazon Keyspaces requires the use of Transport Layer Security (TLS) to help secure connections with clients. To connect to Amazon Keyspaces using TLS, you need to download Amazon digital certificates and configure the Python driver to use TLS. 
@@ -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
@@ -57 +83,3 @@ The following code example shows you how to connect to Amazon Keyspaces with a P
-    ssl_context.load_verify_locations('path_to_file/sf-class2-root.crt')
+    
+    ssl_context.load_verify_locations('path_to_file/keyspaces-bundle.pem')
+    
@@ -67 +95 @@ 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.
@@ -97 +125 @@ The following code example shows how to connect to Amazon Keyspaces by using the
-    ssl_context.load_verify_locations('path_to_file/sf-class2-root.crt')
+    ssl_context.load_verify_locations('path_to_file/keyspaces-bundle.pem')
@@ -118 +146 @@ 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.