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
...

LDAP Directory

GOnnect supports contact lookup via LDAP directories.

Example 2. 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.

Example 3. 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

[caldav0]
enabled=true
host=nextcloud.example.com
path=/remote.php/dav/calendars/user1/personal/
port=443
useSSL=true
user=user1

[carddav0]
enabled=true
displayName="Nextcloud contacts"
prio=40
host=nextcloud.example.com
path=/remote.php/dav/addressbooks/user1/contacts/
port=443
useSSL=true
user=user1

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.

If contacts and events from the Evolution Data Server should not be processed, the following configuration snippet can be used:

Example 4. Disable Evolution Data Server contacts and calendar

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

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