===== Einrichten der LDAP-Verbindung in Jamf School =====


=== Annahmen ===
Ihren IServ können Sie z.B. unter der Webadresse https://www.**mein-iserv.de** erreichen.

Ihr LDAP-Benutzer heißt: **jamfschool**

Ihr LDAP-Passwort lautet: **geheim**

Dann gilt für die <Platzhalter> in dieser Anleitung:

| @#F61303:**Platzhalter** | @#F61303:**Beispiel** |
| @lightgrey:<iserv_url> | @lightgrey:mein-iserv.de|
| <iserv_binduser> | cn=jamfschool,ou=ldap,dc=mein-iserv,dc=de |
| @lightgrey:<iserv_binduser_passwd> | @lightgrey:geheim|
| <iserv_domain> | mein-iserv |
| @lightgrey:<iserv_tld> | @lightgrey:de|

==== Konfiguration der LDAP-Verbindung in Jamf School ====

Gehen Sie in Jamf im linken Menu auf **Organisation => Einstellungen**. Sie müssen danach etwas nach unten scrollen, um den Punkt **Synchronisierung** zu finden:

{{:anleitung:01-organisation.png?direct |}}
{{:anleitung:02-organisation-einstellungen.png?direct |}}
{{:anleitung:03-organisation-synchronisierung.png?direct |}}

=== Einstellungen ===
Nehmen Sie jetzt folgende Einstellungen vor - die <Platzhalter> werden ganz oben auf dieser Seite erklärt.

| @#F61303:**Konfigurationseinstellung** | @#F61303:**Einstellung** |
| @lightgrey:Synchronisierungsmethode | @lightgrey:LDAP|
| Einstellung für die automatische Synchronisierung | Zwischen 2:00 - 3:00 |
| @lightgrey:LDAP-Server/-Port | @lightgrey:<iserv_url> / 10636|
| Verzeichnistyp | Microsoft Active Directory |
| @lightgrey:Benutzername | @lightgrey:<iserv_binduser>|
| Passwort | <iserv_binduser_passwd> |
| @lightgrey:Basis-DN | @lightgrey:dc=<iserv_domain>, dc=<iserv_tld>|
| Basis-DN für alle Benutzer verwenden | Haken nicht setzen |
| @lightgrey:CNs mit OUs aus Verzeichnisdienst abrufen | @lightgrey:Haken setzen|
| "OU" von Schülern | zunächst leer lassen |
| @lightgrey:"OU" von Lehrern | @lightgrey:zunächst leer lassen|
| "OU" von Gruppen | leer lassen |
| @lightgrey:Benutzername | @lightgrey:uid |
| Vorname | leer lassen |
| @lightgrey:Nachname | @lightgrey:leer lassen |
| Beschreibung | leer lassen |
| @lightgrey:E-Mail | @lightgrey:leer lassen |
| Mitglied von | leer lassen |
| @lightgrey:Gruppenmitgliedschaft | @lightgrey:leer lassen |
| Definierter Name der Gruppe | leer lassen |
| @lightgrey:Gruppenname | @lightgrey:leer lassen |
| Auslagerung aktivieren | Haken bei Ersteinrichtung NICHT setzen, später ggf. probieren |
| @lightgrey:Rekursive Gruppen aktieren | @lightgrey:Haken nicht setzen |
| Entfernte Nutzer löschen| Haken setzen |
| @lightgrey:Entfernte Gruppen löschen | @lightgrey:Haken setzen |
| Entfernte Gruppen mit nicht synchronisierten OUs löschen | Haken setzen |
| @lightgrey:Anhand eines Clients-Zertifikats authentifizieren | @lightgrey:Haken nicht setzen |

=== Einstellungen speichern, prüfen und Nutzer:innen auswählen ===

Speichern Sie nun Ihre Einstellungen mit der Schaltfläche ganz unten rechts:\\
{{:anleitung:04-ldap-speichern.png?direct |}}\\
\\ \\
<WRAP center round important 80%>
=== Wichtig ===
Egal, was Sie in den LDAP-Einstellungen ändern: Sie müssen immer erst auf diese Weise speichern, bevor sich Ihre neuen Eingaben auswirken. 
</WRAP>

Jetzt prüfen Sie zunächst, ob die Verbindung zwischen Jamf School und IServ funktioniert:\\
{{:anleitung:05-ldap-verbindung-test.png?direct|}}

Jetzt können Sie die erste LDAP-Abfrage starten:
{{ :anleitung:06-ldap-ou-abruf.png?direct |}}

Bei den "OU" von Schülern können sie jetzt alle Gruppen auf dem IServ auswählen, die ausschließlich Schüler:innen enthalten, wenn diese Klassen über ein personengebundenes iPad verfügen. Dieses Verfahren ist dem mit "Basis-DN für alle Benutzer:innen verwenden" unbedingt vorzuziehen, weil ansonsten auch Accounts synchronisiert werden, bei denen das nicht erforderlich ist. Jamf School dankt es Ihnen im Benutzer:innenbereich mit deutlich mehr Übersichtlichkeit.

<WRAP center round info 80%>
Ich habe noch keine Möglichkeit gefunden, die Synchronisation von allen Gruppen des IServ zu verhindern. Diese besitzen dann in Jamf School zwar keine Mitglieder, sind jedoch dennoch vorhanden, wenngleich leicht filterbar.
</WRAP>

=== Ergebnis prüfen ===
Sie können jetzt die Synchronisierung prüfen:\\
{{:anleitung:07-ldap-sync-test-button.png?direct|}}
\\
\\
Ein erfolgreicher Test könnte etwa so aussehen:\\
{{:anleitung:08-ldap-sync-test.png?direct|}}
\\
\\
Man sieht, dass mit dieser Konfiguration nicht alle IServ-Nutzer:innen synchronisiert werden, sondern nur ausgewählte. Jamf School legt jetzt alle Gruppen und Nutzer:innen an. Ein automatischer Abgleich erfolgt jede Nacht zwischen 2 und 3 Uhr. 

<WRAP center round important 80%>
=== Probleme mit dem IServ-Zertifikat nach drei Monaten ===
IServ verwendet für die verschlüsselte Verbindung zu seinem LDAP Zertifikate von Let's Encrypt. Diese laufen nach ca. drei Monaten aus und werden automatisch ersetzt. Es wird berichtet, dass danach die Syncronisierung zu Jamf School zusammenbrechen kann. Dies wirkt sich nicht auf bereits synchronisierte Datenbestände aus.

Die Empfehlung ist, in Jamf School den LDAP-Port zu ändern, zu speichern und dann wieder zurückzuändern. Dies legt die Verbindung neu an. Prüfen Sie aber immer alle Einstellungen durch, da dadurch viele Ihrer Eingaben gelöscht werden und neu eingegeben werden müssen **BEVOR** Sie die Konfiguration erneut prüfen.
</WRAP>



[[anleitung:iservjamfstart|zurück zur Übersicht]]