AWS Security ChangesHomeSearch

AWS athena: Document ODBC TrustedCerts verification and User-Agent privacy mode

Service: athena · 2026-09-29 · Documentation medium

File: athena/latest/ug/odbc-v2-driver-advanced-options.md · Type: encryption

Summary

Expanded TrustedCerts guidance for certificate verification across Windows/Linux/macOS and added a UserAgentPrivacyMode parameter to omit runtime environment metadata from identity provider requests.

Security assessment

Documents TLS certificate trust-store configuration (TrustedCerts) for the Athena ODBC driver and a privacy mode that reduces metadata leakage in User-Agent headers to identity providers. This is encryption-in-transit and privacy hardening guidance, not a fix for a specific CVE.

Evidence

+Use the following operating-system guidance to configure certificate verification with the `TrustedCerts` parameter. For more information, see [Encryption in transit](./encryption-in-transit.html).

Diff

diff --git a/athena/latest/ug/odbc-v2-driver-advanced-options.md b/athena/latest/ug/odbc-v2-driver-advanced-options.md
index a8fbd29e0..2e2f2a8c0 100644
--- a//athena/latest/ug/odbc-v2-driver-advanced-options.md
+++ b//athena/latest/ug/odbc-v2-driver-advanced-options.md
@@ -7 +7 @@
-Fetch sizeResult fetcherEnable result reuseResult reuse maximum ageUse multiple S3 threadsUse single catalog and schemaUse query to list tablesUse WCHAR for string typesQuery external catalogsVerify SSLS3 result block sizeString column lengthComplex type column lengthTrusted CA certificateMin poll periodMax poll periodPoll multiplierMax poll durationConnection timeoutRequest timeout
+Fetch sizeResult fetcherEnable result reuseResult reuse maximum ageUse multiple S3 threadsUse single catalog and schemaUse query to list tablesUse WCHAR for string typesQuery external catalogsVerify SSLS3 result block sizeString column lengthComplex type column lengthTrusted CA certificateUser-Agent privacy modeMin poll periodMax poll periodPoll multiplierMax poll durationConnection timeoutRequest timeout
@@ -125 +125,19 @@ ComplexTypeColumnLength | Optional | 65535 | `ComplexTypeColumnLength=123456;`
-Instructs the HTTP client where to find your SSL certificate trust store. This value is passed to the `ClientConfiguration.caFile` parameter. For more information, see [AWS Client configuration](https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/client-config.html) in the _AWS SDK for C++ Developer Guide_.
+Use the following operating-system guidance to configure certificate verification with the `TrustedCerts` parameter. For more information, see [Encryption in transit](./encryption-in-transit.html).
+
+TrustedCerts behavior by operating system Operating system | Default behavior | Private CA configuration  
+---|---|---  
+Windows | The driver uses the operating system trust store for certificate verification. The Windows WinHTTP client does not use the path in the `TrustedCerts` parameter. | Configure the private CA in Windows so that WinHTTP trusts it.  
+Linux | If you do not set this parameter, the driver checks the `CURL_CA_BUNDLE` and `SSL_CERT_FILE` environment variables. It then checks a set of well-known system paths. The driver caches the resolved CA path for the lifetime of the process. Restart the application after changing either environment variable. | Set `TrustedCerts` or one of the environment variables to the path of your CA bundle. The parameter takes precedence over the environment variables and system paths.  
+macOS | If you do not set this parameter, certificate verification uses the system curl library's default trust store. | Set `TrustedCerts` to the path of your trust store file.  
+  
+**Connection string name** | **Parameter type** | **Default value** | **Connection string example**  
+---|---|---|---  
+TrustedCerts | Optional | Not set. Certificate verification follows the platform behavior in TrustedCerts behavior by operating system. | `TrustedCerts=/etc/ssl/certs/cacert.pem;`  
+  
+## User-Agent privacy mode
+
+Use this parameter to control whether the driver includes runtime environment metadata in the `User-Agent` header that it sends to identity provider requests. By default, the driver includes this metadata. Set this parameter to `1` to omit operating system, architecture, and execution environment metadata from identity provider requests. The header continues to include the driver identifier in the form `lib/AmazonAthenaODBC#<version>`. Only the literal value `1` enables privacy mode.
+
+This parameter applies to identity provider requests only. Requests to AWS services, including Athena, AWS Glue, and Amazon S3, always include the full `User-Agent` header, regardless of this setting. Windows Integrated Authentication continues to use a browser `User-Agent`.
+
+Use this parameter if a legacy identity provider policy cannot accept runtime environment metadata in the `User-Agent` header.
@@ -129 +147 @@ Instructs the HTTP client where to find your SSL certificate trust store. This v
-TrustedCerts | Optional | `%INSTALL_PATH%/bin` | `TrustedCerts=C:\\Program Files\\Amazon Athena ODBC Driver\\bin\\cacert.pem;`  
+UserAgentPrivacyMode | Optional | `0` | `UserAgentPrivacyMode=1;`