Metodo setEncrypt (SQLServerDataSource)

  • Articolo

Scaricare il driver JDBC

Imposta un valore Boolean che indica se la proprietà encrypt è abilitata.

Sintassi

  
public void setEncypt(boolean encrypt)

Parametri

encrypt

true se la crittografia Transport Layer Security (TLS), precedentemente nota come Secure Sockets Layer (SSL), è abilitata tra il client e SQL Server. In caso contrario, false.

Osservazioni

Se la proprietà di crittografia è impostata su true, Microsoft JDBC Driver per SQL Server fa in modo che in SQL Server venga usata la crittografia TLS per tutti i dati inviati tra il client e il server, se nel server è installato un certificato. Il valore predefinito è false.

Il driver JDBC rileva l'ambiente Java Virtual Machine (JVM) in cui viene eseguito durante il tentativo di stabilire un handshake TLS.

Se la proprietà di crittografia è impostata su true, Microsoft JDBC Driver per SQL Server usa il provider di sicurezza JSSE predefinito di JVM per negoziare la crittografia TLS con SQL Server. È possibile che il provider di sicurezza predefinito non supporti tutte le funzionalità necessarie per negoziare la crittografia TLS. Tale provider può ad esempio non supportare la dimensione della chiave pubblica RSA usata nel certificato TLS/SSL di SQL Server. In questo caso, è possibile che venga generato un errore dal provider di sicurezza predefinito, a causa del quale la connessione viene terminata dal driver JDBC. Per risolvere il problema, eseguire una delle operazioni seguenti:

  • Configurare SQL Server con un certificato del server con una chiave pubblica RSA più piccola.

  • Configurare JVM per l'uso di un provider di sicurezza JSSE diverso nel file delle proprietà di sicurezza "<java-home>/lib/security/java.security"

  • Utilizzare una versione di JVM diversa.

Se la proprietà di crittografia non è specificata o è impostata su false, il driver non impone il supporto della crittografia TLS a SQL Server. Se l'istanza di SQL Server non è configurata in modo da imporre la crittografia TLS, viene stabilita una connessione senza crittografia. Se l'istanza di SQL Server è configurata per la forzatura della crittografia TLS, Microsoft JDBC Driver per SQL Server abilita questo tipo di crittografia automaticamente durante l'esecuzione in un ambiente JVM correttamente configurato. In caso contrario, la connessione viene terminata e il driver genera un errore.

Vedere anche

Membri di SQLServerDataSource
Classe SQLServerDataSource