MDM für iPads — NanoMDM, NanoDEP und SCEP
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/3-apps-workloads/300r0-mdm.md
MDM für iPads — NanoMDM, NanoDEP und SCEP
Eigener, rein quelloffener Mobile-Device-Management-Server für die Vereins-iPads. Die iPads melden sich per Automated Device Enrollment (Apple Business) automatisch an, werden beaufsichtigt (supervised) und bekommen als erste Konfiguration eine Nachricht auf dem Sperrbildschirm. Alles, was sich automatisieren lässt, übernimmt n8n; was Apple nur per Browser-Login erlaubt, steht als kurze Checkliste in 300t0.
Cluster: TECH · Ordner
argocd/apps/tech/mdm/· Namespacemdm· URLhttps://mdm-prod.pke-lab.de(extern, nur die iPad-Pfade),mdm.prod.homeserver(intern, gleiche Pfade).kubectl-Befehle in diesem Doc gelten für den TECH-Cluster (Zugriff je Cluster).
| Doc | Inhalt |
|---|---|
| 300r0 (dieses Doc) | Überblick, Architektur, Komponenten und Versionen |
| 300s0 | Was deployt wird, wo es liegt, Erstinstallation, neu deployen |
| 300t0 | Manuelle Checkliste für Apple Business, Apple Push Certificates und Apple Configurator, End-to-End-Test |
| 300u0 | Die zwölf n8n-Workflows |
| 300v0 | Jährliche Verlängerung, Backup und Restore, Updates, Troubleshooting, Notfälle |
| 300w0 | Exponierte Endpunkte, Secrets, NetworkPolicies, Risiken |
| 600d0 | Begründungen und Fallstricke zum Code |
Architektur
flowchart LR
subgraph Apple
ABM[Apple Business<br/>DEP-API]
APNS[APNs]
ID[identity.apple.com<br/>Push-Zertifikat]
end
IPAD[iPad]
CF[Cloudflare Tunnel<br/>mdm-prod.pke-lab.de]
TR[Traefik]
subgraph ns_mdm [Namespace mdm]
ENR[enroll<br/>nginx]
MDM[NanoMDM<br/>/mdm]
SCEP[SCEP-Server<br/>/scep]
DEPS[depserver]
SYNC[depsyncer]
PG[(PostgreSQL<br/>nanomdm, nanodep)]
BK[CronJob mdm-backup<br/>restic]
end
N8N[n8n<br/>Workflows und Formulare]
NTFY[ntfy und Zammad]
VM[VictoriaMetrics]
NAS[(NAS)]
IPAD -->|HTTPS| CF --> TR
TR -->|/mdm/enroll| ENR
TR -->|/mdm| MDM
TR -->|/scep| SCEP
MDM --> PG
DEPS --> PG
SYNC --> PG
SYNC -->|Sync| DEPS
DEPS -->|Proxy| ABM
MDM -->|Push| APNS
APNS -.->|Push| IPAD
ABM -.->|DEP-Profil| IPAD
MDM -->|Webhook| N8N
SYNC -->|Webhook| N8N
N8N -->|API, intern| MDM
N8N -->|API, intern| DEPS
N8N -->|SQL| PG
N8N -->|Abfragen| VM
N8N --> NTFY
BK --> PG
BK --> NAS
ID -.->|Zertifikat per Formular| N8N
Der Ablauf bei einem neuen iPad:
- Die Seriennummer taucht in Apple Business auf,
depsyncersynchronisiert sie (alle 10 Minuten) und weist ihr das DEP-Enrollment-Profil zu (Assigner). n8n prüft das Ergebnis. - Beim Einrichten des iPads holt es von
https://mdm-prod.pke-lab.de/mdm/enrolldas Enrollment-Profil (enroll-Pod), bezieht per SCEP sein Geräte-Identitätszertifikat und meldet sich bei/mdman. - NanoMDM schickt bei jedem Check-in einen Webhook an n8n. Beim ersten
TokenUpdatereiht n8n alle aktiven Basisprofile (heute: die Sperrbildschirm-Nachricht) perInstallProfileein. Wiederholte Check-ins senden nichts doppelt. - Das iPad quittiert (
Acknowledged), n8n vermerktinstalledin der Datenbank.
Komponenten und Versionen
| Komponente | Version | Image | Aufgabe |
|---|---|---|---|
| NanoMDM | v0.9.0 | ghcr.io/micromdm/nanomdm:0.9.0@sha256:… |
MDM-Kern: Check-in, Befehlswarteschlange, APNs-Push, Admin-API |
NanoDEP depserver |
v0.7.0 | ghcr.io/micromdm/nanodep:0.7.0@sha256:… |
Apple-Business-/DEP-API, Token-Verwaltung, Proxy |
NanoDEP depsyncer |
v0.7.0 | dasselbe Image (/app/depsyncer) |
Geräte aus Apple Business synchronisieren, Assigner |
| SCEP-Server | micromdm/scep v2.3.0 |
ghcr.io/pkr-lab/mdm-scep:sha-… (selbst gebaut) |
Geräte-Identitätszertifikate |
| PostgreSQL | 17 (17-alpine3.24) |
postgres:17-alpine3.24@sha256:… |
Speicher für NanoMDM und NanoDEP, Zustand der Automatisierung |
| Enrollment-Server | nginx 1.31 | nginx:1.31-alpine3.24@sha256:… |
liefert das Enrollment-Profil unter /mdm/enroll aus |
| Backup | restic (Alpine-Paket) | alpine:3.24.3@sha256:… |
pg_dump und SCEP-Depot nach restic auf dem NAS |
| n8n | 2.x (bestehend) | — | Workflows, Formulare, Erinnerungen |
Die exakten Tags und Digests stehen in argocd/apps/tech/mdm/values.yaml. Renovate bumpt die Upstream-Images, das SCEP-Image baut build-images.yml (image.tag, siehe 300s0).
Wo was liegt
| Pfad | Inhalt |
|---|---|
argocd/apps/tech/mdm/ |
Helm-Chart (ein Chart, alle Komponenten) |
argocd/apps/tech/mdm/files/ |
Datenbankschemas (NanoMDM v0.9.0, NanoDEP v0.7.0) und Tabellen der Automatisierung |
argocd/apps/tech/mdm/profiles/ |
Vorlage des Sperrbildschirm-Profils, DEP-Enrollment-Profil (JSON) |
argocd/apps/tech/mdm/scripts/ |
Admin-Skripte (Secrets, CSR, DEP-Schlüssel, Enrollment-Profil, n8n-Import) |
argocd/apps/tech/mdm/image/scep/ |
Dockerfile des SCEP-Images |
argocd/apps/tech/n8n/workflows/mdm-*.json |
die zwölf n8n-Workflows |
capulus-ansible: roles/argocd/defaults/main.yml |
Namespace mdm in den Listen, Freigabe n8n ↔ mdm |
Öffentlich und intern
| Pfad | Ziel | Von wo erreichbar |
|---|---|---|
/mdm |
NanoMDM (Check-in und Befehle der iPads) | öffentlich |
/mdm/enroll |
nginx mit dem Enrollment-Profil | öffentlich |
/scep |
SCEP-Server | öffentlich |
NanoMDM-API (/v1/...), /version, /migration |
mdm-nanomdm.mdm.svc.cluster.local:9000 |
nur im Cluster (n8n, kubectl) |
NanoDEP-API (/v1/..., /proxy/...) |
mdm-depserver.mdm.svc.cluster.local:9001 |
nur im Cluster (n8n, kubectl) |
| PostgreSQL | mdm-postgres.mdm.svc.cluster.local:5432 |
nur im Cluster |
Der Ingress kennt ausschließlich die drei öffentlichen Pfade. Alles andere liefert Traefik als 404. Details: 300w0.