Background

CentreStack supports connecting to SharePoint Online document libraries via CentreStack Team Folders. In this way, SharePoint Online document libraries may be viewed in via the CentreStack drive letter, or in the CentreStack portal, alongside other CentreStack Team Folders.

Known Limitations

• CentreStack build 9.2.5126.40535 or later is required.
• SharePoint Online Document Libraries are per CentreStack tenant

Configuration

1. Login as the CentreStack cluster admin or tenant admin.
2. From the Dashboard click on the tenant that will be configured for SharePoint Online access.
3. Click on the CONTROL PANEL button at the right of the page.
4. Click on Sharepoint Online Integration
5. Click Edit
6. Copy the text in the Callback URL Paste it into a text editor for now.
7. Sign into https://portal.azure.com as a global administrator for the Azure AD tenant.
8. In the left-most blade click Azure Active Directory:
   
9. In the next blade click App registrations:
   
   
10. In the next blade click New registration:
    
11. In the Register an application blade use these settings:
    Name: AccessSharePointFromCentreStack
    Supported account types:  Accounts in this organizational directory only (hadroncloud only - Single tenant)
    Redirect URI: Web: <the Callback URL from the CentreStack Storage Manager>
    
    
12. Click the Register button at the bottom of the Register an application blade.
13. The CentreStack configuration requires the Application ID and Tenant Id (Directory Id). Click on the Overview node in the app registration blade and copy the Application (client) ID and Directory (tenant) ID to the clipboard and paste both values into a text editor.
    
14. In the Branding node,  update the Home page URL with the Callback URL from the CentreStack portal then click the Save button:
    
15. In the app registration blade, click on the  API permissions node then click the Add a permission button:
    
16. Click on the SharePoint card:
    
    
    
17. In the Request API permissions blade, click the Delegated permissions card:
    
18. Expand the AllSites node and enable the AllSites.Read and AllSites.Write options. Expand the MyFiles node and enable the MyFiles.Read and MyFiles.Write options then click the Add permissions button:
    
19. In the app registration blade, click on the Expose an API node, then click the Add a scope button.
20. In the Add a scope blade, click the Save and continue button:
    
21. In the Add a scope blade make sure to enable Admins and users in the Who can consent option. Other text fields are arbitrary:
    
    Click the Add scope button once the Add a scope blade is filled in.
22. Back in the app registration blade, click on the Certificates & secrets node then click the New client secret button:
    
23. In the Add a client secret blade, type some text in the Description such as Secret (the value is arbitrary). The Expires option allows you to configure how long until the password expires. Select an Expires value appropriate for the security requirements for your organization then click the Add button:
    
24. The value of the secret will be generated automatically. Click the Copy to clipboard icon:
    
25. Paste the secret into an text editor and verify that the value in the text editor matches the Azure portal.
26. Login as the CentreStack cluster admin or tenant admin.
27. From the Dashboard click on the tenant that will be configured for SharePoint Online access.
28. Click on the CONTROL PANEL button at the right of the page.
29. Enable the Sharepoint Online Integration option.
30. Click Edit
    1. Scroll down to Sharepoint Online and click the option to enable it.
    2. In the Client ID field paste in the value from Azure AD's Application (client) ID
    3. In the Client Secret field paste in the value from Azure AD's password Value field.
    4. In the Tenant Id, use the text corresponding to the Directory (tenant) ID from the Azure portal.
       
    5. Click Apply at the upper right of the page to save the settings.
31. Click on TENANT DASHBOARD at the top of the page.
32. Click on Create Team Folder:
    
33. Click on Cloud Storage:
    
34. Click on Microsoft SharePoint Online:
    
35. In the Folder name field use a name like the SharePoint Online site name then click Next:
    
36. Paste the URL of the SharePoint Online site into the text box, then click on Get Authorization Code:
    Important Note:  The Team Folder integration for SharePoint Online has been enhanced in later versions to support Team Folder mappings to multiple document libraries under the same SharePoint site rather than mapping to the root of the site collection.   This can be noted by the example provided on the account configuration screen.
37. Enable the Consent on behalf of your organization option then click the Accept button:
    
38. Click Finish
39. Click Add Collaborator:
    
    
40. Add the appropriate users or groups, then click the Save icon:
    
    
41. The collaborators you added will have the new Team Folder in their CentreStack drive.