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 von 0 bis 65535. Bleibt das Feld leer, speichert Relution den Wert 0; 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 443 ein unverschlüsselter Verbindungsaufbau versucht, der fehlschlägt.
Das Feld Vorrangige URL erwartet eine vollständige URL mit Schema und Host (z. B. 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:

  1. Anfrage PROPFIND /.well-known/caldav an den unter Hostname hinterlegten Server.
  2. Der Server antwortet mit einer Umleitung (301) auf seinen DAV-Endpunkt (bei ownCloud/Nextcloud /remote.php/dav).
  3. Über den DAV-Endpunkt wird der current-user-principal und 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.

Neuere iOS-Versionen sind bei der Auswertung der Umleitung strenger als iOS 17. Eine fehlerhafte Umleitung (z. B. auf 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
Betrieb hinter einem Reverse-Proxy / TLS-Terminierung: Terminiert ein vorgelagerter Proxy die TLS-Verbindung und leitet intern per HTTP an einen anderen Port weiter (z. B. 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

SymptomUrsacheLösung
Einrichtung schlägt nur auf neueren iOS-Versionen fehl; ältere Geräte funktionieren weiterDie Umleitung verweist auf http:// (Downgrade); ältere iOS-Versionen tolerierten diesUmleitung auf https:// korrigieren
301 verweist auf einen internen Port (z. B. :8080)Reverse-Proxy/TLS-Terminierung, der Webserver kennt seine öffentliche Adresse nichtUmleitung 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 falschVorrangige URL mit abweichendem Host oder http:// statt https:// hinterlegt, oder SSL verwenden nicht aktiviertVorrangige 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:

Wie hilfreich war dieser Artikel?