Kalender (CalDAV)
Mit der Konfiguration Kalender wird ein CalDAV-Konto per Konfigurationsprofil an die native Kalender-App von iOS und iPadOS übergeben. Für den Endanwender entfällt damit die manuelle Einrichtung. Die zum Konto gehörenden Kalenderpfade werden auf aktuellen iOS-Versionen automatisch nach RFC 6764 über eine Umleitung unter /.well-known/caldav ermittelt. Eine korrekt eingerichtete serverseitige /.well-known/caldav-Umleitung ist deshalb auf aktuellen iOS-Versionen zwingende Voraussetzung; die alleinige Angabe einer Vorrangigen URL (Principal-URL) genügt dort nicht mehr.
Die Konfiguration steht auch für Geräte mit Benutzer-Einschreibung → zur Verfügung. Im Formular ist sie entsprechend mit Unterstützt Benutzerregistrierung gekennzeichnet.
Auf Shared iPads stellt Relution die Konfiguration über den Benutzerkanal zu. Das Konto wird damit im Profil des angemeldeten Benutzers installiert und nicht geräteweit.
Konfigurationsmöglichkeiten
Die Konfiguration wird im Relution-Portal über Geräte → Richtlinien → {iOS-Richtlinie} → Hinzufügen → Kalender → Details hinzufügen angelegt. Konfigurationen lassen sich nur im Entwurf einer Richtlinie hinzufügen und bearbeiten; in anderen Versionen sind die Felder schreibgeschützt, und Speichern wird nicht angezeigt (siehe Richtlinien-Versionierung →). Das Formular trägt beim Anlegen den Titel Kalender erstellen, beim Bearbeiten einer gespeicherten Konfiguration den Titel Kalender bearbeiten.
Pro Richtlinie können mehrere Konfigurationen Kalender angelegt werden, etwa für mehrere CalDAV-Konten. In der Konfigurationsliste der Richtlinie und bei der Auswahl für Per Account VPN erscheint jede Konfiguration mit ihrer Kontenbeschreibung als Name; ohne Kontenbeschreibung bleibt der Name leer.
Die folgenden Felder stehen für das CalDAV-Konto zur Verfügung. Sie entsprechen den Schlüsseln des Apple-CalDAV-Payloads (com.apple.caldav.account).
Kontoeinstellungen
Das Formular zeigt die Felder im Bereich Allgemein in dieser Reihenfolge:
- Kontenbeschreibung — Anzeigename des Kontos auf dem Gerät.
- Hostname (Pflichtfeld) — Serveradresse als DNS-Name ohne Schema, Port und Pfad (z. B.
kalender.example.com). Reine IP-Adressen werden nicht akzeptiert. Ungültige Eingaben markiert das Formular mit „muss ein gültiger Hostname sein“; die Konfiguration lässt sich dann nicht speichern. - Port — in der Regel
443. Das Feld ist nicht vorbelegt. Zulässig sind Werte von0bis65535. Bleibt das Feld leer, speichert Relution den Wert0; er erscheint beim erneuten Öffnen im Feld und wird so auch im Profil übertragen. - Vorrangige URL (optional) — vollständige URL zum Benutzer-Principal mit Schema und Host (z. B.
https://kalender.example.com/remote.php/dav/principals/users/${user.name}/). - Benutzername (Pflichtfeld) — manuell oder über Platzhalter wie
${user.name}bzw.${user.email}. Weitere Platzhalter sind im Bereich Verfügbare Platzhalter unterhalb des Formulars aufgeführt. - Passwort — bei fehlender Angabe erfolgt die Abfrage bei der Profilinstallation am Gerät. Ein gespeichertes Passwort wird im Formular nicht angezeigt; das Feld zeigt dann
*****. Bleibt es beim Bearbeiten unverändert, bleibt das gespeicherte Passwort erhalten. Eine neue Eingabe ersetzt es; wird das Feld nach einer Eingabe leer gespeichert, entfällt das gespeicherte Passwort. Weitere Informationen: Passwörter und Schlüssel in Konfigurationen → - SSL verwenden — standardmäßig aktiviert; bei Erreichbarkeit über HTTPS aktiviert lassen. Ohne aktives SSL wird bei Port
443ein unverschlüsselter Verbindungsaufbau versucht, der fehlschlägt.
https://kalender.example.com/...). Ein reiner Pfad wie /remote.php/dav/... wird als ungültig markiert („muss eine gültige URL sein“), und die Konfiguration lässt sich nicht speichern. Host und Schema der URL sollten zu Hostname und SSL verwenden passen. Auf aktuellen iOS-Versionen ersetzt eine gesetzte Vorrangige URL die automatische Erkennung jedoch nicht mehr — maßgeblich ist eine korrekt eingerichtete /.well-known/caldav-Umleitung. Das Feld kann daher leer bleiben.Beispiel: Kalenderkonto je Benutzer
Jeder Benutzer erhält seinen Kalender vom Server kalender.example.com, auf dem /.well-known/caldav eingerichtet ist (siehe Serverseitige Einrichtung der Umleitung →). Der Benutzername in Relution entspricht dem Anmeldenamen am Kalenderserver.
- Kontenbeschreibung:
Firmenkalender - Hostname:
kalender.example.com - Port:
443 - Vorrangige URL: leer
- Benutzername:
${user.name} - Passwort: leer
- SSL verwenden: aktiviert
Nach der Installation des Profils erscheint in der Kalender-App das Konto Firmenkalender. Das Passwort wird am Gerät abgefragt, die Kalender ermittelt iOS über /.well-known/caldav.
Per Account VPN
Das CalDAV-Konto kann in einer VPN-Konfiguration im Bereich Per Account VPN referenziert werden, sodass die Verbindung zum Kalenderserver über dieses VPN aufgebaut wird. Im Formular der Konfiguration Kalender erscheint dann der Hinweis „Diese Konfiguration ist in einer VPN Konfiguration referenziert.“ mit dem Link Referenzierte Konfiguration anzeigen. Die Einrichtung des VPN ist unter App zu VPN Zuordnung → beschrieben.
Automatische Erkennung über .well-known
Aktuelle iOS-Versionen richten CalDAV-Konten nach RFC 6764 ein. Der Ablauf ist dabei:
- Anfrage
PROPFIND /.well-known/caldavan den unter Hostname hinterlegten Server. - Der Server antwortet mit einer Umleitung (
301) auf seinen DAV-Endpunkt (bei ownCloud/Nextcloud/remote.php/dav). - Über den DAV-Endpunkt wird der
current-user-principalund darüber der Kalender-Bereich des Benutzers ermittelt.
Die zuverlässige Einrichtung hängt damit vollständig von einer korrekten /.well-known-Umleitung ab. Auf neueren iOS-Versionen lässt sich die automatische Erkennung nicht mehr durch Angabe einer Vorrangigen URL umgehen — ohne funktionierende /.well-known-Umleitung schlägt die Einrichtung fehl, selbst wenn eine Vorrangige URL hinterlegt ist.
http:// statt https://), die unter iOS 17 noch toleriert wurde, führt auf aktuellen Versionen zum Abbruch der Erkennung. Bereits unter iOS 17 eingerichtete Konten auf Altgeräten können dabei weiterhin funktionieren, während Neueinrichtungen fehlschlagen.Serverseitige Einrichtung der Umleitung
/.well-known/caldav und /.well-known/carddav müssen per 301 auf den DAV-Endpunkt des Servers umleiten. Die Ziel-Adresse muss zwingend mit https:// beginnen und darf keinen internen Port enthalten.
Für nginx:
location = /.well-known/caldav { return 301 https://$host/remote.php/dav; }
location = /.well-known/carddav { return 301 https://$host/remote.php/dav; }
Für Apache (im vHost):
Redirect 301 /.well-known/caldav https://kalender.example.com/remote.php/dav
Redirect 301 /.well-known/carddav https://kalender.example.com/remote.php/dav
8080), kennt der Webserver seine öffentliche Adresse häufig nur als http auf dem internen Port. Eine daraus erzeugte Umleitung lautet dann fehlerhaft z. B. http://kalender.example.com:8080/remote.php/dav. Da aktuelle iOS-Versionen einem Wechsel von https auf http nicht folgen, schlägt die Erkennung fehl. In diesem Fall ist die Umleitung mit vollständiger https://-Zieladresse zu setzen — entweder direkt am TLS-terminierenden Proxy oder als absolute Ziel-URL wie im Apache-Beispiel.Verifizierung
Die Umleitung lässt sich mit curl prüfen:
curl -sI https://kalender.example.com/.well-known/caldav
Die Antwort muss eine Umleitung mit korrektem location-Header enthalten:
HTTP/2 301
location: https://kalender.example.com/remote.php/dav
Der location-Header muss mit https:// beginnen und darf keinen internen Port (z. B. :8080) enthalten.
Fehlerbehebung
| Symptom | Ursache | Lösung |
|---|---|---|
| Einrichtung schlägt nur auf neueren iOS-Versionen fehl; ältere Geräte funktionieren weiter | Die Umleitung verweist auf http:// (Downgrade); ältere iOS-Versionen tolerierten dies | Umleitung auf https:// korrigieren |
301 verweist auf einen internen Port (z. B. :8080) | Reverse-Proxy/TLS-Terminierung, der Webserver kennt seine öffentliche Adresse nicht | Umleitung mit vollständiger https://-Adresse am Proxy oder Webserver setzen |
405 Method Not Allowed auf Pfaden wie / oder /principals/ | Die automatische Erkennung greift nicht und probiert Standardpfade, die auf dem Server nicht existieren | /.well-known-Umleitung korrekt einrichten (auf neueren iOS-Versionen zwingend) |
| Der ermittelte Pfad ist offensichtlich falsch | Vorrangige URL mit abweichendem Host oder http:// statt https:// hinterlegt, oder SSL verwenden nicht aktiviert | Vorrangige URL mit https:// und dem unter Hostname eingetragenen Server angeben oder leer lassen, SSL verwenden aktivieren |
Eingrenzung am Gerät
Zur Eingrenzung kann ein CalDAV-Konto testweise direkt am Gerät unter Einstellungen → Kalender → Accounts eingerichtet werden. Verbindet sich das manuell eingerichtete Konto, während das per Profil verteilte Konto fehlschlägt, liegt die Ursache in der automatischen Erkennung (/.well-known) bzw. in der über das Profil verteilten Vorrangigen URL — nicht am Server selbst.
Verwendung unter macOS
Die CalDAV-Konfiguration und die serverseitige /.well-known-Voraussetzung gelten für macOS identisch: