Als je een web- of appdeveloper bent, werk je waarschijnlijk met verschillende talen, frameworks en omgevingen. Ontwikkeltools kunnen helpen om je projecten naar een hoger niveau te tillen. Maar tijdens het werken met deze tools, is er een kans dat je obstakels tegenkomt zoals de ERR_OSSL_EVP_UNSUPPORTED fout.

Gelukkig is de oorsprong van de ERR_OSSL_EVP_UNSUPPORTED fout eenvoudig. Bovendien wordt hij veroorzaakt door een eenvoudige inconsistentie in je beveiligingssoftware, dus is hij relatief eenvoudig op te lossen.

In dit artikel bespreken we de ERR_OSSL_EVP_UNSUPPORTED fout en de oorzaak ervan. Daarna laten we je zien hoe je het in drie verschillende scenario’s kunt oplossen. Laten we meteen beginnen!

Wat is de ERR_OSSL_EVP_UNSUPPORTED fout?

Laten we beginnen met te kijken hoe de ERR_OSSL_EVP_UNSUPPORTED fout er in een ontwikkelomgeving uit kan zien:

Een voorbeeld van de fout err_ossl_evp_unsupported
De ERR_OSSL_EVP_UNSUPPORTED fout (Bron: Stackoverflow)

Op het eerste gezicht vallen woorden als “UNSUPPORTED” en “ERR” op omdat ze een duidelijke betekenis hebben. Om deze fout echter goed te begrijpen, moeten we ons concentreren op het gedeelte waar “OSSL” staat

Dit OSSL label staat voor de cryptografische software OpenSSL:

De OpenSSL website homepage
De OpenSSL website

OpenSSL is een open source software library die de Secure Sockets Layer (SSL) en Transport Layer Security (TLS) protocollen gebruikt om veilige communicatie binnen webontwikkelingsomgevingen te waarborgen.

Net zoals website-eigenaren SSL certificaten op websites kunnen installeren, kun je OpenSSL gebruiken om SSL bestanden op je webserver te installeren. Ze geven je ontwikkelomgeving een extra beschermingslaag. Daarom wordt OpenSSL veel gebruikt.

Echter, omdat OpenSSL encryptie gebruikt, vertrouwt het op bepaalde hashingalgoritmen. Wanneer deze algoritmen evolueren met elke nieuwe versie van de software, kunnen er inconsistenties ontstaan met andere ontwikkeltools. Dat leidt ons naar onze volgende sectie, waar we de oorzaken van de ERR_OSSL_EVP_UNSUPPORTED fout zullen bespreken.

Wat veroorzaakt de ERR_OSSL_EVP_UNSUPPORTED fout?

Nu je wat weet over OpenSSL en hoe de ERR_OSSL_EVP_UNSUPPORTED fout eruit ziet, laten we de oorzaken ervan bespreken. Zoals de naam al aangeeft, hangt het probleem af van de “ondersteuning” van de OpenSSL software.

Met andere woorden, de foutmelding geeft aan dat iets binnen je webontwikkelingsstack niet compatibel is met de OpenSSL bestanden die je draait.

Maar waarom gebeurt dit? Naarmate hashingalgoritmen zich ontwikkelen om meer veiligheid te bieden, kunnen hun beperkingen strenger worden, en hun sleutelgroottes kunnen veranderen. Als de hashingalgoritmen van OpenSSL gewijzigd worden, kunnen er dus inconsistenties optreden tussen je ontwikkeltools.

Hoewel er ongetwijfeld veel verbeteringen in zitten, heeft het uitkomen van OpenSSL 3.0 ervoor gezorgd dat de foutmelding ERR_OSSL_EVP_UNSUPPORTED vaker verschijnt:

OpenSSL 3.0 release aankondiging
OpenSSL 3.0 aankondiging

Hoewel ontwikkeltools eventuele incompatibiliteitsproblemen in hun upgrades zouden moeten oplossen, is het mogelijk dat je met verouderde software werkt. Dit kan een pakket, module, framework, bundel, omgeving of iets anders zijn dat de foutmelding veroorzaakt.

Zo los je de ERR_OSSL_EVP_UNSUPPORTED fout op (3 veel voorkomende gevallen)

Zoals we hebben besproken, veroorzaakt verouderde programmeersoftware waarschijnlijk de ERR_OSSL_EVP_UNSUPPORTED foutmelding. Daarom zullen we laten zien hoe je drie verschillende ontwikkeltools kunt upgraden om het probleem op te lossen.

Als je ze echter om welke reden dan ook niet wilt upgraden, kun je gewoon de OpenSSL 3.0 legacy provider inschakelen als workaround. Het enige wat je hoeft te doen is het volgende commando gebruiken:

--openssl-legacy-provider

Anders zijn hier drie manieren om de fout ERR_OSSL_EVP_UNSUPPORTED op te lossen!

1. Upgrade je Node.js versie

Node.js is een cross-platform runtime omgeving die gebruikt wordt om serverside en netwerkapplicaties te bouwen. Omdat het het gebruik van JavaScript vereenvoudigt, versnelt en verbetert, is het zeer populair.

Echter, door het grote aantal gebruikers dat Node.js heeft geïnstalleerd, komt de ERR_OSSL_EVP_UNSUPPORTED fout vaak voor in deze omgeving. Je kunt de ERR_OSSL_EVP_UNSUPPORTED zelfs tegenkomen in Angular of Next.js, omdat Node.js voor beide een voorwaarde is.

Als oplossing raden we aan je versie van Node.js te upgraden. Voor dit proces moet je de node package manager (npm) gebruiken. Als je die nog niet geïnstalleerd hebt, kun je dat doen door het volgende in je commandoprompt in te voeren:

npm install -g n

Controleer vervolgens je huidige versie van Node.js door dit commando in te voeren:

node -v

Als je ten slotte ontdekt dat je versie verouderd is, voer dan dit commando in:

n latest

Dit zal Node.js upgraden naar de nieuwste versie. Controleer daarna opnieuw je versie om er zeker van te zijn dat de update succesvol was. Hopelijk lost dit de fout ERR_OSSL_EVP_UNSUPPORTED op.

2. Upgrade je React.js versie

Samen met Node.js is React.js een integraal onderdeel van veel webontwikkelingsprogramma’s, zoals Gatsby. Met dat in gedachten gaan we je ook laten zien hoe je je versie van React.js kunt upgraden.

Je kunt dit doen met npm of de yarn package manager. Met npm voer je gewoon het volgende commando in:

npm install react react-dom

Als alternatief, voor yarn, gebruik je dit:

yarn add react react-dom

Zorg er dan voor dat je je versie controleert of die nu is bijgewerkt.

3. Upgrade je Vue.js versie

Vue.js is een ander populair frontend JavaScript framework. Daarom kan tijdens het werken in Vue de fout ERR_OSSL_EVP_UNSUPPORTED verschijnen.

Nogmaals, je kunt de versie van je framework upgraden met npm of yarn. Ga echter eerst je Vue.js versie checken in een van beide pakketbeheerders met het volgende commando:

vue --version

Dan, om Vue.js te upgraden met npm, gebruik je het volgende:

update -g @vue/cli

Als alternatief, met yarn, moet je dit gebruiken:

global upgrade --latest @vue/cli

Houd er rekening mee dat beide commando’s het globale Vue CLI pakket zullen upgraden.

Samenvatting

Als je OpenSSL gebruikt om je ontwikkelingsprojecten te beveiligen, kun je de foutmelding ERR_OSSL_EVP_UNSUPPORTED tegenkomen. Dit je project tijdelijk stilzetten. Gelukkig kun je dit vervelende probleem op een paar verschillende manieren oplossen.

Afhankelijk van je devstack kun je de fout oplossen door je versie van Node.js, React.js, of Vue.js te upgraden. Als dat niet werkt, of als je niet wilt upgraden, kun je ook --openssl-legacy-provider gebruiken als workaround.

Door te kiezen voor een betrouwbare hostingprovider als Kinsta heb je minder kans op problemen zoals de ERR_OSSL_EVP_UNSUPPORTED fout. Bovendien worden al onze hostingabonnementen geleverd met hoogwaardige klantenondersteuning om je te helpen bij het oplossen van problemen. Daarnaast bieden we zelfs hosting speciaal voor Node.js!