PKR-Lab

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.

NanoMDM

NanoDEP

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.


Datenbank


n8n-Workflows


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