Hoe configureert u Kopano Z-Push voor ActiveSync Mobile Sync?

Met Z-Push kunnen compatibele mobiele apparaten synchroniseren met Kopano Core via Microsoft Exchange ActiveSync. Een betrouwbare configuratie is afhankelijk van de juiste afstemming van de Z-Push-backend op de Kopano-server, het publiceren van het ActiveSync-eindpunt via HTTPS en het behoud van de Z-Push-status tijdens upgrades. De juiste configuratie hangt ook af van de vraag of u een eenvoudige implementatie met één server wilt of dat u aparte services en capaciteit voor meerdere hosts nodig hebt.

Kies de configuratie die het beste bij uw omgeving past.

Z-Push is een open-source ActiveSync-synchronisatieserver. Het fungeert als de protocollaag tussen een compatibel apparaat en een groupware-backend; het apparaat voegt meestal een Exchange- of ActiveSync-account toe in plaats van rechtstreeks verbinding te maken met Kopano. Z-Push kan e-mail, contactpersonen, agenda-items en taken synchroniseren wanneer de gekozen backend en mobiele client deze gegevenstypen ondersteunen. Kopano beschrijft deze relatie in de documentatie voor beheerders van Kopano Core .

Voor een bestaande Kopano Core-server is de Kopano-backend het natuurlijke startpunt. Selecteer IMAP plus CalDAV/CardDAV alleen als die systemen daadwerkelijk de relevante gegevens bevatten, of als u bewust gescheiden bronnen wilt gebruiken. Backend-vervangingen zijn niet functie-neutraal: synchronisatiegedrag, adresboeken, taken, openbare mappen en compatibiliteit kunnen verschillen.

Voordat u de installatie uitvoert of de configuratie wijzigt.

• Noteer de versies van Kopano Core, Z-Push, PHP, uw webserver en uw besturingssysteem. Controleer de ondersteunde combinaties voor de pakketten die u wilt gebruiken; de PHP-versie die door Z-Push wordt geaccepteerd, garandeert op zich niet dat de Kopano MAPI-extensie daarvoor beschikbaar is.
• Kies de openbare hostnaam die clients zullen gebruiken, bijvoorbeeld sync.example.com, en bereid een vertrouwd TLS-certificaat voor die naam voor.
• Bepaal of Z-Push op de Kopano-host of op een aparte webserver draait. Een aparte host kan webgerichte services isoleren, maar vereist een werkende netwerkverbinding met Kopano en een correct geconfigureerd MAPI-serveradres.
• Maak een back-up van de Z-Push-configuratie en de statusmappen voordat u een upgrade uitvoert. De Z-Push-status houdt de apparaatsynchronisatie bij; in de upgradehandleiding van Kopano staat dat de status voor bestaande mobiele profielen behouden moet blijven.
• Selecteer de gegevenstypen die elke gebruiker moet synchroniseren en controleer de vereisten voor het apparaatbeleid voordat u persoonlijke of zakelijke telefoons registreert.

Configureer de serverzijde

1. Installeer een bijpassende Z-Push-pakketset

Gebruik pakketten die zijn ontwikkeld voor uw distributie en Kopano-release, zodra deze beschikbaar zijn. Een typische pakketgebaseerde configuratie scheidt de Z-Push-kern, de Kopano-backend en de webserverintegratie. De beheerdershandleiding van Kopano beschrijft pakketten zoals z-push-backend-kopanoen configuratiepakketten voor de webserver, maar de exacte pakketnamen en beschikbaarheid in de repository zijn distributiespecifiek en de handleiding is gebaseerd op een oudere versie van de Kopano Core-documentatie. Controleer of het pakket momenteel wordt ondersteund voordat u de verouderde commando's ervan gebruikt.

Installaties vanuit de broncode en containers bieden meer controle over versies en de indeling van het bestandssysteem. Ze verschuiven de verantwoordelijkheid echter naar de operator: u moet PHP-extensies beschikbaar maken voor dezelfde PHP-runtime die door de webserver wordt gebruikt, de status en logboeken bewaren en ervoor zorgen dat de ActiveSync-route bereikbaar blijft na herimplementaties.

2. Selecteer het Kopano-backend- en serveradres.

Stel in de hoofdconfiguratie van Z-Push de backendprovider in op de Kopano-backend met behulp van de instelling en klassenaam die gedocumenteerd zijn voor uw geïnstalleerde release. Een veelvoorkomende instelling in pakketimplementaties is BackendKopano; plak geen instelling in een anders gestructureerd configuratiebestand zonder eerst het voorbeeld te raadplegen dat bij uw pakket is meegeleverd. Stel in de Kopano-backendconfiguratie het MAPI-serveradres in wanneer de Kopano-service zich niet op dezelfde host bevindt of niet bereikbaar is via de standaard lokale verbinding.

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

Bestandsnamen en constanten kunnen verschillen tussen verschillende pakketversies. Houd geheimen buiten openbare configuratievoorbeelden, beperk de machtigingen voor configuratiebestanden en controleer of de PHP-runtime die door Apache of PHP-FPM wordt gebruikt, de vereiste Kopano MAPI-extensie kan laden. Een goed functionerende PHP-omgeving op de commandoregel garandeert niet dat de PHP-runtime op het web dezelfde extensies heeft ingeschakeld.

3. Publiceer het ActiveSync-eindpunt via HTTPS.

Clients hebben een stabiele HTTPS-URL nodig voor de ActiveSync-handler, meestal de hostnaam gevolgd door /Microsoft-Server-ActiveSync. Configureer Apache, Nginx of de gekozen reverse proxy om dat pad naar het toegangspunt van Z-Push te routeren. Houd het canonieke eindpunt op dezelfde hostnaam en vermijd omleidingen die de aanvraagmethode wijzigen of een mobiele client naar een ander pad sturen. De Kopano-handleiding waarschuwt specifiek tegen het hernoemen van de Z-Push-directory om het eindpunt aan te maken, omdat een omleiding de apparaatsynchronisatie kan verstoren.

Gebruik een geldig certificaat waarvan de naam overeenkomt met de hostnaam van het eindpunt. HTTPS beschermt inloggegevens en synchronisatiegegevens tijdens de overdracht, en veel huidige mobiele clients weigeren onbetrouwbare of niet-overeenkomende certificaten. Omzeil certificaatwaarschuwingen niet door TLS uit te schakelen op productieaccounts. Als TLS wordt beëindigd bij een reverse proxy, controleer dan of de proxy verzoeken en authenticatiegerelateerde headers correct doorstuurt en of de verbinding van de proxy naar Z-Push voldoet aan uw interne beveiligingsbeleid.

4. Stel de beschrijfbare status en loglocaties in.

Z-Push moet toegang hebben tot de status- en loglocaties. Verleen toegang aan het specifieke webserveraccount, zoals www-databij veel Debian- en Ubuntu-installaties; het serviceaccount verschilt per distributie. Vermijd het wereldwijd beschrijfbaar maken van deze mappen. Kies bij een implementatie met meerdere hosts een statusmechanisme dat is ontworpen voor gedeelde toegang, in plaats van ervan uit te gaan dat bestanden op de ene node zichtbaar zijn voor de andere. De Kopano-beheerdershandleiding legt de machtigingen voor statusmappen uit en merkt op dat de status behouden moet blijven bij het upgraden van Z-Push.

Stel het mobiele account in.

Voeg op de telefoon een werk- of Exchange-account toe en selecteer Exchange ActiveSync, Microsoft Exchange of de equivalente optie die door die client wordt aangeboden. De exacte labels en schermen variëren per besturingssysteem en e-mailapp. Voer het e-mailadres en de inloggegevens van de gebruiker in. Als de server niet automatisch wordt gevonden, voer dan de Z-Push-hostnaam in en, indien gevraagd, het ActiveSync-eindpunt. Gebruik de gebruikersnaamindeling die uw Kopano-authenticatie vereist; ga er niet vanuit dat het volledige e-mailadres en de Kopano-inlognaam altijd identiek zijn.

Laat SSL/TLS ingeschakeld en accepteer apparaatbeleid pas nadat u hebt gecontroleerd wat het toestaat, zoals het vereisen van een toegangscode of het toepassen van door de organisatie beheerde apparaatinstellingen. Selecteer welke categorieën u wilt synchroniseren: e-mail, contacten, agenda en taken (indien beschikbaar). De oude Kopano-handleiding voor mobiele apparaten beschrijft de algemene workflow voor Exchange-accounts, maar de schermafbeeldingen en besturingssysteemlabels zijn verouderd. Volg de aanwijzingen van uw huidige telefoon in plaats van oudere menupaden letterlijk te kopiëren.

Als de e-mailapp synchronisatieschema's ondersteunt, zorgen pushmeldingen of frequente updates voor een snellere bezorging, maar kunnen ze meer batterij en netwerkactiviteit verbruiken. Langere polling-intervallen verminderen achtergrondcontroles, maar vertragen de ontvangst van nieuwe berichten. Voor een zakelijk account waar tijdige e-mail belangrijk is, begin dan met de push-instelling van de e-mailclient (indien ondersteund) en pas deze vervolgens aan op basis van het batterijverbruik en het beleid van de organisatie.

Controleer elke laag voordat u meer apparaten registreert.

1. Eindpunt: Open de openbare hostnaam in een browser en controleer of het TLS-certificaat geldig is. Een browserfout of certificaatwaarschuwing moet worden verholpen voordat accounts worden toegevoegd.
2. Webroutering: Controleer of het ActiveSync-pad de Z-Push-handler bereikt zonder omleidingslussen of een algemene 404-pagina van de webserver. Het eindpunt is een protocolhandler, geen normale website.
3. Authenticatie aan de backend: Gebruik een testaccount en controleer of de Z-Push-logboeken een succesvolle backendverbinding tonen zonder wachtwoorden of tokens prijs te geven.
4. Eerste synchronisatie: Voeg een testtelefoon toe en controleer de geselecteerde e-mailmappen, contacten, agenda en taken. Een succesvolle aanmelding garandeert niet dat alle gegevenstypen correct worden gesynchroniseerd.
5. Wijzigingen in twee richtingen: Maak een testagenda-afspraak aan op de telefoon en controleer of deze in Kopano verschijnt; voer vervolgens een testwijziging door in Kopano en controleer of deze de telefoon bereikt.
6. Opnieuw opstarten en herstellen: Start de webservice opnieuw op tijdens een geplande testperiode, controleer of de synchronisatie is hersteld en bevestig dat de statusdirectory intact is gebleven.

Probleemoplossing op basis van symptomen

Gebruik de eigen logbestanden van Z-Push en de logbestanden van de webserver/PHP samen, met dezelfde tijdstempel. Als u een nieuw apparaatprofiel wilt testen, controleer dan eerst of een reset van de serverstatus geschikt is voor uw release en of dit een volledige resynchronisatie zal veroorzaken. Verwijder niet de volledige statusmap als eerste stap bij het oplossen van problemen.

Welke configuratie moet u kiezen?

Voor een kleine, bestaande Kopano Core-installatie volstaan ​​een door de distributie ondersteunde Z-Push-pakkettenset, de Kopano-backend, één HTTPS-eindpunt en zorgvuldig beheerde lokale statusinformatie om het aantal variabelen te minimaliseren. Gebruik een aparte host wanneer isolatie of operationele beperkingen de extra netwerk- en PHP-MAPI-compatibiliteitswerkzaamheden rechtvaardigen. Gebruik een multi-host-ontwerp pas nadat een gedeelde statusbenadering is geselecteerd en getest. Als e-mail, agenda's of contacten zich buiten Kopano bevinden, vergelijk dan de relevante Z-Push-backends vóór de uitrol en test elk gegevenstype op de mobiele clients die uw gebruikers daadwerkelijk gebruiken.

De pakketten van Z-Push en Kopano, de PHP-ondersteuning en het gedrag van apparaten veranderen per release. Beschouw de voorbeeldconfiguratie van het geïnstalleerde pakket en de bijbehorende releasedocumentatie als leidend; oudere Kopano-handleidingen zijn nuttig voor concepten, maar mogen niet blindelings worden gekopieerd naar een nieuwer systeem. De repository van het Z-Push-project is de bron voor de actuele projectcode en release-informatie.