Cum se configurează Kopano Z-Push pentru ActiveSync Mobile Sync

Z-Push permite dispozitivelor mobile compatibile să se sincronizeze cu Kopano Core prin Microsoft Exchange ActiveSync. O configurare fiabilă depinde de potrivirea backend-ului Z-Push cu serverul Kopano, publicarea endpoint-ului ActiveSync prin HTTPS și păstrarea stării Z-Push în timpul actualizărilor. Configurația corectă depinde, de asemenea, de faptul dacă doriți cea mai simplă implementare pe un singur server sau aveți nevoie de servicii separate și capacitate multi-host.

Alegeți configurația care se potrivește mediului dvs.

Z-Push este un server de sincronizare ActiveSync open-source. Acesta acționează ca strat de protocol între un dispozitiv compatibil și un backend de grup; dispozitivul adaugă de obicei un cont Exchange sau ActiveSync în loc să se conecteze direct la Kopano. Z-Push poate sincroniza e-mailurile, contactele, elementele din calendar și activitățile atunci când backend-ul ales și clientul mobil acceptă aceste tipuri de date. Kopano descrie această relație în documentația sa de administrator Kopano Core .

Pentru un server Kopano Core existent, backend-ul Kopano este punctul de plecare natural. Selectați IMAP plus CalDAV/CardDAV numai atunci când aceste sisteme dețin datele relevante sau când doriți în mod intenționat surse separate. Substituțiile backend nu sunt neutre din punct de vedere al caracteristicilor: comportamentul de sincronizare, agendele, activitățile, folderele publice și compatibilitatea pot diferi.

Înainte de a instala sau modifica configurația

• Înregistrați versiunile Kopano Core, Z-Push, PHP, server web și sistem de operare. Verificați combinațiile acceptate pentru pachetele pe care intenționați să le utilizați; versiunea PHP acceptată de Z-Push nu garantează că extensia Kopano MAPI este disponibilă pentru aceasta.
• Alegeți numele public de gazdă pe care îl vor utiliza clienții, cum ar fi sync.example.com, și pregătiți un certificat TLS de încredere pentru acel nume.
• Decideți dacă Z-Push rulează pe gazda Kopano sau pe un server web separat. O gazdă separată poate izola serviciile orientate către web, dar necesită acces funcțional la rețeaua Kopano și o adresă de server MAPI configurată corect.
• Faceți o copie de rezervă a directoarelor de configurare și stare Z-Push înainte de o actualizare. Starea Z-Push urmărește sincronizarea dispozitivelor; instrucțiunile de actualizare documentate de Kopano recomandă păstrarea stării pentru profilurile mobile existente.
• Alegeți tipurile de date pe care fiecare utilizator ar trebui să le sincronizeze și examinați cerințele politicii privind dispozitivele înainte de a înregistra telefoanele personale sau ale companiei.

Configurați partea de server

1. Instalați un set de pachete Z-Push corespunzător

Folosește pachete create pentru distribuția ta și versiunea Kopano atunci când sunt disponibile. O configurare tipică bazată pe pachete separă nucleul Z-Push, backend-ul Kopano și integrarea serverului web. Manualul de administrare al Kopano descrie pachete precum z-push-backend-kopanoși pachete de configurare a serverului web, dar numele exacte ale pachetelor și disponibilitatea repozitoriului sunt specifice distribuției, iar manualul acoperă o generație mai veche de documentație Kopano Core. Confirmă suportul actual pentru pachete înainte de a aplica comenzile sale istorice.

Instalările sursă și containerele oferă mai mult control asupra versiunilor și a aspectului sistemului de fișiere. De asemenea, transferă responsabilitatea către operator: trebuie să faceți extensiile PHP disponibile pentru același runtime PHP utilizat de serverul web, să persistați starea și jurnalele și să mențineți ruta ActiveSync accesibilă după redistribuiri.

2. Selectați backend-ul și adresa serverului Kopano

În configurația principală Z-Push, setați furnizorul backend la backend-ul Kopano folosind setarea și numele clasei documentate pentru versiunea instalată. O setare comună în implementările pachet este BackendKopano; nu lipiți o setare într-un fișier de configurare cu structură diferită fără a verifica exemplul livrat de pachet. În configurația backend Kopano, setați adresa serverului MAPI atunci când serviciul Kopano nu se află pe aceeași gazdă sau nu poate fi accesat prin conexiunea locală implicită.

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

Numele fișierelor și constantele pot diferi între versiunile pachetelor. Nu includeți secrete în exemplele de configurare publice, restricționați permisiunile fișierelor de configurare și verificați dacă runtime-ul PHP utilizat de Apache sau PHP-FPM poate încărca extensia Kopano MAPI necesară. Un mediu PHP sănătos în linie de comandă nu dovedește că runtime-ul web PHP are aceleași extensii activate.

3. Publicați endpoint-ul ActiveSync prin HTTPS

Clienții au nevoie de o adresă URL HTTPS stabilă pentru handlerul ActiveSync, de obicei numele gazdei urmat de /Microsoft-Server-ActiveSync. Configurați Apache, Nginx sau proxy-ul invers ales pentru a direcționa acea cale către punctul de intrare Z-Push. Păstrați endpoint-ul canonic pe același nume de gazdă și evitați redirecționările care modifică metoda de solicitare sau trimit un client mobil către o cale diferită. Ghidul Kopano avertizează în mod specific împotriva redenumirii directorului Z-Push pentru a crea endpoint-ul, deoarece o redirecționare poate întrerupe sincronizarea dispozitivelor.

Folosiți un certificat valid al cărui nume corespunde cu numele gazdei endpoint-ului. HTTPS protejează acreditările și datele de sincronizare în tranzit, iar mulți clienți mobili actuali resping certificatele neîncrezătoare sau nepotrivite. Nu ocoliți avertismentele privind certificatele prin dezactivarea TLS în conturile de producție. Dacă TLS se termină la un proxy invers, confirmați că proxy-ul redirecționează solicitările și anteturile legate de autentificare conform intenției și că conexiunea de la proxy la Z-Push respectă politica dvs. internă de securitate.

4. Setați starea de scriere și locațiile jurnalelor

Z-Push trebuie să poată scrie starea sa și locațiile în jurnal. Acordați acces contului specific de server web, cum ar fi www-dataîn multe instalări Debian și Ubuntu; contul de serviciu variază în funcție de distribuție. Evitați să faceți aceste directoare accesibile tuturor. Într-o implementare multi-host, alegeți un mecanism de stare conceput pentru acces partajat, mai degrabă decât să presupuneți că fișierele de pe un nod sunt vizibile pentru altul. Ghidul administratorului Kopano explică permisiunile directorului de stare și notează că starea trebuie păstrată la actualizarea Z-Push.

Configurați contul mobil

Pe telefon, adăugați un cont de serviciu sau Exchange și selectați Exchange ActiveSync, Microsoft Exchange sau opțiunea echivalentă oferită de clientul respectiv. Etichetele și ecranele exacte variază în funcție de sistemul de operare și de aplicația de e-mail. Introduceți adresa de e-mail și acreditările utilizatorului. Dacă descoperirea automată nu localizează serverul, introduceți numele de gazdă Z-Push și, dacă este solicitat, punctul final ActiveSync. Utilizați formatul de nume de utilizator așteptat de configurația de autentificare Kopano; nu presupuneți că adresa de e-mail completă și numele de utilizator Kopano sunt întotdeauna identice.

Lăsați SSL/TLS activat și acceptați politicile dispozitivului numai după ce ați verificat ce permit acestea, cum ar fi solicitarea unei parole sau aplicarea controalelor de dispozitiv gestionate de organizație. Selectați categoriile de sincronizat: e-mail, contacte, calendar și activități, acolo unde sunt disponibile. Ghidul vechi pentru dispozitive mobile Kopano descrie fluxul de lucru general al contului Exchange, dar capturile de ecran și etichetele sistemului de operare sunt învechite. Urmați instrucțiunile telefonului actual în loc să copiați literal căile de meniu mai vechi.

Dacă aplicația de e-mail oferă programări de sincronizare, actualizările push sau frecvente oferă o livrare mai rapidă, dar pot consuma mai multă baterie și activitate în rețea. Intervalele de interogare mai lungi reduc verificările de fundal, dar întârzie mesajele noi. Pentru un cont de serviciu în care e-mailul prompt este important, începeți cu setarea push a clientului, dacă este acceptată, apoi ajustați în funcție de utilizarea bateriei și de politica organizațională.

Verificați fiecare strat înainte de a înscrie mai multe dispozitive

1. Punct final: Deschideți numele de gazdă public într-un browser și confirmați că certificatul TLS este valid. O eroare de browser sau un avertisment privind certificatul trebuie remediat înainte de a adăuga conturi.
2. Rutare web: Confirmați că ruta ActiveSync ajunge la handler-ul Z-Push fără bucle de redirecționare sau o pagină 404 generică a serverului web. Punctul final este un handler de protocol, nu un site web obișnuit.
3. Autentificare backend: Folosește un cont de testare și confirmă că jurnalele Z-Push arată o conexiune backend reușită fără a expune parole sau token-uri.
4. Sincronizare inițială: Adăugați un telefon de test și verificați folderele de e-mail, contactele, calendarul și activitățile selectate. O conectare reușită nu dovedește că fiecare tip de date se sincronizează corect.
5. Modificări bidirecționale: Creați un eveniment de testare în calendar pe telefon și confirmați că apare în Kopano; apoi efectuați o modificare de testare în Kopano și confirmați că ajunge pe telefon.
6. Repornire și restaurare: Reporniți serviciul web în timpul unei ferestre de testare planificate, verificați dacă sincronizarea se recuperează și confirmați că directorul de stare rămâne intact.

Depanare în funcție de simptom

Folosește jurnalele proprii ale Z-Push și jurnalele serverului web/PHP împreună, corelate cu aceeași marcă temporală. Dacă trebuie să testezi un profil de dispozitiv nou, confirmă mai întâi că o resetare a stării pe server este potrivită pentru versiunea ta și înțelege dacă aceasta va declanșa o resincronizare completă. Nu șterge întregul director de stare ca prim pas de depanare.

Ce configurație ar trebui să alegi?

Pentru o instalare Kopano Core existentă de dimensiuni reduse, un set de pachete Z-Push suportate de distribuție, backend-ul Kopano, un endpoint HTTPS și o stare locală cu permisiuni atent stabilite minimizează de obicei componentele mobile. Folosiți o gazdă separată atunci când izolarea sau limitele operaționale justifică munca suplimentară de rețea și compatibilitate PHP-MAPI. Folosiți un design multi-gazdă numai după selectarea și testarea unei abordări de stare partajată. Dacă e-mailul, calendarele sau contactele se află în afara Kopano, comparați backend-urile Z-Push relevante înainte de implementare și testați fiecare tip de date pe clienții mobili reali pe care se bazează utilizatorii dvs.

Împachetarea Z-Push și Kopano, suportul PHP și comportamentul dispozitivelor se schimbă de la o versiune la alta. Tratați configurația exemplu a pachetului instalat și documentația corespunzătoare a versiunii ca fiind autoritare; manualele Kopano mai vechi sunt utile pentru concepte, dar nu ar trebui copiate orbește într-un sistem mai nou. Depozitul de proiecte Z-Push este sursa pentru codul curent al proiectului și informațiile despre versiune.