WebTop groupware

Contenuti

WebTop groupware#

WebTop è un groupware completo che implementa Protocolli ActiveSync, CalDAV e CardDAV.

È possibile installare più istanze WebTop sullo stesso nodo dal Software center.

Configurazione#

WebTop ha bisogno di un host virtuale dedicato, un FQDN come webtop.nethserver.org.

Prima di procedere con la configurazione, assicurarsi di creare il relativo record all’interno del server DNS. Se hai intenzione di utilizzare un certificato Let’s Encrypt come predefinito, assicurati anche di avere un record DNS pubblico corrispondente.

Come configurare:

  1. accedere alla pagina di configurazione dell’applicazione e inserire un FQDN valido all’interno del campo Host virtuale WebTop (FQDN)

  2. abilitare Richiedi certificato Let's Encrypt

  3. collegare l’istanza WebTop ad un Mail server esistente

  4. selezionare la Localizzazione predefinita e il Fuso orario predefinito

  5. cliccare sul pulsante Save

All’interno della sezione Avanzate, è inoltre possibile configurare:

  • la modalità debug

  • livelli di log

  • memoria minima e massima

Autenticazione#

Utilizzare sempre il formato completo del nome utente <utente>@<dominio> per accedere all’applicazione web e Active Sync.

Esempio

  • Nome del server: mymail.mightydomain.com

  • Dominio di posta alternativo: baddomain.net

  • Utente: goofy

  • Login: goofy@mightydomain.com

Nota

Il protocollo Active Sync è supportato solo su dispositivi Android e iOS. Outlook non è supportato.

Utente amministratore#

Dopo l’installazione, WebTop sarà accessibile utilizzando l’utente amministratore. L’utente amministratore può modificare le impostazioni globali e accedere come qualsiasi altro utente, tuttavia, non è un utente di sistema e non può accedere a qualsiasi altro servizio come Posta, Calendari, ecc.

Le credenziali di default sono:

  • Utente: admin

  • Password: admin

La password dell’utente dell’amministratore deve essere modificata dall’interfaccia di WebTop.

Avvertimento

Ricorda di cambiare la password di amministratore dopo l’installazione!

Per controllare la posta dell’account admin di sistema, utilizzare il seguente login: admin@<dominio> dove <dominio> è il TLD dell’FQDN.

Esempio

Cambiare password di admin#

Accedere a WebTop utilizzando l’utente admin, quindi aprire le impostazioni dell’utente facendo clic sul menu hamburger nell’angolo in alto a destra.

Andare in Impostazioni quindi fare clic su Cambia password.

Gestione delle impostazioni utente#

La maggior parte delle impostazioni utente può essere gestita direttamente dall’utente stesso tramite il menu delle impostazioni. Le impostazioni bloccate richiedono privilegi amministrativi.

L’amministratore può impersonare utenti, per controllare gli account esistenti utilizzando credenziali di login speciali:

  • ** Nome utente** : admin!<username>

  • Password: <WebTop admin password>

Mentre si assume l’identità di un utente si ricevono gli stessi privilegi dell’utente, avendo la possibilità di controllare ciò che l’utente può vedere. La gestione completa delle impostazioni dell’utente è disponibile direttamente nell’interfaccia di amministrazione, cliccando con il pulsante destro del mouse su un utente: il menu impostazioni aprirà il pannello delle impostazioni complete dell’utente, con tutte le opzioni sbloccate.

È inoltre possibile modificare l’email di tutti gli utenti selezionati:

  1. selezionare gli utenti (Click + CTRL per la selezione multipla)

  2. cliccare con il pulsante destro del mouse su Aggiorna il dominio email

Autenticazione a due fattori (2FA)#

WebTop supporta two factor Authentication. L’utente può scegliere tra:

Per abilitare 2FA:

  • cliccare sul pulsante del menù in alto a destra e selezionare l’icona Impostazioni

  • quindi selezionare Sicurezza (OTP) e fare clic sul pulsante Attiva

_images/webtop-2fa.png

Sincronizzazione ActiveSync (EAS)#

I dispositivi mobili possono essere sincronizzati con ActiveSync. Active Sync può essere utilizzato solo per contatti e calendari.

Apple iOS#

Accedi al tuo iOS device, naviga su Impostazioni e aggiungi un account Exchange seguendo la guida ufficiale.

Compila i campi richiesti con:

  • E-mail: aggiungi il tuo indirizzo email, ad esempio: goofy@nethserver.org

  • Server: aggiungi il nome pubblico del tuo server, ad esempio: mail.nethserver.org

  • Domain: lasciare vuoto

  • ** Nome utente** : inserisci il tuo nome utente completo di dominio, ad esempio: goofy@nethserver.org

  • Password: inserire la password

Nota

i dispositivi iOS richiedono un certificato SSL valido sul server. Vedi Certificati TLS

Google Android#

Accedi al tuo Android device, naviga nelle Impostazioni, quindi seleziona Aggiungi account -> Exchange (o Aziendale per le versioni precedenti).

Compila i campi richiesti con:

  • ** Nome utente** : inserisci il tuo nome utente completo di dominio, ad esempio: goofy@nethserver.org

  • Password: inserire la password

Quindi selezionare Configurazione manuale e modificare il nome del campo Server con il nome pubblico del server. Infine, se hai un certificato autofirmato sul tuo server, assicurati di selezionare l’opzione SSL/TLS (accetta tutti i certificati).

Nota

Su alcune versioni Android (in particolare Samsung), il nome utente e il dominio devono essere inseriti nella stessa riga. In questo caso, lasciare vuoto il campo prima del carattere backslash \, e inserire il nome utente nel seguente formato: \goofy@nethserver.org

Calendario e contatti multipli#

I calendari e i contatti condivisi possono essere sincronizzati utilizzando il protocollo ActiveSync.

Le risorse condivise vengono visualizzate con il nome e la categoria del proprietario. Il numero tra parentesi quadrate è l’ID interno. Gli eventi privati non sono sincronizzati.

Dispositivi mobili basati su Apple iOS supportano completamente cartelle/categorie per calendari, contatti e attività (chiamati promemoria), compresi i colori originali.

I dispositivi mobili basati sul Android supportano solo calendari e contatti, le attività non sono supportate. Utilizzando l’applicazione Google Calendar tutti gli elementi avranno lo stesso colore.

Installazione e utilizzo dell’applicazione CloudCal, è possibile modificare i colori associati a ciascun calendario, compresi quelli condivisi.

Su dispositivi Android, i contatti da rubriche condivise vengono uniti con la rubrica personale e visualizzati in una sola vista. I contatti possono essere modificati e le modifiche verranno salvate nella sorgente originale.

Nota

Al fine di ricevere i dati tramite EAS sui dispositivi mobili, le risorse condivise (Calendari e contatti) dovrebbero avere attivato la sincronizzazione (con permessi completi o in sola lettura):

Sincronizzazione multipla

È possibile attivare o disattivare la sincronizzazione per ogni risorsa condivisa.

Per farlo, basta cliccare con il pulsante destro del mouse sulla risorsa condivisa Personalizza → Sincr. Dispositivi:

Sync condiviso EAS

L’impostazione predefinita è Non attivo.

Sincronizzazione CalDAV e CardDAV#

I calendari e le rubriche possono essere sincronizzate anche attraverso i protocolli CalDAV e CardDAV.

Per sincronizzare un calendario, selezionare il link URL facendo clic con il tasto destro del mouse sul calendario e selezionando Collegamenti al calendario, quindi utilizzarlo per configurare il client di terze parti.

Per sincronizzare una rubrica, selezionare il link URL` facendo clic con il pulsante destro del mouse sulla rubrica e selezionando Collegamenti alla rubrica, quindi usarlo per configurare il client di terze parti.

Per autenticare, fornire le credenziali nel seguente modulo:

  • ** Nome utente** : inserisci il tuo nome utente completo di dominio (es: goofy@nethserver.org)

  • Password: inserire la password

Alcuni client di terze parti permettono di semplificare la configurazione tramite la funzione auto-discovery che scopre automaticamente le risorse sincronizzabili, come nel caso dei dispositivi mobili (ad esempio dispositivi Android o iOS).

Nota

Se si utilizzano client che non supportano l’auto-discovery, è necessario utilizzare l’URL completo: https://<server_name>/webtop-dav/server.php

Se si utilizzano client che supportano l’auto-discovery utilizzare l’URL: https://<server_name>

Google Android#

Un buon client di terze parti Android è Opensync .

  • installare l’app suggerita dallo store

  • aggiungere un nuovo account cliccando sul + e selezionare Login con URL e username

  • inserire URL (https://<server_name>), nome utente completo (es: goofy@nethserver.org) e password

  • clicca sul nuovo profilo e seleziona le risorse che vuoi sincronizzare

Apple iOS#

Il supporto CalDAV/CardDAV è integrato e nativo su iOS, quindi per configurarlo:

  • andare su Impostazioni -> Account e Password - > Aggiungi account

  • selezionare Altro -> Aggiungi CalDAV o CardDAV account

  • inserire il nome del server (es: server.nethserver.org), il nome utente completo (es: goofy@nethserver.org) e la password

Client desktop#

Thunderbird

Thunderbird include già il supporto per i calendari CalDAV. Per sincronizzare i contatti con CardDAV è necessario un add-on di terze parti come Cardbook .

Outlook

Il plugin Open Source CalDAV Synchronizer per Outlook supporta sia CardDAV che CalDAV.

Avvertimento

Webtop è un groupware client-less: le sue funzionalità sono completamente disponibili solo utilizzando l’interfaccia web !

L’uso di CalDAV/CardDAV attraverso clienti di terze parti non può essere considerato un’alternativa all’interfaccia web.

Condivisione e-mail#

È possibile condividere una singola cartella o l’intero account con tutte le sottocartelle. Selezionare la cartella da condividere -> click destro -> Gestisci condivisione:

_images/webtop-sharing_mail_folder_1.png
  • selezionare l’utente per condividere la risorsa (1)

  • selezionare se si desidera condividere la propria identità con l’utente e anche forzare la firma (2)

  • scegliere il livello di autorizzazioni associate a questa quota (3)

  • se è necessario modificare ulteriormente le autorizzazioni, selezionare Avanzate (4)

  • infine, scegliere se applicare la condivisione solo alla cartella da cui hai iniziato, o solo al ramo delle sottocartelle o all’intero account (5)

_images/webtop-sharing_mail_folder_2.png

Nota

L’opzione: Forza firma può essere utilizzata solo se la firma è stata associata all’indirizzo di posta.

Condivisione calendari e contatti#

Condivisione Calendari#

Puoi condividere ogni calendario personale singolarmente. Selezionare il calendario da condividere -> click destro -> Condivisione e permessi:

_images/webtop-sharing_cal_1.png

Selezionare l’utente destinatario della condivisione (o Gruppo) e abilitare le autorizzazioni sia per la cartella che per i singoli elementi:

_images/webtop-sharing_cal_2.png

Condivisione Contatti#

Allo stesso modo, è possibile condividere i contatti selezionando la directory che si desidera condividere -> click destro -> :guilabel: Condivisione e permessi. Selezionare l’utente destinatario della condivisione (o Gruppo) e abilitare le autorizzazioni sia per la cartella che per i singoli elementi.

Etichette personalizzate#

È possibile aggiungere una o più etichette nelle e-mail, in un evento di calendario o un’attività.

Ci sono due tipi di etichette:

  • Private: non utilizzabile per campi personalizzati e non visibile ad altri utenti

  • Shared: utilizzabile per pannelli di campi personalizzati e visibile ad altri utenti

L’utente può normalmente gestire solo etichette private. Per gestire le etichette condivise è necessario abilitare una specifica autorizzazione tramite il pannello di amministrazione:

  • andare nel menù Amministrazione, quindi selezionare Domini - > NethServer -> Gruppi - > Utenti - > Authorizzazioni

  • aggiungere (+) -> Servizio -> com.sonicle.webtop.core (WebTop) -> Contesto -> TAGS -> Azione -> MANAGE

  • cliccare OK poi Salve e chiudi

È possibile gestire le etichette tramite il pulsante tools nell’angolo in alto a destra.

La stessa funzionalità può essere raggiunta anche dai singoli moduli facendo clic con il tasto destro -> :guilabel: Etichette -> Gestisci etichette.

La visibilità può essere impostata solo durante la creazione di etichette. Per modificare la visibilità dell’etichetta è necessario eliminare l’etichetta e crearla di nuovo.

Le etichette create possono essere utilizzate in qualsiasi altro modulo come Posta, Rubrica, Calendario e Attività.

Campi personalizzati#

Con i campi personalizzati, è possibile fornire informazioni e dati aggiuntivi per ogni contatto, evento o attività.

Custom fields are only available for the Address Book, Calendar, and Tasks modules and are specific to each different module.

In order to manage custom fields and their panels, the user must have a specific authorization, obtained through the administration panel:

  • andare nel menù Amministrazione, quindi selezionare Domini - > NethServer -> Gruppi - > Utenti - > Authorizzazioni

  • add (+) -> Services -> com.sonicle.webtop.core (WebTop) -> Resource -> CUSTOM_FIELDS -> Action -> MANAGE

  • click OK then save and exit

Users who have this authorization will find the specific button available at the top right:

_images/webtop-cf1.png

To create a new custom field it is necessary to fill in at least the Name field and select the Type:

_images/webtop-cf2.png

For the Name field only alphanumeric characters (including - and _) are allowed. Spaces are not allowed. The Description field is used to add details to the field and the Label field represents the label that will be shown along with the field.

For each field it is possible to enable two options:

  • Show in search bar: the field is added in the multiple search window (a new access will be required)

  • Show in preview: the field is shown in the preview window of a contact

Additional specific properties, that are also customizable, are available for each type.

For the List box type it is necessary to fill in the values to be selected:

_images/webtop-cf4.png

Using the Clone button you can copy the custom field to create similar ones:

_images/webtop-cf5.png

Nota

With the FREE version, installed by default, it is possible to create up to a maximum of 3 custom fields for each different module (3 in Address Book + 3 in Calendar + 3 in Activities). To remove this limit it is necessary to upgrade to the PREMIUM version by purchasing a dedicated license on Nethesis shop

Searches on custom fields#

One of the best functionalities of custom fields is the possibility to perform multiple searches on all modules and fields for which the option Show in search bar has been activated.

Custom panels#

Custom panels display the :ref:`custom_fields-section and associated them with resources.

Users with the authorization to manage custom fields can access the configuration panel using the button at the top right:

_images/webtop-panels.png

When creating a new panel it is mandatory to indicate the Name that will appear in the resource. You can also insert a Description and a Title.

Using shared labels, you can easily assign panels to specific resource categories. A panel without an associated label will be visible for every available resource: all contacts, all events or all activities.

Use the Add button to add a custom field inside the panel.

Mailcards#

One of the main features of managing signatures on WebTop is the opportunity to integrate images or custom fields profiled per user.

To use the images you need to upload them to the public cloud through the WebTop admin user like this:

_images/webtop-public_images.png

You can use the Upload button to load an image which is at the bottom or simply via drag & drop.

Nota

Remember that the public images inserted in the signature are actually connected with a public link. To be visible to email recipients, the server must be reachable remotely on port 80 (http) and its FQDN name must be publicly resolvable.

Alternatively, you can configure a global setting to turn images automatically into inline attachments instead of public internet links.

It is possible to do this from web interface by accessing the administration panel -> Properties (system) -> Add -> select com.sonicle.webtop.mail (Mail) and enter the data in the Key and Value fields according to the key to be configured:

public.resource.links.as.inline.attachments = true (default = false)

To change the signature, each user can access the Settings ‣ Mail ‣ Editing ‣ Edit User mailcard:

_images/webtop-edit_mailcard.png

You can use the uploaded image inside the mailcard with this button:

_images/webtop-public_signature.png

Nota

The personal mailcard can be associated with the user or the mail address. Users with access to the mail address will also be able to use the mailcard.

By accessing the user settings from the WebTop administration panel ( Domains ‣ NethServer ‣ Users ‣ Right click on user ) it is also possible to set up a general domain mailcard that will be automatically set for all users who have not configured their personal mailcard:

_images/webtop-domain_mailcard.png

Furthermore, it will also be possible to modify personal details:

_images/webtop-personal_information.png

that can be used within the template-based fields within the domain mailcard editor:

_images/webtop-mailcard_editor.png

In this way it is possible to create a single mailcard that will be automatically customized for every user who does not use his own mailcard.

Multiple mailcards#

It is possible to configure multiple mailcards (HTML signatures) for each user.

Access the Settings ‣ Mail ‣ Identities and create multiple identities:

_images/webtop-sig_sig1.png

To edit every single signature select Settings ‣ Mail ‣ Identities then select each individual signature and click on the edit mailcard button

_images/webtop-sig_sig2.png _images/webtop-sig_sig3.png

When finished, close the window and click YES:

_images/webtop-sig_sig4.png

to use multiple mailcards, create a new email, and choose the signature:

_images/webtop-sig_sig5.png

Mail inline preview#

By default, the mail page will display a preview of the content of the latest received messages.

This feature can be enabled or disabled from the Settings menu, under the Mail tab, the check box is named Show quick preview on message row.

Mail archiving#

Archiving is useful for keeping your inbox folder organized by manually moving messages.

Nota

Mail archiving is not a backup.

The system automatically creates a new special Archives folder

_images/webtop-archive_archive1.png

If the Archives folder does not appear immediately upon login, it will appear at the first archiving.

There are three archiving criteria:

  • Single folder: a single root for all archived emails

  • Per year: a root for each year

  • By year / month: a root for each year and month

_images/webtop-archive_archive2.png

To maintain the original structure of the folders is possible to activate Keep folder structure

_images/webtop-archive_archive3.png

The archiving operation is accessible from the contextual menu (right-click). Click on Archive

_images/webtop-archive_archive4.png

The system will process archiving according to the last settings chosen.

IMAP folders subscription#

By default, all IMAP folders on the server are automatically subscribed and therefore visible since the first login.

If you want to hide some folders from the view, which is equivalent to removing the subscription, you can simply right-click on the folder to hide and select from the interactive menu the item Hide from the list.

For example, if you want to hide the subfolder folder1 from this list, just right-click on it and select Hide from the list:

_images/webtop-sub_imap_folder1.png

It is possible to manage the visibility of hidden folders by selecting the Manage visibility function:

_images/webtop-sub_imap_folder2.png

For example, if you want to restore the subscription of the folder1 just hidden, just select it from the list of hidden folders and click on the icon on the left:

_images/webtop-sub_imap_folder3.png

Customize proactive security on emails#

The Proactive Security module (PAS) warns the end user of possible security risks and suspicious senders inside the emails. The user will also be warned when trying to open potentially dangerous attachments or links contained in emails.

The PAS function allows some customization both for the end user and the WebTop admin.

For the end user it is possible to mark a sender as trusted when it is recognized as such by the yellow shield. To do so, it is possible to click directly on the shield or right click on the sender and select the Mark as trusted entry.

Nota

This type of customization is only valid for the user that performed the action. It is possible to mark a sender as trusted only if the shield is yellow.

The admin user can disable all or some of the rules that are part of the PAS (ProActive Security), both for single users and groups. To do so, it is necessary to add a specific authorization (to the single user or the group of users) for the Service com.sonicle.webtop.mail (Mail) and for the PRO_ACTIVE_SECURITY resource:

_images/webtop-pas1.png

Below is an explanation of every single entry available as Action :

  • DISABLED: completely disables PAS

  • NO_LINK_DOMAIN_CHECK: do not check domains different from the sender’s domain

  • NO_MY_DOMAIN_CHECK: do not verify if the sender’s domain is in my domain

  • NO_FREQUENT_CONTACT_CHECK: do not check if the sender is in my contacts which are saved automatically

  • NO_ANY_CONTACTS_CHECK: do not check if the sender is among one of my contacts

  • NO_FAKE_PATTERNS_CHECK: do not verify the presence of false patterns in the sender (e.g. email address of the name shown is different from the sender’s email address)

  • NO_UNSUBSCRIBE_DIRECTIVES_CHECK: do not check the entry for the unsubscribe directives to the mailing list (only if the spam status is green)

  • NO_DISPLAYNAME_CHECK: do not compare the contact’s display name with the contact in my address book with the same email

  • NO_SPAM_SCORE_VISUALIZATION: do not show/check the spam score displayed in the message header

  • NO_LINK_CLICK_PROMPT: do not check the click action on links

  • NO_ZIP_CHECK: do not give warning about zip attachments

This way it is possible to customize and create special profiles for some users who might not want all the actions to be active.

The administrator can also choose the list of file extensions for attachments which are considered a threat. As default, these are the extensions that are considered dangerous: exe,bat,dll,com,cmd,bin,cab,js,jar

To modify this list it is necessary to add this global setting:

  • Service = com.sonicle.webtop.mail

  • Key = pas.dangerous.extensions

For example, if you wanted to add the HTML extension among those that are considered dangerous, the value field should contain the following:

  • Value = exe,bat,dll,com,cmd,bin,cab,js,jar,html (Values always need to be separated by a comma)

Export events (CSV)#

To export calendars events in CSV (Comma Separated Value) format, click on the tools button in the top right corner and select ERP export (CSV)

Finally, select a time interval and click on Next to export into a CSV file.

Tasks#

Quick view filters#

In the toolbar above the grid there are 7 buttons that allow you to select the most suitable quick view. The first two buttons refer to today’s activities or to those planned within the next 7 days:

_images/webtop-task1.png
  • Today: shows unfinished tasks without a start date or with a start date up to today (inclusive) and those completed with an end date up to today (inclusive)

  • Next 7 days: shows uncompleted tasks with no start date or starting up to 7 days from today and completed tasks with completion date up to now (inclusive)

The remaining 5 buttons allow you to obtain these other types of quick views:

_images/webtop-task2.png
  • Not started: shows only activities with status «To be started» and starting today (inclusive)

  • Late: shows only uncompleted tasks with start date up to today (inclusive) and completion date previous to the current one

  • Completed: shows all activities with status completed and with any date range

  • Not completed: shows all activities with status other than completed and start date within 1 year (for recurring tasks, only the first instance of the series still to be completed is shown)

  • All: shows all activities in any status (for recurring tasks the series icon main is shown)

Recurring tasks#

It is possible to configure any type of recurrence:

_images/webtop-task3.png

Editing a recurring activity can be done in two different ways:

  1. on the individual task by opening it with a double click from a view other than All In this case the task will be removed from the recurrence and its icon will become this one:

_images/webtop-task4.png
  1. on the entire series with a double click from the All view or by using the following button on the single task already open:

_images/webtop-task5.png

Sub-tasks#

On any task it is always possible to add related sub-tasks (one Master/Slave level only) simply by using the right button and selecting Add sub-task Within the connected tasks, both in the master and in the slave, a link is available at the bottom right to open the related tasks:

_images/webtop-task6.png

It is possible to Move or Copy this type of activity (right click -> Move/Copy) by choosing to copy or move the sub-activities through an option active by default.

Multiple searches#

In the bar at the top there is a quick search that is executed on all fields. You can also narrow the search by filling multiple search fields.

_images/webtop-task7.png

Nextcloud integration#

Before proceeding, verify that the Nextcloud module has been installed from the Software center.

By default, Nextcloud integration is disabled for all users. To enable it, use the administration panel which can be accessed using the webtop admin password

If you want to enable the service for all users, proceed as follows:

  1. access the administrative panel and select Groups:

_images/webtop-admin_panel_groups.png
  1. modify the properties of the «users» group by double-clicking and selecting the button related to the Authorizations:

_images/webtop-admin_panel_permission.png
  1. add to existing authorizations those related to both the STORE_CLOUD and STORE_OTHER resources by selecting the items as shown below:

_images/webtop-admin_panel_nextcloud_auth_1.png _images/webtop-admin_panel_nextcloud_auth_2.png

to get this:

_images/webtop-admin_panel_nextcloud_auth_3.png
  1. save and close.

Fron now on, any user it will be able to insert the Nextcloud resource (local or remote) in the personal Cloud.

To do this, simply select the Cloud button and add a new Nextcloud resource by right-clicking on My resources and then Add resource in this way:

_images/webtop-nextcloud_1.png

A pre-filled wizard will open:

_images/webtop-nextcloud_2.png

Nota

Remember to fill in the User name and Password fields related to access to the Nextcloud resource, otherwise it will not be possible to use the public link to the shared files

Nota

If Nextcloud has been configured with a custom virtual host (eg. nextcloud.mydomain.com) the Path must be changed from /nextcloud/remote.php/webdav to /remote.php/webdav, please note that /nextcloud prefix has been removed. Also make sure to enter the name of the custom virtual host inside the Host (eg. nextcloud.mydomain.com).

Proceed with the Next button until the Wizard is complete.

Personal Cloud#

The personal Cloud module allows you to send and receive documents via web links.

Request for a document#

To create the request, insert the subject of the email then select the button at the top right:

_images/webtop-doc_cloud7.png

Follow the wizard. You can set both an expiration date and a password. The link will be automatically inserted into the message:

_images/webtop-doc_cloud8.png

A request email will be sent to upload the document to the Cloud:

_images/webtop-doc_cloud9.png

The sender will receive a notification for each file that will be uploaded:

_images/webtop-doc_cloud10.png

To download the files just access your personal Cloud ‣ Uploads ‣ Folder with date and name:

_images/webtop-doc_cloud11.png

Chat integration#

Web chat integration installation is disabled by default for all users.

To enable chat integration:

  1. Install the «Instant messaging» module from Software Center.

  2. Access WebTop as admin user then enable the web chat authorization:

    • Access the Administration menu, then Domains ‣ NethServer ‣ Groups ‣ Users ‣ Authorizations

    • Add (+) ‣ Services ‣ com.sonicle.webtop.core (WebTop) ‣ Resource ‣ WEBCHAT ‣ Action ‣ ACCESS

    • Click OK then save and close

Jitsi integration#

With this integration it is possible to start a new video conference and send the invitation via email, or schedule one by creating the event directly from the calendar. To activate the integration it is necessary to configure the Jitsi instance that you would like to use directly from admin panel by modifying the documented global settings

By default, the videoconferencing service is disabled for all users. To enable it, for all users it is necessary to add a specific authorization from the administration panel:

  • Access the Administration menu, then Domains ‣ NethServer ‣ Groups ‣ Users ‣ Authorizations

  • Add (+) ‣ Services ‣ com.sonicle.webtop.core (WebTop) ‣ Resource MEETING ‣ Action ‣ CREATE

  • Click OK then save and close

The conference will be available for the users after a new login.

To create a new video conference meeting, you can start from these two buttons:

(top left)

_images/webtop_jitsi1.png

(top right)

_images/webtop_jitsi2.png

It is also possible to do this from a new email window or a new calendar event.

For each new meeting you have to decide whether it should start immediately (instant meeting) or if it should be scheduled by invitation.

There are several ways to share the new meeting link:

_images/webtop_jitsi3.png
  • Start now allows you to immediately access the newly created meeting room and copy the link via the button available next to the URL

  • Send invitation -> Copy meeting invite: in this case an invitation message, which also includes the meeting link, will be copied (e.g: To join the meeting on Jitsi Meet, click this link: …)

  • Send invitation -> Share by email: you will be asked if you would like to change the subject and date of the meeting, which will then be inserted in the newly generated email:

_images/webtop_jitsi4.png
  • Send invitation -> Plan event: also in this case you will be asked if you would like to change the subject and date/time of the meeting before creating the calendar event that will allow you to invite other participants.

If an event contains a link to a third-party video conference, the buttons that will allow you to access the meeting directly:

_images/webtop_jitsi5.png

Third-party video calls#

The video conferencing services that are currently supported, in addition to Jitsi, are: Google Meet, MS Teams and Zoom. It is possible to add additional platforms through a global setting.

SMS integration#

It is possible to send SMS (Short Message Service) messages to a contact that has the mobile number in the address book. To activate sending SMS, first you need to choose one of the two supported providers: smshosting or twilio.

Once registered to the service of the chosen provider, retrieve the API keys (AUTH_KEY and AUTH_SECRET) to be inserted in the WebTop configuration db. The settings to configure are those shown here .

You can do it by accessing the administration panel -> Properties (system) -> Add -> select com.sonicle.webtop.core (WebTop) and enter the data in the Key and Value fields according to the key to be configured:

sms.provider = smshosting or twilio

sms.provider.webrest.user = API AUTH_KEY

sms.provider.webrest.password = API AUTH_SECRET

sms.sender = (default optional)

The sms.sender key is optional and is used to specify the default sender when sending SMS. It is possible to indicate a number (max 16 characters) or a text (max 11 characters).

Nota

Each user can overwrite the sender by customizing it as desired through its settings panel: WebTop -> Switchboard VOIP and SMS -> SMS Hosting service configured -> Default sender

To send an SMS from the address book, right-click on a contact that has the mobile field filled in -> Send SMS

Launcher customization#

The launcher is the icon-based menu on the left of the page. You can add custom buttons to the launcher.

To configure the buttons, access the WebTop administration panel and select -> Domains -> NethServer -> Launcher :

_images/webtop_launchers.png

For each button, enter these three values

  • Name : tab descriptive text that appears with mouse-over

  • Link URL : URL to be opened in a new browser

  • Icon URL : icon image URL, it should always be a publicly reachable address. To avoid scaling problems, use vector images

If you can’t find a public URL for the icon image, you can upload the icon on Webtop public cloud. WebTop public cloud already hosts mailcards images. Access the administrator panel and click on Cloud -> Public Images, then insert a URL like https://<public_name_server>/webtop/resources/156c0407/images/<icon.svg>.

The configured custom link buttons will be shown to all users at the next login.

Browser notifications#

WebTop can notify new mail messages and upcoming calendar events.

To activate it, simply access the general settings of your user:

_images/webtop-desktop_notifications.png

It is possible to enable desktop notifications in two modes:

  • Always: notifications will always be shown, even with the browser open

  • Auto (in background only): notifications will be shown only when the browser is in the background

Make sure to allow notifications inside your browser.

If you need to enable this consent later on a different browser just click on the appropriate button:

_images/webtop-button_desktop_notifications.png

External IMAP accounts (Beta)#

External IMAP accounts can be accessed in read-only mode. Each user can have a maximum of 3 external accounts.

To enable the feature:

  1. Access the administration panel, then selected Properties (system)

  2. Click on Add button and select com.sonicle.webtop.mail

  3. Create a new key named external-account.enabled with value true

  4. Give a specific authorization to the user by setting:

    • Service: com.sonicle.webtop-mail

    • Resource: EXTERNAL_ACCOUNT_SETTINGS

    • Action: CHANGE

Users can now configure personal external accounts by accessing the Settings section.

Subscribing remote resources#

WebTop supports subscriptions to remote calendars and contacts (directory) using CardDAV, CalDAV and iCal.

Remote calendars#

An Internet Calendar can be added and synchronized. To do so just click the right button on personal calendars, Add Internet Calendar. Two types of remote calendars are supported: WebCal (ICS format) and CalDAV.

Nota

Synchronization of Webcal calendars (ICS) is always done by downloading every event on the remote resource every time, while only the differences are synchronized with the CalDAV mode

Example of Google Cal remote calendar (Webcal only - ICS)#

  1. Take the public access ICS link from your Google calendar: Calendar options -> Settings and sharing -> Secret address in iCal format

  2. On WebTop, add an Internet calendar of type Webcal and paste the copied URL without entering the authentication credentials in step 1 of the wizard.

  3. The wizard will connect to the calendar, giving the possibility to change the name and color, and then perform the first synchronization.

Nota

The first synchronization may fail due to Google’s security settings. If you receive a notification that warns you about accessing your resources you need to allow them to be used confirming that it is a legitimate attempt.

Remote contacts (directory)#

Google CardDAV remote address book#

Steps:

  • on Webtop, configure a new Internet address book, right-click on Personal Categories -> Add Internet address book and and enter a URL of this type in step 1 of the wizard: https://www.googleapis.com/carddav/v1/principals/XXXXXXXXXX@gmail.XXX/lists/default/ Replace the X with your GMail account

  • enter the authentication credentials (as user name use the full address of gmail):

    _images/webtop-remote_phonebook.png
  • the wizard in the following steps will connect to the phonebook, giving the possibility to change the name and color, and then perform the first synchronization

You must enable the synchronization into your Google account and enable access for App Password.

Synchronization of remote resources can be performed manually or automatically.

Automatic synchronization#

To synchronize automatically you can choose between three time intervals: 15, 30 and 60 minutes. The choice of the time interval can be made in the creation phase or later by changing the options. To do this, right-click on the phonebook (or on the calendar), Edit Category, Internet Addressbook (or Internet Calendar):

_images/webtop-sync_automatic.png

Sincronizzazione manuale#

Per aggiornare una rubrica remota, ad esempio, fare clic su di essa con il pulsante destro del mouse e quindi selezionare «Sincronizza»:

_images/webtop-sync_google.png

Per le rubriche CardDAV, così come per i calendari di CalDAV remoti, è possibile selezionare se eseguire una sincronizzazione completa o solo per le modifiche. Per fare questo, fare clic con il pulsante destro del mouse sulla rubrica (o sul calendario), Modifica categoria:

_images/webtop-edit_sync_google.png

Selezionare la modalità desiderata accanto al pulsante di sincronizzazione:

_images/webtop-edit_sync_google2.png

Accesso utente e log di sessione utenti#

La tabella che mostra l’intero registro di accessi e sessioni per ogni utente è disponibile sotto il pannello di amministratore. Accedere al menu: Amministrazione, poi Domini –> NethServer –> Audit (dominio) –> Log accessi.

Per ogni accesso, la tabella riporta i seguenti dati nelle colonne: ID sessione, nome utente, data e ora, durata della sessione, stato di autenticazione ed eventuali errori di login.

È possibile abilitare la geolocalizzazione IP pubblica. In primo luogo, è necessario registrare un account su ipstack e ottenere la API KEY da inserire nel db di configurazione.

Login al pannello di amministrazione -> Proprietà (sistema) -> aggiungi -> com.sonicle.webtop.core (WebTop) -> inserire i seguenti dati nei campi Chiave e Valore :

  • geolocation.provider = ipstack

  • geolocation.ipstack.apikey = <API KEY FROM PROVIDER>

Poi, logout e un nuovo login. Per mostrare la geolocalizzazione IP cliccare sull’icona all’estrema destra della riga:

_images/webtop_geologip.png

Impersonate login

Per impostazione predefinita, i login effettuati tramite impersonate (admin!<user>) non vengono visualizzati nella tabella dei log di accesso. Per aggiungere anche questo tipo di accesso, è necessario aggiungere la seguente chiave per il servizio core:

  • chiave = audit.logimpersonated

  • valore = true

Nuova notifica del dispositivo#

È possibile ricevere una e-mail che avvisa quando un nuovo dispositivo accede all’account per la prima volta.

Per impostazione predefinita, per evitare troppi falsi positivi non intenzionali sul primo login, questa funzione è disabilitata per tutti gli utenti.

È possibile personalizzare questa funzione accedendo al pannello di amministratore.

Nota

Per gli accessi effettuati tramite impersonate (admin!<user>) non verranno inviate notifiche via email

Limite massimo della dimensione del file#

Ci sono limiti predefiniti relativi alla dimensione massima del file:

  • Dimensione massima del file per gli upload di chat (impostazione predefinita interna = 10 MB)

  • Dimensione massima del singolo file allegato nel messaggio (impostazione predefinita interna = 10 MB)

  • Dimensione massima del file per caricamenti interni nel cloud (impostazione predefinita interna = 500 MB)

  • Dimensione massima del file per gli upload pubblici nel cloud (impostazione predefinita interna = 100 MB)

Per modificare questi valori predefiniti per tutti gli utenti, le seguenti chiavi possono essere aggiunte tramite l’interfaccia di amministrazione: Proprietà (sistema) `-> `Aggiungi. Il valore deve essere espresso in bytes. Esempio: 10MB = 10485760 bytes.

Dimensione massima del file per gli upload delle chat

  • Servizio: com.sonicle.webtop.core

  • Chiave: im.upload.maxfilesize

Dimensione massima del singolo file allegato nel messaggio

  • Servizio: com.sonicle.webtop.mail

  • Chiave: attachment.maxfilesize

Dimensione massima del file per caricamenti interni sul cloud

  • Servizio: com.sonicle.webtop.vfs

  • Chiave: upload.private.maxfilesize

Dimensione massima del file per gli upload pubblici sul cloud

  • Servizio: com.sonicle.webtop.vfs

  • Chiave: upload.public.maxfilesize

Importa contatti e calendari#

WebTop supporta l’importazione di contatti e calendari da vari formati di file.

Contatti#

Formato di contatti supportati:

  • CSV - Comma Valori separati (*.txt, *.csv)

  • Excel (.*xls, *.xlsx)

  • VCard (*.vcf, *.vcard)

  • LDIF (*.ldif)

Per importare contatti:

  1. cliccare a destra sulla rubrica, quindi selezionare Importare contatti

    _images/webtop-import_contacts1.png
  2. selezionare il formato di importazione e assicurarsi che i campi sul file corrispondono a quelli disponibili su WebTop

    _images/webtop-import_contacts2.png

Se si sta importando una rubrica esportata da Outlook, assicurarsi di impostare Testo qualificante come " valore.

_images/webtop-import_contacts3.png

Calendari#

Formati di calendario supportati: iCalendar (*.ics, *.ical, *.icalendar)

Per importare eventi:

  1. cliccare a destra sul calendario di destinazione, quindi selezionare Importa eventi

    _images/webtop-import_calendars1.png
  2. selezionare il formato di importazione

    _images/webtop-import_calendars2.png
  3. quindi scegliere se si desidera eliminare tutti gli eventi esistenti e importare nuovi, o semplicemente aggiungere i dati importati agli eventi di calendario esistenti

    _images/webtop-import_calendars3.png

Personalizzazione della composizione email#

Nascondere il destinatario auto suggerito#

È possibile disabilitare il suggerimento degli indirizzi salvati automaticamente. Accedere al pannello di amministrazione web -> Proprietà (sistema) -> Aggiungi ->, selezionare com.sonicle.webtop.core (WebTop) e inserire i dati in Chiave e Valore secondo la chiave da configurare:

recipient.provider.auto.enabled = false (default is true)

Modificare oggetto di una mail e salvare#

Per consentire la modifica dell’oggetto sulle e-mail ricevute o inviate, accedere al pannello di amministrazione web -> Proprietà (sistema) -> Aggiungi -> selezionare com.sonicle.webtop.mail (Mail) e inserire i dati nel Chiave e :guilabel: Valore campi secondo la chiave da configurare:

``message.edit.subject``= true (default is false)

Eliminare gli indirizzi email suggeriti automaticamente#

Quando si compila il destinatario di una mail, vengono suggeriti alcuni indirizzi e-mail salvati automaticamente. Se è necessario eliminarne qualcuno errato, passare con i tasti freccia fino a selezionare quello che si desidera eliminare (senza fare clic su di esso), quindi cancellarlo con Shift + Canc