Als u of uw gebruikers een Internal Server Error zien wanneer u een link naar het SoSafe E-Learning platform opent, helpt dit artikel u te achterhalen wat de oorzaak is en wat u vervolgens kunt doen.
In de meeste gevallen betekent deze fout dat het certificaat achter de Single Sign-on (SSO)-verbinding van uw organization is verlopen. Om dit op te lossen is beheerderstoegang nodig tot uw identity provider en tot de SoSafe Manager. Als u die toegang niet heeft, stuurt u uw IT-afdeling een link naar dit artikel. De voortgang van trainingen wordt niet beïnvloed.
Ziet u deze fout?
De fout verschijnt nadat u een link in een herinnerings- of uitnodigings-e-mail heeft geselecteerd, of wanneer u zich aanmeldt bij het E-Learning platform. De pagina laadt niet en toont een bericht zoals dit:
{"title":"Internal Server Error","status":500,"reference":"00000000-0000-0000-0000-000000000000","randomUUID":"00000000-0000-0000-0000-000000000000"}De waarden voor reference en randomUUID zijn voor elke fout anders, dus de uwe zal niet overeenkomen met het bovenstaande voorbeeld. Twee dingen bevestigen dat u op de juiste plek bent:
-
De adresbalk toont een URL die eindigt op /auth/saml/consume
-
Uw organization meldt zich aan bij SoSafe via SSO
Wat de oorzaak is
Uw organization meldt zich aan bij SoSafe via een SSO-verbinding op basis van SAML. Die verbinding maakt gebruik van een ondertekeningscertificaat, en het certificaat verloopt volgens een schema dat is ingesteld door uw identity provider. Zodra het verloopt, werkt het aanmelden niet meer en zien gebruikers de bovenstaande fout.
Sommige identity providers waarschuwen u vóór de verloopdatum. Microsoft Entra ID stuurt bijvoorbeeld een e-mailmelding met het onderwerp "Please renew your application certificate".
Als u een beheerder bent
U heeft 2 opties. We raden aan te migreren naar Enterprise SSO, omdat dit de terugkerende certificaatvernieuwing overbodig maakt en de configuratie in uw eigen handen legt.
Migreren naar Enterprise SSO
Enterprise SSO is onze huidige SSO-oplossing, aangedreven door Auth0. U stelt dit zelf in via de SoSafe Manager via een begeleide wizard, en u kunt uw configuratie daar later wijzigen zonder contact op te nemen met de ondersteuning. Er wordt ook geen SAML-ondertekeningscertificaat gebruikt dat bij ons verlengd moet worden.
Migreren is eenvoudig en zou minder dan een uur moeten duren: Migration to Auth0 SSO
Een certificaatvernieuwing aanvragen
Als u momenteel niet kunt migreren, kan de SoSafe-ondersteuning uw SAML-certificaat voor u bijwerken. Neem contact op met uw contactpersoon en lever uw nieuwe certificaat aan.
Houd er rekening mee dat hiermee het aanmelden wordt hersteld, maar niet wordt voorkomen dat het probleem terugkeert. Het vervangende certificaat zal ook verlopen, en elke verlenging moet via de ondersteuning verlopen, wat betekent dat uw gebruikers elke keer dat het verloopt opnieuw worden buitengesloten.
Veelgestelde vragen
Heeft migreren invloed op de trainingsvoortgang van mijn gebruikers?
Nee. De trainingsvoortgang en analytics worden niet beïnvloed, zolang de e-mailadressen van uw users gelijk blijven.
Kan ik migreren terwijl een campaign actief is?
Ja. De migratie wijzigt alleen de manier waarop uw users zich aanmelden. Campaigns, trainingsgegevens en gebruikersprovisioning worden niet aangetast.
Hoe lang kunnen mijn gebruikers zich niet aanmelden?
Doorgaans minder dan 1 uur. Dit omvat de tijd tussen het verbreken van de verouderde verbinding en het voltooien van de nieuwe verbinding. Nadat u de nieuwe verbinding heeft ingeschakeld, kan het tot 10 minuten duren voordat alle gegevens zijn gesynchroniseerd.
Moet ik contact opnemen met SoSafe-ondersteuning om te migreren?
Nee. Zowel de migratie als de nieuwe installatie zijn self-service, en dat geldt ook voor eventuele configuratiewijzigingen die u daarna doorvoert.
Kan ik na de migratie terugkeren naar de verouderde configuratie?
Nee. Het verbreken van de verouderde verbinding is onomkeerbaar. Zodra u begint, voltooit u de nieuwe configuratie om het aanmelden te herstellen.
Deze vertaling is geautomatiseerd. Bekijk bij twijfel de Engelse versie.