SharpMailserver SHARPMAILSERVER
Kapitel 09 Clients, Groupware & CLI Admin: #pUsers

Smartphone- & iPhone-Onboarding per QR, WhatsApp & 1-Klick Admin-Einladung

Neue Mitarbeiter sollen ihr Postfach samt Kalender, Kontakten und Notizen in unter 30 Sekunden einrichten können, ohne Servernamen, Ports oder ihr Hauptpasswort abzutippen. SharpMailserver erzeugt dafür kryptografisch PKCS#7/CMS-signierte Apple-.mobileconfig-Profile mit einem isolierten Geräte-App-Passwort.

Praxis-Tipp & Architektur-Hinweis

Warum ein eigener Setup-Link (/onboarding/setup/{token}) für WhatsApp & Teams entscheidend ist: Messenger rufen versendete Links im Hintergrund vorab ab, um ein Vorschaubild zu laden. Ein klassischer Einmal-Download-Link wäre dadurch bereits entwertet, bevor der Nutzer klickt! Die SharpMailserver-Setup-Seite ignoriert Bot-/HEAD-Anfragen, maskiert Zugangsdaten für Crawler und leitet aus In-App-Browsern sauber an Safari weiter.

Ablauf für neue Mitarbeiter (30 Sekunden auf iPhone & iPad)

Kein Abtippen von Ports, kein Herausgeben des Hauptpassworts.

Referenz / Konfiguration
1. Admin klickt in #pUsers beim Konto auf "📱 Smartphone einrichten"
2. Link per WhatsApp, Teams, E-Mail senden oder QR-Code scannen lassen
3. Mitarbeiter öffnet Link in Safari -> tippt auf "iPhone / iPad Push-Profil laden"
4. iOS Einstellungen -> "Profil geladen" -> Installieren -> Fertig!

Einstellungen, Standardwerte & Best Practices

Einstellung / Ort Funktion Standardwert Best Practice im Betrieb
Admin: Smartphone einrichten (#pUsers) Erzeugt direkt aus der Benutzerliste, im Konto-Editor oder unmittelbar nach dem Anlegen eines neuen Kontos einen 24h-Setup-Link für diesen Benutzer. 24 Stunden gültig / 24h TTL Ideal für das Onboarding neuer Mitarbeiter: Link mit 1 Klick per WhatsApp teilen, kopieren oder direkt als Einladungs-E-Mail senden lassen.
Profil-Modus: Exchange Push vs. IMAP + DAV Auf der Setup-Seite kann der Nutzer zwischen All-in-One Push (EAS-kompatibel inkl. Notizen/Erinnerungen) und Standard IMAP + CalDAV/CardDAV wählen. Push-Kombi-Profil empfohlen Auf iPhone und iPad ist das Push-Kombi-Profil besonders komfortabel (ein einziger Schalter in iOS für Mail, Kalender, Kontakte, Notizen & Erinnerungen).
Isoliertes Geräte-App-Passwort Jedes erzeugte Onboarding-Profil erhält automatisch ein eigenes zufälliges App-Passwort statt des Haupt-Login-Passworts. Automatisch pro Gerät Geht ein Diensthandy verloren, widerrufst du im Konto-Editor lediglich dieses eine App-Passwort; alle anderen Geräte und 2FA bleiben unberührt.
Download-Toleranz & Safari-Handoff Erlaubt dem echten Endgerät bis zu 6 Profil-Abrufe innerhalb des 24h-Fensters, damit der Wechsel vom WhatsApp-In-App-Browser zu Safari reibungslos klappt. Max. 6 Abrufe / 24h TTL Auf iOS muss das Profil in Safari geladen und anschließend unter Einstellungen -> Allgemein -> VPN & Geräteverwaltung bestätigt werden.