SyncMyDay
Vyskúšať zadarmo
Všetky návody

Pripojenie CalDAV kalendára

  • Používateľské meno a heslo

CalDAV je otvorený štandardný protokol na prístup ku kalendárovým dátam cez internet. Podporuje ho mnoho kalendárových služieb, napríklad Fastmail, Nextcloud, SOGo, Radicale, Baikal alebo Synology Calendar.

Postup

  1. Zhromaždite svoje CalDAV údaje

    Pred pripojením musíte nájsť informácie o vašom CalDAV serveri. Tie sa obvykle nachádzajú v:

    • dokumentácii pomoci vášho poskytovateľa,
    • stránke nastavení účtu,
    • e-maile od vášho poskytovateľa pri registrácii.

    Budete potrebovať:

    1. 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.
    2. Používateľské meno – obvykle vaša e-mailová adresa alebo používateľské meno účtu
    3. Heslo – heslo vášho účtu alebo heslo pre aplikáciu

    Údaje pre Fastmail, Nextcloud, SOGo a Synology Calendar nájdete nižšie v časti Obľúbení poskytovatelia CalDAV.

  2. Prejdite na stránku Kalendáre

    V SyncMyDay kliknite v menu na Kalendáre, alebo prejdite priamo na stránku Kalendáre.

  3. Kliknite na „Iný CalDAV“

    Nájdite dlaždicu Iný CalDAV a kliknite na ňu.

  4. Zadajte svoje CalDAV prihlasovacie údaje

    Vyplňte formulár údajmi, ktoré ste zhromaždili:

    • Adresa servera – adresa servera alebo priamo URL CalDAV, napríklad:
      • https://caldav.fastmail.com
      • https://nextcloud.example.com/remote.php/dav
      • caldav.example.com (https:// pridáme automaticky)
    • Používateľské meno – obvykle vaša e-mailová adresa (napr. vy@example.com) alebo používateľské meno
    • Heslo – heslo vášho účtu alebo heslo pre aplikáciu (ak to 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.

  5. Nechajte SyncMyDay nájsť kalendáre

    Kliknite na Nájsť kalendáre. SyncMyDay pritom:

    1. overí, že je server dosiahnuteľný cez HTTPS,
    2. prihlási sa vašimi prihlasovacími údajmi,
    3. vyhľadá dostupné kalendáre.

    To obvykle trvá niekoľko sekúnd.

  6. Vyberte kalendár

    Uvidíte zoznam kalendárov dostupných na vašom CalDAV serveri. Vyberte ten, ktorý chcete synchronizovať, prípadne upravte jeho názov a kliknite na Dokončiť nastavenie. Vybraný kalendár môžete neskôr zmeniť v jeho detaile cez Upraviť.

    Typické kalendáre, ktoré môžete vidieť:

    • Osobný – váš hlavný kalendár
    • Práca – pracovné udalosti
    • Rodina – zdieľaný rodinný kalendár
    • akékoľvek vlastné kalendáre, ktoré ste vytvorili

    Kalendár označený Len na čítanie môže byť len zdrojom jednosmerného pravidla. Blokácie doň zapisovať nejde a obojsmernú synchronizáciu s ním nenastavíte.

  7. Pripojenie dokončené

    Váš CalDAV kalendár je teraz pripojený a pripravený na použitie.

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 povolené 2FA)

Dokumentácia Fastmail CalDAV

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íček 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íček Kalendár a CalDAV je povolený v nastaveniach Kalendára.

Riešenie problémov

„Server … nie je dostupný“ alebo „Server … nemá platný certifikát“

Skontrolujte tieto časté problémy:

  1. Adresa servera: https:// pridáme automaticky. Ak samotná adresa servera nestačí, zadajte úplnú URL CalDAV z dokumentácie poskytovateľa.
  2. Lomky na konci: skúste adresu s lomkou (/) na konci aj bez nej.
  3. Číslo portu: niektoré servery potrebujú explicitný port (napr. :8443).
  4. 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.
  5. Dostupnosť z internetu: server, na ktorý sa dostanete len z vnútornej siete alebo cez VPN, pripojiť nejde.

„CalDAV odmietol prihlasovacie údaje.“

Časté príčiny:

  • nesprávne používateľské meno alebo heslo,
  • potreba použiť heslo pre aplikáciu (ak je povolené 2FA),
  • zlý formát používateľského mena (skúste s @domena.sk aj bez),
  • účet uzamknutý alebo deaktivovaný.

Riešenie: skontrolujte prihlasovacie údaje, vygenerujte heslo pre aplikáciu, ak je potrebné, 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 aspoň jeden kalendár vo vašom účte.
  • Skontrolujte, že kalendáre nie sú skryté alebo archivované.
  • Skúste vytvoriť testovací kalendár vo webovom rozhraní vášho 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.

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:

  • To je normálne kvôli obmedzeniam protokolu CalDAV.
  • Push notifikácie v reálnom čase nie sú dostupné.
  • Frekvencia pollingu vyvažuje odozvu so zaťažením servera.

Potrebujete rýchlejšiu synchronizáciu? Zvážte použitie Google Calendar alebo Microsoft 365, ktoré podporujú webhooky v reálnom čase.

Ďalšie kroky

Pripojte ďalší kalendár Na pravidlo synchronizácie potrebujete aspoň 2 kalendáre. Otvoriť Vytvorte prvé pravidlo Nastavte, odkiaľ a kam sa obsadenosť prenáša, a pridajte filtre. Otvoriť

Technické detaily

Pre vývojárov a IT

Protokol CalDAV (RFC 4791)

SyncMyDay implementuje CalDAV štandard pomocou:

  • PROPFIND — objavovanie kalendárov, ich oprávnení a značiek zmien
  • REPORT — dotazovanie kalendárových dát (calendar-query)
  • PUT — vytváranie a aktualizácia blokácií
  • DELETE — odstraňovanie blokácií

Objavovanie služby

Používame WebDAV service discovery na nájdenie kalendárových kolekcií:

  1. Skúsime zadanú URL; ak na nej CalDAV neodpovedá, skúsime /.well-known/caldav (RFC 6764).
  2. Cez current-user-principal nájdeme vlastnosť calendar-home-set.
  3. V home sete vyhľadáme kalendárové kolekcie.
  4. Podľa current-user-privilege-set rozpozná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 to 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 pollingu

Pretože CalDAV nepodporuje push notifikácie:

  • Zmeny kontrolujeme každých 5 minút.
  • Porovnáme getctag / sync-token kalendára; keď sa nezmenil, udalosti znova nesťahujeme.
  • Keď sa zmenil, načítame udalosti celého synchronizovaného obdobia dotazom 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, DTEND, STATUS.
  • Spracovávame pravidlá opakovania (RRULE).
  • Podporujeme konverziu časových pásiem (VTIMEZONE).

Známe obmedzenia

  • Žiadna synchronizácia v reálnom čase: 5-minútový interval pollingu
  • 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.