Itgenclr199: SSL-handshake mislukt door een niet-ondersteund protocol

Wiki (nl)
1

Bij het gebruik van Invantive UniversalSQL Server kan een foutmelding optreden:

itgenclr199
Authentication failed, see inner exception.
SSL Handshake failed with OpenSSL error - SSL_ERROR_SSL.
error:…:SSL routines::unsupported protocol.
Er is een onbekende fout opgetreden.
Connect with a client that supports TLS 1.2.

Wat betekent de melding itgenclr199?

Invantive UniversalSQL Server versleutelt de verbinding met TLS en staat daarbij alleen TLS 1.2 toe. Een client die TLS 1.2 niet aanbiedt, komt niet door de handshake. De melding staat in het logboek van de server en kan ook op het scherm van de client verschijnen. Of een client TLS 1.2 gebruikt, hangt af van het stuurprogramma en van de instellingen van het besturingssysteem.

Oorzaken

Mogelijke oorzaken zijn:

  • Een oud stuurprogramma gebruikt alleen TLS 1.0 en/of TLS 1.1.
  • Het besturingssysteem of de omgeving van de client heeft TLS 1.2 niet ingeschakeld. Dat geldt voor oudere besturingssystemen en oudere Java-omgevingen.
  • Een client biedt alleen TLS 1.3 aan. Invantive UniversalSQL Server staat TLS 1.3 niet toe.

Oplossing

De volgende stappen kunnen het probleem oplossen:

  1. Werk het stuurprogramma van de client bij naar een versie met TLS 1.2, bijvoorbeeld Microsoft ODBC Driver 17 of 18 voor SQL Server.
  2. Schakel TLS 1.2 in op het besturingssysteem of in de omgeving van de client. De documentatie van het besturingssysteem of van de omgeving beschrijft hoe dat gaat. Besturingssystemen die niet meer ondersteund worden door de leverancier zoals Microsoft worden ook door Invantive niet ondersteund.
  3. Test de verbinding met SQL Server Management Studio, waarmee Invantive UniversalSQL Server is getest.

Een beheerder kan dit niet met een instelling oplossen. Invantive UniversalSQL Server staat alleen TLS 1.2 toe.

Een vraag stellen op het forum

Lukt het niet om het probleem op te lossen, dan kan een vraag worden gesteld in de categorie “Vragen” van dit forum. Een vraag is goed te beantwoorden met de volgende gegevens:

  • de foutcode itgenclr199
  • de volledige tekst van de melding
  • het tijdstip van de melding in UTC, met de tijdzone erbij
  • het product Invantive UniversalSQL Server
  • de naam en versie van de client en van het besturingssysteem
  • de stappen die al zijn geprobeerd