Internal Server Error 500 beim Öffnen von E-Learning-Links

Read this article in: English, German

Wenn bei Ihnen oder Ihren Lernern beim Öffnen eines Links zur SoSafe-E-Learning-Plattform ein interner Serverfehler angezeigt wird, hilft Ihnen dieser Artikel dabei, die Ursache zu ermitteln und die nächsten Schritte zu bestimmen.

In den meisten Fällen bedeutet dieser Fehler, dass das Zertifikat hinter der Single-Sign-On-Verbindung (SSO) Ihrer Organisation abgelaufen ist. Um das Problem zu beheben, benötigen Sie Administratorrechte für Ihren Identitätsanbieter und den SoSafe Manager. Falls Sie diese Rechte nicht haben, leiten Sie diesen Artikel bitte an Ihre IT-Abteilung weiter. Der Schulungsfortschritt wird dadurch nicht beeinträchtigt.

Tritt dieser Fehler bei Ihnen auf?

Der Fehler tritt auf, nachdem Sie einen Link in einer Erinnerungs- oder Einladungs-E-Mail angeklickt haben oder wenn Sie sich bei der E-Learning-Plattform anmelden. Die Seite wird nicht geladen und es wird eine Meldung wie diese angezeigt:

786a5998-5022-4f4e-9ee8-d61feb493276.png
JSON
{"title":"Internal Server Error","status":500,"reference":"00000000-0000-0000-0000-000000000000","randomUUID":"00000000-0000-0000-0000-000000000000"}

Die Werte für „reference“ und „randomUUID“ sind jedes Mal Unterschiedlich, es geht um die Struktur drum herum. Stellen Sie sicher, dass die folgenden 2 Punkte zutreffen:

  • In der Adressleiste wird eine URL angezeigt, die mit /auth/saml/consume endet

  • Ihre Organisation meldet sich über SSO bei SoSafe an

Ursache

Ihre Organisation meldet sich über eine auf SAML basierende SSO-Verbindung bei SoSafe an. Diese Verbindung stützt sich auf ein Signaturzertifikat, das nach einem von Ihrem Identitätsanbieter festgelegten Zeitpunkt abläuft. Sobald es abgelaufen ist, funktioniert die Anmeldung nicht mehr und die Lerner sehen den oben genannten Fehler.

Einige Identitätsanbieter warnen Sie bereits vor dem Ablaufdatum. Microsoft Entra ID versendet beispielsweise entsprechende Benachrichtigungs-E-Mails.

Wenn Sie Administrator sind

Sie haben 2 Möglichkeiten. Wir empfehlen die Umstellung auf unsere neue SSO-Lösung, da dadurch die wiederkehrende Zertifikatserneuerung entfällt und Sie die Konfiguration selbst in die Hand nehmen können.

Umstellung auf Enterprise SSO

Unsere neue SSO-Lösung basiert auf Auth0. Sie können diese selbst im SoSafe Manager einrichten und können Ihre Konfiguration dort später ändern, ohne den Support kontaktieren zu müssen. Außerdem wird kein SAML-Signaturzertifikat verwendet, das bei uns erneuert werden muss.

Die Migration ist einfach und sollte weniger als eine Stunde dauern: Migration zum neuen Single Sign-on (SSO)

Zertifikatserneuerung beantragen

Falls Sie die Migration derzeit nicht durchführen können, kann der SoSafe-Support Ihr SAML-Zertifikat für Sie aktualisieren. Wenden Sie sich an Ihre SoSafe-Ansprechperson und übermitteln Sie ihr Ihr neues Zertifikat.

Bitte beachten Sie, dass dadurch zwar die Anmeldung wieder möglich ist, das Problem jedoch nicht dauerhaft behoben ist. Das Ersatzzertifikat läuft ebenfalls ab, und jede Erneuerung muss über den Support erfolgen, was bedeutet, dass Ihre Lerner in Zukunft möglicherweise erneut ausgesperrt werden.

Häufig gestellte Fragen

Hat die Migration Auswirkungen auf den Schulungsfortschritt meiner Lernenden?

Nein. Der Schulungsfortschritt und die Analytics bleiben unbeeinträchtigt, solange die E-Mail-Adressen Ihrer Nutzer unverändert bleiben.

Kann ich die Migration durchführen, während eine Kampagne läuft?

Ja. Die Migration ändert lediglich die Art und Weise, wie sich Ihre Nutzer anmelden. Kampagnen, Schulungsdaten oder die Nutzerverwaltung sind davon nicht betroffen.

Wie lange können sich meine Lernenden nicht anmelden?

In der Regel weniger als 1 Stunde. Dies umfasst die Zeit zwischen der Trennung der alten Verbindung und der Herstellung der neuen Verbindung. Nachdem Sie die neue Verbindung aktiviert haben, dauert es bis zu 10 Minuten, bis alle Daten synchronisiert sind.

Muss ich mich für die Migration an den SoSafe-Support wenden?

Nein. Sowohl die Migration als auch die neue Einrichtung erfolgen im Self-Service, ebenso wie alle Konfigurationsänderungen, die Sie anschließend vornehmen können.

Kann ich nach der Migration zur alten Konfiguration zurückkehren?

Nein. Die Trennung der alten Verbindung ist unwiderruflich.

Last updated: