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.

Example 1. Turn contacts into a block list
# 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.

Example 2. Prefer avatars from the chat account over LDAP
[ldap0]
...
# optional, default: 50
avatarPrio=40

[chat0]
...
avatarPrio=60

LDAP Directory

GOnnect supports contact lookup via LDAP directories.

Example 3. LDAP configuration
[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 https://

useSSL

true

Host nextcloud.example.com

host

nextcloud.example.com

Path /remote.php/dav/calendars/user-id/personal/

path

/remote.php/dav/calendars/user-id/personal/

(no port in the URL)

port

443

(not contained in the URL)

user

user1

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.

Example 4. CardDAV and CalDAV configuration
[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.

Example 5. Subscribe the presence state of work and mobile numbers
[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:

Example 6. Disable Evolution Data Server contacts and calendar
# Disable EDS contacts
[eds-contacts]
enabled=false

# Disable EDS calendar
[eds-calendar]
enabled=false