Pripojenie CalDAV kalendára
CalDAV je otvorený štandardný protokol na prístup ku kalendárom cez internet. Podporuje ho mnoho služieb, napríklad Fastmail, Nextcloud, SOGo, Radicale, Baikal alebo Synology Calendar.
Postup
-
Pripravte si údaje CalDAV
Pred pripojením si musíte zistiť údaje o svojom CalDAV serveri. Zvyčajne ich nájdete:
- v pomocníkovi alebo dokumentácii svojho poskytovateľa,
- na stránke nastavení účtu,
- v e-maile, ktorý vám poskytovateľ poslal pri registrácii.
Budete potrebovať:
- Adresu servera – často stačí samotná adresa servera, napr.
cloud.example.com, presnú cestu ku kalendárom skúsime dohľadať sami. Inak zadajte úplnú URL CalDAV, napr.https://example.com/dav. - Používateľské meno – zvyčajne vašu e-mailovú adresu alebo používateľské meno účtu
- Heslo – heslo k účtu alebo heslo pre aplikáciu
Údaje pre Fastmail, Nextcloud, SOGo a Synology Calendar nájdete nižšie v časti Obľúbení poskytovatelia CalDAV.
-
Prejdite na stránku Kalendáre
V SyncMyDay kliknite v menu na Kalendáre, alebo prejdite priamo na stránku Kalendáre.
-
Kliknite na „Iný CalDAV“
V zozname Ďalší poskytovatelia pod hlavnými dlaždicami kliknite na Iný CalDAV.
-
Zadajte prihlasovacie údaje CalDAV
Vyplňte formulár údajmi, ktoré ste si pripravili:
- Adresa servera – adresa servera alebo priamo URL CalDAV, napríklad:
https://caldav.fastmail.comhttps://nextcloud.example.com/remote.php/davcaldav.example.com(https://pridáme automaticky)
- Používateľské meno – zvyčajne vaša e-mailová adresa (napr.
vy@example.com) alebo používateľské meno - Heslo – heslo k účtu alebo heslo pre aplikáciu (ak ho váš poskytovateľ vyžaduje)
- E-mail (nepovinné) – zobrazí sa pri kalendári, ak sa líši od používateľského mena
Keď do poľa E-mail zadáte adresu poskytovateľa, pre ktorého máme vlastný formulár, ponúkneme vám prepnutie naň. Pri adrese na vlastnej doméne skúsime CalDAV server dohľadať a jeho adresu doplníme, ak ste ju ešte nevyplnili.
- Adresa servera – adresa servera alebo priamo URL CalDAV, napríklad:
-
Nechajte SyncMyDay nájsť kalendáre
Kliknite na Nájsť kalendáre. SyncMyDay pritom:
- overí, že je server dostupný cez HTTPS,
- prihlási sa vašimi prihlasovacími údajmi,
- vyhľadá dostupné kalendáre.
Zvyčajne to trvá niekoľko sekúnd.
-
Vyberte kalendáre
Uvidíte zoznam kalendárov dostupných na vašom CalDAV serveri. Zaškrtnite jeden alebo viac kalendárov, ktoré chcete synchronizovať, a kliknite na Dokončiť nastavenie. Každý zaškrtnutý kalendár bude v SyncMyDay samostatný, s vlastnou farbou a vlastnými pravidlami. Názov prevezme zo servera, názov aj farbu môžete neskôr zmeniť v detaile kalendára. Ďalšie kalendáre z účtu pridáte aj neskôr tlačidlom Pridať ďalší kalendár z účtu v detaile kalendára.
Typicky tu uvidíte napríklad tieto kalendáre:
- Osobný – váš hlavný kalendár
- Práca – pracovné udalosti
- Rodina – zdieľaný rodinný kalendár
- akékoľvek vlastné kalendáre, ktoré ste si vytvorili
Kalendár označený Len na čítanie môže byť len zdrojom jednosmerného pravidla. Blokácie sa doň nedajú zapisovať a obojsmernú synchronizáciu s ním nenastavíte.
-
Hotovo, kalendáre sú pripojené
Vybrané kalendáre sú teraz pripojené a pripravené na použitie, každý ako samostatná karta v zozname.
Obľúbení poskytovatelia CalDAV
Fastmail
Populárna e-mailová a kalendárová služba.
- URL servera:
https://caldav.fastmail.com - Používateľské meno: vaša e-mailová adresa Fastmail
- Heslo: vaše heslo Fastmail (alebo heslo pre aplikáciu, ak je zapnuté 2FA)
Nextcloud
Self-hosted alebo spravovaný Nextcloud.
- URL servera:
https://vas-nextcloud.com/remote.php/dav - Používateľské meno: vaše používateľské meno Nextcloud
- Heslo: vaše heslo Nextcloud alebo heslo pre aplikáciu
SOGo
Open-source groupware server.
- URL servera:
https://vas-sogo-server.com/SOGo/dav - Používateľské meno: vaše používateľské meno SOGo (často
email@domena.sk) - Heslo: vaše heslo SOGo
Synology Calendar
Balík Kalendár pre Synology NAS.
- URL servera:
https://vase-nas-adresa.com:5001/calendar - Používateľské meno: vaše používateľské meno Synology DSM
- Heslo: vaše heslo Synology DSM
Uistite sa, že je nainštalovaný balík Kalendár a že je v nastaveniach Kalendára povolený CalDAV.
Riešenie problémov
„Server … nie je dostupný“ alebo „Server … nemá platný certifikát“
Skontrolujte tieto časté problémy:
- Adresa servera:
https://pridáme automaticky. Ak samotná adresa servera nestačí, zadajte úplnú URL CalDAV z dokumentácie poskytovateľa. - Lomka na konci: skúste adresu s lomkou (
/) na konci aj bez nej. - Číslo portu: niektoré servery potrebujú výslovne uvedený port (napr.
:8443). - Certifikát: pripájame sa len cez HTTPS a k serverom s neplatným certifikátom (vrátane self-signed) sa z bezpečnostných dôvodov nepripojíme. Ak server prevádzkujete sami, nastavte mu platný certifikát.
- Dostupnosť z internetu: server, na ktorý sa dostanete len z vnútornej siete alebo cez VPN, sa pripojiť nedá.
„CalDAV odmietol prihlasovacie údaje.“
Časté príčiny:
- nesprávne používateľské meno alebo heslo,
- treba použiť heslo pre aplikáciu (ak máte zapnuté 2FA),
- zlý formát používateľského mena (skúste ho s
@domena.skaj bez), - účet je zamknutý alebo deaktivovaný.
Riešenie: skontrolujte prihlasovacie údaje, v prípade potreby vygenerujte heslo pre aplikáciu, alebo kontaktujte svojho poskytovateľa.
„Nenašli sme žiadny kalendár. Skontrolujte adresu servera.“
Ak sa kalendáre nenájdu:
- Zadajte namiesto samotnej adresy servera úplnú URL CalDAV z dokumentácie poskytovateľa.
- Uistite sa, že máte vo svojom účte aspoň jeden kalendár.
- Skontrolujte, či kalendáre nie sú skryté alebo archivované.
- Skúste vytvoriť testovací kalendár vo webovom rozhraní svojho poskytovateľa.
Synchronizácia sa zastavila a prišiel mi e-mail
Keď uložené heslo prestane fungovať, SyncMyDay pripojenie pozastaví a pošle vám e-mail. Otvorte kalendár na stránke Kalendáre, kliknite na Upraviť, vyplňte Nové heslo (nepovinné) a kliknite na Uložiť zmeny. Nové heslo platí pre všetky kalendáre z účtu.
Synchronizácia je pomalá
CalDAV kalendáre sa synchronizujú každých 5 minút, čo je pomalšie ako pri Google Calendar a Microsoft 365:
- Je to normálne kvôli obmedzeniam protokolu CalDAV.
- Push notifikácie v reálnom čase nie sú k dispozícii.
- Frekvencia dopytovania vyvažuje rýchlosť odozvy a zaťaženie servera.
Potrebujete rýchlejšiu synchronizáciu? Zvážte Google Calendar alebo Microsoft 365, ktoré podporujú webhooky v reálnom čase.
Ďalšie kroky
Technické detaily
Pre vývojárov a IT
Protokol CalDAV (RFC 4791)
SyncMyDay implementuje štandard CalDAV pomocou týchto požiadaviek:
PROPFIND— objavovanie kalendárov, ich oprávnení a značiek zmienREPORT— dopytovanie kalendárových dát (calendar-query)PUT— vytváranie a aktualizácia blokáciíDELETE— odstraňovanie blokácií
Objavovanie služby
Kalendárové kolekcie hľadáme pomocou WebDAV service discovery:
- Skúsime zadanú URL; ak na nej CalDAV neodpovedá, skúsime
/.well-known/caldav(RFC 6764). - Cez
current-user-principalnájdeme vlastnosťcalendar-home-set. - V home sete vyhľadáme kalendárové kolekcie.
- Podľa
current-user-privilege-setrozpoznáme kalendáre len na čítanie a označíme ich.
Autentifikácia a zabezpečenie
- Basic Auth: štandardná HTTP Basic Authentication cez HTTPS
- Digest Auth: podporované, ak ho server vyžaduje
- Len HTTPS s platným certifikátom, adresy vo vnútorných sieťach odmietame.
- Prihlasovacie údaje sú v databáze šifrované (libsodium).
Stratégia dopytovania (polling)
Keďže CalDAV nepodporuje push notifikácie:
- Zmeny kontrolujeme každých 5 minút.
- Porovnáme
getctag/sync-tokenkalendára; keď sa nezmenil, udalosti znova nesťahujeme. - Keď sa zmenil, načítame udalosti celého synchronizovaného obdobia dopytom
REPORT(calendar-query). - Najmenej raz za hodinu kalendár prejdeme celý aj bez zmeny.
Formát iCalendar
Udalosti sa vymieňajú vo formáte iCalendar (RFC 5545):
- Parsujeme komponenty
VEVENT. - Extrahujeme
DTSTART,DTENDaSTATUS. - Spracúvame pravidlá opakovania (
RRULE). - Podporujeme prevod časových pásiem (
VTIMEZONE).
Známe obmedzenia
- Žiadna synchronizácia v reálnom čase: interval dopytovania 5 minút
- Závislosť od servera: vyžaduje správnu implementáciu CalDAV
- Obmedzenia firewallu: server musí byť prístupný z internetu
Nepodarilo sa? Napíšte nám a pomôžeme vám.