From b47fc579558ea5ebf93d26313f9a8e29cbbd623e Mon Sep 17 00:00:00 2001 From: Josh Date: Tue, 14 Jan 2025 09:09:32 -0500 Subject: [PATCH] docs: README formatting and instruction refactoring Signed-off-by: Josh --- README.md | 27 ++++++++++++++++++--------- 1 file changed, 18 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 83fef56..7b07118 100644 --- a/README.md +++ b/README.md @@ -12,15 +12,24 @@ The SharePoint Backend allows administrators to add SharePoint document librarie ![screenshot](screenshots/configuration.png) -Supports SharePoint 2013, 2016, 2019 (experimental) and SharePoint Online (Office 365). Nextcloud accesses SharePoint through the SharePoint REST API and uses SAML Token authentication, with a fallback to NTLM auth. Nextcloud respects file access permissions associated with its configured user credentials. Versioning and sharing are handled by Nextcloud. +* Supports SharePoint 2013, 2016, 2019 (experimental) and SharePoint Online (Office 365). +* Nextcloud accesses SharePoint through the SharePoint REST API and uses SAML Token authentication, with a fallback to NTLM auth. +* Nextcloud respects file access permissions associated with its configured user credentials. +* Versioning and sharing are handled by Nextcloud. -# How To Add Office 365 Onedrive - Make sure you have enabled [External storage support](https://docs.nextcloud.com/server/24/go.php?to=admin-external-storage) and the Sharepoint app. Then go to Administration - Settings and select External Storage and add Sharepoint as follow: - First, you need to get your remote's URL: +Learn more about External Storage and SharePoint on [https://nextcloud.com/storage/](https://nextcloud.com/storage/). -Go [here](https://onedrive.live.com/about/en-us/signin/) to open your OneDrive or to sign in -Now take a look at your address bar, the URL should look like this: https://[YOUR-DOMAIN]-my.sharepoint.com/personal/[YOUR-EMAIL]/_layouts/15/onedrive.aspx -You'll only need this URL up to the email address as "Host". After that, you'll most likely want to add "Documents" as "Document Library". That subdirectory contains the actual data stored on your OneDrive. Then enter your email as "Username" and password and you are good to go. Credit goes to [rclone](https://rclone.org/webdav/#sharepoint-online). +# How To Add Office 365 Onedrive -Learn more about External Storage and SharePoint on [https://nextcloud.com/storage/](https://nextcloud.com/storage/) +1. Enable the *[External storage support](https://docs.nextcloud.com/server/stable/go.php?to=admin-external-storage)* app. +2. Install/enable the *Sharepoint Backend* app (this app). +3. Get your remote's URL: + 1. Go [here](https://onedrive.live.com/about/en-us/signin/) to open your OneDrive or to sign in. + 2. Look at your address bar. The URL should look like this: `https://[YOUR-DOMAIN]-my.sharepoint.com/personal/[YOUR-EMAIL]/_layouts/15/onedrive.aspx`. You'll only need this URL up to the email address. + 3. You'll most likely need to append `Documents` to the URL. That subdirectory contains the actual data stored on your OneDrive. +3. In Nextcloud, go to *Administration Settings* and select *External Storage*. +4. Add a *Sharepoint* storage. +5. Enter the remote URL from above in the *Host* field (i.e. `https://[YOUR-DOMAIN]-my.sharepoint.com/personal/[YOUR-EMAIL]/Documents` +6. Enter your email as *Username* and enter your *password* and you are good to go. (Note: If you have 2FA enabled, you have to generate an app password within your Sharepoint account). + +Credit goes to [rclone](https://rclone.org/webdav/#sharepoint-online).