Skip to content

sync_windows10.rst: Cleanup and document TLSv1.2 #7515

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 14 additions & 33 deletions user_manual/groupware/sync_windows10.rst
Original file line number Diff line number Diff line change
Expand Up @@ -21,54 +21,35 @@ Calendar

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".


Contacts
--------
1. In the bottom left of the Contacts View (in Nextcloud Contacts) look for a little impeller symbol that looks like this:

.. image:: ../images/contacts_link.png

which will display a URL that looks something like this:
https://cloud.nextcloud.com/remote.php/dav/addressbooks/users/daniel/Thunderbird/

2. Launch the Windows 10 Calendar app. Then, click the settings icon (gear icon) and select "Manage accounts".

3. Click "Add account" and choose "iCloud".

4. Enter an email, username and password. None of this information has to be valid-it will all be changed in the upcoming steps.

5. Click "Sign in" and then "Done". A message should appear indicating the settings were saved successfully.

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".

7. Scroll to the bottom of the dialog box, select "Advanced mailbox settings". Scroll once more to the bottom of the dialog box and paste your CardDAV URL in the field labelled "Contacts server (CardDAV)".

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".
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.

2. Scroll to the bottom of the dialog box, select "Advanced mailbox settings". Scroll once more to the bottom of the dialog box and paste your CardDAV URL in the field labelled "Contacts server (CardDAV)".

3. Replace the path "principals" within the URL with "addressbooks".

Troubleshooting
---------------
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".

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

**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:**

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

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.

Special thanks to this Reddit user for their post:
https://www.reddit.com/r/Nextcloud/comments/5rcypb/using_the_windows_10_calendar_application_with/
Troubleshooting: TLSv1.2
------------------------

- 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".

Contacts
--------
Credits
------

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.

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

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

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".
.. _must support TLSv1.2: https://docs.microsoft.com/en-us/windows/win32/secauthn/protocols-in-tls-ssl--schannel-ssp-