AWS keyspaces high security documentation change
Summary
Updated certificate configuration instructions to include multiple Amazon Root CAs (1-4) alongside Starfield, added detailed conversion steps for truststore files, and included warnings about SHA1withRSA security risks
Security assessment
The change addresses certificate authority migration (from Starfield to Amazon Trust Services CAs) which is security-critical for maintaining TLS trust chains. Explicit warnings about SHA1withRSA being a security risk and instructions to trust multiple CAs directly impact secure communication configuration. The added certificate details and migration notice indicate proactive security maintenance.
Diff
diff --git a/keyspaces/latest/devguide/using_java_driver.md b/keyspaces/latest/devguide/using_java_driver.md index 0fa347120..b529e7bc3 100644 --- a//keyspaces/latest/devguide/using_java_driver.md +++ b//keyspaces/latest/devguide/using_java_driver.md @@ -47 +47 @@ To connect to Amazon Keyspaces, you need to complete the following tasks before - 1. Download the Starfield digital certificate using the following command and save `sf-class2-root.crt` locally or in your home directory. + 1. Download the following digital certificates and save the files locally or in your home directory. @@ -49 +49,17 @@ To connect to Amazon Keyspaces, you need to complete the following tasks before - 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 @@ -53 +69 @@ To connect to Amazon Keyspaces, you need to complete the following tasks before -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. @@ -55 +71,13 @@ You can also use the Amazon digital certificate to connect to Amazon Keyspaces a - 2. Convert the Starfield digital certificate into a trustStore file. + 2. Convert the digital certificates into trustStore files and add them to the keystore. + + openssl x509 -outform der -in AmazonRootCA1.pem -out temp_file.der + keytool -import -alias amazon-root-ca-1 -keystore cassandra_truststore.jks -file temp_file.der + + openssl x509 -outform der -in AmazonRootCA2.pem -out temp_file.der + keytool -import -alias amazon-root-ca-2 -keystore cassandra_truststore.jks -file temp_file.der + + openssl x509 -outform der -in AmazonRootCA3.pem -out temp_file.der + keytool -import -alias amazon-root-ca-3 -keystore cassandra_truststore.jks -file temp_file.der + + openssl x509 -outform der -in AmazonRootCA4.pem -out temp_file.der + keytool -import -alias amazon-root-ca-4 -keystore cassandra_truststore.jks -file temp_file.der @@ -60 +88 @@ You can also use the Amazon digital certificate to connect to Amazon Keyspaces a -In this step, you need to create a password for the keystore and trust this certificate. The interactive command looks like this. +In the last step, you need to create a password for the keystore and trust each certificate. The interactive command looks like this. @@ -63,0 +92,148 @@ In this step, you need to create a password for the keystore and trust this cert + Owner: CN=Amazon Root CA 1, O=Amazon, C=US + Issuer: CN=Amazon Root CA 1, O=Amazon, C=US + Serial number: 66c9fcf99bf8c0a39e2f0788a43e696365bca + Valid from: Tue May 26 00:00:00 UTC 2015 until: Sun Jan 17 00:00:00 UTC 2038 + Certificate fingerprints: + SHA1: 8D:A7:F9:65:EC:5E:FC:37:91:0F:1C:6E:59:FD:C1:CC:6A:6E:DE:16 + SHA256: 8E:CD:E6:88:4F:3D:87:B1:12:5B:A3:1A:C3:FC:B1:3D:70:16:DE:7F:57:CC:90:4F:E1:CB:97:C6:AE:98:19:6E + Signature algorithm name: SHA256withRSA + Subject Public Key Algorithm: 2048-bit RSA key + Version: 3 + + Extensions: + + #1: ObjectId: 2.5.29.19 Criticality=true + BasicConstraints:[ + CA:true + PathLen:2147483647 + ] + + #2: ObjectId: 2.5.29.15 Criticality=true + KeyUsage [ + DigitalSignature + Key_CertSign + Crl_Sign + ] + + #3: ObjectId: 2.5.29.14 Criticality=false + SubjectKeyIdentifier [ + KeyIdentifier [ + 0000: 84 18 CC 85 34 EC BC 0C 94 94 2E 08 59 9C C7 B2 ....4.......Y... + 0010: 10 4E 0A 08 .N.. + ] + ] + + Trust this certificate? [no]: yes + Certificate was added to keystore + Enter keystore password: + Owner: CN=Amazon Root CA 2, O=Amazon, C=US + Issuer: CN=Amazon Root CA 2, O=Amazon, C=US + Serial number: 66c9fd29635869f0a0fe58678f85b26bb8a37 + Valid from: Tue May 26 00:00:00 UTC 2015 until: Sat May 26 00:00:00 UTC 2040 + Certificate fingerprints: + SHA1: 5A:8C:EF:45:D7:A6:98:59:76:7A:8C:8B:44:96:B5:78:CF:47:4B:1A + SHA256: 1B:A5:B2:AA:8C:65:40:1A:82:96:01:18:F8:0B:EC:4F:62:30:4D:83:CE:C4:71:3A:19:C3:9C:01:1E:A4:6D:B4 + Signature algorithm name: SHA384withRSA + Subject Public Key Algorithm: 4096-bit RSA key + Version: 3 + + Extensions: + + #1: ObjectId: 2.5.29.19 Criticality=true + BasicConstraints:[ + CA:true + PathLen:2147483647 + ] + + #2: ObjectId: 2.5.29.15 Criticality=true + KeyUsage [ + DigitalSignature + Key_CertSign + Crl_Sign + ] + + #3: ObjectId: 2.5.29.14 Criticality=false + SubjectKeyIdentifier [ + KeyIdentifier [ + 0000: B0 0C F0 4C 30 F4 05 58 02 48 FD 33 E5 52 AF 4B ...L0..X.H.3.R.K + 0010: 84 E3 66 52 ..fR + ] + ] + + Trust this certificate? [no]: yes + Certificate was added to keystore + Enter keystore password: + Owner: CN=Amazon Root CA 3, O=Amazon, C=US + Issuer: CN=Amazon Root CA 3, O=Amazon, C=US + Serial number: 66c9fd5749736663f3b0b9ad9e89e7603f24a + Valid from: Tue May 26 00:00:00 UTC 2015 until: Sat May 26 00:00:00 UTC 2040 + Certificate fingerprints: + SHA1: 0D:44:DD:8C:3C:8C:1A:1A:58:75:64:81:E9:0F:2E:2A:FF:B3:D2:6E + SHA256: 18:CE:6C:FE:7B:F1:4E:60:B2:E3:47:B8:DF:E8:68:CB:31:D0:2E:BB:3A:DA:27:15:69:F5:03:43:B4:6D:B3:A4 + Signature algorithm name: SHA256withECDSA + Subject Public Key Algorithm: 256-bit EC (secp256r1) key + Version: 3 + + Extensions: + + #1: ObjectId: 2.5.29.19 Criticality=true + BasicConstraints:[ + CA:true + PathLen:2147483647 + ] + + #2: ObjectId: 2.5.29.15 Criticality=true + KeyUsage [ + DigitalSignature + Key_CertSign + Crl_Sign + ] + + #3: ObjectId: 2.5.29.14 Criticality=false + SubjectKeyIdentifier [ + KeyIdentifier [ + 0000: AB B6 DB D7 06 9E 37 AC 30 86 07 91 70 C7 9C C4 ......7.0...p... + 0010: 19 B1 78 C0 ..x. + ] + ] + + Trust this certificate? [no]: yes + Certificate was added to keystore + Enter keystore password: + Owner: CN=Amazon Root CA 4, O=Amazon, C=US + Issuer: CN=Amazon Root CA 4, O=Amazon, C=US + Serial number: 66c9fd7c1bb104c2943e5717b7b2cc81ac10e + Valid from: Tue May 26 00:00:00 UTC 2015 until: Sat May 26 00:00:00 UTC 2040 + Certificate fingerprints: + SHA1: F6:10:84:07:D6:F8:BB:67:98:0C:C2:E2:44:C2:EB:AE:1C:EF:63:BE + SHA256: E3:5D:28:41:9E:D0:20:25:CF:A6:90:38:CD:62:39:62:45:8D:A5:C6:95:FB:DE:A3:C2:2B:0B:FB:25:89:70:92 + Signature algorithm name: SHA384withECDSA + Subject Public Key Algorithm: 384-bit EC (secp384r1) key + Version: 3 + + Extensions: + + #1: ObjectId: 2.5.29.19 Criticality=true + BasicConstraints:[ + CA:true + PathLen:2147483647 + ] + + #2: ObjectId: 2.5.29.15 Criticality=true + KeyUsage [ + DigitalSignature + Key_CertSign + Crl_Sign + ] + + #3: ObjectId: 2.5.29.14 Criticality=false + SubjectKeyIdentifier [ + KeyIdentifier [ + 0000: D3 EC C7 3A 65 6E CC E1 DA 76 9A 56 FB 9C F3 86 ...:en...v.V.... + 0010: 6D 57 E5 81 mW.. + ] + ] + + Trust this certificate? [no]: yes + Certificate was added to keystore + Enter keystore password: @@ -69 +244,0 @@ In this step, you need to create a password for the keystore and trust this cert - MD5: 32:4A:4B:BB:C8:63:69:9B:BE:74:9A:C6:DD:1D:46:24 @@ -72 +247 @@ In this step, you need to create a password for the keystore and trust this cert - Signature algorithm name: SHA1withRSA