Schlagwort-Archive: Kopano Open-Source-Groupware

Kopano ist eine Open-Source-Groupware-Anwendungssuite, die ursprünglich auf Zarafa basiert.

Kopano 8.7 Installation auf Debian 12

Kopano Tutorial zur Installation auf Debian 12. Die Groupware Anwendungssuite für Mailserver erlaubt größtmögliche Kontrolle über die Daten. Die Dienste decken den Großteil der Kommunikationsbedürfnisse in einem Unternehmen ab. Ein Kopano Server ist eine Alternative zu den Angeboten, die als Cloud-Dienste unter der Kontrolle der Anbieter laufen.

Kopano Core Installation
WebApp Installation
Z-Push Installation
Kopano und Postfix

Tutorial zur Installation von Kopano Groupware

Kopano Core Installation

Die Installation von Kopano Core auf Debian erfolgt durch Provisionierung aus dem Kopano Repository, zusammen mit der WebApp und Z-Push für Apache2, mit Fertigstellung in weniger als 10 Minuten, abhängig der Rechner Performance und Download Speed. Zu Beginn wird das KC-Repository hinzugefügt, hierzu ein Kopano Subscription Key (serial) benötigt wird.

Die im Beitrag gezeigten Kommandos werden als root („su -“) in der Konsole ausgeführt, viele verwenden auch sudo, die Befehle können mit sudo abgearbeitet werden, oder unter Ubuntu ebenfalls mit („sudo su -“) root werden, hier einfach die gewünschte Methode wählen.

Als Vorbereitung werden folgende Pakete aus dem Debian Standard Repository bereitgestellt.

$ apt update
$ apt install -y gnupg2 wget apt-transport-https

Debian 12 verwendet „apt_auth.conf“ für die Einbettung von Anmeldeinformationen, die für die Verbindung und zum Herunterladen von Pakete aus einem Repository benötigt werden.

Die APT Anmeldeinformationen zum Kopano Repository hinzufügen in/etc/apt/auth.conf.d/kopano.conf

$ echo "machine download.kopano.io/supported/core:/final/Debian_11/ login serial password XXXXXXXXXXXXXXXXXXXXXXXXX" | tee /etc/apt/auth.conf.d/kopano.conf

Anstelle des Platzhalters („XXX“) den 25-stelligen Serial Key einfügen.

Hinzufügen des Repository zum Final Release von Kopano Core.

$ echo "deb https://download.kopano.io/supported/core:/final/Debian_11/ ./" | tee /etc/apt/sources.list.d/kopano.list

Die Datei befindet sich unter/etc/apt/sources.list.d/kopano.list

Die Repository PGP-Signatur zu Trusted Keys hinzufügen (Debian 12).

$ wget -O- https://serial:XXXXXXXXXXXXXXXXXXXXXXXXX@download.kopano.io/supported/core:/final/Debian_11/Release.key | tee /etc/apt/trusted.gpg.d/KopanoRelease.key > /dev/null 2>&1

  Anstelle des Platzhalters („XXX“) den 25-stelligen Serial Key einfügen.

Den Public Key zu trusted.gpg.d keyring hinzufügen.

$ apt-key add /etc/apt/trusted.gpg.d/KopanoRelease.key
$ gpg2 --import /etc/apt/trusted.gpg.d/KopanoRelease.key

Das neu hinzugefügte Repository aktivieren.

$ apt update

MariaDB Installation

Der Server ist nun vorbereitet und die Bereitstellung wird fortgeführt mit der Installation von MariaDB und dem Kopano Server.

$ apt install -y mariadb-server kopano-*

Ein SQL-Datenbank Benutzer für den Kopano Store erstellen. Die Kopano Datenbank selbst wurde durch das Installationsskript erstellt.

$ mysql
CREATE USER 'kopano'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON kopano.* TO 'kopano'@'localhost';
quit

  Anstelle von password ein sicheres Passwort verwenden.

Die Konfiguration für den Kopano Server anpassen.

Falls unter/etc/kopanokeine Dateien vorliegen, dann die .cfg-Dateien in/usr/share/doc/kopano/example-configkopieren.

$ gzip -d -f --keep /usr/share/doc/kopano/example-config/*.cfg.gz & \cp /usr/share/doc/kopano/example-config/*.cfg /etc/kopano

Die Beispiel Konfigurationsdateien (.cfg) entpacken und kopieren.
Hinweis: um den Alias ‚cp -i‘ zu umgehen verwende ich den nicht aliasierten cp, indem ich den Prefix \ voranstelle, wenn das nicht funktioniert! führe zuerst den Befehl unalias cp aus, anstelle von \cp.

Die Kopano Server Konfiguration editieren/etc/kopano/server.cfg

Vorerst wird nur der Benutzer für Kopano Admin, die Ausführung und den Datenbankzugriff geändert.

local_admin_users = root kopano
run_as_user = kopano
run_as_group = kopano
mysql_user = kopano
mysql_password = password

  Das Passwort dieses für den Datenbank Benutzer eingegeben wurde.

Der Kopano Server kann jetzt gestartet werden.

$ systemctl start kopano-server

Nun vergewissern wir uns über den Status der Kopano Dienste.

$ systemctl status kopano-*

Wann bis hierher alles klappte, erscheint die folgende Ausgabe.

systemctl status kopano-server

Die Konfiguration des Kopano Servers in diesem Tutorial basiert auf dem Datenbank-Backend, dabei muss nichts geändert werden, da das Datenbank user_plugin bereits der Standardwert ist. Daneben gibt es zur besseren Verwaltung das LDAP Plugin („user_plugin=ldap“) für die Integration von OpenLDAP, Active Directory und Samba, dazu hier nicht weiter eingegangen wird.

Für die Verwaltung der Kopano Groupware ein Admin Account erstellen.

$ kopano-cli --create -u kadmin --fullname "Kopano Admin" --password P@ssw0rd! --email admin@example.org

Kopano WebApp Installation

Die WebApp ist das Front-end der Kopano Groupware, welche wie die meisten CMS auf dem LAMP-Stack (Apache, MySQL, PHP) basiert. Für Debian 11 wird der Apache2 Webserver und standardmässig PHP 7.4 („libapache2-mod-php“) aus dem Debian Standard Repository installiert.

$ apt install -y apache2 php php-common

Wird mit Debian oder Ubuntu eine Neuinstallation des Servers gewählt, was die empfohlene Bereitstellungsmethode für eine KC-Installation ist, kann mit taskel einfach der gesamte LAMP-Stack (Apache, MySQL, PHP) installiert werden. Dadurch alle Pakete bereitgestellt werden, die für den erfolgreichen Abschluss des Kopano-Installationsskripts erforderlich sind.

Nun muss ein weiteres Kopano WebApp Repository hinzugefügt werden in/etc/apt/sources.list.d/kopano.list

$ echo "deb https://download.kopano.io/supported/webapp:/final/Debian_11/ ./" | tee -a /etc/apt/sources.list.d/kopano.list

Die Anmeldeinformationen für APT hinzufügen (anhängen) in/etc/apt/auth.conf.d/kopano.conf

$ echo "machine download.kopano.io/supported/webapp:/final/Debian_11/ login serial password XXXXXXXXXXXXXXXXXXXXXXXXX" | tee -a /etc/apt/auth.conf.d/kopano.conf

Die dazugehörende PGP-Signatur zu den Trusted Keys hinzufügen.

$ wget -O- https://serial:XXXXXXXXXXXXXXXXXXXXXXXXX@download.kopano.io/supported/webapp:/final/Debian_11/Release.key | tee /etc/apt/trusted.gpg.d/WebAppRelease.key > /dev/null 2>&1

Das neu hinzugefügte Repository aktivieren.

$ apt update

Jetzt wird die Kopano WebApp aus dem Repository installiert.

$ apt install -y kopano-webapp

Die Kopano WebApp-Site aktivieren und Apache2 neu laden.

$ a2ensite kopano-webapp
$ systemctl reload apache2

Da sichere Cookies ab WebApp 3.4.0 standardmäßig aktiviert sind, bedeutet dies, dass man ohne SSL-Zertifikate nicht auf die WebApp zugreifen kann. Dies kann deaktiviert werden, indem unsichere Cookies aktiviert werden in/etc/kopano/webapp/config.php

define("SECURE_COOKIES", false);

Die änderung von true auf false ungefähr bei Zeile 44 editieren.

Sicherstellen dass der Webserver beim Systemstart aktiviert ist.

$ phpenmod kopano
$ systemctl enable apache2
$ systemctl reload apache2

Öffne in einem Broweser die URL zur WebApp-Anmeldeseite, zum Beispiel http://kopano.example.org/webapp/

Kopano WebApp Anmeldeseite

Z-Push Installation

Bei Z-Push handelt sich um eine Implementierung des ActiveSync-Protokolls von Microsoft, das drahtlos für ActiveSync-fähige Geräte mit mehreren Plattformen verwendet, darunter Apple iPhone und iPad und Android Geräte. Mit Open Source Z-Push kann jedes PHP-basierte Groupware-Paket vollständig mit jedem ActiveSync-kompatiblen Gerät synchronisiert werden.

Die Provisionierung von Z-Push erfolgt wieder aus dem Repository.

$ echo "deb https://download.kopano.io/zhub/z-push:/final/Debian_11/ ./" | tee /etc/apt/sources.list.d/z-push.list

Die dazugehörende PGP-Signatur zu den Trusted Keys hinzufügen.

$ wget -O- https://download.kopano.io/zhub/z-push:/final/Debian_11/Release.key > /etc/apt/trusted.gpg.d/z-push.key

Das neu hinzugefügte Repository aktivieren.

$ apt update

Z-Push kann nun auf dem Server bereitgestellt werden.

$ apt install -y z-push-kopano z-push-config-apache

Um Z-Push zu aktivieren muss der Webserver neu geladen werden.

$ systemctl reload apache2

Z-Push ist jetzt installiert und ist unter/usr/share/z-pushzu finden. Die Konfigurationsdatei liegt in/etc/z-push/z-push.conf.phphier keine änderungen gemacht werden müssen.

Überprüfen lässt sich Z-Push mit öffnen der URL in einem Browser.

http://kopano.example.org/Microsoft-Server-ActiveSync

Wenn alles klappte wird man zur Anmeldung aufgefordert, hier mit dem zuvor erstellten Benutzer („kadmin“) anmelden, es erscheint die Z-Push ActiveSync Seite.

Z-Push ActiveSync Seite

Kopano und Postfix Mail Transport Agent

Kopano Core enthält keinen eigenen MTA, kann aber mit allen etablierten MTAs integriert werden, die in modernen Linux-Distributionen zu finden sind. Obwohl KC die meisten Linux-MTAs unterstützt, wird die Verwendung von Postfix empfohlen.

Um eine E-Mail an das Postfach eines Benutzers zuzustellen, wird der kopano-dagent ausgeführt. Nachrichten werden über das LMTP-Protokoll an kopano-dagent übergeben. Die Verwendung von LMTP ist die empfohlene Bereitstellungsmethode, da dies den Single Instance Attachment Storage ermöglicht.

Die Bereitstellung von Postfix mit Integration zu Kopano Core wie folgt.

$ apt install -y postfix postfix-mysql

Bei der Installation wird man aufgefordert einen Hostnamen für die Postfix-Konfiguration einzugeben, zum Beispiel: kopano.example.org.

Die Postfix-Hauptkonfiguration hinzufügen in/etc/postfix/main.cf

myhostname = kopano.example.org
mydestination = localhost
# relayhost if relaying via a smarthost
relayhost = 172.31.245.70
mynetworks = 127.0.0.0/8 [::ffff:127.0.0.0]/104 [::1]/128 172.31.245.70

virtual_alias_maps = hash:/etc/postfix/virtual
virtual_mailbox_maps = mysql:/etc/postfix/mysql-users.cf
virtual_transport = lmtp:127.0.0.1:2003
virtual_mailbox_domains = example.org

smtpd_recipient_restrictions = permit_mynetworks,
        reject_non_fqdn_recipient,
        reject_non_fqdn_hostname,
        reject_non_fqdn_sender,
        reject_unknown_client,
        reject_unknown_hostname,
        reject_invalid_hostname,
        reject_unauth_pipelining,
        reject_unauth_destination,
        reject_unverified_recipient,
        permit

Um die Abfrage der Email Adresse bei eingehenden Emails zu ermöglichen wird im nächsten Schritt erneut das Passwort benötigt.

Erstelle zusätzlich eine Datei/etc/postfix/mysql-users.cf

$ echo "user = kopano
password = password
hosts = 127.0.0.1
dbname = kopano
query = SELECT value FROM objectproperty where propname = 'emailaddress' and value = '%s';" > /etc/postfix/mysql-users.cf

  Gemäß einem Kopano-Server in einer Multi-Tenancy-Umgebung wird hier das Anmeldenamenformat „%u@%c“ (%u Benutzername, %c Mandantenname) verwendet, für die Anmeldung mit E-Mail-Adressen als Benutzernamen.

Zuletzt noch die Zugriffsrechte einschränken und aus virtual die Berkeley-DB erzeugen.

$ chmod 600 /etc/postfix/mysql-users.cf
$ touch /etc/postfix/virtual
$ postmap /etc/postfix/virtual
$ systemctl restart postfix

Bei eingehenden E-Mails prüft nun Postfix virtual_mailbox_maps per SQL-Abfrage, ob der Empfänger (Benutzer) im Store existiert. Darüber hinaus ist es auch möglich über LDAP mit Postfix zu interagieren, was in diesem Tutorial jedoch nicht behandelt wird.

Fazit

Der Kopano-Server ist jetzt Funktionsbereit, für die Verwendung von Desktop- und mobile Endgeräte die genutzt werden können. Eine weitere Vielzahl von Anwendungen und Plugins können weiter bereitgestellt werden. Die Infrastrukturintegration für Active Directory oder Samba und OpenLDAP können weitere Schritte sein.

Kopano OL Extension E-Mail Signaturen

E-Mail Signatur auf Outlook übernehmen mit Kopano OL Extension

Die Kopano OL Extension (KOE) dient als Erweiterung der bereits enthaltenen ActiveSync-Unterstützung von Microsoft Outlook 2013, 2016 und 2019 (für Windows 32-Bit und 64-Bit). KOE funktioniert sowohl mit On-Prem lizenzierten Outlook-Versionen als auch mit den Office 365-Varianten. KOE ist als exe-Installationsprogramm verfügbar und kann vor oder nach dem Erstellen des eigentlichen ActiveSync-Kontos in Outlook installiert werden. Für GPO-basierte Bereitstellungen sind dedizierte MSI-Pakete für 32-Bit- und 64-Bit-Umgebungen verfügbar.

Darüber hinaus ermöglicht OLE, die E-Mail Signaturen zu verwalten, in dem für ein Konto die Signatur erstellt wird, aus der WebApp oder der Kopano Desktop App, diese dann über die Einstellungen von KOE mit überschreiben auf den Client verteilt werden.

OL Extension Kopano WebApp Mail Signaturen

Im Outlook Menüband unter dem Abschnitt Kopano bei EinstellungenSignaturen das häcken setzen bei Lokale Signaturen überschreiben.

Kopano OL Extension Einstellungen Signaturen

Die E-Mail Signatur wird in Outlook mit klick auf Neue E-Mail oder Neues Element mit Ctrl+N im Nachrichten Bereich eingefügt.

Die E-Mail Signatur wird in Outlook mit erstellen eines neuen Element (Ctrl+N) im Nachrichten Bereich eingefügt.

Anforderungen

Z-Push 2.3.x ist eine Voraussetzung für die Verwendung von KOE, sowie natürlich ein Kopano Server. Die Kopano OL Extension (KOE) kann hier hertuntergeladen werden.

Die Kopano Open-Source-Groupware

Kopano ist eine Open-Source-Groupware-Anwendungssuite, die ursprünglich auf Zarafa basiert. Die ursprüngliche Version von Kopano Core (KC) wurde von der damals aktuellen Version (der Open-Source-Teile der) Zarafa Collaboration Platform abgeleitet und löste ZCP in Bezug auf die Abstammung ab, da ZCP mit von KC bereitgestellten Patches in den Wartungsmodus wechselte. Kopano WebApp stammt ebenfalls von Zarafa WebApp ab. Seit Oktober 2017 ist Kopano Core auch genauer als Kopano Groupware Core bekannt, da Kopano B.V. mehr Produkte entwickelt hat, die nicht direkt Groupware-Komponenten erforderten.