Anpassen von Netzwerkschnittstelle und Port¶

Die Angabe der IP und des Ports auf denen Radicale erreichbar ist legt man über die Einstellung hosts im Abschnitt [server] fest:

hosts = IPv4-des-Radicale-Rechners:5232

oder für alle IPv4-Adressen:

hosts = 0.0.0.0:5232

oder für alle IPv4- und IPv6-Adressen auf Port 9999:

 hosts = 0.0.0.0:9999, [::]:9999

Es können dabei mehrere IP-Adressen getrennt durch Komata angegeben werden. IPv6-Adressen sind dabei stets in [ ] einzufassen.

Ändern der Authentifizierungsmethode¶

Die Authentifizierungsmethode legt man im Abschnitt [auth] fest, den man wie folgt anpasst, um die Nuzter in einer mit bcrypt gesicherten Datei /etc/radicale/users mittels htpasswd anlegen und verwalten zu können:

type = htpasswd
htpasswd_filename = /etc/radicale/users
htpasswd_encryption = bcrypt

Anlegen von Benutzern¶

Nach dem Anpassen der Authentifizierungsmethode können Benutzer wie folgt angelegt werden:

# 1. Benutzer
sudo htpasswd -c -B /etc/radicale/users BENUTZER01

# Datei /etc/radicale/users nur für den System-Nutzer radicale zugreifbar machen:
sudo chown radicale:radicale /etc/radicale/users
sudo chmod o-r /etc/radicale/users

# weitere Benutzer anlegen
sudo htpasswd -B /etc/radicale/users BENUTZER02

# Passwort eines Benutzers ändern:
sudo htpasswd -B /etc/radicale/users BENUTZER01 

Löschen von Benutzern¶

Benutzer lassen sich einfach durch das folgende Kommando aus der /etc/radicale/users löschen - also z.B. für BENTUZER02:

sudo htpasswd -D /etc/radicale/users BENUTZER02 

Damit wird der Benutzer aber nur aus der Passwortdatei /etc/radicale/users gelöscht, die Kalender- und Adressbuchdateien des betreffenden Nutzers bleiben davon unberührt.

Möchte man auch diese Daten löschen, so muss man das Verzeichnis des betreffenden Nutzers aus /var/lib/radicale/collections/collection-root löschen, um alle Daten zu entfernen oder man löscht selektiv einzelne Kalender oder Adressbücher, indem man sie aus /var/lib/radicale/collections/collection-root/<Benutzername> entfernt - also z.B. für BENUTZER02:

# Alle Daten von BENUTZER02 löschen:
sudo rm -Rf /var/lib/radicale/collections/collection-root/BENUTZER02

# Einzelne Daten von BENUTZER02 löschen, z.B. das Adressbuch mit der UID "0b41234d-a9b2-317d-9a7d-58259212c39c"
sudo rm -Rf /var/lib/radicale/collections/collection-root/BENUTZER02/0b41234d-a9b2-317d-9a7d-58259212c39c 

Absicherung der Verbindung mittels TLS¶

Die Verbindung zum Radicale-Server kann recht einfach mit einer Transportverschlüsselung (TLS) versehen werden. Dazu in der /etc/radicale/config im Abschnitt [server] die folgenden Änderung einpflegen:

ssl = True
certificate = /etc/ssl/certs/ssl-cert-snakeoil.pem
key = /etc/ssl/private/ssl-cert-snakeoil.key
protocol = PROTOCOL_TLSv1_3

Damit wird Radicale angewiesen für die Verschlüsselung das während der Ubuntuinstallation durch das Paket ssl-cert angelegte selbsignierte Zertifikat und den zugehörigen Schlüssel zu verwenden. Damit Radicale auch auf den Key zugreifen kann, muss der Systembenutzer radicale der Gruppe ssl-cert hinzugefügt werden. Außerdem empfiehlt es sich zwecks Nutzung des Rechnernamens im Zertifikat das Sankeoilzertifikat und den zugehörigen Key nochmals neu zu generieren:

# radicale der Gruppe ssl-cert hinzufügen:
sudo usermod -aG ssl-cert radicale

# Snakeoilzertifikat und Key neu erstellen:
sudo make-ssl-cert generate-default-snakeoil --force-overwrite 

Anschließend Radicale neustarten. Mittels

openssl s_client --connect IP-Adresse-des-Radicale-Rechners:5232 -tls1_2
openssl s_client --connect IP-Adresse-des-Radicale-Rechners:5232 -tls1_3 

kann man die ordnungsgemäße Bereitstellung von TLS am Server überprüfen. In beiden Fällen sollte ein sog. Handshake zustande kommen.

Versionierung des Kalender- und Adressbuchspeichers mittels git¶

Radicale erlaubt es sehr einfach den Kalender- und Adressbuchspeicher mittels Git zu versionieren:

1. Sofern noch nicht geschehen, installiert man git.

2. Anschließend stoppt man den Radicale Server.

3. Dann legt man in der /etc/radicale/config im Abschnitt [storage] den Eintrag hook wiefolgt an:

       hook = ([ -d .git ] || git init) && git add -A && (git diff --cached --quiet || git commit -m "Changes by "%(user)s) 

4. Nun wechselt man in eine Shell des Systembenutzers radicale und initialisiert im Verzeichnis /var/lib/radicale/collections ein leeres Git-Repository. Dazu führt man der Reihe nach die folgenden Befehle aus:

       sudo -s
       cd /var/lib/radicale/collections
       exec su -s "$SHELL" radicale
       git init
       git config user.name radicale
       git config user.email radicale@radicale.lan
       nano .gitignore 

   Hinweis:

   Da es sich in diesem Fall nicht um ein öffentliches Git-Repository handelt, spielt es keine Rolle, welche Angaben man bei den Befehlen "git config user.name" und "git config user.email" macht. Die beiden Konfigurationsmerkmale sind aber zwingende Voraussetzung, damit git funktioniert.

5. In die Datei .gitignore fügt man folgendes ein:

       .Radicale.cache
       .Radicale.lock
       .Radicale.tmp-*

6. Nun verlässt man die radicale-Shell wieder:

       exit 

7. Schließlich startet man radicale wieder.

Fortan wird bei jeder Änderung eines Kalenders oder Adressbuchs ein git-commit ausgeführt. Weitere Details zur Versionierung unter Git.

Benutzerrechte¶

# write access to own files for each user
[owner-write]
user: .+
collection: ^%(login)s(/.+)?$
permission: rw

# Symbolischen Link erstellen
sudo ln -s /var/lib/radicale/collections/collection-root/<Benutzer01>/<Geteilte-Ressource>/ /var/lib/radicale/collections/collection-root/<Benutzer02>/<Geteilte-Ressource>

# Systemnutzer radicale zum Besitzer des symbolischen Links machen
sudo chown -h radicale:radicale /var/lib/radicale/collections/collection-root/<Benutzer02>/<Geteilte-Ressource> 

Weitere Konfigurationsoptionen¶

Neben den bereits vorgestellten Konfigurationsmöglichkeiten erlaubt Radicale noch die Benutzerverwaltung mittels WSGI über einen entsprechenden Server (z.B. Gunicorn oder Apache 2.4 mit mod_wsgi ) oder die Benutzerverwaltung unter Verwendung eines Reverse Proxy.

Details dazu findet man in der Dokumentation 🇬🇧.