diff --git a/.vitepress/config.mts b/.vitepress/config.mts index dae1872..246d201 100644 --- a/.vitepress/config.mts +++ b/.vitepress/config.mts @@ -27,7 +27,11 @@ export default defineConfig(({ mode }) => { { text: 'svws-core', link: '/SVWS-Server/svws-core/' }, { text: 'svws-db', link: '/SVWS-Server/svws-db/' }, { text: 'svws-db-utils', link: '/SVWS-Server/svws-db-utils/' }, - { text: 'svws-module-dav-api', link: '/SVWS-Server/svws-module-dav-api/' }, + { text: 'svws-module-dav-api', link: '/SVWS-Server/svws-module-dav-api/', collapsed: true, items: [ + { text: 'Beschreibung der Implementierung des CardDav Protokolls', link: 'SVWS-Server/svws-module-dav-api/carddav-beschreibung der implementierung.md' }, + { text: 'CardDAV API - Limitierungen', link: 'SVWS-Server/svws-module-dav-api/carddav-limitierungen.md' }, + { text: 'CalDav Limitierungen', link: 'SVWS-Server/svws-module-dav-api/caldav-limitierungen.md' }, + ] }, { text: 'svws-openapi', link: '/SVWS-Server/svws-openapi/' }, { text: 'svws-server-app', link: '/SVWS-Server/svws-server-app/' }, { text: 'svws-transpile', link: '/SVWS-Server/svws-transpile/' }, diff --git a/SVWS-Server/svws-module-dav-api/CalDav-Anwender-Doku.md b/SVWS-Server/svws-module-dav-api/CalDav-Anwender-Doku.md index 9ddcebe..2774bab 100644 --- a/SVWS-Server/svws-module-dav-api/CalDav-Anwender-Doku.md +++ b/SVWS-Server/svws-module-dav-api/CalDav-Anwender-Doku.md @@ -72,31 +72,31 @@ wird in folgenden Schritten eingerichtet: Kalenderanwendung öffnen und im Menü den Menüeintrag Datei \> Neu \> Kalender… öffnen: - +![alt text](media/caldav-import-1.png) Im Dialog „Neuen Kalender erstellen“ wählen Sie die Option Netzwerk. - +![alt text](media/caldav-import-2.png) Im nun folgenden Dialog geben Sie den Benutzername des persönlichen SVWS-Benutzeraccounts sowie die Adresse ```https://\/db/\/dav``` an. - +![alt text](media/caldav-import-3.png) Im Anschluss erscheint ein Dialog zur Passworteingabe des persönlichen SVWS-Benutzeraccounts: - +![alt text](media/caldav-import-4.png) Nach erfolgreicher Anmeldung können nun die zu synchronisierenden Kalender ausgewählt werden. Eine Mehrfachauswahl ist möglich. Die Liste der auswählbaren Kalender kann sich – abhängig von den Berechtigungen des SVWS-Benutzeraccounts und den Leserechten an verschiedenen Kalendern – unterscheiden. Die Farben können frei gewählt werden und werden in der Anzeige des Thunderbird für Termine aus verschiedenen Kalendern genutzt. - +![alt text](media/caldav-import-5.png) Nach Bestätigung der Auswahl mit der Schaltfläche „Abonnieren“ werden die Kalender in Thunderbird angezeigt. - +![alt text](media/caldav-import-6.png) Das Schloss am Kalender symbolisiert einen Kalender, auf den nur Lesend zugegriffen werden kann. diff --git a/SVWS-Server/svws-module-dav-api/carddav-limitierungen.md b/SVWS-Server/svws-module-dav-api/carddav-limitierungen.md index ec5f0d4..bc9b490 100644 --- a/SVWS-Server/svws-module-dav-api/carddav-limitierungen.md +++ b/SVWS-Server/svws-module-dav-api/carddav-limitierungen.md @@ -30,7 +30,7 @@ Folgende Einschränkungen gibt es: anzulegen (MKCOL-Methode). - Es besteht keine Möglichkeit in Adressbüchern zu suchen - („CARDDAV:addressbook-query“ REPORT + „CARDDAV:addressbook-query“ REPORT **Keine Ermittlung von Differenzdaten bei der Synchronisation möglich** @@ -78,6 +78,7 @@ selbstsignierte Zertifikate werden nicht akzeptiert, hat über HTTP aber auch nicht funktioniert: bei Versuch über HTTP zuzugreifen, wird kein Benutzername/Kennwort (Basic Auth) mitgesendet) +``` Logeintrag bei Test gegen Baikal: 172.18.0.1 \[25/Aug/2022:08:21:31 +0000\] "PROPFIND /dav.php/ HTTP/1.1" 401 414 "-" "iOS/15.6.1 (19G82) accountsd/1.0" 0.013 "BODY: "\[\\x0A\\x0A \\x0A \\x0A \\x0A\\x0A\] "Accept-Header: " \[\*/\*\] "Accept-Encoding: " \[-\] "Content-Type: " \[text/xml\] +```` Nicht erfolgreich: NextCloud (Server) Import über CardDAV ist kein Feature von NextCloud. NextCloud App scheint nur mit NextCloud Server diff --git a/SVWS-Server/svws-module-dav-api/index.md b/SVWS-Server/svws-module-dav-api/index.md index dd16da8..3a7b718 100644 --- a/SVWS-Server/svws-module-dav-api/index.md +++ b/SVWS-Server/svws-module-dav-api/index.md @@ -1,14 +1,5 @@ # CardDAV API -Inhaltsverzeichnis - * [Generierte Adressbücher](#generierte-adressbücher) - * [Zugriffschutz auf Adressdaten](#zugriffschutz-auf-adressdaten) - * [Kompatibilität mit CardDAV-Clients](#kompatibilität-mit-carddav-clients) - * [Anleitung: Import von Adressdaten über CardDAV](#anleitung-import-von-adressdaten-über-carddav) - * [Thunderbird Adressbuch (built-in)](#thunderbird-adressbuch-built-in) - * [Thunderbird Cardbook-Addon](#thunderbird-cardbook-addon) - * [Outlook CalDAV Synchonizer Addon](#outlook-caldav-synchroninizer-addon) - ## Generierte Adressbücher Folgende Adressbücher können vom SVWS-Server in Clientprogramme mit @@ -85,32 +76,27 @@ Clientprogrammen ist gegeben: OK Thunderbird: Cardbook-Addon 76.7 -https://addons.thunderbird.net/de/thunderbird/addon/cardbook/ +https://addons.thunderbird.net/de/thunderbird/addon/cardbook/ X Thunderbird: TbSync

3.0.2

2.0.2

-

https://addons.thunderbird.net/de/thunderbird/addon/tbsync

-

https://addons.thunderbird.net/de/thunderbird/addon/dav-4-tbsync

+

https://addons.thunderbird.net/de/thunderbird/addon/tbsync

+

https://addons.thunderbird.net/de/thunderbird/addon/dav-4-tbsync

OK Outlook: CalDAV Synchronizer 4.3.0 -https://caldavsynchronizer.org/ +https://caldavsynchronizer.org/ X iOS 15.6.1 -Einstellungen - Kontakte - Accounts - Account hinzufügen - Andere - -CardDAV-Account hinzufügen +Einstellungen - Kontakte - Accounts - Account hinzufügen - Andere - CardDAV-Account hinzufügen @@ -125,24 +111,23 @@ bewerkstelligt werden. Es ist also nicht zwingend erforderlich Zusatzsoftware zu installieren. Die Synchronisation mit dem SVWS-Server wird in folgenden Schritten eingerichtet: -Adressbuch-Anwendung öffnen und im Menü den Menüeintrag Datei \> Neu \> +Adressbuch-Anwendung öffnen und im Menü den Menüeintrag Datei > Neu > CardDAV-Adressbuch… öffnen: - - - +![alt text](media/image1.png) +![alt text](media/image2.png) Im Dialog „Neues CardDAV Adressbuch“ die folgenden Eingaben machen: - Benutzername: Benutzername des persönlichen SVWS-Benutzerkontos - Adresse: URL zum CardDAV API des SVWS-Servers: - https://\/db/\/carddav/ + https://server-adresse/db/svws-db-schema/carddav/ Im Anschluss erscheint ein Dialog zur Passworteingabe des persönlichen SVWS-Benutzerkontos: - +![alt text](media/image3.png) Nach erfolgreicher Anmeldung am CardDAV-API des SVWS-Servers können im Dialog „Neues CardDAV-Adressbuch“ die zu synchronisierenden Adressbücher @@ -150,7 +135,7 @@ ausgewählt werden. Eine Mehrfachauswahl ist möglich. Die Liste der auswählbaren Adressbücher kann sich – abhängig von den Berechtigungen des SVWS-Benutzerkontos – unterscheiden. - +![alt text](media/image4.png) Nach Bestätigung der Auswahl mit der Schaltfläche „Weiter“ werden die Adressbücher in Thunderbird angezeigt. @@ -164,22 +149,22 @@ Anzeige der Kontakte ermöglicht. ## Thunderbird Cardbook-Addon -Öffnen der CardBook-Anwendung und im Menü den Menüeintrag Adressbuch \> +Öffnen der CardBook-Anwendung und im Menü den Menüeintrag Adressbuch > Neues Adressbuch aufrufen, um eine Wizard zur Einrichtung des Adressbuchs zu starten. - +![alt text](media/image5.png) Im Wizard-Dialog „Neues Adressbuch hinzufügen“ die Option „Im Netzwerk“ auswählen und die Schaltfläche „Weiter“ betätigen. - +![alt text](media/image6.png) Im folgenden Wizard-Dialog dann unterhalb von „Art“ zunächst die Art des Netzwerk-Adressbuchs auf „CardDAV“ festlegen und im Anschluss die weiteren Angaben unterhalb von „Verbindung“ im Dialog ergänzen: - +![alt text](media/image7.png) - URL: URL zum CardDAV API des SVWS-Servers: @@ -192,7 +177,7 @@ kann dann mit der Schaltfläche „Weiter“ der nächste Schritt des Wizards aufgerufen werden, in dem die zu importierenden Adressbücher ausgewählt werden können: - +![alt text](media/image8.png) Eine Mehrfachauswahl wird unterstützt. @@ -201,7 +186,7 @@ Für eine zügigere Synchronisation bitte folgende Cardbook-Einstellungen verwen - Maximale Anzahl an Änderungen, die pro Synchronisation angestoßen werden: **1000** - Bei GET-Anfrage Karten gruppieren nach: **1000** - +![alt text](media/cardbook_settings.png) ## Outlook CalDAV-Synchroninizer-Addon @@ -220,7 +205,7 @@ Installationsanleitung: Nach der Installation erscheint beim Aufruf des Outlook-Kalender ein neuer Menüeintrag „CalDav Synchronizer“: - +![alt text](media/image9.png) SVWS Adressbücher einrichten: @@ -228,17 +213,17 @@ Um die Adressbücher vom SVWS-Server verbinden zu können, muss für jedes relevante Adressbuch ein „Synchronization Profile“ eingerichtet werden. Dies erfolgt über den Menüeintrag „Synchronisation Profiles“ - +![alt text](media/image10.png) Es wird der Dialog „Options“ angezeigt. Dort die Schaltfläche „Add new profile“ betätigen und im Dialog „Select Profile Type“ die Option „Generisches Profil“ auswählen. - +![alt text](media/image11.png) Die für die Verbindung erforderlichen Angaben im Profil-Dialog erfassen: - +![alt text](media/image12.png) - Name: Beliebiger Name für das zu importierende Adressbuch. Entspricht dem späteren Anzeigenamen in Outlook. @@ -247,7 +232,8 @@ Die für die Verbindung erforderlichen Angaben im Profil-Dialog erfassen: Bedarf ein neues Verzeichnis anlegen und auswählen. - DAV URL: URL zum CardDAV API des SVWS-Servers: - https://\/db/\/carddav/ + + https://server-adresse/db/svws-db-schema/carddav/ - Username: Benutzername des persönlichen SVWS-Benutzerkontos @@ -283,4 +269,4 @@ TIPP: Über die Sortierung der Kontaktliste nach dem Wert „Kategorien“ werden die heruntergeladenen Kontaktdaten gruppiert angezeigt, z.B. nach Klasse, Jahrgang oder Kurs. - +![alt text](media/image13.png) diff --git a/SVWS-Server/svws-module-dav-api/media/media/caldav-import-1.png b/SVWS-Server/svws-module-dav-api/media/caldav-import-1.png similarity index 100% rename from SVWS-Server/svws-module-dav-api/media/media/caldav-import-1.png rename to SVWS-Server/svws-module-dav-api/media/caldav-import-1.png diff --git a/SVWS-Server/svws-module-dav-api/media/media/caldav-import-4.png b/SVWS-Server/svws-module-dav-api/media/caldav-import-4.png similarity index 100% rename from SVWS-Server/svws-module-dav-api/media/media/caldav-import-4.png rename to SVWS-Server/svws-module-dav-api/media/caldav-import-4.png diff --git a/SVWS-Server/svws-module-dav-api/media/media/caldav-import-5.png b/SVWS-Server/svws-module-dav-api/media/caldav-import-5.png similarity index 100% rename from SVWS-Server/svws-module-dav-api/media/media/caldav-import-5.png rename to SVWS-Server/svws-module-dav-api/media/caldav-import-5.png diff --git a/SVWS-Server/svws-module-dav-api/media/media/caldav-import-6.png b/SVWS-Server/svws-module-dav-api/media/caldav-import-6.png similarity index 100% rename from SVWS-Server/svws-module-dav-api/media/media/caldav-import-6.png rename to SVWS-Server/svws-module-dav-api/media/caldav-import-6.png diff --git a/SVWS-Server/svws-module-dav-api/media/media/cardbook_settings.png b/SVWS-Server/svws-module-dav-api/media/cardbook_settings.png similarity index 100% rename from SVWS-Server/svws-module-dav-api/media/media/cardbook_settings.png rename to SVWS-Server/svws-module-dav-api/media/cardbook_settings.png diff --git a/SVWS-Server/svws-module-dav-api/media/media/image1.png b/SVWS-Server/svws-module-dav-api/media/image1.png similarity index 100% rename from SVWS-Server/svws-module-dav-api/media/media/image1.png rename to SVWS-Server/svws-module-dav-api/media/image1.png diff --git a/SVWS-Server/svws-module-dav-api/media/media/image10.png b/SVWS-Server/svws-module-dav-api/media/image10.png similarity index 100% rename from SVWS-Server/svws-module-dav-api/media/media/image10.png rename to SVWS-Server/svws-module-dav-api/media/image10.png diff --git a/SVWS-Server/svws-module-dav-api/media/media/image11.png b/SVWS-Server/svws-module-dav-api/media/image11.png similarity index 100% rename from SVWS-Server/svws-module-dav-api/media/media/image11.png rename to SVWS-Server/svws-module-dav-api/media/image11.png diff --git a/SVWS-Server/svws-module-dav-api/media/media/image12.png b/SVWS-Server/svws-module-dav-api/media/image12.png similarity index 100% rename from SVWS-Server/svws-module-dav-api/media/media/image12.png rename to SVWS-Server/svws-module-dav-api/media/image12.png diff --git a/SVWS-Server/svws-module-dav-api/media/media/image13.png b/SVWS-Server/svws-module-dav-api/media/image13.png similarity index 100% rename from SVWS-Server/svws-module-dav-api/media/media/image13.png rename to SVWS-Server/svws-module-dav-api/media/image13.png diff --git a/SVWS-Server/svws-module-dav-api/media/media/image2.png b/SVWS-Server/svws-module-dav-api/media/image2.png similarity index 100% rename from SVWS-Server/svws-module-dav-api/media/media/image2.png rename to SVWS-Server/svws-module-dav-api/media/image2.png diff --git a/SVWS-Server/svws-module-dav-api/media/media/image3.png b/SVWS-Server/svws-module-dav-api/media/image3.png similarity index 100% rename from SVWS-Server/svws-module-dav-api/media/media/image3.png rename to SVWS-Server/svws-module-dav-api/media/image3.png diff --git a/SVWS-Server/svws-module-dav-api/media/media/image4.png b/SVWS-Server/svws-module-dav-api/media/image4.png similarity index 100% rename from SVWS-Server/svws-module-dav-api/media/media/image4.png rename to SVWS-Server/svws-module-dav-api/media/image4.png diff --git a/SVWS-Server/svws-module-dav-api/media/media/image5.png b/SVWS-Server/svws-module-dav-api/media/image5.png similarity index 100% rename from SVWS-Server/svws-module-dav-api/media/media/image5.png rename to SVWS-Server/svws-module-dav-api/media/image5.png diff --git a/SVWS-Server/svws-module-dav-api/media/media/image6.png b/SVWS-Server/svws-module-dav-api/media/image6.png similarity index 100% rename from SVWS-Server/svws-module-dav-api/media/media/image6.png rename to SVWS-Server/svws-module-dav-api/media/image6.png diff --git a/SVWS-Server/svws-module-dav-api/media/media/image7.png b/SVWS-Server/svws-module-dav-api/media/image7.png similarity index 100% rename from SVWS-Server/svws-module-dav-api/media/media/image7.png rename to SVWS-Server/svws-module-dav-api/media/image7.png diff --git a/SVWS-Server/svws-module-dav-api/media/media/image8.png b/SVWS-Server/svws-module-dav-api/media/image8.png similarity index 100% rename from SVWS-Server/svws-module-dav-api/media/media/image8.png rename to SVWS-Server/svws-module-dav-api/media/image8.png diff --git a/SVWS-Server/svws-module-dav-api/media/media/image9.png b/SVWS-Server/svws-module-dav-api/media/image9.png similarity index 100% rename from SVWS-Server/svws-module-dav-api/media/media/image9.png rename to SVWS-Server/svws-module-dav-api/media/image9.png diff --git a/SVWS-Server/svws-module-dav-api/media/media/caldav-import-2.png b/SVWS-Server/svws-module-dav-api/media/media/caldav-import-2.png deleted file mode 100644 index 8af5406..0000000 Binary files a/SVWS-Server/svws-module-dav-api/media/media/caldav-import-2.png and /dev/null differ diff --git a/SVWS-Server/svws-module-dav-api/media/media/caldav-import-3.png b/SVWS-Server/svws-module-dav-api/media/media/caldav-import-3.png deleted file mode 100644 index d14241a..0000000 Binary files a/SVWS-Server/svws-module-dav-api/media/media/caldav-import-3.png and /dev/null differ