Skip to content

Commit

Permalink
bugfixes dav
Browse files Browse the repository at this point in the history
  • Loading branch information
hmt committed Apr 18, 2024
1 parent a33ae19 commit b2af9e0
Show file tree
Hide file tree
Showing 24 changed files with 38 additions and 46 deletions.
6 changes: 5 additions & 1 deletion .vitepress/config.mts
Original file line number Diff line number Diff line change
Expand Up @@ -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/' },
Expand Down
12 changes: 6 additions & 6 deletions SVWS-Server/svws-module-dav-api/CalDav-Anwender-Doku.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,31 +72,31 @@ wird in folgenden Schritten eingerichtet:
Kalenderanwendung öffnen und im Menü den Menüeintrag Datei \> Neu \>
Kalender… öffnen:

<img src="./media/media/caldav-import-1.png" width="350px"/>
![alt text](media/caldav-import-1.png)

Im Dialog „Neuen Kalender erstellen“ wählen Sie die Option Netzwerk.

<img src="./media/media/caldav-import-2.png" width="350px"/>
![alt text](media/caldav-import-2.png)

Im nun folgenden Dialog geben Sie den Benutzername des persönlichen SVWS-Benutzeraccounts sowie die Adresse ```https://\<server-adresse\>/db/\<svws-db-schema\>/dav``` an.

<img src="./media/media/caldav-import-3.png" width="350px"/>
![alt text](media/caldav-import-3.png)

Im Anschluss erscheint ein Dialog zur Passworteingabe des persönlichen
SVWS-Benutzeraccounts:

<img src="./media/media/caldav-import-4.png" width="350px"/>
![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.

<img src="./media/media/caldav-import-5.png" width="350px"/>
![alt text](media/caldav-import-5.png)

Nach Bestätigung der Auswahl mit der Schaltfläche „Abonnieren“ werden die
Kalender in Thunderbird angezeigt.

<img src="./media/media/caldav-import-6.png" width="350px"/>
![alt text](media/caldav-import-6.png)

Das Schloss am Kalender symbolisiert einen Kalender, auf den nur Lesend zugegriffen werden kann.
4 changes: 3 additions & 1 deletion SVWS-Server/svws-module-dav-api/carddav-limitierungen.md
Original file line number Diff line number Diff line change
Expand Up @@ -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**

Expand Down Expand Up @@ -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: "\[\<?xml version=\x221.0\x22
Expand All @@ -86,6 +87,7 @@ encoding=\x22UTF-8\x22?\>\x0A\<A:propfind xmlns:A=\x22DAV:\x22\>\x0A
\<A:principal-URL/\>\x0A \<A:resourcetype/\>\x0A
\</A:prop\>\x0A\</A:propfind\>\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
Expand Down
62 changes: 24 additions & 38 deletions SVWS-Server/svws-module-dav-api/index.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down Expand Up @@ -85,32 +76,27 @@ Clientprogrammen ist gegeben:
<td>OK</td>
<td>Thunderbird: Cardbook-Addon</td>
<td>76.7</td>
<td><a
href="https://addons.thunderbird.net/de/thunderbird/addon/cardbook/">https://addons.thunderbird.net/de/thunderbird/addon/cardbook/</a></td>
<td><a href="https://addons.thunderbird.net/de/thunderbird/addon/cardbook/">https://addons.thunderbird.net/de/thunderbird/addon/cardbook/</a></td>
</tr>
<tr class="odd">
<td>X</td>
<td>Thunderbird: TbSync</td>
<td><p>3.0.2</p>
<p>2.0.2</p></td>
<td><p><a
href="https://addons.thunderbird.net/de/thunderbird/addon/tbsync">https://addons.thunderbird.net/de/thunderbird/addon/tbsync</a></p>
<p><a
href="https://addons.thunderbird.net/de/thunderbird/addon/dav-4-tbsync">https://addons.thunderbird.net/de/thunderbird/addon/dav-4-tbsync</a></p></td>
<td><p><a href="https://addons.thunderbird.net/de/thunderbird/addon/tbsync">https://addons.thunderbird.net/de/thunderbird/addon/tbsync</a></p>
<p><a href="https://addons.thunderbird.net/de/thunderbird/addon/dav-4-tbsync">https://addons.thunderbird.net/de/thunderbird/addon/dav-4-tbsync</a></p></td>
</tr>
<tr class="even">
<td>OK</td>
<td>Outlook: CalDAV Synchronizer</td>
<td>4.3.0</td>
<td><a
href="https://caldavsynchronizer.org/">https://caldavsynchronizer.org/</a></td>
<td><a href="https://caldavsynchronizer.org/">https://caldavsynchronizer.org/</a></td>
</tr>
<tr class="odd">
<td>X</td>
<td>iOS</td>
<td>15.6.1</td>
<td>Einstellungen - Kontakte - Accounts - Account hinzufügen - Andere -
CardDAV-Account hinzufügen</td>
<td>Einstellungen - Kontakte - Accounts - Account hinzufügen - Andere - CardDAV-Account hinzufügen</td>
</tr>
</tbody>
</table>
Expand All @@ -125,32 +111,31 @@ 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:

<img src="./media/media/image1.png"/>

<img src="./media/media/image2.png"/>
![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://\<server-adresse\>/db/\<svws-db-schema\>/carddav/
https://server-adresse/db/svws-db-schema/carddav/

Im Anschluss erscheint ein Dialog zur Passworteingabe des persönlichen
SVWS-Benutzerkontos:

<img src="./media/media/image3.png"/>
![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
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.

<img src="./media/media/image4.png"/>
![alt text](media/image4.png)

Nach Bestätigung der Auswahl mit der Schaltfläche „Weiter“ werden die
Adressbücher in Thunderbird angezeigt.
Expand All @@ -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.

<img src="./media/media/image5.png"/>
![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.

<img src="./media/media/image6.png"/>
![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:

<img src="./media/media/image7.png"/>
![alt text](media/image7.png)

- URL: URL zum CardDAV API des SVWS-Servers:

Expand All @@ -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:

<img src="./media/media/image8.png"/>
![alt text](media/image8.png)

Eine Mehrfachauswahl wird unterstützt.

Expand All @@ -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**

<img src="./media/media/cardbook_settings.png" />
![alt text](media/cardbook_settings.png)

## Outlook CalDAV-Synchroninizer-Addon

Expand All @@ -220,25 +205,25 @@ Installationsanleitung:
Nach der Installation erscheint beim Aufruf des Outlook-Kalender ein
neuer Menüeintrag „CalDav Synchronizer“:

<img src="./media/media/image9.png"/>
![alt text](media/image9.png)

SVWS Adressbücher einrichten:

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“

<img src="./media/media/image10.png"/>
![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.

<img src="./media/media/image11.png"/>
![alt text](media/image11.png)

Die für die Verbindung erforderlichen Angaben im Profil-Dialog erfassen:

<img src="./media/media/image12.png"/>
![alt text](media/image12.png)

- Name: Beliebiger Name für das zu importierende Adressbuch. Entspricht
dem späteren Anzeigenamen in Outlook.
Expand All @@ -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://\<server-adresse\>/db/\<svws-db-schema\>/carddav/

https://server-adresse/db/svws-db-schema/carddav/

- Username: Benutzername des persönlichen SVWS-Benutzerkontos

Expand Down Expand Up @@ -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.

<img src="./media/media/image13.png"/>
![alt text](media/image13.png)
Binary file not shown.
Binary file not shown.

0 comments on commit b2af9e0

Please sign in to comment.