Radicale – Auto-hébergez vos contacts, calendriers & tâches¶

Prérequis¶

Radicale requiert Python pour fonctionner. Connectez-vous au serveur et installez les packages suivants :

sudo apt install python3 python3-pip

Installation¶

Installez Radicale :

sudo -H python3 -m pip install --upgrade radicale

Ensuite, créez un utilisateur système qui lancera Radicale. Dans le cadre de ce tutoriel, nous appellerons cet utilisateur système radicaleadmin. Évidemment, vous pouvez choisir n'importe quel nom, assurez-vous simplement d'ajuster les commandes en conséquence :

sudo useradd --system --home-dir / --shell /sbin/nologin radicaleadmin

Pas besoin d'une base de données, créez simplement un dossier où les données de Radicale seront stockées en fichiers bruts :

sudo mkdir -p /var/lib/radicale/collections

Utilisateurs et utilisatrices¶

Radicale supporte des utilisateurs multiples. Chacun.e d'eux peut avoir son propre lot de calendriers, contacts, et tâches. Les accès peuvent être sécurisés par des identifiants utilisateur, qui sont stockés dans un fichier chiffré sur le serveur.

Installez les packages suivants pour activer le chiffrement :

sudo -H python3 -m pip install --upgrade passlib bcrypt

Ensuite, créez un répertoire pour stocker les identifiants utilisateur :

sudo mkdir /var/www/radicale

Enfin, créez un premier compte utilisateur avec la commande ci-dessous, en utilisant le flag -c. Remplacez $USER par le vrai nom d'utilisateur. Lorsque vous y êtes invité, entrez un mot de passe fort et unique :

sudo htpasswd -B -c /var/www/radicale/users $USER

En guise d'illustration, créons trois utilisateurs — Georg, Lenina et Tom :

sudo htpasswd -B -c /var/www/radicale/users Georg
sudo htpasswd -B /var/www/radicale/users Lenina
sudo htpasswd -B /var/www/radicale/users Tom

Notez que nous avons utilisé l'option -c pour créer le premier utilisateur Georg, puis nous avons enlevé l'option pour créer les utilisateurs supplémentaires Lenina et Tom.

Enfin, vérifiez que tous les identifiants utilisateur ont été ajoutés correctement :

sudo cat /var/www/radicale/users

Le terminal devrait afficher quelque chose comme :

Georg:$2y$05$Zsb8MYlKjRr2InVi/IQNtustqfdnHWN14uG9jNNhx1g rF7a/8Cg6
Lenina:$2y$05$Hh2Y8nrikm 9f1Pz8LrOFe K5NR HlL0Qz3Yvv gupSBgIr4lT0bi
Tom:$2y$05$1BnHnXCqNHXZtWMiFhnxBOpYM9xeVnZXm70SoTclEfsrI JPSvDVy

Paramètres¶

Créez un répertoire contenant tous les paramètres :

sudo mkdir /etc/radicale

Ouvrez la configuration :

sudo vi /etc/radicale/config

Ajoutez ou modifiez les lignes suivantes :

[server]
hosts               = 0.0.0.0:5232, [::]:5232
max_connections     = 20
max_content_length  = 10000000
timeout             = 10

[auth]
type                = http_x_remote_user
htpasswd_filename   = /var/www/radicale/users
htpasswd_encryption = bcrypt
delay               = 5

[storage]
filesystem_folder   = /var/lib/radicale/collections

Quelques informations supplémentaires à propos de ces paramètres :

Permissions¶

Nous allons limiter à l'utilisateur radicaleadmin l'accès aux répertoires /var/lib/radicale (contient les données), /var/www/radicale (contient les identifiants utilisateur chiffrés) et /etc/radicale (contient les paramètres) :

sudo chown -R radicaleadmin:radicaleadmin /var/lib/radicale
sudo chmod -R 700 /var/lib/radicale

sudo chown -R radicaleadmin:radicaleadmin /var/www/radicale
sudo chmod -R 755 /var/www/radicale

sudo chown -R radicaleadmin:radicaleadmin /etc/radicale
sudo chmod -R 700 /etc/radicale

Démarrage automatique¶

Assurez-vous que Radicale se lance automatiquement à chaque démarrage. Créez un fichier de configuration :

sudo vi /etc/systemd/system/radicale.service

Ajoutez le contenu suivant (ajustez en conséquence) :

[Unit]
Description=A simple CalDAV (calendar) and CardDAV (contact) server
After=network.target
Requires=network.target

[Service]
ExecStart=/usr/bin/env python3 -m radicale
Restart=on-failure
User=radicaleadmin
Group=radicaleadmin
PrivateTmp=true
ProtectSystem=strict
ProtectHome=true
PrivateDevices=true
ProtectKernelTunables=true
ProtectKernelModules=true
ProtectControlGroups=true
NoNewPrivileges=true
ReadWritePaths=/var/lib/radicale/collections

[Install]
WantedBy=multi-user.target

Vérifions que Radicale se lance automatiquement à chaque fois que le serveur démarre :

sudo systemctl daemon-reload
sudo systemctl enable radicale

Redémarrez le serveur :

sudo reboot

Assurez-vous que Radicale est en état de marche (le statut devrait être "Actif") :

sudo systemctl status radicale

Créez un fichier de configuration Apache :

sudo vi /etc/apache2/sites-available/myradicale.gofoss.duckdns.org.conf

Ajoutez le contenu suivant et assurez-vous de régler les paramètres selon votre propre configuration, comme les noms de domaines (myradicale.gofoss.duckdns.org), chemins vers les clés SSL, adresses IP et ainsi de suite :

<VirtualHost *:80>

ServerName              myradicale.gofoss.duckdns.org
ServerAlias             www.myradicale.gofoss.duckdns.org
Redirect permanent /    https://myradicale.gofoss.duckdns.org/

</VirtualHost>

<VirtualHost *:443>

ServerName              myradicale.gofoss.duckdns.org
ServerAlias             www.myradicale.gofoss.duckdns.org
ServerSignature         Off

SecRuleEngine           Off
SSLEngine               On
SSLProxyEngine          On
SSLProxyCheckPeerCN     Off
SSLCertificateFile      /etc/dehydrated/certs/gofoss.duckdns.org/fullchain.pem
SSLCertificateKeyFile   /etc/dehydrated/certs/gofoss.duckdns.org/privkey.pem

<Location />
    Order deny,allow
    Deny from all
    Allow from 127.0.0.1
    Allow from 192.168.1.0/24
    Allow from 10.8.0.1/24
</Location>

RewriteEngine On
RewriteRule ^/radicale$ /radicale/ [R,L]

<Location "/radicale/">
    AuthType      Basic
    AuthName      "Radicale - Password Required"
    AuthUserFile  "/var/www/radicale/users"
    Require       valid-user

    ProxyPass        http://localhost:5232/ retry=0
    ProxyPassReverse http://localhost:5232/
    RequestHeader    set X-Script-Name /radicale/
RequestHeader    set X-Remote-User expr=%{REMOTE_USER}
</Location>

ErrorLog ${APACHE_LOG_DIR}/myradicale.gofoss.duckdns.org-error.log
CustomLog ${APACHE_LOG_DIR}/myradicale.gofoss.duckdns.org-access.log combined

</VirtualHost>

Une fois que le contenu est ajouté, sauvez et quittez le fichier (:wq!).

Notez comment nous avons activé le chiffrement SSL pour Radicale avec l'instruction SSLEngine On, et utilisé le certificat SSL /etc/dehydrated/certs/gofoss.duckdns.org/fullchain.pem ainsi que la clé privée SSL /etc/dehydrated/certs/gofoss.duckdns.org/privkey.pem, que nous avions créés précédemment.

Notez également comment nous avons désactivé ModSecurity dans le fichier de configuration d'Apache avec l'instruction SecRuleEngine Off, car Radicale et ModSecurity ne font pas bon ménage.

Maintenant, activez l'hôte virtuel d'Apache et redémarrez Apache :

sudo a2ensite myradicale.gofoss.duckdns.org.conf
sudo systemctl reload apache2

Configurez Pi-Hole pour résoudre l'adresse locale de Radicale. Naviguez vers https://mypihole.gofoss.duckdns.org et connectez-vous à l'interface web de Pi-Hole (ajustez en conséquence). Naviguez vers l'entrée Local DNS Record et ajoutez la combinaison domaine/IP suivante (ajustez en conséquence) :

DOMAIN:      myradicale.gofoss.duckdns.org
IP ADDRESS:  192.168.1.100

Naviguez jusqu'à https://myradicale.gofoss.duckdns.org/radicale et connectez-vous avec des identifiants valides. Créez alors des calendrier, des répertoires et des listes de tâches selon vos besoins.

Dans cette vidéo, nous configurons une interface web, nous créons un carnet d'adresses et un calendrier pour Georg, et une liste de tâches pour Lenina.

Si vous souhaitez faire des sauvegardes manuellement, connectez-vous à https://myradicale.gofoss.duckdns.org/radicale (ajustez en conséquence) et cliquez sur les adresses URL des carnets d'adresses, calendriers et listes de tâches pour télécharger vos données.

Vous pouvez aussi effectuer des sauvegardes automatiques des répertoires /var/lib/radicale, /var/www/radicale et/etc/radicale.