Einrichtung der individuelle IServ-Integration

Die Einbindung unseres digitalen Schülerausweises in IServ bietet Schulen die Vorteile einer Single Sign-On (SSO)-Funktion. Durch die SSO-Integration können Lehrkräfte und Schüler:innen mit nur einem Konto auf die IServ-Plattform zugreifen und gleichzeitig auf den digitalen Schülerausweis und andere Funktionen zugreifen. Dies vereinfacht den Zugriff und reduziert die Notwendigkeit, sich mehrfach anzumelden bzw. mehrere Konten gleichzeitig zu pflegen, was Zeit spart und den administrativen Aufwand verringert. Die Einbindung des digitalen Schülerausweises als Teil des SSO-Systems in IServ ermöglicht eine nahtlose und effiziente Nutzung für alle Beteiligten.

‍

Für die Einbindung von IServ werden E-Mail-Adressen vorausgesetzt, welche in der Verwaltungsplattform von Geevoo zu jedem Konto hinterlegt sind. Andernfalls wird die Integration nicht funktionieren.

‍

Was ist der Unterschied zwischen der globalen und individuellen IServ-Integration?

Beide Integrationen bewirken eine Verknüpfung zur IServ-Plattform. Die Integrationen sind beide sogenannte Single-Sign-On Integrationen, welche es Ihren Schüler:innen und Lehrkräften ermöglichen sich mit einem bestehenden IServ-Konto direkt in Geevoo anzumelden.

‍

Globale Integration:

• Benutzer:innen müssen sich über den regulären Login anmelden (Schulcodes dürfen dabei nicht genutzt werden)
• Benutzer:innen müssen die IServ Server-Adresse der Schule beim Login angeben
• Die Integration gilt nur zur Anmeldung in bereits angelegte Geevoo-Konten
• Die Registrierung von neuen Schüler-Konten ist über die globale Integration nicht möglich

‍

Individuelle Integration:

• Benutzer:innen müssen Ihren 4-stelligen Schulcode angeben, um die IServ-Schnittstelle nutzen zu können
• Benutzer:innen müssen beim Login keine IServ Server-Adresse der Schule angeben
• Die „Registrierung erlauben“-Funktion kann optional angeschaltet werden und ermöglicht es Schüler:innen im laufenden Schuljahr schnell und einfach an Ihr Geevoo-Konto zu kommen, da bei einem ersten Login unser System automatisch das Schülerkonto anlegt (diese Option gilt ausschließlich für Anmeldungen von Schülerkonten in der App)

Wie aktiviere ich die Einbindung in IServ?

Um die Einbindung unseres digitalen Schülerausweises in IServ zu aktivieren, müssen Sie bzw. der Administrator der Schule die folgenden Schritte durchführen:

‍

Schritt 1: Navigation im IServ

• Melden Sie sich im IServ-Administrationsbereich Ihrer Schule an.
• Navigieren Sie über das Menü auf der linken Seite zum Punkt „Verwaltung“.
• Wählen Sie im Dropdown-Menü „System“ die Option „Single-Sign-On“ aus.

Schritt 2: Neuen OAuth-Client hinzufügen

Klicken Sie auf die Schaltfläche „Hinzufügen“ im oberen Bereich, um einen neuen OAuth-Client zu erstellen.

Schritt 3: Client-Einstellungen konfigurieren

Allgemein:

• Tragen Sie unter „Name“ einen aussagekräftigen Namen für die Integration ein, z. B. „Geevoo“.
• Setzen Sie „Vertrauenswürdig“ auf „Ja“, wenn die Anwendung ohne zusätzliche Benutzererlaubnis arbeiten soll. (Optional)
• Eine Client-ID und ein Client-Geheimnis werden automatisch generiert. Diese Informationen sind wichtig und müssen später bei Geevoo eingegeben werden.

Rechte:

• Keine Änderungen erforderlich, außer es gibt spezifische Anforderungen. Hier könnten Sie z. B. einstellen, ob nur bestimmte Nutzergruppen Zugriff auf den Single-Sign-On haben sollen.

Beschränkungen:

• Wählen Sie die „Erlaubten Grant-Typen“ aus, die unterstützt werden sollen. In den meisten Fällen ist „Autorisierungs-Code“ ausreichend.
• Beschränken Sie die Scopes auf die notwendigen, z. B. „E-Mail“, „OpenID“, „Profil“, und „UUID“.

Anwendung:

• Fügen Sie die „Weiterleitungs-URIs“ hinzu, die aus der Dokumentation der Client-Anwendung stammen. Diese URIs sind essenziell für die korrekte Rückleitung nach der Authentifizierung.
• Verwenden Sie folgende URLs:
  • https://api.geevoo.de/api/v2/auth/oauth/iserv/callback
  • https://management.geevoo.de/auth/redirect
  • https://api.geevoo.de/app/oauth2/iserv/callback
  • https://api.geevoo.de/app/v1/oauth2/iserv/callback
    

Schritt 4: Speichern und Bestätigen

Nachdem alle Einstellungen vorgenommen wurden, klicken Sie auf „Speichern“ oder „Speichern und weiter“, um die Konfiguration abzuschließen.

‍

Wie aktiviere ich die Einbindung in Geevoo?

Um die Einbindung unseres digitalen Schülerausweises in Geevoo zu aktivieren, folgen Sie bitte diesen Schritten:

‍

Schritt 1: Öffnen der Weboberfläche

‍Öffnen Sie die Geevoo-Weboberfläche. Öffnen Sie dafür in Ihrem Internet Browser die Seite: management.geevoo.de

Schritt 2: Anmeldung

Melden Sie sich mit Ihrem Administrator-Account an.

Schritt 3: Reiter „Integrationen“ öffnen

In der Seitenleiste finden Sie den Menüpunkt „Integrationen“. Klicken Sie darauf.

‍

Schritt 4: IServ auswählen

Wählen Sie „IServ“ aus der Liste der verfügbaren Integrationen aus. Klicken Sie auf das Zahnrad-Symbol neben der IServ-Integration.

‍

Schritt 5: Integration aktivieren

Aktivieren Sie die Integration, indem Sie den Aktivierungshaken setzen.

‍

Schritt 6: Individuelle Integration aktivieren

Um die individuelle Integration zu aktivieren, wählen Sie den folgenden Menüpunkt aus.

‍

Schritt 7: Integrationsdaten eintragen

Tragen Sie die zuvor erstellte IServ-URL, die Client-ID und das Client-Geheimnis (Client-Secret) ein.‍

Achten Sie darauf, dass die IServ-URL mit dem Vorzeichen „https://<IHRE SCHULSERVER-ADRESSE>“ eingetragen wird.

‍

‍

Schritt 8: Speichern‍

Wenn Sie Änderungen vorgenommen haben, klicken Sie auf „Speichern“, um die Einstellungen zu übernehmen. Durch diese Schritte wird die Einbindung des digitalen Schülerausweises in Geevoo aktiviert. Schüler und Lehrer können nun den digitalen Schülerausweis über die Geevoo-Plattform nutzen und von den damit verbundenen Vorteilen profitieren.

‍

Hinweis: Sollten Sie die Registrierung über IServ erlauben, werden für Schüler:innen beim erstmaligen Login ein Konto anhand der IServ-Daten erstellt.

‍

Wie melde ich mich mit meinem IServ-Konto in Geevoo an?

Wichtiger Hinweis: Die Anmeldung für die Geevoo-Integration erfolgt ausschließlich über die Dienste von Geevoo. Die Querverlinkung zur Anmeldung aus IServ in der Seitenleiste Ihres IServ’s funktioniert nicht.

Schüler:innen

• Öffnen Sie die Geevoo-App.
• Tragen Sie Ihren 4-stelligen Schulcode ein. [1]
• Wählen Sie die Option, sich mit Ihrem IServ-Konto anzumelden.
• Sofern Sie keine aktive Session für die IServ-Plattform auf Ihrem Gerät haben, müssen Sie sich anmelden.
• Bestätigen Sie die Berechtigungen, die Geevoo auf Ihr IServ-Konto anfordert. [2]

Lehrer:innen

• Rufen Sie die Verwaltungsoberfläche unter https://management.geevoo.de auf.
• Tragen Sie Ihren 4-stelligen Schulcode ein. [1]
• Wählen Sie die Option, sich mit Ihrem IServ-Konto anzumelden.
• Sofern Sie keine aktive Session für die IServ-Plattform auf Ihrem Gerät haben, müssen Sie sich anmelden.
• Bestätigen Sie die Berechtigungen, die Geevoo auf Ihr IServ-Konto anfordert. [2]

[1] Hinweis: Den 4-stelligen Schulcode finden Sie auf dem Dashboard in der Kachel mit Ihrem persönlichen Ansprechpartner.

[2] Hinweis: Eine zusätzliche Bestätigung ist nur erforderlich, wenn die Vertrauenswürdigkeit des Geevoo-SSO auf „Nein“ gesetzt wurde.

‍