Skip to content

Commit 3e47d4a

Browse files
committed
sync_windows10.rst: Cleanup and document TLSv1.2
- Remove redundant Contacts section. The remaining section works and is simpler. - Remove redundant "repeat steps" step - Move credit to the bottom as it is just a distraction - Document the server-side TLSv1.2 requirement for Windows 10's schannel TLS client support. Signed-off-by: Bryan Drewery <[email protected]>
1 parent eeaa486 commit 3e47d4a

File tree

1 file changed

+14
-33
lines changed

1 file changed

+14
-33
lines changed

user_manual/pim/sync_windows10.rst

Lines changed: 14 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -21,54 +21,35 @@ Calendar
2121

2222
8. Click "Done". Enter your Nextcloud username and password in the appropriate fields, and change the account name to whatever you prefer (e. g. "Nextcloud Calendar"). Click "Save".
2323

24-
2524
Contacts
2625
--------
27-
1. In the bottom left of the Contacts View (in Nextcloud Contacts) look for a little impeller symbol that looks like this:
28-
29-
.. image:: ../images/contacts_link.png
30-
31-
which will display a URL that looks something like this:
32-
https://cloud.nextcloud.com/remote.php/dav/addressbooks/users/daniel/Thunderbird/
33-
34-
2. Launch the Windows 10 People app. Then, click the settings icon (gear icon) and select "Manage accounts".
35-
36-
3. Click "Add account" and choose "iCloud".
37-
38-
4. Enter an email, username and password. None of this information has to be valid-it will all be changed in the upcoming steps.
39-
40-
5. Click "Sign in" and then "Done". A message should appear indicating the settings were saved successfully.
41-
42-
6. In the "Manage Accounts" menu, click on the iCloud account created in previous steps, and select "Change settings". Then, click on "Change mailbox sync settings".
4326

44-
7. Scroll to the bottom of the dialog box, select "Advanced mailbox settings". Paste your CalDAV URL in the field labelled "Contacts server (CalDAV)".
45-
46-
8. Click "Done". Enter your Nextcloud username and password in the appropriate fields, and change the account name to whatever you prefer (e. g. "Nextcloud Contacts"). Click "Save".
27+
1. Repeat steps 1 - 7 from the Calendar instructions. If you already have setup the Calendar synchronization, you can use the same account for this.
4728

29+
2. In the "Advanced mailbox settings" paste your CalDAV URL in the field labelled "Contacts server (CardDAV)".
4830

31+
3. Replace the path "principals" within the URL with "addressbooks".
4932

50-
Troubleshooting
51-
---------------
33+
4. Click "Done". Enter your Nextcloud username and password in the appropriate fields, and change the account name to whatever you prefer (e. g. "Nextcloud"). Click "Save".
5234

53-
After following all these steps, your Nextcloud calendar should synchronize. If not, check your username and password. Otherwise, repeat these steps.
35+
Troubleshooting: 2FA
36+
--------------------
5437

5538
**NOTE: You will not be able to synchronize your calendar if you have two-factor authentication enabled. Follow the steps below to get an app password that can be used with the Calendar client app:**
5639

5740
1. Log into Nextcloud. Click on your user icon, then click on "Settings".
5841

5942
2. Click on "Security", then locate a button labeled "Create new app password". Next to this button, enter "Windows 10 Calendar app". Then, click the button, copy and paste the password. Use this password instead of your Nextcloud password for Step 8.
6043

61-
Special thanks to this Reddit user for their post:
62-
https://www.reddit.com/r/Nextcloud/comments/5rcypb/using_the_windows_10_calendar_application_with/
63-
64-
65-
Contacts
66-
--------
44+
Troubleshooting: TLSv1.2
45+
------------------------
6746

68-
1. Repeat steps 1 - 7 from the Calendar instructions. If you already have setup the Calendar synchronization, you can use the same account for this.
47+
- For Windows 10 your Nextcloud https server `must support TLSv1.2`_. This is apparent if no connection attempts are seen on the server, and the Windows client Event Viewer will display Schannel TLS errors under "Windows Logs -> System".
6948

70-
2. In the "Advanced mailbox settings" paste your CalDAV URL in the field labelled "Contacts server (CardDAV)".
49+
Credits
50+
------
7151

72-
3. Replace the path "principals" within the URL with "addressbooks".
52+
Special thanks to this Reddit user for their post:
53+
https://www.reddit.com/r/Nextcloud/comments/5rcypb/using_the_windows_10_calendar_application_with/
7354

74-
4. Click "Done". Enter your Nextcloud username and password in the appropriate fields, and change the account name to whatever you prefer (e. g. "Nextcloud"). Click "Save".
55+
.. _must support TLSv1.2: https://docs.microsoft.com/en-us/windows/win32/secauthn/protocols-in-tls-ssl--schannel-ssp-

0 commit comments

Comments
 (0)