From 4298c7b67578243c31992c6e3b100da774b931b8 Mon Sep 17 00:00:00 2001 From: Benjamin Lipp Date: Wed, 4 Dec 2024 11:47:32 +0100 Subject: [PATCH 1/2] Update sync_ios.rst: Clarify how to use TLS in CalDAV URLs Signed-off-by: Benjamin Lipp --- user_manual/groupware/sync_ios.rst | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/user_manual/groupware/sync_ios.rst b/user_manual/groupware/sync_ios.rst index 85c20bc7cb9..918f8ff8993 100644 --- a/user_manual/groupware/sync_ios.rst +++ b/user_manual/groupware/sync_ios.rst @@ -16,11 +16,16 @@ Calendar #. Enter your user name and password. #. Select Next. #. Open Advanced Settings -#. For server, type the domain name of your server and username i.e. ``example.com/remote.php/dav/principals/users/username/`` +#. For server, type the domain name of your server and username, i.e., ``example.com/remote.php/dav/principals/users/username/``. #. Close Advanced Settings Your calendar will now be visible in the Calendar application. +.. note:: It is important **not** to type the protocol (``https://``) as prefix of the URL. + The application automatically uses TLS, which you can confirm in “Advanced Settings” of the account after saving. + If you explicitly add the protocol, you need to also explicitly specify the port, + i.e., ``https://example.com:443/remote.php/dav/principals/users/username/`` + .. note:: Beginning with iOS 12 an SSL encryption is necessary. Therefore do **not** disable **SSL** (For this reason a certificate is required at your domain, https://letsencrypt.org/ will do). From 3bc2de49fc5b3e24b1c3f50496814fb61274edef Mon Sep 17 00:00:00 2001 From: Benjamin Lipp Date: Wed, 4 Dec 2024 12:36:19 +0100 Subject: [PATCH 2/2] sync_ios.rst: Clarify specification of protocol and port Signed-off-by: Benjamin Lipp --- user_manual/groupware/sync_ios.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/user_manual/groupware/sync_ios.rst b/user_manual/groupware/sync_ios.rst index 918f8ff8993..a221ed12ae6 100644 --- a/user_manual/groupware/sync_ios.rst +++ b/user_manual/groupware/sync_ios.rst @@ -21,10 +21,11 @@ Calendar Your calendar will now be visible in the Calendar application. -.. note:: It is important **not** to type the protocol (``https://``) as prefix of the URL. - The application automatically uses TLS, which you can confirm in “Advanced Settings” of the account after saving. - If you explicitly add the protocol, you need to also explicitly specify the port, - i.e., ``https://example.com:443/remote.php/dav/principals/users/username/`` +.. note:: If you get an error message related to SSL, you can try the following: Make sure that you + either specify both the protocol (``https://``) and the port (usually ``443``) in the ``Server`` field, + i.e., ``https://example.com:443/remote.php/dav/principals/users/username/``, + or none, like in the step-by-step guide above. Either way, the application automatically tries to use SSL, + which you can confirm in “Advanced Settings” of the account after saving. .. note:: Beginning with iOS 12 an SSL encryption is necessary. Therefore do **not** disable **SSL** (For this reason a certificate is required at your domain, https://letsencrypt.org/ will do).