Skip to content
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.

Sign up for GitHub

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

docs: README formatting and instruction refactoring #223

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

docs: README formatting and instruction refactoring #223

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
27 changes: 18 additions & 9 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Documents should be entered in the Document Library field, not as part of the Host URL.

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