Using SSL/TLS to encrypt a connection to a DB cluster
You can use Secure Socket Layer (SSL) or Transport Layer Security (TLS) from your application to encrypt a connection to a DB cluster running Aurora MySQL or Aurora PostgreSQL.
SSL/TLS connections provide one layer of security by encrypting data that moves between your client and a DB cluster. Using a server certificate provides an extra layer of security by validating that the connection is being made to an Amazon Aurora DB cluster. It does so by checking the server certificate that is automatically installed on all DB clusters that you provision.
Each DB engine has its own process for implementing SSL/TLS. To learn how to implement SSL/TLS for your DB cluster, use the link following that corresponds to your DB engine:
Note
All certificates are only available for download using SSL/TLS connections.
Certificate authorities
The certificate authority (CA) is the certificate that identifies the root CA at the top of the certificate chain. The CA signs the DB instance certificate, which is the server certificate that is installed on each DB instance. The server certificate identifies the DB instance as a trusted server.
Amazon RDS provides the following CAs to sign the server certificate for a DB instance.
| Certificate authority (CA) | Description |
|---|---|
|
rds-ca-2019 |
Uses a certificate authority with RSA 2048 private key algorithm and SHA256 signing algorithm for your DB instance server certificate. This CA expires in 2024 and doesn't support automatic server certificate rotation. If you are using this CA and want to keep the same standard, we recommend that you switch to the rds-ca-rsa2048-g1 CA. |
|
rds-ca-rsa2048-g1 |
Uses a certificate authority with RSA 2048 private key algorithm and SHA256 signing algorithm for your DB instance server certificate in most AWS Regions. In the AWS GovCloud (US) Regions, this CA uses a certificate authority with RSA 2048 private key algorithm and SHA384 signing algorithm for your DB instance server certificate. This CA remains valid for longer than the rds-ca-2019 CA. This CA supports automatic server certificate rotation. |
|
rds-ca-rsa4096-g1 |
Uses a certificate authority with RSA 4096 private key algorithm and SHA384 signing algorithm for your DB instance server certificate. This CA supports automatic server certificate rotation. |
|
rds-ca-ecc384-g1 |
Uses a certificate authority with ECC 384 private key algorithm and SHA384 signing algorithm for your DB instance server certificate. This CA supports automatic server certificate rotation. |
Note
If you are using the AWS CLI, you can see the validities of the certificate authorities listed above by using describe-certificates.
When you use the rds-ca-rsa2048-g1, rds-ca-rsa4096-g1, or rds-ca-ecc384-g1 CA with a DB instance, RDS manages the server certificate on the DB instance. RDS rotates it automatically before it expires. These CA certificates are included in the regional and global certificate bundle.
You can set the CA for a DB instance when you perform the following tasks:
-
Create an Aurora DB cluster – You can set the CA for a DB instance in an Aurora cluster when you create the first DB instance in the DB cluster using the AWS CLI or RDS API. Currently, you can't set the CA for the DB instances in a DB cluster when you create the DB cluster using the RDS console. For instructions, see Creating an Amazon Aurora DB cluster.
-
Modify a DB instance – You can set the CA for a DB instance in a DB cluster by modifying it. For instructions, see Modifying a DB instance in a DB cluster.
You can set the default CA for your AWS account by using the modify-certificates command.
The available CAs depend on the DB engine and DB engine version. When you use the AWS Management Console, you can choose the CA using the Certificate authority setting, as shown in the following image.
The console only shows the CAs that are available for the DB engine and DB engine version. If you are using the AWS CLI, you can set the CA for a DB instance using the create-db-instance or modify-db-instance command.
If you are using the AWS CLI, you can see the available CAs for your account by using the describe-certificates command. This command
also shows the expiration date for each CA in ValidTill in the output. You can find the CAs
that are available for a specific DB engine and DB engine version using the describe-db-engine-versions command.
The following example shows the CAs available for the default RDS for PostgreSQL DB engine version.
aws rds describe-db-engine-versions --default-only --engine postgres
Your output is similar to the following. The available CAs are listed in SupportedCACertificateIdentifiers.
The output also shows whether the DB engine version supports rotating the certificate without restart in
SupportsCertificateRotationWithoutRestart.
{
"DBEngineVersions": [
{
"Engine": "postgres",
"MajorEngineVersion": "13",
"EngineVersion": "13.4",
"DBParameterGroupFamily": "postgres13",
"DBEngineDescription": "PostgreSQL",
"DBEngineVersionDescription": "PostgreSQL 13.4-R1",
"ValidUpgradeTarget": [],
"SupportsLogExportsToCloudwatchLogs": false,
"SupportsReadReplica": true,
"SupportedFeatureNames": [
"Lambda"
],
"Status": "available",
"SupportsParallelQuery": false,
"SupportsGlobalDatabases": false,
"SupportsBabelfish": false,
"SupportsCertificateRotationWithoutRestart": true,
"SupportedCACertificateIdentifiers": [
"rds-ca-2019",
"rds-ca-rsa2048-g1",
"rds-ca-ecc384-g1",
"rds-ca-rsa4096-g1"
]
}
]
}You can view the details about the CA for a DB instance by viewing the Connectivity & security tab in the console, as in the following image.
If you are using the AWS CLI, you can view the details about the CA for a DB instance by using the describe-db-instances command.
Certificate bundles for all AWS Regions
To get a certificate bundle that contains both the intermediate and root
certificates for all AWS Regions, download it from
https://truststore.pki.rds.amazonaws.com/global/global-bundle.pem
If your application is on Microsoft Windows and requires a PKCS7
file, you can download the PKCS7 certificate bundle. This bundle contains both
the intermediate and root certificates at
https://truststore.pki.rds.amazonaws.com/global/global-bundle.p7b
Note
Amazon RDS Proxy and Aurora Serverless use certificates from the AWS Certificate Manager (ACM). If you are using RDS Proxy, you don't need to download Amazon RDS certificates or update applications that use RDS Proxy connections. For more information about using TLS/SSL with RDS Proxy, see Using TLS/SSL with RDS Proxy.
If you are using Aurora Serverless, downloading Amazon RDS certificates isn't required. For more information about using TLS/SSL with Aurora Serverless, see Using TLS/SSL with Aurora Serverless v1.
Certificate bundles for specific AWS Regions
To get a certificate bundle that contains both the intermediate and root certificates for an AWS Region, download it from the link for the AWS Region in the following table.
AWS GovCloud (US) certificates
To get a certificate bundle that contains both the intermediate and
root certificates for the AWS GovCloud (US) Regions, download from
https://truststore.pki.us-gov-west-1.rds.amazonaws.com/global/global-bundle.pem
If your application is on Microsoft Windows and requires a PKCS7
file, you can download the PKCS7 certificate bundle. This bundle contains both
the intermediate and root certificates at
https://truststore.pki.us-gov-west-1.rds.amazonaws.com/global/global-bundle.p7b
To get a certificate bundle that contains both the intermediate and root certificates for an AWS GovCloud (US) Region, download from the link for the AWS GovCloud (US) Region in the following table.
| AWS GovCloud (US) Region | Certificate bundle (PEM) | Certificate bundle (PKCS7) |
|---|---|---|
| AWS GovCloud (US-East) | us-gov-east-1-bundle.pem |
us-gov-east-1-bundle.p7b |
| AWS GovCloud (US-West) | us-gov-west-1-bundle.pem |
us-gov-west-1-bundle.p7b |
