Všetky návody

Pripojenie CalDAV kalendára

  • Používateľské meno a heslo

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 v skratke: údaje si pripravíte u svojho poskytovateľa, zvyšok prebehne v SyncMyDay.

Postup

  1. 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ť:

    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 – zvyčajne vašu e-mailovú adresu alebo používateľské meno účtu
    3. 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.

  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“

    V zozname Ďalší poskytovatelia pod hlavnými dlaždicami kliknite na Iný CalDAV.

  4. 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.com
      • https://nextcloud.example.com/remote.php/dav
      • caldav.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.

  5. Nechajte SyncMyDay nájsť kalendáre

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

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

    Zvyčajne to trvá niekoľko sekúnd.

  6. 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.

  7. 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)

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í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:

  1. Adresa servera: https:// pridáme automaticky. Ak samotná adresa servera nestačí, zadajte úplnú URL CalDAV z dokumentácie poskytovateľa.
  2. Lomka na konci: skúste adresu s lomkou (/) na konci aj bez nej.
  3. Číslo portu: niektoré servery potrebujú výslovne uvedený 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, 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.sk aj 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 zmien
  • REPORT — 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:

  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 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-token kalendá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, DTEND a STATUS.
  • 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.