Guide-CalDAV
Ce guide pratique vous accompagne dans la configuration des variables CalDAV pour synchroniser l'agenda Pronote vers un calendrier compatible CalDAV. Pour consulter le tableau complet des variables disponibles, reportez-vous à la page Configuration.
Choisir un serveur CalDAV
Plusieurs solutions existent pour héberger un serveur CalDAV. Voici les trois options principales, adaptées à différents besoins :
- Nextcloud / ownCloud : Solution cloud auto-hébergée complète, avec un module calendrier intégré. Idéal pour une utilisation personnelle ou familiale.
- Radicale : Serveur CalDAV léger et minimaliste, parfait pour un auto-hébergement simple et performant.
- Baïkal : Serveur dédié CalDAV/CardDAV, conçu pour une intégration facile et une gestion centralisée des calendriers et contacts.
Nextcloud / ownCloud
Trouver l'URL CalDAV
- Connectez-vous à l'interface web de votre instance Nextcloud/ownCloud.
- Ouvrez l'application Calendrier depuis le tableau de bord.
- Dans le coin inférieur gauche de la barre latérale, cliquez sur l'icône Réglages (engrenage).
- À côté du calendrier de votre choix, cliquez sur le menu trois points (
...) puis sélectionnez Copier le lien privé ou Copier le lien d'abonnement. - Pour obtenir l'URL racine, descendez dans les réglages globaux (en bas de la page) et cherchez Copier l'adresse CalDAV principale.
Format d'URL
- URL de base (principale) :
https://<cloud.example.com>/remote.php/dav/principals/users/<USERNAME>/ - URL d'un calendrier spécifique :
https://<cloud.example.com>/remote.php/dav/calendars/<USERNAME>/<CALENDAR_SLUG>/
Remarque :
<USERNAME>correspond à votre identifiant Nextcloud, et<CALENDAR_SLUG>est le nom technique du calendrier (ex.personal,work).
Créer un mot de passe d'application
Si votre instance utilise une authentification à deux facteurs (2FA), les mots de passe d'application sont obligatoires pour les connexions CalDAV.
- Cliquez sur votre avatar utilisateur (en haut à droite) puis sélectionnez Paramètres personnels (ou Réglages).
- Dans la barre latérale gauche, sous la section Personnel, cliquez sur Sécurité.
- Descendez jusqu'à la section Appareils et sessions ou Mots de passe d'application.
- Saisissez un nom pour l'application (ex.
pronote-sync) puis cliquez sur Créer un nouveau mot de passe d'application. - Nextcloud affiche alors votre nom d'utilisateur et un jeton généré (à usage unique). Conservez ce jeton précieusement : il servira de mot de passe pour la variable
CALDAV_PASSWORD.
Radicale
Format d'URL
- URL de base (accès racine) :
ou, si configuré derrière un reverse proxy avec HTTPS :
http://<hote>:5232/https://<radicale.example.com>/ - URL d'un calendrier :
http://<hote>:5232/<USERNAME>/<CALENDAR>/
Créer un calendrier
Avec Radicale, les calendriers sont créés automatiquement à la première écriture par un client CalDAV compatible. Vous pouvez également les gérer manuellement via l'interface web si celle-ci est activée.
Identifiants
Les identifiants sont configurés dans le fichier de configuration de Radicale, généralement sous la section [auth]. Par défaut, Radicale utilise souvent une authentification de type htpasswd (fichier Apache).
Pour créer un utilisateur, utilisez la commande suivante :
htpasswd -Bc /chemin/vers/users.htpasswd <USERNAME>
Exemple :
htpasswd -Bc /etc/radicale/users.htpasswd pronote-syncVous serez invité à saisir un mot de passe pour l'utilisateur
<USERNAME>.
Baïkal
Format d'URL
- Point d'accès DAV (racine) :
https://<baikal.example.com>/dav.php - URL principale de l'utilisateur :
https://<baikal.example.com>/dav.php/principals/<USERNAME>/ - URL d'un calendrier :
https://<baikal.example.com>/dav.php/calendars/<USERNAME>/<CALENDAR>/
Administration
- Accédez à l'interface d'administration de Baïkal à l'URL :
https://<baikal.example.com>/admin/ - Rendez-vous dans la section Users and address books → Users → Add User pour créer un nouvel utilisateur.
- Les calendriers peuvent être gérés sous Users → Calendars ou créés automatiquement par les clients CalDAV.
Distinction entre URL du serveur et chemin du calendrier
Il est important de bien comprendre la différence entre ces deux variables pour une configuration correcte :
-
CALDAV_URL: Il s'agit de l'URL racine du serveur CalDAV ou du point d'accès de découverte (ex.https://cloud.example.com/remote.php/dav). Cette URL permet au client de découvrir les capacités du serveur et les collections disponibles. -
CALDAV_CALENDAR_PATH: Il s'agit du chemin spécifique identifiant la collection de calendrier où les événements (VEVENT) seront écrits. Par exemple :/remote.php/dav/calendars/john/personal/.
Astuce : La plupart des serveurs CalDAV exposent l'URL complète du calendrier dans leur interface web, via un menu de partage ou de réglages (ex. « Copier l'URL CalDAV » ou « Copier le lien privé »). Vous pouvez extraire
CALDAV_URLetCALDAV_CALENDAR_PATHà partir de cette URL complète.
Sécurité : HTTPS obligatoire
Pour protéger vos identifiants et vos données en transit, les règles suivantes s'appliquent :
- HTTPS est obligatoire par défaut pour la variable
CALDAV_URL. - HTTP n'est toléré que pour les hôtes locaux (
localhost,127.0.0.1,::1) et uniquement si la variableCALDAV_ALLOW_INSECURE_HTTP=trueest définie. - Cette mesure garantit que vos identifiants ne sont pas transmis en clair sur le réseau.
- La variable
CALDAV_URLest stockée sous forme deSecretStret masquée dans les logs pour éviter toute fuite accidentelle.
Exemple de configuration
Voici des exemples de configuration pour les serveurs présentés ci-dessus :
# Exemple pour Nextcloud
CALDAV_URL=https://cloud.example.com/remote.php/dav
CALDAV_USERNAME=pronote-sync
CALDAV_PASSWORD=mot_de_passe_application
CALDAV_CALENDAR_PATH=/pronote-sync/
# Exemple pour Radicale en local (développement uniquement)
# CALDAV_URL=http://localhost:5232
# CALDAV_USERNAME=user
# CALDAV_PASSWORD=mot_de_passe
# CALDAV_CALENDAR_PATH=/user/pronote/
# CALDAV_ALLOW_INSECURE_HTTP=true
→ Configuration — tableau des variables → Sécurité — gestion des secrets