Apple School Manager Import
Die ASM Import Konfiguration ermöglicht es Relution, neue Benutzer basierend auf den Daten aus dem Apple School Manager (ASM) zu erstellen oder bestehende Benutzer mit den verwalteten Apple Accounts (im Portal: Managed Apple ID) aus dem ASM zu synchronisieren. Zusätzlich lassen sich die Klassen aus dem ASM übernehmen.
Der umgekehrte Weg, also das Anlegen verwalteter Apple Accounts im ASM aus den Daten in Relution, ist unter SFTP-Upload → beschrieben.
Voraussetzungen
- Ein gültiger ADE-Token (Automatische Geräteregistrierung, im Portal: DEP-Token) in der Organisation, in der die Konfiguration angelegt werden soll.
- Verwaltete Apple Accounts, die im ASM mindestens in einer Klasse zusammengefasst sind (mindestens ein Schüler und mindestens ein Lehrer).
Konfiguration
Navigieren zu den Einstellungen:
Einstellungen→Bildung→Apple School Manager Import KonfigurationNeue Konfiguration hinzufügen: Über Hinzufügen wird eine neue Konfiguration angelegt.
Name des Anbieters eintragen: Unter Name des Anbieters wird ein eindeutiger Name eingetragen. Der Name kann nach dem Speichern nicht mehr geändert werden, da Relution darüber die bereits synchronisierten Objekte zuordnet.
DEP-Konto auswählen: Unter DEP-Konto wird über Auswählen das DEP-Konto festgelegt, über das auf den Apple School Manager zugegriffen wird. Ohne DEP-Konto sind Verbindung prüfen, Standorte und Vorschau nicht verfügbar, und die Konfiguration lässt sich nicht speichern.
Verbindung prüfen: Über Verbindung prüfen kann überprüft werden, ob mit dem DEP-Konto eine Verbindung zum Apple School Manager möglich ist.
Standorte auswählen: Unter Standorte werden über Auswählen ein oder mehrere ASM-Standorte für den Import festgelegt. Importiert werden nur die Klassen dieser Standorte sowie die Lehrkräfte und Schüler, die Mitglied einer dieser Klassen sind.
Vorschau der Klassen: Unter Vorschau werden über Anzeigen die Klassen angezeigt, die schlussendlich importiert werden.
In der Global-Organisation und in Meta-Organisationen gibt es den Punkt Standorte nicht. Dort wird die Konfiguration zunächst mit dem DEP-Konto gespeichert. Anschließend wird im Bereich Objekte zu Organisationen zuordnen unter Standorte zu Organisationen zuordnen festgelegt, welche ASM-Standorte in welche Organisation importiert werden. Ohne zugeordnete Standorte findet keine Synchronisation statt.
Synchronisationseinstellungen
Im Bereich Synchronisationseinstellungen wird festgelegt, welche Objekte Relution aus dem ASM anlegt und was mit Objekten geschieht, die nicht mehr aus dem ASM geliefert werden.
Neue Relution-Benutzer erstellen
- Standardmäßig aktiviert.
- Relution legt für jeden ASM-Benutzer, zu dem kein passender Relution-Benutzer gefunden wird, einen neuen Benutzer an. Gesucht wird über die Verknüpfung aus früheren Synchronisationen, den verwalteten Apple Account und die unter Erweitert aktivierten Abgleichsregeln.
- Gefundene Benutzer ohne Quellsystem (z.B. manuell angelegt) oder aus derselben ASM-Konfiguration werden stattdessen verknüpft und übernommen. Sie erhalten die ASM-Konfiguration als Quellsystem.
- Benutzer anderer Quellsysteme (z.B. LDAP) werden nicht verknüpft. Haben sie dieselbe E-Mail-Adresse oder denselben Benutzernamen wie der anzulegende Benutzer, schlägt das Anlegen fehl (Synchronisierungsfehler Doppelte E-Mail bzw. Doppelter Benutzername).
- Ist die Option deaktiviert, werden nur vorhandene Benutzer verknüpft. ASM-Benutzer ohne passenden Relution-Benutzer werden nicht importiert.
Verwaltete Apple ID für den zugehörigen Benutzer eines beliebigen Quellsystems aktualisieren
- Standardmäßig deaktiviert.
- Überschreibt das Feld Managed Apple ID eines Benutzers aus einem anderen Quellsystem (z.B. LDAP), wenn der ASM-Benutzer diesem Benutzer über eine der unter Erweitert aktivierten Abgleichsregeln zugeordnet werden kann. Weitere Daten des Benutzers und sein Quellsystem bleiben unverändert.
- Die Option greift nur für ASM-Benutzer, die weder verknüpft noch neu angelegt wurden, in der Praxis also nur, wenn Neue Relution-Benutzer erstellen deaktiviert ist.
Klassen synchronisieren
- Standardmäßig aktiviert.
- Importiert die Klassen der ausgewählten Standorte aus dem ASM und legt sie in Relution an bzw. aktualisiert sie.
- Klassen, für die in Relution keine synchronisierte Lehrkraft oder kein synchronisierter Schüler vorhanden ist, werden übersprungen (Synchronisierungsfehler Unterrichtsteilnehmer fehlen).
- Nur zu empfehlen, wenn:
- Noch keine Daten (Klassen) in Relution vorliegen.
- Klassen nicht manuell in Relution erstellt werden.
- Kein LDAP-System genutzt wird.
- Wichtig: Sollten Klassen bereits über LDAP synchronisiert werden, ist von diesem Punkt abzuraten.
Aktion, wenn ein Benutzer in ASM entfernt wird
- Legt fest, was mit Benutzern dieser Konfiguration geschieht, die bei einer Synchronisation nicht mehr geliefert werden:
- Keine (Standard): Die Benutzer bleiben unverändert.
- Deaktivieren: Die Benutzer werden in Relution deaktiviert.
- Löschen: Die Benutzer werden in Relution gelöscht.
- Betroffen sind alle Benutzer, die die ASM-Konfiguration als Quellsystem haben, also neu angelegte Benutzer ebenso wie verknüpfte Benutzer ohne vorheriges Quellsystem (z.B. manuell angelegt).
- Benutzer anderer Quellsysteme (z.B. LDAP), bei denen nur der verwaltete Apple Account aktualisiert wurde, bleiben unverändert. Ihr verwalteter Apple Account wird nicht entfernt.
- Liefert eine Synchronisation keinen einzigen Benutzer, etwa wegen eines Verbindungsproblems oder einer Fehlkonfiguration, werden keine Benutzer deaktiviert oder gelöscht.
Aktion, wenn eine Klasse in ASM entfernt wird
- Legt fest, ob Klassen in Relution bei Entfernung im ASM gelöscht werden: Keine (Standard) oder Löschen.
- Wenn keine Klassen synchronisiert wurden, hat diese Option keine Auswirkung.
Automatische Synchronisation über Cron-Syntax
- Definiert die Häufigkeit, mit der Relution automatisiert Informationen aus dem ASM importiert.
- Standardmäßig läuft die Synchronisation täglich um 6 und 21 Uhr (
0 0 6,21 * * ?).
Erweitert
Im Bereich Erweitert wird festgelegt, wie ASM-Benutzer vorhandenen Relution-Benutzern zugeordnet werden und welcher ASM-Wert als Benutzername dient.
Zuordnung zwischen ASM-Benutzer und Relution-Benutzer
- Legt fest, nach welchen Regeln ein ASM-Benutzer einem vorhandenen Relution-Benutzer zugeordnet wird. Mehrere Regeln können gleichzeitig aktiv sein.
- Vor diesen Regeln sucht die Synchronisation immer zuerst einen Relution-Benutzer, der bereits mit dem ASM-Benutzer verknüpft ist oder denselben verwalteten Apple Account hat.
- Danach werden die aktivierten Regeln in dieser Reihenfolge geprüft. Die erste zutreffende Regel gilt:
- Abgleich der verwalteten Apple-ID des ASM-Benutzers mit der E-Mail des Relution-Benutzers (Standard: aktiviert)
- Abgleich der E-Mail des ASM-Benutzers mit der E-Mail des Relution-Benutzers (Standard: deaktiviert)
- Abgleich des ASM-Benutzernamens mit dem Relution-Benutzername (Standard: deaktiviert)
- Abgleich von Vor- und Nachname des ASM-Benutzers mit Vor- und Nachname des Relution-Benutzers (Standard: deaktiviert)
- Berücksichtigt werden nur Relution-Benutzer derselben Organisation, die keinem Quellsystem zugeordnet sind oder aus dieser ASM-Konfiguration stammen. Benutzer anderer Quellsysteme (z.B. LDAP) werden nicht übernommen. Ist Verwaltete Apple ID für den zugehörigen Benutzer eines beliebigen Quellsystems aktualisieren aktiviert, bestimmen dieselben Regeln (ohne die vorgeschaltete Prüfung), bei welchem Benutzer eines anderen Quellsystems nur der verwaltete Apple Account aktualisiert wird.
- Hinweis: Wenn Neue Relution-Benutzer erstellen nicht ausgewählt wurde und keine der Regeln eine Zuordnung zulässt, passiert keine Verknüpfung zwischen den beiden Systemen.
Zuordnung ASM-Benutzer zu Relution-Benutzer
- Über Als Benutzername zu verwendende ASM-Eigenschaft wird festgelegt, welcher Wert aus dem ASM als Benutzername in Relution genutzt wird. Zur Auswahl stehen Name (Standard), Managed Apple ID und E-Mail.
- Hinweis: Bei jeder Synchronisation werden für zugeordnete Benutzer der Benutzername sowie Vor- und Nachname aus dem ASM übernommen. Die E-Mail-Adresse in Relution wird durch den verwalteten Apple Account ersetzt, und der Benutzer wird aktiviert.
Synchronisation
Die Synchronisation läuft automatisch nach dem eingestellten Zeitplan. Manuell wird sie in der Liste der Konfigurationen über das Kontextmenü mit Synchronisieren oder in der Detailansicht einer Konfiguration über das Symbol Synchronisieren gestartet.
Synchronisierte Lehrkräfte und Schüler werden der jeweiligen Standardgruppe Teacher bzw. Student ihrer Organisation hinzugefügt. Zu diesen Gruppen siehe Bildungsfunktion →.
Die Detailansicht zeigt die Ergebnisse der Synchronisationen getrennt nach Benutzer und Klassen, unter anderem mit Nächste geplante Synchronisierung, Zuletzt abgeschlossen und Erfolgreich. Über die Spalte Synchronisierungsfehler lassen sich die einzelnen Fehler anzeigen, z.B. Doppelte E-Mail, Doppelter Benutzername, Unterrichtsteilnehmer fehlen oder Die Synchronisation des Roster-Objekts ist fehlgeschlagen.