Kalendáře a kontakty přes ActiveSync
Poste.io obsahuje dvě věci, které se do verze 2.5.23 nikdy nepotkaly:
- Z-Push, server ActiveSync, který telefony používají pro typ účtu „Exchange“, nastavený jen pro poštu: přepínače kalendáře a kontaktů v telefonu jsou zapnuté, ale nikdy nic nedorazí;
- server CalDAV/CardDAV (SabreDAV, na
https://<your host>/dav/), kde každá schránka může mít kalendáře a adresáře, vytvořené v administraci.
S jedním účtem ActiveSync dostane telefon poštu i kalendáře a kontakty ze serveru DAV: stejná data, jaká vidí klient CalDAV/CardDAV, a to oběma směry. Od verze 2.5.24 je Poste.io propojuje samo, se standardními backendy CalDAV a CardDAV ze Z-Push. Tento doplněk (Poste.io 2.5.24 nebo novější) to zachovává a nahrazuje jen tyto dva backendy opravenými: událost odmítnutá serverem se telefonu nehlásí jako uložená a vypnutý server DAV nevyřadí ActiveSync (viz obejité problémy níže).
Co uživatelé dostanou
| Schránka má (v administraci) | Telefon zobrazí |
|---|---|
| nic | poštu + „Calendar“ a „Contacts“, které pro ni vytvoří Poste.io (viz níže) |
| kalendář | poštu + tento kalendář (jako výchozí kalendář) + jeho úkoly |
| adresář | poštu + kontakty |
| kalendář sdílený kolegou | tento kalendář jako další kalendář |
Vše funguje oběma směry: událost nebo kontakt vytvořené v telefonu se uloží na serveru a změny na serveru se dostanou do telefonu.
Zapnutí kalendářů a kontaktů pro schránku
Kalendáře a adresáře se vytvářejí pro každou schránku v administraci. Od verze 2.5.24, když je DAV zapnutý, server DAV Poste.io navíc dá schránce, která žádné nemá, prázdný „Calendar“ a „Contacts“ při jejím prvním přístupu k DAV (kalendář webmailu, ActiveSync a pozvánky potřebují kam ukládat): doplněk tomu nemůže a ani nebrání.
- Settings → DAV (Experimental) → Enabled musí být zaškrtnuto (zapíná samotný server DAV).
- Mailboxes → příslušná schránka → DAV, sekce: Create calendar a/nebo Create address book.
- V telefonu musí být v nastavení účtu ActiveSync zapnutá synchronizace kalendáře a kontaktů; pak synchronizujte (nebo počkejte na příští synchronizaci).
- Po zapnutí nebo vypnutí DAV restartujte kontejner: od verze 2.5.24 Poste.io vybírá backend ActiveSync (jen pošta, nebo pošta + kalendáře a kontakty) při startu kontejneru.
Schránka bez kalendáře a bez adresáře má v telefonu dál jen poštu. Když se kalendář nebo adresář v administraci vytvoří nebo smaže, telefon složku přidá nebo odebere při příští synchronizaci složek.
Je kolega zaneprázdněn? Sdílení jen pro čtení
V sekci DAV schránky kolegy otevřete u kalendáře stránku share, vyberte schránku, se kterou se má sdílet, a zvolte read only. V telefonu tohoto uživatele se kalendář kolegy objeví jako další kalendář, s událostmi a jejich názvy (server DAV nemá úroveň „jen volno/obsazeno“).
Zápis do kalendáře jen pro čtení z telefonu je odmítnut: nová událost dostane chybu, změna dostane konflikt (vyhraje verze na serveru), smazání se na serveru neprovede a událost se při příští synchronizaci vrátí. Funguje i sdílení pro čtení i zápis.
Výchozí kalendář
ActiveSync má jeden výchozí kalendář na účet. Poste.io pojmenovává kalendáře
náhodnými identifikátory, takže doplněk nehádá: ptá se serveru přes
schedule-default-calendar-URL (RFC 6638), tutéž vlastnost, kterou klienti
CalDAV používají pro pozvánky. SabreDAV odpoví prvním kalendářem, který
uživatel vlastní; kalendáře sdílené kolegy nejsou nikdy výchozí.
Nastavení telefonu
Přidejte účet Exchange / ActiveSync s adresou a heslem schránky a názvem hostitele vašeho poštovního serveru a pak ověřte, že je pro tento účet zapnutá synchronizace kalendáře a kontaktů. Testováno s aplikací Gmail v Androidu; ostatní klienti ActiveSync by se měli chovat stejně, ale testováni nebyli.
Když je server DAV vypnutý nebo nefunkční
Kombinovaný backend Z-Push odmítne celé přihlášení, pokud ho odmítne kterýkoli z jeho backendů, takže bez opatření by server DAV, který neodpovídá, vyřadil ActiveSync pro všechny uživatele, včetně pošty. Doplněk tomu brání:
- pokud server DAV při přihlášení neodpoví tak, jak má (například když je DAV v nastavení vypnutý), backendy kalendářů a kontaktů přihlášení přijmou bez složek;
- telefon dál synchronizuje poštu (nová pošta se doručí ve stejné odpovědi) a kalendáře a kontakty odstraní při příští synchronizaci složek;
- když server DAV znovu funguje, kalendáře a kontakty se vrátí samy.
Log Z-Push pak ukazuje the DAV server is not answering ... mail goes on.
Instalace do existující instalace: zařízení se musí znovu synchronizovat
Sestavte a spusťte image podle Instalace. Doplněk mění konfiguraci Z-Push a s ní i identifikátory poštovních složek; telefon, který už synchronizoval, by dostal nové složky, aniž by se odstranily ty staré (zdvojené poštovní složky). Hned po prvním spuštění s doplňkem požádejte každé zařízení o úplnou novou synchronizaci (resync):
# every user/device pair known to Z-Push
docker exec <container> sh -c 'cd /opt/z-push && runuser -u www-data -- php z-push-admin.php -a list'
# one pair (device ids are listed without dashes)
docker exec <container> runuser -u www-data -- php /opt/z-push/z-push-admin.php -a resync -u <user> -d <device>
# or all pairs at once
docker exec <container> sh -c 'cd /opt/z-push && runuser -u www-data -- php z-push-admin.php -a list | awk "NF == 2 && \$1 != \"Device\" && \$1 !~ /^-/" | while read -r d us; do for u in $(echo "$us" | tr , " "); do runuser -u www-data -- php z-push-admin.php -a resync -u "$u" -d "$d"; done; done'
Každý telefon pak při příští synchronizaci začne znovu od prázdného seznamu složek (může být potřeba otevřít poštovní aplikaci). Zprávy zůstávají na serveru; telefon je jen znovu stáhne.
Nové sestavení image nebo aktualizace Poste.io s doplňkem uvnitř resync
nevyžaduje: konfigurace zůstává stejná a stav Z-Push je uložen na svazku
/data (/data/zpush).
Odebrání doplňku
Odeberte z Dockerfile blok ActiveSync: calendars and contacts, sestavte image znovu, znovu vytvořte kontejner a pak znovu synchronizujte všechna zařízení jako výše (identifikátory složek se změní zpět).
Aktualizace Poste.io
activesync-dav-install.sh kontroluje každý řádek, který v konfiguraci Z-Push
mění, a zastaví sestavení, pokud některý z nich není přesně takový, jak
se očekává. Vydání Poste.io, které změní Z-Push, tedy sestavení hlasitě
přeruší, místo aby vytvořilo napůl nakonfigurovaný image.
Omezení
- Složitá opakování se v telefonu zjednoduší (omezení Z-Push): například „měsíčně 2. a 3. den“ dorazí jako „měsíčně 2. den“. Událost na serveru zůstane nedotčená.
- Žádné zjišťování volna/obsazenosti při zvaní: Z-Push ho implementuje jen pro Kopano, ne pro CalDAV. Ke zobrazení kalendáře kolegy použijte sdílení jen pro čtení.
- Žádný sdílený ani globální adresář: server DAV v Poste.io sdílí kalendáře, ne adresáře.
- Všechny adresáře uživatele se zobrazí jako jedna složka kontaktů (backend CardDAV v Z-Push); nové kontakty z telefonu jdou do prvního adresáře.
- Úkoly: Z-Push zobrazuje každý kalendář dvakrát, jako události a jako úkoly.
Jak to funguje
Konfigurace měněná skriptem activesync-dav/activesync-dav-install.sh
(3 řádky ve 2 souborech; každý, i nastavení Poste.io, na která backendy
spoléhají, se zkontroluje dřív, než se cokoli zapíše):
Soubor (v /opt/z-push) |
Změna |
|---|---|
config.php |
žádná: Poste.io nastavuje BACKEND_PROVIDER při každém startu (BackendCombined, když je DAV zapnutý) |
backend/combined/config.php |
backend kalendářů c → BackendPosteCalDAV, backend kontaktů d → BackendPosteCardDAV (mapování složek z Poste.io zůstává) |
backend/caldav/config.php |
žádná: server, port a cesta jsou ty, které zapisuje Poste.io |
backend/carddav/config.php |
výchozí cesta /dav/addressbooks/%u/ místo …/default/: nové kontakty jdou do prvního adresáře uživatele, žádný „default“ se nevytváří |
Soubory nainstalované v /opt/z-push/backend/:
| Soubor | Role |
|---|---|
postecaldav/postecaldav.php |
BackendPosteCalDAV, rozšiřuje BackendCalDAV ze Z-Push |
postecarddav/postecarddav.php |
BackendPosteCardDAV, rozšiřuje BackendCardDAV ze Z-Push |
postecaldav/postedav.php |
pomocník pro PROPFIND sdílený oběma |
Oba backendy komunikují se serverem DAV uvnitř kontejneru, na adrese, kterou
nastavuje Poste.io, pomocí přihlašovacích údajů, se kterými se přihlásil telefon (HTTP Basic, heslo
schránky). Každé přihlášení začíná jedním PROPFIND, který je zároveň
kontrolou stavu serveru DAV. Balíček Debianu libawl-php (potřebuje ho klient
CalDAV v Z-Push) je součástí Poste.io od verze 2.5.24; Dockerfile ho přesto
instaluje, neškodně, aby doplněk na tom nezávisel; jeho adresář přidává do
include path PHP pouze backend.
Obejité problémy Z-Push
Nalezeny při testování Z-Push 2.7.5 proti serveru DAV v Poste.io a opraveny ve dvou backendech bez úprav vlastních souborů Z-Push:
- Událost odmítnutá serverem byla telefonu potvrzena jako uložená.
BackendCalDAVnikdy nekontroluje výsledek PUT, takže událost zapsaná do sdíleného kalendáře jen pro čtení zůstala v telefonu, zatímco ji nikdo jiný neviděl. Nyní je odmítnutý zápis nebo smazání pro zařízení chybou. - Kontakt přidaný uživatelem bez adresáře shodil Z-Push (nedostatek paměti, HTTP 500 pro celou synchronizaci včetně pošty, telefon to zkoušel donekonečna znovu). Nyní uživatel bez adresáře nemá složku kontaktů a kontakt, který se přesto odešle, dostane chybu.
- Vypnutý server DAV vyřadil ActiveSync, viz výše.
Řešení potíží
- Logy Z-Push:
/var/log/z-push/z-push.logaz-push-error.logv kontejneru. Řádky doplňku začínajíBackendPosteCalDAV,BackendPosteCardDAVneboPosteDAV. - Co má zařízení:
z-push-admin.php -a list -u <user> -d <device>(spuštěno jakowww-data, viz výše) ukáže složky a synchronizovaná data (Emails,Calendars,Tasks,Contacts). - Kalendáře chybí všem: zkontrolujte, že je DAV v nastavení zapnutý;
s vypnutým DAV odpovídá
/dav/Enable DAV at your server settings. - Kalendáře chybí jednomu uživateli: tato schránka nemá v administraci kalendář, nebo má telefon pro tento účet vypnutou synchronizaci kalendáře.
Testováno
Poste.io 2.5.24 se Z-Push 2.7.5, Pro (v produkci) a open source (sestaveno a otestováno v kontejneru). V testovacím kontejneru sestaveném z Dockerfile: typy složek a výchozí kalendář, server ↔ telefon pro události a kontakty, sdílení jen pro čtení, uživatelé bez zapnutých funkcí, adresář odstraněný, zatímco ho telefon ještě měl jako složku, DAV vypnutý a znovu zapnutý a migrace již synchronizovaného telefonu s resynchronizací i bez ní.