Address Books and Calendars
Searching for contacts is a central feature of GOnnect. However, GOnnect does not create another data silo, but rather uses existing data sources to avoid increasing the maintenance effort. The same concept applies to accessing calendar events.
Block list
All contact sources allow the definition of block=true which turns the source into a block list. All contacts found in this source will be blocked.
# Works for all address book sources. CardDAV is used here as an example.
[carddav1]
...
# If set to true, all contacts (their phone numbers resp.) are not visible via the address book search or anywhere else. Instead, they are treated
# as a blacklist for incoming calls. Such invites will automatically be declined.
# default: false
# (optional)
block=true
## The SIP status code to respond the invite when a blocked contact calls. Must be a valid SIP status code ≥ 400.
## default: 603 (declined)
## (optional)
# blockSipCode=603
...
Avatars
Contacts can have avatar images from several sources, e.g. from LDAP, CardDAV or a chat account.
GOnnect merges them: for each contact, the avatar of the source with the highest avatarPrio is shown. If this
source has no avatar for the contact, the source with the next lower priority is used.
avatarPrio can be set in every address book section (e.g. ldapN, carddavN, eds-contacts, akonadi-contacts)
and in every chatN section. A value of 0 disables avatars from this source. If several sources have the same
priority, the result is undefined.
[ldap0]
...
# optional, default: 50
avatarPrio=40
[chat0]
...
avatarPrio=60
LDAP Directory
GOnnect supports contact lookup via LDAP directories.
[ldap0]
displayName="Company Contacts"
prio=50
url=ldap://ldap.example.com
base="ou=people,dc=example,dc=com"
baseNumber=+496990009
filter="(objectClass=inetOrgPerson)"
sipStatusSubscriptableAttributes=telephoneNumber
# Only one CA certificate is allowed here
caFile=~/.var/app/de.gonicus.gonnect/config/gonnect/example-org.crt
[ldap1]
displayName="CRM Contacts"
prio=60
url=ldap://crm.example.com
base="ou=crm,dc=example,dc=com"
filter="(objectClass=inetOrgPerson)"
WebDAV
GOnnect can be configured to access a CardDAV and/or a CalDAV Server.
If you need to verify a self signed certificate authority (CA), the global setting of generic/caFiles is used.
Another option is to disable the TLS certificate verification by setting generic/verifyServer to false.
Usually there is an option in your CalDAV server to copy a link to the calendar or addressbook. Let’s suppose the link looks like this:
The link is made up of several parts, each of which is mapped to a configuration field:
| URL part | Config field | Example value |
|---|---|---|
Scheme |
|
|
Host |
|
|
Path |
|
|
(no port in the URL) |
|
|
(not contained in the URL) |
|
|
The scheme determines the transport security and the default port: https implies useSSL=true and port=443,
while http implies useSSL=false and port=80. If the copied URL contains an explicit port (for example
https://nextcloud.example.com:5000/remote.php/dav/calendars/user-id/personal/), use that value for port instead
of the default.
[generic]
# Allow access to servers with self signed certificate authorities
# A list of certificate files is allowed. Separate with commas.
# Place the files in a folder, where GOnnect as flatpak can access them, e.g. the config folder.
caFiles=~/.var/app/de.gonicus.gonnect/config/gonnect/nextcloud.crt,~/.var/app/de.gonicus.gonnect/config/gonnect/company.crt
# Optional, but not secure, is to disable the verfication of the TLS certificate by setting
#verifyServer=false
[caldav0]
enabled=true
host=nextcloud.example.com
path=/remote.php/dav/calendars/user-id/personal/
port=443
useSSL=true
user=user1
[carddav0]
enabled=true
displayName="Nextcloud contacts"
prio=40
host=nextcloud.example.com
path=/remote.php/dav/addressbooks/user-id/contacts/
port=443
useSSL=true
user=user1
SIP presence for CardDAV contacts
Like LDAP sources, CardDAV sources support sipStatusSubscriptableAttributes. For CardDAV, the values are
vCard TEL TYPE parameters: a phone number is used for the SIP presence subscription only if its TYPE
contains one of the listed values. Multiple values are separated by commas; the comparison is case-insensitive.
If the option is not set, no number of this source is used for presence subscriptions.
[carddav0]
...
sipStatusSubscriptableAttributes="work,cell"
Evolution Data Server
GOnnect automatically accesses the local Evolution Data Server. This is installed automatically on GNOME. However, note that this does not apply to contacts and events from Evolution if Evolution is installed as a Flatpak. In this case, an EDS runs within the Evolution Flatpak, which GOnnect cannot access. Typically, an EDS also runs on the host, which can be edited via the "GNOME Contacts" app, for example.
The Evolution Data Server is only available on Linux. Both the contacts (eds-contacts) and, since GOnnect 2.5,
the calendar (eds-calendar) are enabled by default.
If contacts and events from the Evolution Data Server should not be processed, the following configuration snippet can be used:
# Disable EDS contacts
[eds-contacts]
enabled=false
# Disable EDS calendar
[eds-calendar]
enabled=false