AWS keyspaces high security documentation change
Summary
Removed manual Starfield certificate download steps and updated instructions to use the system trust store with Amazon Root CAs for TLS configuration.
Security assessment
The change addresses potential security risks by deprecating manual certificate handling in favor of relying on the system trust store, which includes trusted Amazon Root CAs. This reduces the risk of misconfiguration (e.g., using outdated or invalid certificates) and ensures proper TLS validation, mitigating risks like man-in-the-middle attacks. The removal of direct certificate downloads suggests a shift to more secure defaults.
Diff
diff --git a/keyspaces/latest/devguide/using_dotnetcore_driver.md b/keyspaces/latest/devguide/using_dotnetcore_driver.md index afaaa0f48..5bba3c7fc 100644 --- a//keyspaces/latest/devguide/using_dotnetcore_driver.md +++ b//keyspaces/latest/devguide/using_dotnetcore_driver.md @@ -7 +7 @@ -This section shows you how to connect to Amazon Keyspaces by using a .NET Core client driver. The setup steps will vary depending on your environment and operating system, you might have to modify them accordingly. 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 a Starfield digital certificate and configure your driver to use TLS. +This section shows you how to connect to Amazon Keyspaces by using a .NET Core client driver. The setup steps will vary depending on your environment and operating system, you might have to modify them accordingly. Amazon Keyspaces requires the use of Transport Layer Security (TLS) to help secure connections with clients. To connect to Amazon Keyspaces using TLS, configure your driver to use the system trust store, which includes the Amazon Root CAs 1-4. @@ -9,6 +9 @@ This section shows you how to connect to Amazon Keyspaces by using a .NET Core c - 1. Download the Starfield certificate and save it to a local directory, taking note of the path. Following is an example using PowerShell. - - $client = new-object System.Net.WebClient - $client.DownloadFile("https://certs.secureserver.net/repository/sf-class2-root.crt","path_to_file\sf-class2-root.crt") - - 2. Install the CassandraCSharpDriver through nuget, using the nuget console. + 1. Install the CassandraCSharpDriver through nuget, using the nuget console. @@ -18 +13 @@ This section shows you how to connect to Amazon Keyspaces by using a .NET Core c - 3. The following example uses a .NET Core C# console project to connect to Amazon Keyspaces and run a query. + 2. The following example uses a .NET Core C# console project to connect to Amazon Keyspaces and run a query. @@ -38,2 +32,0 @@ This section shows you how to connect to Amazon Keyspaces by using a .NET Core c - X509Certificate2Collection certCollection = new X509Certificate2Collection(); - X509Certificate2 amazoncert = new X509Certificate2(@"path_to_file\sf-class2-root.crt"); @@ -67 +63 @@ Usage notes: - 1. Replace `"`path_to_file`/sf-class2-root.crt"` with the path to the certificate saved in the first step. + 1. Ensure that you use the default system trust store, which includes the Amazon Root CAs 1-4.