From e9ee4c32a6c032419a0826262a7240ffbc27f593 Mon Sep 17 00:00:00 2001 From: Valerie Chiang Date: Wed, 18 Nov 2026 20:18:40 -0500 Subject: [PATCH] doc: show the RDS CA bundle in the MySQL IAM example The MySQL IAM authentication example uses SSL MODE verify_identity without a certificate authority. Amazon RDS certificates are signed by Amazon's own CAs, which are not in the system's default CA certificates, so the example needs the RDS certificate bundle. Add the secret and SSL CERTIFICATE AUTHORITY, and explain when it is needed. Co-Authored-By: Claude Fable 5.2 --- doc/user/content/sql/create-connection.md | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/doc/user/content/sql/create-connection.md b/doc/user/content/sql/create-connection.md index bd8b7c7d3527a..2728788a29a0d 100644 --- a/doc/user/content/sql/create-connection.md +++ b/doc/user/content/sql/create-connection.md @@ -803,14 +803,28 @@ CREATE CONNECTION aws_rds_mysql TO AWS ( REGION = 'us-west-1' ); +CREATE SECRET aws_rds_cas AS ''; + CREATE CONNECTION mysql_connection TO MYSQL ( HOST 'instance.foo000.us-west-1.rds.amazonaws.com', PORT 3306, USER 'root', AWS CONNECTION aws_rds_mysql, - SSL MODE 'verify_identity' + SSL MODE 'verify_identity', + SSL CERTIFICATE AUTHORITY SECRET aws_rds_cas ); ``` + +AWS IAM authentication requires SSL. Amazon RDS certificates are signed by +Amazon's own certificate authorities, which are not in the system's default +CA certificates. To verify the server's certificate with `SSL MODE` set to +`verify_ca` or `verify_identity`, [download the certificate bundle for your +AWS Region](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html), +store its contents in a secret, and pass that secret as +`SSL CERTIFICATE AUTHORITY`. With `SSL MODE 'required'`, the connection is +encrypted but the server's certificate is not verified, and no certificate +bundle is needed. + {{< /tab >}} {{< /tabs >}}