Come configurare Kopano Z-Push per la sincronizzazione con ActiveSync Mobile

Z-Push consente ai dispositivi mobili compatibili di sincronizzarsi con Kopano Core tramite Microsoft Exchange ActiveSync. Una configurazione affidabile dipende dall'abbinamento del backend di Z-Push al server Kopano, dalla pubblicazione dell'endpoint ActiveSync tramite HTTPS e dalla conservazione dello stato di Z-Push durante gli aggiornamenti. La configurazione corretta dipende anche dal fatto che si desideri una distribuzione più semplice con un singolo server o si necessitino di servizi separati e capacità multi-host.

Scegli la configurazione più adatta al tuo ambiente

Z-Push è un server di sincronizzazione ActiveSync open source. Funge da livello di protocollo tra un dispositivo compatibile e un backend di groupware; il dispositivo in genere aggiunge un account Exchange o ActiveSync anziché connettersi direttamente a Kopano. Z-Push può sincronizzare email, contatti, elementi del calendario e attività quando il backend e il client mobile scelti supportano questi tipi di dati. Kopano descrive questa relazione nella documentazione di amministrazione di Kopano Core .

Per un server Kopano Core esistente, il backend Kopano rappresenta il punto di partenza naturale. Selezionare IMAP più CalDAV/CardDAV solo se questi sistemi contengono effettivamente i dati rilevanti o se si desidera intenzionalmente fonti separate. La sostituzione del backend non è neutrale rispetto alle funzionalità: il comportamento di sincronizzazione, le rubriche, le attività, le cartelle pubbliche e la compatibilità possono variare.

Prima di installare o modificare la configurazione

• Annota le versioni di Kopano Core, Z-Push, PHP, del server web e del sistema operativo. Verifica le combinazioni supportate dai pacchetti che intendi utilizzare; la sola versione di PHP accettata da Z-Push non garantisce la disponibilità dell'estensione Kopano MAPI.
• Scegli il nome host pubblico che i client utilizzeranno, ad esempio sync.example.com, e prepara un certificato TLS attendibile per tale nome.
• Decidi se Z-Push deve essere eseguito sull'host Kopano o su un server web separato. Un host separato consente di isolare i servizi accessibili via web, ma richiede un accesso di rete funzionante a Kopano e un indirizzo server MAPI configurato correttamente.
• Eseguire un backup delle directory di configurazione e di stato di Z-Push prima di un aggiornamento. Lo stato di Z-Push tiene traccia della sincronizzazione dei dispositivi; le istruzioni di aggiornamento documentate da Kopano raccomandano di preservare lo stato dei profili mobili esistenti.
• Scegli i tipi di dati che ogni utente deve sincronizzare e rivedi i requisiti delle policy del dispositivo prima di registrare telefoni personali o aziendali.

Configura il lato server

1. Installare un pacchetto Z-Push compatibile

Utilizza i pacchetti creati per la tua distribuzione e versione di Kopano quando sono disponibili. Una tipica configurazione basata su pacchetti separa il core di Z-Push, il backend di Kopano e l'integrazione con il server web. Il manuale di amministrazione di Kopano descrive pacchetti come z-push-backend-kopanoe i pacchetti di configurazione del server web, ma i nomi esatti dei pacchetti e la disponibilità del repository sono specifici della distribuzione e il manuale fa riferimento a una versione precedente della documentazione di Kopano Core. Verifica il supporto corrente del pacchetto prima di applicare i relativi comandi storici.

Le installazioni da sorgente e i container offrono un maggiore controllo sulle versioni e sulla struttura del filesystem. Inoltre, trasferiscono la responsabilità all'operatore: è necessario rendere le estensioni PHP disponibili allo stesso runtime PHP utilizzato dal server web, rendere persistenti lo stato e i log e mantenere la route ActiveSync raggiungibile anche dopo i ridistribuzioni.

2. Selezionare il backend Kopano e l'indirizzo del server

Nella configurazione principale di Z-Push, imposta il provider di backend sul backend Kopano utilizzando l'impostazione e il nome della classe documentati per la versione installata. Un'impostazione comune nelle distribuzioni preconfigurate è BackendKopano; non incollare un'impostazione in un file di configurazione con una struttura diversa senza prima controllare l'esempio fornito dal pacchetto. Nella configurazione del backend Kopano, imposta l'indirizzo del server MAPI quando il servizio Kopano non si trova sullo stesso host o non è raggiungibile tramite la connessione locale predefinita.

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

I nomi dei file e le costanti possono variare tra le diverse versioni pacchettizzate. Evitate di condividere informazioni riservate negli esempi di configurazione pubblici, limitate i permessi dei file di configurazione e verificate che l'ambiente di runtime PHP utilizzato da Apache o PHP-FPM sia in grado di caricare l'estensione Kopano MAPI necessaria. Un ambiente PHP a riga di comando funzionante non garantisce che l'ambiente di runtime PHP web abbia le stesse estensioni abilitate.

3. Pubblicare l'endpoint ActiveSync tramite HTTPS

I client necessitano di un URL HTTPS stabile per il gestore ActiveSync, solitamente il nome host seguito da /Microsoft-Server-ActiveSync. Configura Apache, Nginx o il proxy inverso scelto per instradare tale percorso al punto di ingresso di Z-Push. Mantieni l'endpoint canonico sullo stesso nome host ed evita reindirizzamenti che modifichino il metodo di richiesta o indirizzino un client mobile a un percorso diverso. La guida di Kopano sconsiglia specificamente di rinominare la directory di Z-Push per creare l'endpoint, poiché un reindirizzamento può interrompere la sincronizzazione dei dispositivi.

Utilizza un certificato valido il cui nome corrisponda al nome host dell'endpoint. HTTPS protegge le credenziali e i dati di sincronizzazione durante la trasmissione e molti client mobili attuali rifiutano i certificati non attendibili o non corrispondenti. Non aggirare gli avvisi relativi ai certificati disabilitando TLS sugli account di produzione. Se la terminazione TLS avviene tramite un proxy inverso, verifica che il proxy inoltri le richieste e le intestazioni relative all'autenticazione come previsto e che la connessione dal proxy a Z-Push sia conforme alla tua policy di sicurezza interna.

4. Imposta lo stato scrivibile e le posizioni dei log

Z-Push deve essere in grado di scrivere nelle posizioni di stato e di log. Concedi l'accesso allo specifico account del server web, come avviene www-datain molte installazioni di Debian e Ubuntu; l'account di servizio varia a seconda della distribuzione. Evita di rendere queste directory scrivibili da tutti. In una distribuzione multi-host, scegli un meccanismo di stato progettato per l'accesso condiviso anziché presumere che i file su un nodo siano visibili agli altri. La guida di amministrazione di Kopano spiega i permessi delle directory di stato e sottolinea che lo stato deve essere mantenuto durante l'aggiornamento di Z-Push.

Configura l'account mobile

Sul telefono, aggiungi un account aziendale o Exchange e seleziona Exchange ActiveSync, Microsoft Exchange o l'opzione equivalente offerta da quel client. Le etichette e le schermate esatte variano a seconda del sistema operativo e dell'applicazione di posta elettronica. Inserisci l'indirizzo email e le credenziali dell'utente. Se il rilevamento automatico non individua il server, inserisci il nome host di Z-Push e, se richiesto, l'endpoint di ActiveSync. Utilizza il formato del nome utente previsto dalla configurazione di autenticazione di Kopano; non dare per scontato che l'indirizzo email completo e il nome di accesso a Kopano siano sempre identici.

Lascia SSL/TLS abilitato e accetta i criteri del dispositivo solo dopo averne esaminato le autorizzazioni, come ad esempio la richiesta di un codice di accesso o l'applicazione dei controlli del dispositivo gestiti dall'organizzazione. Seleziona le categorie da sincronizzare: posta, contatti, calendario e attività, ove disponibili. La vecchia guida di Kopano per dispositivi mobili descrive il flusso di lavoro generale dell'account Exchange, ma le schermate e le etichette del sistema operativo sono obsolete. Segui le istruzioni visualizzate sul telefono in uso anziché copiare letteralmente i percorsi dei menu precedenti.

Se l'app di posta elettronica offre la possibilità di programmare la sincronizzazione, le notifiche push o gli aggiornamenti frequenti garantiscono una consegna più rapida, ma potrebbero consumare più batteria e utilizzare maggiormente la rete. Intervalli di polling più lunghi riducono i controlli in background, ma ritardano la ricezione dei nuovi messaggi. Per un account aziendale in cui la tempestività della posta è fondamentale, è consigliabile iniziare con l'impostazione push del client, se supportata, e poi regolarla in base al consumo della batteria e alle policy aziendali.

Verifica ogni livello prima di registrare altri dispositivi.

1. Endpoint: Aprire il nome host pubblico in un browser e verificare che il certificato TLS sia valido. Eventuali errori del browser o avvisi relativi al certificato devono essere risolti prima di aggiungere gli account.
2. Instradamento web: verificare che il percorso ActiveSync raggiunga il gestore Z-Push senza cicli di reindirizzamento o una pagina di errore 404 generica del server web. L'endpoint è un gestore di protocollo, non un normale sito web.
3. Autenticazione backend: utilizzare un account di prova e verificare che i log di Z-Push mostrino una connessione backend avvenuta con successo, senza esporre password o token.
4. Sincronizzazione iniziale: aggiungi un telefono di prova e verifica le cartelle di posta, i contatti, il calendario e le attività selezionati. Un accesso riuscito non garantisce che tutti i tipi di dati vengano sincronizzati correttamente.
5. Modifiche bidirezionali: crea un evento di prova sul calendario del telefono e verifica che venga visualizzato in Kopano; quindi effettua una modifica di prova in Kopano e verifica che venga visualizzata sul telefono.
6. Riavvia e ripristina: riavvia il servizio web durante una finestra di test pianificata, verifica che la sincronizzazione venga ripristinata e conferma che la directory di stato rimanga intatta.

Risoluzione dei problemi in base ai sintomi

Utilizzate i log di Z-Push e i log del server web/PHP insieme, facendoli corrispondere allo stesso timestamp. Se dovete testare un nuovo profilo dispositivo, verificate prima che un ripristino dello stato lato server sia appropriato per la vostra versione e capite se attiverà una risincronizzazione completa. Non eliminate l'intera directory di stato come primo passaggio per la risoluzione dei problemi.

Quale configurazione dovresti scegliere?

Per una piccola installazione di Kopano Core esistente, un set di pacchetti Z-Push supportato dalla distribuzione, il backend di Kopano, un endpoint HTTPS e uno stato locale con autorizzazioni attentamente gestite solitamente riducono al minimo i componenti da gestire. Utilizzare un host separato quando l'isolamento o i limiti operativi giustificano il lavoro aggiuntivo di rete e di compatibilità PHP-MAPI. Utilizzare un'architettura multi-host solo dopo aver selezionato e testato un approccio con stato condiviso. Se la posta, i calendari o i contatti risiedono al di fuori di Kopano, confrontare i backend Z-Push pertinenti prima del rollout e testare ogni tipo di dato sui client mobili effettivamente utilizzati dagli utenti.

Il packaging di Z-Push e Kopano, il supporto PHP e il comportamento dei dispositivi cambiano tra le varie versioni. Considerate come fonti autorevoli la configurazione di esempio del pacchetto installato e la relativa documentazione di rilascio; i manuali Kopano più vecchi sono utili per comprendere i concetti, ma non devono essere copiati ciecamente in un sistema più recente. Il repository del progetto Z-Push è la fonte del codice sorgente e delle informazioni sulle versioni più recenti.