So konfigurieren Sie Kopano Z-Push für ActiveSync Mobile Sync

Z-Push ermöglicht die Synchronisierung kompatibler Mobilgeräte mit Kopano Core über Microsoft Exchange ActiveSync. Eine zuverlässige Einrichtung setzt voraus, dass das Z-Push-Backend mit dem Kopano-Server übereinstimmt, der ActiveSync-Endpunkt über HTTPS veröffentlicht wird und der Z-Push-Status bei Aktualisierungen erhalten bleibt. Die optimale Konfiguration hängt außerdem davon ab, ob Sie eine einfache Einzelserver-Bereitstellung oder separate Dienste und Multi-Host-Kapazität benötigen.

Wählen Sie die Konfiguration, die zu Ihrer Umgebung passt.

Z-Push ist ein Open-Source-ActiveSync-Synchronisierungsserver. Er fungiert als Protokollschicht zwischen einem kompatiblen Gerät und einem Groupware-Backend. Das Gerät fügt üblicherweise ein Exchange- oder ActiveSync-Konto hinzu, anstatt sich direkt mit Kopano zu verbinden. Z-Push kann E-Mails, Kontakte, Kalendereinträge und Aufgaben synchronisieren, sofern das gewählte Backend und der mobile Client diese Datentypen unterstützen. Kopano beschreibt diese Beziehung in seiner Administratordokumentation zu Kopano Core .

Für einen bestehenden Kopano Core-Server ist das Kopano-Backend der natürliche Ausgangspunkt. Wählen Sie IMAP plus CalDAV/CardDAV nur dann, wenn diese Systeme tatsächlich die relevanten Daten enthalten oder wenn Sie bewusst separate Datenquellen wünschen. Backend-Ersetzungen sind nicht funktionsneutral: Synchronisierungsverhalten, Adressbücher, Aufgaben, öffentliche Ordner und Kompatibilität können sich unterscheiden.

Vor der Installation oder Änderung der Konfiguration

• Notieren Sie sich die Versionen von Kopano Core, Z-Push, PHP, Webserver und Betriebssystem. Prüfen Sie die unterstützten Kombinationen der von Ihnen verwendeten Pakete; die von Z-Push akzeptierte PHP-Version allein garantiert nicht, dass die Kopano MAPI-Erweiterung dafür verfügbar ist.
• Wählen Sie den öffentlichen Hostnamen, den die Clients verwenden sollen, z. B. sync.example.com, und erstellen Sie ein vertrauenswürdiges TLS-Zertifikat für diesen Namen.
• Entscheiden Sie, ob Z-Push auf dem Kopano-Host oder einem separaten Webserver ausgeführt wird. Ein separater Host kann webbasierte Dienste isolieren, erfordert jedoch einen funktionierenden Netzwerkzugriff auf Kopano und eine korrekt konfigurierte MAPI-Serveradresse.
• Sichern Sie vor einem Upgrade die Z-Push-Konfigurations- und Statusverzeichnisse. Der Z-Push-Status verfolgt die Gerätesynchronisierung; laut der dokumentierten Upgrade-Anleitung von Kopano sollten die Statusinformationen für bestehende mobile Profile beibehalten werden.
• Wählen Sie die Datentypen aus, die jeder Benutzer synchronisieren soll, und überprüfen Sie die Geräterichtlinienanforderungen, bevor Sie private oder Firmenhandys anmelden.

Konfigurieren Sie die Serverseite

1. Installieren Sie ein passendes Z-Push-Paket

Verwenden Sie, sofern verfügbar, für Ihre Distribution und Kopano-Version erstellte Pakete. Eine typische paketbasierte Konfiguration trennt den Z-Push-Kern, das Kopano-Backend und die Webserver-Integration. Das Kopano-Administratorhandbuch beschreibt Pakete wie z. z-push-backend-kopanoB. Webserver-Konfigurationspakete. Die genauen Paketnamen und die Verfügbarkeit im Repository sind jedoch distributionsspezifisch, und das Handbuch basiert auf einer älteren Kopano-Core-Dokumentation. Prüfen Sie daher die aktuelle Paketunterstützung, bevor Sie ältere Befehle anwenden.

Quellcodeinstallationen und Container bieten mehr Kontrolle über Versionen und Dateisystemstruktur. Sie verlagern die Verantwortung jedoch auf den Betreiber: PHP-Erweiterungen müssen für dieselbe PHP-Laufzeitumgebung wie der Webserver verfügbar gemacht, Status und Protokolle persistent gespeichert und die Erreichbarkeit der ActiveSync-Route nach erneuten Bereitstellungen sichergestellt werden.

2. Wählen Sie das Kopano-Backend und die Serveradresse aus.

Legen Sie in der Hauptkonfiguration von Z-Push den Backend-Provider mithilfe der für Ihre installierte Version dokumentierten Einstellungen und Klassennamen auf das Kopano-Backend fest. Eine gängige Einstellung in Paketinstallationen ist BackendKopano[hier fehlt die Angabe der Einstellung]. Kopieren Sie keine Einstellung in eine anders strukturierte Konfigurationsdatei, ohne vorher das mitgelieferte Beispiel zu prüfen. Geben Sie in der Kopano-Backend-Konfiguration die MAPI-Serveradresse an, wenn sich der Kopano-Dienst nicht auf demselben Host befindet oder nicht über die standardmäßige lokale Verbindung erreichbar ist.

// Example only: confirm the setting and file path in your installed package.
define('BACKEND_PROVIDER', 'BackendKopano');

Dateinamen und Konstanten können sich zwischen verschiedenen Paketversionen unterscheiden. Halten Sie geheime Informationen aus öffentlichen Konfigurationsbeispielen fern, beschränken Sie die Berechtigungen für Konfigurationsdateien und stellen Sie sicher, dass die von Apache oder PHP-FPM verwendete PHP-Laufzeitumgebung die benötigte Kopano-MAPI-Erweiterung laden kann. Eine funktionierende PHP-Umgebung in der Kommandozeile beweist nicht, dass die Web-PHP-Laufzeitumgebung dieselben Erweiterungen aktiviert hat.

3. Veröffentlichen Sie den ActiveSync-Endpunkt über HTTPS.

Clients benötigen eine stabile HTTPS-URL für den ActiveSync-Handler, üblicherweise den Hostnamen gefolgt von /Microsoft-Server-ActiveSync. Konfigurieren Sie Apache, Nginx oder den gewählten Reverse-Proxy so, dass dieser Pfad zum Einstiegspunkt von Z-Push weitergeleitet wird. Behalten Sie den kanonischen Endpunkt unter demselben Hostnamen bei und vermeiden Sie Weiterleitungen, die die Anfragemethode ändern oder einen mobilen Client auf einen anderen Pfad umleiten. Die Kopano-Anleitung warnt ausdrücklich davor, das Z-Push-Verzeichnis umzubenennen, um den Endpunkt zu erstellen, da eine Weiterleitung die Gerätesynchronisierung beeinträchtigen kann.

Verwenden Sie ein gültiges Zertifikat, dessen Name mit dem Hostnamen des Endpunkts übereinstimmt. HTTPS schützt Anmeldeinformationen und Synchronisierungsdaten während der Übertragung, und viele moderne mobile Clients lehnen nicht vertrauenswürdige oder nicht übereinstimmende Zertifikate ab. Deaktivieren Sie TLS in Produktionsumgebungen nicht, um Zertifikatswarnungen zu umgehen. Falls TLS an einem Reverse-Proxy endet, stellen Sie sicher, dass der Proxy Anfragen und Authentifizierungs-Header wie vorgesehen weiterleitet und dass die Verbindung vom Proxy zu Z-Push Ihren internen Sicherheitsrichtlinien entspricht.

4. Schreibstatus und Protokollspeicherorte festlegen

Z-Push muss seine Status- und Protokollverzeichnisse schreiben können. Gewähren Sie Zugriff auf das entsprechende Webserver-Konto, wie es beispielsweise www-databei vielen Debian- und Ubuntu-Installationen der Fall ist; das Dienstkonto variiert je nach Distribution. Vermeiden Sie es, diese Verzeichnisse für alle Benutzer beschreibbar zu machen. Wählen Sie in einer Multi-Host-Umgebung einen Statusmechanismus, der für den gemeinsamen Zugriff ausgelegt ist, anstatt davon auszugehen, dass Dateien auf einem Knoten für andere sichtbar sind. Die Kopano-Administratoranleitung erläutert die Berechtigungen für Statusverzeichnisse und weist darauf hin, dass der Status beim Aktualisieren von Z-Push erhalten bleiben sollte.

Mobilkonto einrichten

Fügen Sie auf Ihrem Telefon ein Arbeits- oder Exchange-Konto hinzu und wählen Sie Exchange ActiveSync, Microsoft Exchange oder die entsprechende Option Ihres E-Mail-Programms. Die genauen Bezeichnungen und Bildschirmeinstellungen variieren je nach Betriebssystem und E-Mail-Anwendung. Geben Sie die E-Mail-Adresse und die Anmeldedaten des Benutzers ein. Falls die automatische Servererkennung den Server nicht findet, geben Sie den Z-Push-Hostnamen und, falls erforderlich, den ActiveSync-Endpunkt ein. Verwenden Sie das von Ihrer Kopano-Authentifizierung erwartete Benutzernamenformat; gehen Sie nicht davon aus, dass die vollständige E-Mail-Adresse und der Kopano-Benutzername immer identisch sind.

Lassen Sie SSL/TLS aktiviert und akzeptieren Sie Geräterichtlinien erst, nachdem Sie deren Bestimmungen geprüft haben, z. B. die Anforderung eines Passcodes oder die Anwendung organisationsseitig verwalteter Gerätekontrollen. Wählen Sie die zu synchronisierenden Kategorien aus: E-Mails, Kontakte, Kalender und Aufgaben (sofern verfügbar). Die ältere Kopano-Anleitung für Mobilgeräte beschreibt den allgemeinen Workflow für Exchange-Konten, die Screenshots und Betriebssystembezeichnungen sind jedoch veraltet. Folgen Sie den Anweisungen Ihres aktuellen Telefons, anstatt ältere Menüpfade wörtlich zu kopieren.

Wenn die E-Mail-App Synchronisierungszeitpläne anbietet, beschleunigen Push-Benachrichtigungen oder häufige Aktualisierungen die Zustellung, verbrauchen aber mehr Akku und Netzwerkaktivität. Längere Abfrageintervalle reduzieren Hintergrundprüfungen, verzögern jedoch neue Nachrichten. Bei einem geschäftlichen E-Mail-Konto, wo zeitnahe Zustellung wichtig ist, empfiehlt es sich, zunächst die Push-Einstellungen des Clients zu verwenden (sofern unterstützt) und diese dann je nach Akkuverbrauch und Unternehmensrichtlinien anzupassen.

Überprüfen Sie jede Ebene, bevor Sie weitere Geräte anmelden.

1. Endpunkt: Öffnen Sie den öffentlichen Hostnamen in einem Browser und überprüfen Sie, ob das TLS-Zertifikat gültig ist. Browserfehler oder Zertifikatswarnungen sollten vor dem Hinzufügen von Konten behoben werden.
2. Web-Routing: Stellen Sie sicher, dass der ActiveSync-Pfad den Z-Push-Handler ohne Weiterleitungsschleifen oder eine generische 404-Fehlerseite des Webservers erreicht. Der Endpunkt ist ein Protokollhandler, keine normale Website.
3. Backend-Authentifizierung: Verwenden Sie ein Testkonto und vergewissern Sie sich, dass die Z-Push-Protokolle eine erfolgreiche Backend-Verbindung anzeigen, ohne Passwörter oder Token preiszugeben.
4. Erste Synchronisierung: Fügen Sie ein Testtelefon hinzu und überprüfen Sie die ausgewählten E-Mail-Ordner, Kontakte, Kalender und Aufgaben. Eine erfolgreiche Anmeldung beweist nicht, dass alle Datentypen korrekt synchronisiert werden.
5. Änderungen in beide Richtungen: Erstellen Sie einen Testkalendereintrag auf dem Telefon und prüfen Sie, ob er in Kopano angezeigt wird; nehmen Sie dann eine Teständerung in Kopano vor und prüfen Sie, ob diese auf dem Telefon ankommt.
6. Neustart und Wiederherstellung: Starten Sie den Webdienst während eines geplanten Testzeitraums neu, überprüfen Sie, ob die Synchronisierung wiederhergestellt wird, und bestätigen Sie, dass das Statusverzeichnis intakt bleibt.

Fehlerbehebung anhand der Symptome

Verwenden Sie die Z-Push-eigenen Protokolle und die Webserver-/PHP-Protokolle, die auf denselben Zeitstempel abgestimmt sind. Wenn Sie ein neues Geräteprofil testen müssen, vergewissern Sie sich zunächst, dass ein serverseitiger Status-Reset für Ihre Version geeignet ist und ob dadurch eine vollständige Resynchronisierung ausgelöst wird. Löschen Sie nicht das gesamte Statusverzeichnis als ersten Schritt zur Fehlerbehebung.

Welche Konfiguration sollten Sie wählen?

Bei einer kleinen, bestehenden Kopano Core-Installation minimieren ein vom Distributor unterstütztes Z-Push-Paket, das Kopano-Backend, ein HTTPS-Endpunkt und sorgfältig verwaltete lokale Statusinformationen in der Regel den Aufwand. Verwenden Sie einen separaten Host, wenn Isolation oder Betriebsgrenzen den zusätzlichen Aufwand für Netzwerk- und PHP-MAPI-Kompatibilität rechtfertigen. Setzen Sie ein Multi-Host-Design erst ein, nachdem Sie einen Ansatz für einen gemeinsamen Status ausgewählt und getestet haben. Wenn E-Mails, Kalender oder Kontakte außerhalb von Kopano gespeichert sind, vergleichen Sie die relevanten Z-Push-Backends vor der Einführung und testen Sie jeden Datentyp auf den mobilen Clients, die Ihre Benutzer tatsächlich verwenden.

Z-Push- und Kopano-Paketierung, PHP-Unterstützung und Geräteverhalten ändern sich mit jeder neuen Version. Die Beispielkonfiguration des installierten Pakets und die zugehörige Dokumentation sind maßgebend; ältere Kopano-Handbücher sind zwar hilfreich, um Konzepte zu verstehen, sollten aber nicht einfach in ein neueres System übernommen werden. Das Z-Push-Projekt-Repository ist die Quelle für den aktuellen Projektcode und die Versionsinformationen.