MDM — Apple-Setup (manuelle Checkliste)
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/3-apps-workloads/300t0-mdm-apple-setup.md
MDM — Apple-Setup (manuelle Checkliste)
Apple erlaubt diese Schritte nur mit einem Browser-Login. Alles drumherum ist vorbereitet, jeder Schritt ist nur Hochladen und Herunterladen. Voraussetzung: der Stack läuft (300s0), die n8n-Workflows sind importiert.
Hinweis zu den Screenshots: Die Platzhalter
Screenshot: …werden beim ersten Durchlauf durch echte Bilder ersetzt. Die Menünamen bei Apple ändern sich gelegentlich (Apple Business hieß früher Apple Business Manager). Maßgeblich ist der Sinn des Schritts.
Aufwand im Überblick: einmalig etwa eine Stunde, danach jährlich zwei kurze Verlängerungen (300v0).
| Schritt | Was | Wie oft |
|---|---|---|
| 1 | Apple Business: Organisation und Admin-Account | einmalig |
| 2 | Push-Zertifikat (mdmcert.download, identity.apple.com, n8n-Formular) | einmalig, dann jährlich |
| 3 | Enrollment-Profil versiegeln | einmalig |
| 4 | MDM-Server in Apple Business anlegen, DEP-Token einspielen | einmalig, Token dann jährlich |
| 5 | Server als Standard-MDM für iPads setzen | einmalig |
| 6 | Bestehende iPads mit Apple Configurator zu Apple Business hinzufügen | einmalig je iPad |
| 7 | Restliche n8n-Workflows aktivieren | einmalig |
1. Apple Business: Organisation und Admin-Account
Falls noch nicht vorhanden: Organisation bei Apple Business anmelden (D-U-N-S-Nummer und Verifizierung der Organisation, das dauert bei Apple einige Tage) und einen eigenen Admin-Account für das MDM anlegen. Dieser Apple Account wird später für das Push-Zertifikat immer wieder gebraucht. Zugangsdaten gehören in den Passwortmanager.
Screenshot: Apple Business, Anmeldung und Verwaltung der Accounts
2. Push-Zertifikat
Der MDM-Server braucht ein von Apple ausgestelltes Push-Zertifikat (APNs). Apple verlangt dafür eine von einem MDM-Anbieter signierte Anfrage. Dafür dient der kostenlose Dienst mdmcert.download (nur für Organisationen, einmalige Registrierung mit E-Mail-Bestätigung unter https://mdmcert.download/registration).
- Anfrage erzeugen und senden. Der API-Schlüssel des Dienstes steht in der Quelle
cmd/mdmctl/mdmcert.download.goim Repomicromdm/micromdm(KonstantemdmcertAPIKey).
Das Skript erzeugt inMDMCERT_API_KEY=<Schlüssel> argocd/apps/tech/mdm/scripts/mdm-apns.sh request <registrierte-E-Mail>~/mdm-apple/apns/den Push-Schlüsselpush.key(geheim halten, wird später gebraucht), die Anfragepush.csrund ein Schlüsselpaarpki.key/pki.crtfür die Antwort. - Antwort entschlüsseln. Die signierte Anfrage kommt per E-Mail als Anhang (
mdm_signed_request….plist.b64.p7). Anhang speichern und entschlüsseln:
Ergebnis:argocd/apps/tech/mdm/scripts/mdm-apns.sh decrypt ~/Downloads/mdm_signed_request.….p7~/mdm-apple/apns/push.req. - Bei Apple hochladen.
https://identity.apple.commit dem MDM-Admin-Account öffnen, Create a Certificate wählen,push.reqhochladen, das Zertifikat alspush.pemherunterladen.Screenshot: Apple Push Certificates Portal mit Upload der signierten Anfrage
- In n8n einspielen. Das Formular
https://n8n.prod.homeserver/form/mdm-verlaengerungöffnen (Benutzermdm-admin, Passwortform-passwordaus~/mdm-secrets/credentials.env), Push-Zertifikat erneuern wählen,push.pemundpush.keyhochladen. n8n prüft, ob Zertifikat und Schlüssel zusammengehören, spielt beides in NanoMDM ein und zeigt das gespeicherte Ablaufdatum.Screenshot: n8n-Formular „MDM Verlängerung einspielen“ mit Erfolgsmeldung
3. Enrollment-Profil versiegeln
Das Profil enthält das Push-Topic aus dem Zertifikat, die SCEP-URL und die MDM-URL.
argocd/apps/tech/mdm/scripts/mdm-enrollment-profile.sh ~/mdm-apple/apns/push.pem
Das Skript liest das Topic (com.apple.mgmt.External.…) aus dem Zertifikat, schreibt ~/mdm-apple/enroll.mobileconfig (zum Testen) und versiegelt das Profil in values.yaml (secrets.enrollmentProfile). Danach PR erstellen und mergen. Der Pod mdm-enroll entsteht, der Ingress bekommt den Pfad /mdm/enroll.
Prüfen von außen:
curl -s -o /dev/null -w '%{http_code} %{content_type}\n' https://mdm-prod.pke-lab.de/mdm/enroll
Erwartet: 200 application/x-apple-aspen-config.
4. MDM-Server in Apple Business anlegen, DEP-Token einspielen
- Öffentlichen Schlüssel erzeugen (der private Schlüssel bleibt in der NanoDEP-Datenbank und im Backup):
Ergebnis:argocd/apps/tech/mdm/scripts/mdm-dep-keypair.sh~/mdm-apple/dep-public-cert.pem. - In Apple Business: Einstellungen → Geräteverwaltung (MDM-Server) → MDM-Server hinzufügen, Namen
Capulus MDMvergeben,dep-public-cert.pemhochladen, speichern.Screenshot: Apple Business, MDM-Server hinzufügen mit Zertifikat-Upload
- Beim neuen MDM-Server Token herunterladen (Datei
….p7m).Screenshot: Apple Business, Token herunterladen
- Im n8n-Formular DEP-Token erneuern wählen und die
.p7m-Datei hochladen. n8n entschlüsselt den Token in NanoDEP, prüft die Verbindung zu Apple Business (Servername, Organisation), zeigt das Ablaufdatum und legt beim ersten Mal automatisch das DEP-Enrollment-Profil an und setzt es als Assigner. Ab jetzt startetmdm-depsyncervon selbst.
5. Server als Standard-MDM für iPads setzen
In Apple Business: Einstellungen → Geräteverwaltung → Standard-Geräteverwaltung (Standardserver für neue Geräte), für iPad den Server Capulus MDM wählen. Neu gekaufte oder neu zugeordnete iPads landen damit automatisch bei diesem MDM-Server.
Screenshot: Apple Business, Standard-MDM-Server pro Produktart
6. Bestehende iPads zu Apple Business hinzufügen
Bereits genutzte iPads (nicht über den Händler in Apple Business eingetragen) müssen einmalig mit Apple Configurator (Mac, App Store, kostenlos) hinzugefügt werden. Das iPad wird dabei zurückgesetzt.
- iPad per Kabel an den Mac anschließen, in Apple Configurator auswählen.
- Hinzufügen → Zu Apple Business hinzufügen wählen (Apple Configurator führt durch Anmeldung mit dem Admin-Account und Zuordnung).
- Das iPad wird gelöscht, neu gestartet und erscheint in Apple Business unter Geräte. In der Geräteliste den MDM-Server
Capulus MDMzuordnen, falls der Standard nicht greift. depsyncerübernimmt die Seriennummer beim nächsten Lauf (höchstens 10 Minuten), weist das DEP-Profil zu und n8n meldet, falls etwas offen bleibt.Screenshot: Apple Configurator, „Zu Apple Business hinzufügen“
Hinweis: Ein iPad, das schon einmal anderswo in Apple Business eingetragen war, muss dort zuerst freigegeben werden.
7. Restliche n8n-Workflows aktivieren
Bis zu diesem Punkt waren Formular, Geräte-Workflow, Lock-Screen-Workflow und Backup-Check aktiv. Jetzt die übrigen aktivieren (sie würden vorher nur Alarme für noch nicht eingerichtete Teile senden):
N8N_API_KEY=<API-Schlüssel> argocd/apps/tech/mdm/scripts/mdm-n8n-setup.sh --activate
End-to-End-Test mit einem zurückgesetzten Test-iPad
Diesen Test führst du selbst durch. Er prüft die gesamte Kette: Apple Business → DEP → Enrollment-Profil → SCEP → MDM → n8n → Sperrbildschirm.
- Ein Test-iPad in Apple Business hinzufügen (Schritt 6) und warten, bis die Seriennummer in der Geräteliste mit dem Server
Capulus MDMsteht (bis zu 10 Minuten bis zur Zuweisung des DEP-Profils). - In den Logs prüfen, dass die Zuweisung stattfand:
Erwartet: Zeilekubectl -n mdm logs deploy/mdm-depsyncer --tail=20profile assignedmitsuccess=1. - iPad zurücksetzen (Einstellungen → Allgemein → iPad übertragen/zurücksetzen → Alle Inhalte & Einstellungen löschen) und mit WLAN verbinden. Während der Einrichtung erscheint der Hinweis Fernverwaltung: Die Anmeldung ist verpflichtend (
is_mandatory), der MDM-Server nicht entfernbar. - Der Einrichtungsassistent überspringt die in
profiles/dep-enrollment-profile.jsongenannten Schritte (Apple-ID, Diagnose, Siri und weitere). - Beobachten, was passiert:
Erwartet:kubectl -n mdm logs deploy/mdm-nanomdm -fAuthenticate,TokenUpdate, danach die Befehle aus n8n. - Sperrbildschirm prüfen: iPad sperren (Seitentaste). Unter dem Sperrbildschirm erscheint die Nachricht aus
automation.lockScreenText(bzw. dem zuletzt im Formular gesetzten Text). - Datenbank-Sicht auf den Status des Profils (
queued→installed):kubectl -n mdm exec deploy/mdm-postgres -- psql -U postgres -d nanomdm -c "select * from automation.device_profile" - Text ändern: Formular
https://n8n.prod.homeserver/form/mdm-lockscreen. Nach wenigen Sekunden zeigt das iPad den neuen Text. - Wiederholter Check-in (iPad kurz aus- und einschalten) darf kein zweites Profil senden:
automation.device_profilebleibt beiversion = 1bzw. der aktuellen Version, in der ntfy-App kommt keine Meldung.
Vorher einmal prüfen, ob Cloudflare für die MDM-Pfade nichts blockt (WAF-Regel „Skip“ für mdm-prod.pke-lab.de auf /mdm, /mdm/enroll, /scep, Begründung und Hinweise: 600d0). Während des Tests Cloudflare → Sicherheit → Ereignisse beobachten.
Wenn etwas hängt: 300v0, Troubleshooting. Offen bis zu diesem ersten echten Test ist, ob Apple das unsignierte Enrollment-Profil beim DEP-Abruf akzeptiert und ob die Authentifizierung über den Mdm-Signature-Header durch den Cloudflare-Tunnel hindurch funktioniert (Begründung: 600d0).