600d0 - MDM — Hintergründe
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/6-hintergruende/600d0-mdm.md
MDM — Hintergründe
Begründungen und Fallstricke zu argocd/apps/tech/mdm/, den Workflows argocd/apps/tech/n8n/workflows/mdm-*.json und den zugehörigen Änderungen an n8n, Ansible und build-images.yml. Bedienung und Betrieb stehen in 300r0 bis 300w0.
Öffentlicher Zugang
Cloudflare-Tunnel statt cert-manager
Alle öffentlichen Hosts laufen über den Cloudflare-Tunnel mit der Wildcard-Regel *.pke-lab.de (e0000). Das öffentlich vertrauenswürdige Zertifikat stellt Cloudflare an der Kante aus. cert-manager stellt hier nur das interne *.homeserver-Zertifikat aus. Ein eigenes Let's-Encrypt-Zertifikat pro Host gibt es bei keiner App, auch der Ingress des MDM hat deshalb tls: []. Der Host mdm-prod.pke-lab.de braucht keinen DNS-Eintrag: Er fällt unter die Wildcard (TECH-Tunnel).
Tier prod im Namen, Ordner unter apps/tech: wie n8n, Tier ist nicht Cluster (c0040).
Authentifizierung der Geräte hinter Cloudflare
Das Enrollment-Profil setzt SignMessage = true. Das Gerät signiert dann jede MDM-Anfrage und schickt sein Zertifikat im Header Mdm-Signature mit. NanoMDM liest diesen Header ohne zusätzliches Flag. Ein TLS-Client-Zertifikat würde am Cloudflare-Rand enden, NanoMDM könnte es nicht sehen.
-cert-header ist deshalb nicht gesetzt und darf es auch nicht sein: Laut NanoMDM-Doku liest NanoMDM das Zertifikat dann aus dem genannten Header statt aus Mdm-Signature, und das Profil müsste SignMessage auf false haben. Das Flag ist für Proxys gedacht, die das Client-Zertifikat selbst in einen Header schreiben (RFC 9440 oder URL-kodiertes PEM).
Live geprüft (NanoMDM v0.9.0, Test-CA, -storage inmem, ohne -cert-header, Anfrage PUT /mdm mit Content-Type: application/x-apple-aspen-mdm-checkin):
| Anfrage | Ergebnis |
|---|---|
Mdm-Signature mit Zertifikat der eigenen CA |
200, Authenticate verarbeitet, Zertifikat dem Gerät zugeordnet |
| ohne Header | 400, missing MDM certificate |
| Header mit Zertifikat einer fremden CA | 400, certificate signed by unknown authority |
| Header mit ungültigem Inhalt | 400, ASN.1-Fehler |
Der kombinierte Endpunkt /mdm unterscheidet Check-in und Befehl am Content-Type (application/x-apple-aspen-mdm-checkin); ein anderer Content-Type landet beim Befehls-Handler und führt zu invalid command result. Ein separates -checkin mit CheckInURL ist deshalb nicht nötig.
Cloudflare (nur im Dashboard einstellbar, nicht per Repo): Die Anfragen kommen von iPads, nicht von Browsern. Am Host mdm-prod.pke-lab.de kamen Anfragen mit Mdm-Signature-Header, MDM-Content-Types und Bodys bis 200 KB bisher ungehindert bis Traefik durch (HTTP 404 vom Ursprung, solange der Ingress fehlt). Das beweist nichts für den TLS-Fingerabdruck eines iPads. Empfehlung: im Cloudflare-Dashboard der Zone pke-lab.de eine WAF-Regel mit Aktion „Skip“ für Host mdm-prod.pke-lab.de und die Pfade /mdm, /mdm/enroll, /scep anlegen (verwaltete Regeln, Rate Limiting und, soweit der Tarif es erlaubt, Bot-Schutz überspringen). Bot Fight Mode lässt sich im kostenlosen Tarif nach Cloudflare-Doku nicht per Regel ausnehmen, dann hilft nur, ihn für die Zone auszuschalten. Prüfen, ob etwas blockt: Cloudflare-Dashboard → Sicherheit → Ereignisse, während das Test-iPad enrollt.
Pfade
Der Ingress kennt /mdm und /mdm/enroll als Exact, /scep als Prefix. NanoMDM registriert /mdm exakt, /mdm/enroll braucht den eigenen Dienst, weil NanoMDM kein Enrollment-Profil ausliefert. Das DEP-Profil trägt https://mdm-prod.pke-lab.de/mdm/enroll als url.
Enrollment-Profil unsigniert, POST erlaubt
Beim DEP-Enrollment fragt das Gerät die url per POST (mit signierten Geräteinformationen) und erwartet ein Profil. nginx liefert Dateien nur per GET aus (POST ergibt 405). Die Konfiguration leitet deshalb intern per proxy_method GET auf einen zweiten, nur lokal erreichbaren Server weiter, der die Datei ausliefert. Das Profil wird nicht signiert: Das ist im NanoMDM-Umfeld üblich, ob Apple es beim echten DEP-Abruf akzeptiert, zeigt erst der End-to-End-Test (300t0). Das Profil liegt als SealedSecret vor, weil es die SCEP-Challenge enthält. Der enroll-Pod und die Ingress-Regel entstehen erst, wenn es versiegelt ist.
Komponenten
SCEP-Server
micromdm/scep veröffentlicht kein Container-Image (README: nur Binär-Releases, Docker durch lokalen Build). Es gibt deshalb ein eigenes Image aus image/scep/Dockerfile (go install …/[email protected]), gebaut von build-images.yml. Der Server steht im README als einfach beschrieben und möglicherweise nicht weiter unterstützt; eine robustere Alternative wäre smallstep/certificates. Gewählt wurde micromdm/scep, weil NanoMDM dafür dokumentiert ist und der Betriebsaufwand klein bleibt.
image.tagmuss imvalues.yamlgenau einmal als Top-Level-image.tagstehen, weilscripts/bump-image-tag.pygenau diesen Schlüssel ersetzt. Die Upstream-Images heißen deshalbnanomdm.image.tagusw.-allowrenew=0: Ohne diesen Wert lehnt der SCEP-Server ein zweites Zertifikat für denselben Namen ab. Ein zurückgesetztes und neu eingerichtetes iPad würde dann nie wieder enrollen (NanoMDM-Quickstart nutzt ebenfalls0).-crtvalid=3650: Identitätszertifikate halten zehn Jahre. Ein abgelaufenes Geräte-Zertifikat würde das Gerät vom MDM trennen, ein automatischer Austausch ist nicht vorgesehen.- Die CA wird mit
opensslerzeugt (genrsa -traditional, 4096 Bit, 20 Jahre) statt mitscepserver ca -init, weil der Schlüssel dann vor dem Versiegeln feststeht. Ein Initialisierungs-Lauf im Cluster würde den Schlüssel auf einem Volume ablegen, das nicht in Git abbildbar ist. Der Init-Containerinstall-cakopiert Zertifikat und Schlüssel bei jedem Start ins Depot. Seriennummern und ausgestellte Zertifikate bleiben im Depot-Volume.
NanoMDM
- Alle Einstellungen laufen über Umgebungsvariablen (ab v0.9.0 dokumentiert). Die DSN setzt Kubernetes aus
$(NANOMDM_DB_PASSWORD)zusammen, darum sind die Passwörter hexadezimal (URL-sicher). - Das Image ist
distroless/staticohne Shell: Probes sindhttpGet /version(ohne Anmeldung). - Die Dokumentation im
main-Zweig ist neuer als v0.9.0. Beispiel:GET /v1/pushcert?topic=…(Ablaufdatum abfragen) steht dort, fehlt in v0.9.0 (liefert „failed to find any PEM data“). Das Ablaufdatum des Push-Zertifikats liest n8n deshalb direkt auspush_certs(Spaltentopic,cert_pem,updated_at).PUT /v1/pushcertantwortet dagegen schon mittopicundnot_after. Beim Anheben der Version Dokumentation und Release-Notes des Tags lesen, nicht die vonmain. - Der Webhook (
NANOMDM_WEBHOOK_URL) kennt keine eigenen Header, nur HMAC. Als Absicherung dient deshalb ein geheimer Pfad (mdm-event-<Token>) plus NetworkPolicy. Das Token steht im SealedSecret, im Workflow-JSON steht nur der Platzhalter__WEBHOOK_TOKEN__. enqueueantwortet mit HTTP 500, wenn der Push scheitert, obwohl der Befehl bereits in der Warteschlange liegt (command_uuidist dann in der Antwort). Workflow 1 wertet deshalb nicht den Status, sondern die zurückgegebenecommand_uuidaus. Sonst würde ein APNs-Ausfall dasselbe Profil mehrfach einreihen.
NanoDEP
depserverunddepsyncersind im selben Image (/app/depserver,/app/depsyncer). Der Syncer wird mitcommand: [/app/depsyncer]gestartet.- Das DEP-Schlüsselpaar erzeugt
depserverselbst (GET /v1/tokenpki/<name>), der private Schlüssel bleibt in der Datenbank. Darum gibt es kein separates Schlüsselpaar-Skript im Cluster,mdm-dep-keypair.shholt nur das öffentliche Zertifikat. - Der Proxy von
depservercached die Ziel-URL je DEP-Namen. Wer im Test per/v1/configeine andere Basis-URL setzt, mussdepserverneu starten. - Ohne hinterlegten DEP-Token hat
depsyncernichts zu synchronisieren und würde nur Fehler gegen Apple erzeugen. Der Init-Containerwait-for-dep-tokenpolltGET /v1/tokens/<name>(HTTP 500, solange kein Token hinterlegt ist), damit das Deployment ohne manuelles Umschalten bereitsteht und erst nach dem Upload startet. - Der Assigner (
depsyncerweist neuen Seriennummern das DEP-Profil zu) liest das Profil bei jedem Lauf neu. Bei Geräten, die von einem anderen MDM-Server übernommen werden, erscheinen sie alsmodifiedstattaddedund werden nicht zugewiesen (Hinweis im NanoDEP-Handbuch, MicroMDM-Wiki).
DEP-Enrollment-Profil
is_supervised, is_mandatory, is_mdm_removable: false, allow_pairing: false, Sprache de/Region DE und eine Liste übersprungener Einrichtungsschritte (Apple-ID, Diagnose, Siri, Bildschirmzeit, Datenschutz, Software-Update und weitere). Passcode, Sprache und Region (vorbelegt) und WLAN bleiben im Ablauf. Die Namen der Schritte stammen aus apple/device-management (other/skipkeys.yaml). Die Profil-URL ersetzt init.sh beim ersten Start, der Wert liegt danach in automation.setting, damit n8n ihn beim ersten Token-Upload verwenden kann.
Sperrbildschirm-Profil
Payload com.apple.shareddeviceconfiguration, Schlüssel LockScreenFootnote (Apple: iOS ab 9.3.1, nur beaufsichtigte Geräte, nur ein Profil dieser Art pro Gerät). PayloadRemovalDisallowed = true. Die Vorlage hat Platzhalter __TEXT__, __IDENTIFIER__, __PAYLOAD_UUID__ und __PROFILE_UUID__. Die UUIDs sind fest: Dasselbe PayloadIdentifier ersetzt das alte Profil, das ist das Update-Verhalten bei einer Textänderung.
-
Oberstes
PayloadVersionist immer1. Es bezeichnet die Profilsyntax, nicht die Version des Inhalts. Eine erste Fassung schrieb die interne Versionsnummer dorthin, das iPad lehnte alles ab 2 mit „Profilversion wird nicht unterstützt“ ab (MCProfileErrorDomain 1001). Die Version bleibt nur inautomation.profile_stateunddevice_profile. -
Nur beaufsichtigte Geräte. Ein manuell per Safari angemeldetes iPad antwortet mit
MCSupervisedErrorDomain 29000. Beaufsichtigt wird ein Gerät nur über das automatische Enrollment (Zurücksetzen, Fernverwaltung im Einrichtungsassistenten). -
Darstellung ist fest.
LockScreenFootnoteerscheint klein am unteren Rand des Sperrbildschirms, Größe und Position lassen sich nicht ändern. Für einen großen, zentrierten Text bräuchte es ein Hintergrundbild (Settings→Wallpaper) oderDeviceLock/Lost Mode. -
Freie Mitteilungen (einmalig, „einfliegend“) laufen deshalb über ntfy (Workflow 8), weil MDM keinen Befehl für einen freien Hinweistext kennt.
-
Hintergrundbild ist ein Befehl, kein Profil:
SettingsmitItem Wallpaperwirkt einmalig. Die Unveränderlichkeit kommt vom Profilwallpaper-lock(allowWallpaperModification = false). Beides verlangt ein beaufsichtigtes Gerät. Weil der Befehl in die bestehende Zustandsverwaltung (Version, Idempotenz, Quittung) passen soll, liegt er als Zeile mitkind = 'wallpaper'inautomation.profile_state. Der Befehlsbauer erzeugt daraus stattInstallProfileeinenSettings-Befehl, das Bild steht inparams.IMAGE_B64. Beim Start einer leeren Datenbank liestpsqldas Bild per\set … `base64 -w0 …`aus/init-files(kein Argument-Limit der Kommandozeile, das bei rund 130 KB Base64 knapp wäre). Der ConfigMap-Inhaltpostgres-filesenthält das Bild alsbinaryData. -
Erlaubt-Liste für Apps (
allowListedAppBundleIDs) ist ab iOS 27 als veraltet markiert (Ersatz: deklaratives Management). Ein Gerät mit iPadOS 27.0.1 hat sie angenommen (StatusAcknowledged).
Datenbank
- Eine PostgreSQL-Instanz für beide Dienste und den Automatisierungszustand, weil keine gemeinsame Datenbank im Cluster existiert (nur das Zammad-Subchart). MySQL wäre ebenfalls möglich gewesen, Postgres ist bei NanoMDM und NanoDEP gleichwertig unterstützt.
- Das Init-Skript läuft nur bei leerem Volume (
/docker-entrypoint-initdb.d). Schema-Änderungen späterer Versionen sind manuell einzuspielen. Die Schemadateien infiles/sind die kommentarfreien Fassungen aus den Release-Tags (storage/pgsql/schema.sqlvon NanoMDM v0.9.0 und NanoDEP v0.7.0). Beim Entfernen von Kommentaren Blockkommentare (/* … */) nicht vergessen. - Der n8n-Datenbankbenutzer
mdmautohat nur Spaltenrechte aufenrollments/devices/push_certs.ORDER BYauf einer nicht freigegebenen Spalte (z. B.push_certs.updated_atvor der Freigabe) lieferte „permission denied“. - iPad-Liste in der Datenbank: Gruppen und Seriennummern standen als
ipads-Objekt in den Code-NodesKonfigurationder Workflows 10 und 12 und waren dort auseinandergelaufen (im Mail-Workflow fehlten Seriennummern, die das Formular schon kannte). Sie liegen jetzt inautomation.ipad_groupundautomation.ipad; ein Postgres-NodeiPads lesenvorKonfigurationbaut daraus dasselbecfg.ipads-Objekt wie vorher, der übrige Code blieb unverändert. Eine Gruppe ohne iPad wird abgelehnt, statt still ins Leere zu senden. Weil das Init-Skript nur bei leerem Volume läuft, muss die Migration auf der laufenden Datenbank von Hand eingespielt werden (300v0). Die Formular-Checkboxen und das Dropdown in Workflow 10 sind statisch, ein n8n-Formular kann Optionen nicht aus der Datenbank laden. - Der Zustand der Automatisierung (
automation.*) liegt in derselben Datenbank (nanomdm), damit ein Backup alles enthält und n8n nur eine Verbindung braucht. Cross-Database-Abfragen gibt es in Postgres nicht.
n8n-Workflows
- Die Code-Nodes nutzen
cryptoundtls. Dafür stehtNODE_FUNCTION_ALLOW_BUILTINjetzt aufchild_process,crypto,tls. - Postgres-Nodes verlieren Binärdaten. Der Formular-Workflow liest die hochgeladenen Dateien deshalb direkt aus dem Trigger (
$('Formular Verlaengerung')) und gibt sie in einem Node wieder alsbinaryaus. Der Code-NodeKonfigurationdazwischen droppt sie ebenfalls. - Die Felder eines Formulars kommen in der Ausführung unter ihrem Label an, im HTTP-Request aber als
field-0,field-1, … (relevant für Tests percurl -F). - Formular-Workflows mit
Form-Ende-Knoten bleiben bis zur Anzeige der Abschlussseite im Status „waiting“. Das ist normal. - Parameter für
INSERT … unnest($3::int[])kommen als Postgres-Array-Literal'{30,14}'. - Ein
INSERTohneRETURNINGgibt dem n8n-Postgres-Node keine Ausgabeelemente. Folgeknoten würden dann nicht laufen. Der Vermerk der Erinnerungen nutzt deshalbWITH … RETURNING 1 SELECT count(*). - Zwei Trigger an einem Konfigurations-Node starten beide Zweige. Workflow 5 hat darum für Webhook und Tageslauf je einen eigenen
Konfiguration-Node. - Zugriff auf kube-state-metrics erfolgt über VictoriaMetrics (
kube_cronjob_status_last_successful_timeusw.), weil n8n bereits dorthin darf. So braucht n8n keine Kubernetes-Rechte. - Auftrag per Mail (Workflow 12): Das Ziel ist wählbar, die Formular-Workflows 2, 10 und 11 kennen aber nur „alle“ (Text und Bild liegen als Zeile in
profile_state, Versionen und Idempotenz hängen daran). Beiallenutzt der Mail-Workflow für das Bild deshalb denselben Weg (speichern, Version erhöhen, beanspruchen). Den Footer-Text des Sperrbildschirms ändert er bewusst nicht,sperrbildschirmin der Mail bedeutetDeviceLockmit Nachricht. Eine erste Fassung setzte nur den Footer, das iPad sperrte sich dabei nicht. Bei einzelnen iPads sendet er die Befehle direkt und ohnedevice_profile-Eintrag, damit der gespeicherte Standard für neue iPads unverändert bleibt. Das Bild liest er aus dem Mail-Anhang statt aus dem Formular, deshalb gibt der Code-NodeKonfigurationdie Binärdaten weiter (Code- und Postgres-Nodes verlieren sie sonst). - Zwei Trigger in Workflow 12: Mail und Formular laufen über dieselben Nodes
iPads lesenundKonfiguration.Konfigurationliest die Items per$('…').isExecutedvom Trigger, der gelaufen ist, und gibt dabei Binärdaten (Mail-Anhang, Formular-Upload) weiter, weil der Postgres-Node davor sie verliert.Auftrag lesen(früherMail lesen) macht aus beiden Eingaben denselben Plan. Die Antwortseite des Formulars (Abschluss) hängt hinterRueckmeldungundAus Formular?, damit der Mail-Lauf nie bei einem Form-Ende-Knoten landet. Beim manuellen Test den gewünschten Trigger einzeln ausführen, nicht beide. - Deaktivierte Katalog-Apps: Die Grundeinrichtung (
mdm-ipad-grundeinrichtung.json) setzt bei jedem Lauf mit neuen Gerätenenabledim Katalog auf die Standard-Apps zurück (DLRG Trainer, ntfy, Bitwarden). Microsoft Authenticator und Teams standen danach auffalse, das Formular „App auf iPads installieren“ las aber nurenabled-Zeilen und meldete „Die App steht nicht in der Liste“, obwohl die App im Dropdown stand. Workflow 10 und 12 aktivieren die gewählte Katalog-App deshalb vor dem Lesen. Folge: Eine so aktivierte App fällt beim nächsten neuen Gerät wieder aus der Erlaubt-Liste, bis sie erneut installiert wird. - Festtext vor Sperr-Nachrichten:
DeviceLockzeigt die Nachricht sofort auf dem Sperrbildschirm, ein iPad mit plötzlich gesperrtem Bildschirm sieht nach Verlust aus. Deshalb setzt der Befehlsbauer (lockPrefixin den Workflows 9 und 12) den Satz „Das iPad ist nicht verloren gegangen …“ vor jede Nachricht. Wer einen weiteren Weg zuDeviceLockbaut, muss das Präfix dort ebenfalls setzen. - Mehrere Items vor Postgres-Nodes: Ein Postgres-Node mit mehreren Eingangsitems läuft je Item. In Workflow 12 stehen deshalb hinter Abfragen mit mehreren Ergebniszeilen (
Globale Profile beanspruchen) ein Code-Node, der auf ein Item verdichtet, undalwaysOutputData, damit der Ablauf bei leerem Ergebnis weiterläuft. Spätere Nodes lesen den Zustand der übersprungenen Zweige mittry/catchüber$('Node').all(), weil n8n bei einem nicht ausgeführten Node einen Fehler wirft. - Eine Mail je Lauf: Der IMAP-Trigger kann mehrere Mails in einem Lauf liefern. Der Ablauf hängt an einem Plan, deshalb verarbeitet
Auftrag lesennur die erste und meldet die übrigen als nicht verarbeitet, statt sie still zu verlieren (die Mails sind danach als gelesen markiert). - ntfy kennt keine Geräte: Eine Mitteilung an ein einzelnes iPad geht nur über ein eigenes Topic je iPad. Ohne das trifft sie alle iPads, der iPad-Name steht im Titel.
Push-Zertifikat ohne eigene Vendor-Cert
Apple verlangt für das Push-Zertifikat eine von einem MDM-Anbieter signierte Anfrage. Ein eigenes Anbieter-Zertifikat ist aufwendig (Apple-Programm). Deshalb nutzen wir mdmcert.download, das die Anfrage kostenlos signiert (nur Organisationen, E-Mail-Registrierung). Das Protokoll haben wir aus cmd/mdmctl/mdmcert.download.go (micromdm) übernommen: JSON-POST an https://mdmcert.download/api/v1/signrequest mit Base64-CSR, E-Mail, dem öffentlichen API-Schlüssel des Dienstes und einem Base64-Zertifikat, an das der Dienst die Antwort verschlüsselt. Die Antwort kommt per E-Mail als hex-codiertes PKCS#7 (xxd -r -p und openssl smime -decrypt). Der API-Schlüssel steht nicht im Repo, mdm-apns.sh liest ihn aus der Umgebung. Die Webseite nennt den Dienst nur für Test und Entwicklung. Fällt er aus, ist der Ersatz ein eigener Anbieter-Zertifikatsprozess bei Apple.
Build- und Ablauf-Fallen
- Reihenfolge der Freigaben:
argocd/bootstrap/projects.yamlist nur die committete Kopie des Ansible-Templates. Angewendet wird der AppProjecttechvon der Rolleargocd(kubectl applyim Playbook), nicht von ArgoCD. Ohnemake argocdbleibt die ApplicationmdmaufUnknown(InvalidSpecError), es gibt keinen Retry, der das behebt. Dietier-default-ingress-Policies legt dieselbe Rolle nur für schon vorhandene Namespaces an, deshalb ist ein zweiter Lauf nach dem ersten Sync nötig. - SCEP-Image: Der Bump-PR kommt erst nach dem ersten Merge. Bis dahin bleibt nur
mdm-scepinImagePullBackOff. - Argo-Sync und PVC: Die PVCs tragen
Delete=false(wie bei ntfy), damit ein Abräumen der Application keine Daten löscht. kubeseal --rawbindet an Name und Namespace (mdm-secrets,mdm-scep-ca,mdm-enrollment-profileim Namespacemdm). Umbenennen der Secrets verlangt neues Versiegeln.printf '%s', nichtecho: Alle Werte werden ohne Zeilenumbruch versiegelt (Regel aus 60030). Der SCEP-Schlüssel ist ohne abschließenden Zeilenumbruch geprüft:scepserverliest ihn.