Schlüsselaktualisierung für den Microsoft SSO

In diesem Artikel wird beschrieben, wie das Client Secret für den Microsoft Single Sign-On (SSO) erneuert wird.

Für die Durchführung werden folgende Berechtigungen benötigt:

• Administratorrechte in Microsoft Entra ID (ehemals Azure Active Directory)

• Superadministrator-Rechte in Mehrschulsystemen in Escola

• Administrator-Rechte in Einschulsystemen in Escola

Schritt-für-Schritt-Anleitung

Microsoft Entra öffnen

• Öffne die Verwaltungsoberfläche von Microsoft Entra ID:
  https://entra.microsoft.com/
• Navigiere zu:
  • App-Registrierungen (App registrations) (1)
  • Wähle anschliessend die App-Registrierung für den Escola SSO aus (2)

Neues Client Secret erstellen

Wechsle innerhalb der App-Registrierung zu:

• Zertifikate und Geheimnisse (Certificates & secrets) (3)
• Clientgeheimnisse (Client secrets) (4)
• Klicke auf Neues Clientgeheimnis (New client secret) (5)

Nun:

• Vergib einen Namen (6) z. B. «Escola SSO 2»
• Setze das Ablaufdatum (Expires) auf das Maximum von 730 Tagen (7)
• Klicke auf Speichern (Save) (8)

Client Secret kopieren

Nach dem Speichern wird der Wert (Value) des Client Secrets angezeigt.

• Wichtig: Kopiere den Value sofort in die Zwischenablage (9). Dieser Wert kann später nicht mehr angezeigt werden.

Client Secret in Escola hinterlegen

Wechsle nun zu Escola und navigiere zu:

• Einstellungen → Control Panel → Login

Dort:

• Füge das neue Client Secret ein (10)
• Setze das Ablaufdatum entsprechend dem in Microsoft Entra ID definierten Ablaufdatum (11)

Speichere anschliessend die Änderungen.