rigacci.org

User Tools

Site Tools

Trace:
doc:appunti:calendar_contacts_private

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
doc:appunti:calendar_contacts_private [2018/11/21 15:52] – [Installazione del server DAViCal] niccolodoc:appunti:calendar_contacts_private [2024/11/07 11:03] (current) – [Creazione di un calendario di gruppo] niccolo
Line 3: Line 3:
 Su uno smartphone Android è possibile avere la rubrica dei contatti e dei calendari con gli eventi senza passare per i servizi Google? Sembra di sì, anche se è tutt'altro che semplice! Su uno smartphone Android è possibile avere la rubrica dei contatti e dei calendari con gli eventi senza passare per i servizi Google? Sembra di sì, anche se è tutt'altro che semplice!
  
 +In pratica è necessario installare un server che fornisca il servizio tramite i protocolli DAV, nel nostro caso abbiamo utilizzato **DAViCal** su Debian. Sul terminale Android si deve installare un client opportuno, la nostra scelta è caduta su **DAVdroid**. Infine è necessario adottare diversi accorgimenti per poter **esportare** i calendari e i contatti esistenti e verificare che la **sincronizzazione** col server remoto avvenga correttamente.
 ===== Installazione del server DAViCal ===== ===== Installazione del server DAViCal =====
  
-Con **Apache 2.4** abbiamo definito un **VirtualHost** solo su HTTPS. Chi fa accesso usando HTTP viene rediretto per evitare che trasmetta password in chiaro sulla rete. Questa la configurazione da aggiungere:+In Debian 9 Stretch esiste il pacchetto **DAViCal** versione 1.1.5, per convenienza esiste anche il **[[https://packages.debian.org/stretch-backports/|backport]]** della **versione 1.1.7**, che abbiamo preferito. Per soddisfare le dipendenze è necessario prendere dai backports anche il pacchetto **libawl-php** versione **0.59**. 
 + 
 +È necessario un **database di supporto**, nel nostro caso abbiamo utilizzato **PostgreSQL**. La procedura di installazione è abbastanza //sui generis//, in quanto richiede che venga predisposto l'accesso al database senza password (per fortuna è possibile revocarlo al termine dell'installazione). Vedere gli appunti nel paragrafo **[[https://www.rigacci.org/wiki/doku.php/doc/appunti/linux/sa/davical?s[]=caldav#installazione_del_server_davical|Installazione del server DAViCal]]**. 
 + 
 +In **Apache 2.4** abbiamo definito un **VirtualHost** solo su HTTPS. Chi fa accesso usando HTTP viene rediretto per evitare che trasmetta password in chiaro sulla rete. Questa la configurazione da aggiungere:
  
 <file> <file>
Line 44: Line 49:
 </VirtualHost> </VirtualHost>
 </file> </file>
 +
 +L'URL base del server sarà **%%https://dav.server.org/dav/%%** e sarà accessibile sia con il protocollo WebDAV che con il protocollo HTTPS.
 +
 +L'accesso in HTTPS presenta un'interfaccia minimale di amministrazione web: sarà possibile creare utenti (//principals//), creare address book e calendar (//collections//), ma per le normali operazioni di gestione contatti ed eventi si dovrà utilizzare un client dedicato. Nel nostro caso il client è rappresentato dalla app **DAVdroid** installata su uno smartphone Android, che darà accesso ai contatti e agli eventi di calendario a tutte le app relative.
 ===== Creazione di un utente con address book e calendar ===== ===== Creazione di un utente con address book e calendar =====
  
Line 60: Line 69:
  
 In generale non sarà necessario ricordare il percorso completo dei due oggetti, con l'**autodiscover** dovrebbe essere sempre sufficiente indicare solo l'**URL base del server** e gli oggetti disponibili dovrebbero essere automaticamente mostrati. In generale non sarà necessario ricordare il percorso completo dei due oggetti, con l'**autodiscover** dovrebbe essere sempre sufficiente indicare solo l'**URL base del server** e gli oggetti disponibili dovrebbero essere automaticamente mostrati.
-===== Installazione di DAVdroid =====+===== Installazione di DAVx5 =====
  
-Esistono diverse app per Android per la **sincronizzazione** di **contatti** ed **eventi** calendario verso server **DAV**. Purtroppo si tratta spesso di app che offrono solo una delle due funzionalità e spesso le versioni free hanno limitazioni o problemi (ad esempio continui alert se la connessione con il server fallisce). Pare invece che l'app **[[https://play.google.com/store/apps/details?id=at.bitfire.davdroid|DAVdroid]]** abbia tutte le carte in regola per essere scelta: si tratta di **software open source** disponibile anche su **[[https://f-droid.org/en/packages/at.bitfire.davdroid/|F-Droid]]** e sembra sufficientemente stabile e maturo.+Esistono diverse app per Android per la **sincronizzazione** di **contatti** ed **eventi** calendario verso server **DAV**. Purtroppo si tratta spesso di app che offrono solo una delle due funzionalità e spesso le versioni free hanno limitazioni o problemi (ad esempio continui alert se la connessione con il server fallisce). Pare invece che l'app **[[https://play.google.com/store/apps/details?id=at.bitfire.davdroid|DAVx5]]** (prima conosciuto come **DAVdroid**) abbia tutte le carte in regola per essere scelta: si tratta di **software open source** disponibile anche su **[[https://f-droid.org/en/packages/at.bitfire.davdroid/|F-Droid]]** e sembra sufficientemente stabile e maturo.
  
-{{ .:davdroid:davdroid-account.png?direct&180|DAVdroid Account}}+{{ .:davdroid:davdroid-account.png?direct&180|DAVx5 Account}}
 Una volta scaricata e installata l'app, si deve **creare un nuovo account** sullo smartphone. Nel nostro caso si procede con l'opzione **Login with URL and user name**. Con l'installazione di DAViCal vista in precedenza si inserisce qualcosa del genere: Una volta scaricata e installata l'app, si deve **creare un nuovo account** sullo smartphone. Nel nostro caso si procede con l'opzione **Login with URL and user name**. Con l'installazione di DAViCal vista in precedenza si inserisce qualcosa del genere:
  
Line 71: Line 80:
 ^ Password   | %%******%%  | ^ Password   | %%******%%  |
  
-Lasciare attiva l'opzione predefinita **Groups are separate VCards**. Il server DAViCal support il formato [[wpit>VCard|vCard]] v.3.0 e quindi DAVdroid gestirà i gruppi come vCard separate (i gruppi sono usati ad esempio per creare le etichette da assegnare ai contatti). Vedere il paragrafo //Contact group method// nella [[https://www.davdroid.com/manual/accounts/|documentazione sugli Account]].+Lasciare attiva l'opzione predefinita **Groups are separate VCards**. Il server DAViCal support il formato [[wpit>VCard|vCard]] v.3.0 e quindi DAVx5 gestirà i gruppi come vCard separate (i gruppi sono usati ad esempio per creare le etichette da assegnare ai contatti). Vedere il paragrafo //Contact group method// nella [[https://www.davdroid.com/manual/accounts/|documentazione sugli Account]].
  
-DAVdroid si collega al server e tramite l'**autodiscovery** sul percorso **%%/.well-known/%%** si accorge che esistono già due //collection// collegate all'account: un **addressbook** e un **calendar**. Per impostazione predefinita infatti DAViCal crea queste due collection per ogni //principal// di tipo //person// (cioè per ogni account) che viene creato. Nella schermata che segue (vedi figura) bisogna attivare la sincronizzazione per queste due //collection//.+DAVx5 si collega al server e tramite l'**autodiscovery** sul percorso **%%/.well-known/%%** si accorge che esistono già due //collection// collegate all'account: un **addressbook** e un **calendar**. Per impostazione predefinita infatti DAViCal crea queste due collection per ogni //principal// di tipo //person// (cioè per ogni account) che viene creato. Nella schermata che segue (vedi figura) bisogna attivare la sincronizzazione per queste due //collection//.
  
 Questo è ciò che compare nello smartphone: Questo è ciò che compare nello smartphone:
  
   * Strumenti => **Utenti e account**   * Strumenti => **Utenti e account**
-    * Compare un nuovo account di tipo **DAVdroid**, identificato con l'indirizzo email. Da questo account dipendono tutti i calendari e le rubriche che verranno sincronizzate col server. +    * Compare un nuovo account di tipo **DAVx5**, identificato con l'indirizzo email. Da questo account dipendono tutti i calendari e le rubriche che verranno sincronizzate col server. 
-    * Compare anche un nuovo account di tipo **Rubrica DAVdroid**, identificato con il //Displayname// definito da DAViCal e l'indirizzo email più due lettere casuali. Questo account //figlio// è necessario per una **limitazione di Android**; la rubrica contatti infatti deve essere direttamente collegata ad uno specifico account, quindi l'account **DAVdroid** (padre) deve esporre un account **Rubrica DAVdroid** (figlio) per ogni rubrica contatti disponibile sul server. Questo non accade per i calendari: il singolo account padre è sufficiente per accederli tutti.+    * Compare anche un nuovo account di tipo **Rubrica DAVx5**, identificato con il //Displayname// definito da DAViCal e l'indirizzo email più due lettere casuali. Questo account //figlio// è necessario per una **limitazione di Android**; la rubrica contatti infatti deve essere direttamente collegata ad uno specifico account, quindi l'account **DAVx5** (padre) deve esporre un account **Rubrica DAVx5** (figlio) per ogni rubrica contatti disponibile sul server. Questo non accade per i calendari: il singolo account padre è sufficiente per accederli tutti.
  
 Maggiori dettagli nella pagina **[[https://www.davdroid.com/manual/accounts/|Accounts del manuale di DAVdroid]]**. Maggiori dettagli nella pagina **[[https://www.davdroid.com/manual/accounts/|Accounts del manuale di DAVdroid]]**.
Line 86: Line 95:
 Il sistema Android usa **tecniche aggressive per il risparmi di batteria**, questo affligge soprattutto le app non di sistema tipo DAVdroid. In pratica accade che **viene inibita la sincronizzazione** con il server: quando l'app è in background non viene mai svegliata. Il sistema Android usa **tecniche aggressive per il risparmi di batteria**, questo affligge soprattutto le app non di sistema tipo DAVdroid. In pratica accade che **viene inibita la sincronizzazione** con il server: quando l'app è in background non viene mai svegliata.
  
-Avviando l'app DAVdroid si viene avvisati di questo potenziale problema da tre pop-up:+Avviando l'app DAVx5 si viene avvisati di questo potenziale problema da tre pop-up:
  
   * Battery ... ?   * Battery ... ?
Line 95: Line 104:
  
 Nel nostro caso Android 8.1.0 Oreo su Xiaomi Mi A1, è stato necessario ... FIXME Nel nostro caso Android 8.1.0 Oreo su Xiaomi Mi A1, è stato necessario ... FIXME
 +
 ===== Creazione di un calendario aggiuntivo ===== ===== Creazione di un calendario aggiuntivo =====
  
Line 168: Line 178:
 Sullo smartphone è necessaria una sincronizzazione per vedere l'effetto: Sullo smartphone è necessaria una sincronizzazione per vedere l'effetto:
  
-  * Dalla app **DAVdroid** => Tap su account => CalDAV => [[wp>Hamburger button]] => **Refresh calendar list**.+  * Dalla app **DAVx5** => Tap su account => CalDAV => [[wp>Hamburger button]] => **Refresh calendar list**.
   * **Chiudere** l'app **Calendario**.   * **Chiudere** l'app **Calendario**.
-  * Da **Impostazioni** => //Utenti e account// => //DAVdroid// => //Sincronizzazione account// => **Sincronizza ora**.+  * Da **Impostazioni** => //Utenti e account// => //DAVx5// => //Sincronizzazione account// => **Sincronizza ora**.
  
  
Line 183: Line 193:
  
 Per effettuare la corretta esportazione dei calendari è stato necessario riattivare la App Google e forzare la sincronizzazione. Per effettuare la corretta esportazione dei calendari è stato necessario riattivare la App Google e forzare la sincronizzazione.
 +
 +===== Creazione di un calendario di gruppo =====
 +
 +Scenario: si vuole creare un calendario e condividerlo con due o più utenti.
 +
 +=== Creazione di un Principal di tipo Group ===
 +
 +Il //principal// di tipo //group// avrà il suo login e la sua password, ma le credenziali non verranno condivise con gli utenti che avranno accesso al calendario. Il calendario (in effetti una //collection//) sarà creato come appartenente a questo gruppo.
 +
 +  * User Functions => Create Principal
 +    * Username: caldavtest@domain.tld
 +    * Password: %%******%%
 +    * Fullname: Gruppo per calendario condiviso
 +    * Email Address: caldavtest@domain.tld
 +    * Principal Type: Group
 +
 +=== Aggiunta degli User al Group ===
 +
 +FIXME Serve davvero? Oppure è sufficiente creare il Ticket (vedi avanti)?
 +
 +  * User Functions => List Groups => (click su ID)
 +    * Group Members => (select the user) => Add
 +    * Group Members => (select the user) => Add
 +
 +=== Creazione di un Calendar Collection nel Group ===
 +
 +  * User Functions => List Groups => (click su ID)
 +    * Principal Collections => Create Collection
 +      * DAV Path: /dav/caldav.php/caldavtest@domain.tld/calendar/
 +      * Displayname: Calendario condiviso
 +      * Is a Calendar: [x]
 +      * Default Privileges: [x]
 +      * alendar Timezone: Europe/Rome
 +      * Collection Grants:
 +        * (select the group): ALL (FIXME Serve davvero? O basta il ticket?)
 +        * <del>(select the user): ALL (FIXME Serve davvero? O basta il ticket?)</del>
 +        * <del>(select the user): ALL (FIXME Serve davvero? O basta il ticket?)</del>
 +
 +L'URL completo del calendario è **%%https://dav.domain.tld/dav/caldav.php/caldavtest@domain.tld/calendar/%%**, ma non si userà questo per l'accesso. La risorsa verrà ricollocata (**bind**) come risorsa di ciascun utente.
 +
 +=== Creazione di un Access Ticket per la Collection ===
 +
 +  * User Functions => List Groups => (click su ID)
 +    * Access Tickets
 +      * Ticket ID: Nfe5wq0Y
 +      * Target: /caldavtest@domain.tld/calendar/
 +      * Expires: 2029-12-29
 +      * Privileges: ALL
 +
 +=== Binding della Calendar Collection allo User ===
 +
 +Con questa operazione, il calendario condiviso (che ha URL **%%/caldavtest@domain.tld/calendar/%%**) verrà mappato come risorsa dell'utente (con URL **%%/user1@domain.tld/boundcalendar/%%**):
 +
 +  * User Functions => List Users => (click su ID)
 +    * Bindings to other collections
 +      * ID Bounds As: /user1@domain.tld/boundcalendar/
 +      * Display Name: Calendario condiviso
 +      * To Collection: /caldavtest@domain.tld/calendar/
 +      * Ticket ID: Nfe5wq0Y
 +
 +L'URL completo del calendario diventa quindi **%%https://dav.domain.tld/dav/caldav.php/user1@domain.tld/boundcalendar/%%**. In generale non si dovrà indicare l'URL per esteso, perché il client (es DAVx5 su Android) elencherà il nuovo calendario nell'elenco di quelli disponibili, con l'etichetta impostata in //Displayname//.
 +
 +=== Utilizzo dei ticket ===
 +
 +**%%https://dav.domain.tld/dav/caldav.php/user1@domain.tld/calendar/?ticket=7edu4Cpt%%**
 +
 +===== Aggiornamento del database di backend =====
 +
 +Dopo l'aggiornamento da Debian 9 Stretch a **Debian 10 Buster**, quando ci si collega all'interfaccia web di Davical (nella nostra installazione è qualcosa del tipo **%%https://dav.host.tld/dav/%%**), si legge il seguente warning:
 +
 +<code>
 +Database schema needs upgrading. Current: 1.3.2, Desired: 1.3.3
 +</code>
 +
 +Si è deciso di agire da riga di comando. Anzitutto si crea un file **/etc/davical/administration.yml** con le credenziali per accedere al database (proteggere il file con **mode 600**):
 +
 +<file>
 +admin_db_user: davical_dba
 +admin_db_pass: MySecret
 +admin_db_host: 127.0.0.1
 +</file>
 +
 +Quindi si esegue lo script **/usr/share/davical/dba/update-davical-database** che provvede ad applicare tutte le patch incrementali allo schema del database. Ovviamente si consiglia di fare un backup del database **prima** di eseguire la procedura.
 +
doc/appunti/calendar_contacts_private.1542811921.txt.gz · Last modified: by niccolo