Lokasi ngalangkungan proxy:   [ UP ]  
[Ngawartoskeun bug]   [Panyetelan cookie]                
Skip to content

Commit 9cd4d6f

Browse files
committed
Update connection troubleshooting
1 parent 8176d74 commit 9cd4d6f

1 file changed

Lines changed: 12 additions & 7 deletions

File tree

docs/connect/odbc/connection-troubleshooting.md

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -8,17 +8,22 @@ ms.service: sql
88
ms.subservice: connectivity
99
ms.topic: conceptual
1010
---
11-
# Connection Encryption Troubleshooting
11+
# Troubleshooting connection encryption problems
1212

13-
### SSL Provider: The certificate chain was issued by an authority that is not trusted.
14-
Connection encryption is enabled by default in version 18 and newer. Users may see this error if the SQL Server isn't configured to use certificates. To configure connection encryption for the server, see [Configure SQL Server Database Engine for encrypting connections](../../database-engine/configure-windows/configure-sql-server-encryption.md).
13+
**If you see "SSL Provider: The certificate chain was issued by an authority that is not trusted." or "SSL routines::certificate verify failed: unable to get local issuer certificate" in your error:**
1514

16-
Users can also choose to set the `Encrypt` connection string keyword to `no`/`optional` to disable connection encryption to match the default behavior prior to version 18. In the DSN Configuration UI, this option is set using the `Connection Encryption` dropdown. If connection encryption is desired, `TrustServerCertificate` can also be set to `yes` to skip server certificate validation.
15+
- Connection encryption is enabled by default in version 18 and newer. Users switching from previous versions of ODBC may see these errors if connection encryption was previously not used.
16+
- Users can also choose to set the `Encrypt` connection string keyword to `no`/`optional` to disable connection encryption to match the default behavior prior to version 18. In the DSN Configuration UI, this option is set using the `Connection Encryption` dropdown.
17+
- If connection encryption is desired, `TrustServerCertificate` can also be set to `yes` to skip server certificate validation.
1718

18-
### SSL Provider: The target principal name is incorrect.
19-
Users may see this error if the host name in the certificate returned by the server doesn't match what is expected. By default, the server name is used to check against the certificate. The `HostNameInCertificate` keyword can be used to specify the name expected from the server certificate. Alternatively, a certificate can also be specified to match and verify the returned server certificate against by using the `ServerCertificate` keyword (v18.1+). For more information, see [DSN and Connection String Keywords and Attributes](dsn-connection-string-attribute.md).
19+
**If you see "SSL Provider: The target principal name is incorrect." or "SSL routines::certificate verify failed:subject name does not match host name" in your error:**
2020

21-
You may also use `TrustServerCertificate` to skip server certificate validation.
21+
- Users may see this error if the host name in the certificate returned by the server doesn't match what is expected. By default, the server name is used to check against the certificate.
22+
- The `HostNameInCertificate` keyword can be used to specify the name expected from the server certificate.
23+
- Alternatively, a certificate can also be specified to match and verify the returned server certificate against by using the `ServerCertificate` keyword (v18.1+).
24+
- You may also use `TrustServerCertificate` to skip server certificate validation.
25+
26+
For more information, see [DSN and Connection String Keywords and Attributes](dsn-connection-string-attribute.md).
2227

2328
--------------------------------------------------
2429
## See Also

0 commit comments

Comments
 (0)