Background

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

Known Limitations

• Triofox builds 12.2 or later are required.
• SharePoint Online Document Libraries are per Triofox tenant

Configuration

1. Log in as the Triofox cluster-admin.
2. From the Dashboard click on the Settings link at the left of the page.
3. Click on Sharepoint Online Integration
4. Click Edit
5. Copy the text in the Callback URL and Paste it into a text editor for now.
6. Sign in to https://portal.azure.com as a global administrator for the Azure AD tenant.
7. In the left-most blade click Microsoft Entra ID:
   
   
8. In the next blade click App registrations:
   
   
9. In the next blade click New registration:
   
10. In the Register an application blade use these settings:
    Name: AccessSharePointFromTriofox
    Supported account types:  Accounts in this organizational directory only (hadroncloud only - Single tenant)
    Redirect URI: Web: <the Callback URL from the Triofox Storage Manager>
    
    
11. Click the Register button at the bottom of the Register an application blade.
12. The Triofox 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.
    
13. In the Branding node,  update the Home page URL with the Callback URL from the Triofox portal then click the Save button:
    
14. In the app registration blade, click on the  API permissions node then click the Add a permission button:
    
15. Click on the SharePoint card:
    
    
    
16. In the Request API permissions blade, click the Delegated permissions card:
    
17. 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:
    
18. In the app registration blade, click on the Expose an API node, then click the Add a scope button.
19. In the Add a scope blade, click the Save and continue button:
    
20. 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.
21. Back in the app registration blade, click on the Certificates & secrets node then click the New client secret button:
    
22. 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:
    
23. The VALUE of the secret will be generated automatically. Click the Copy to clipboard icon:
    
24. Paste the secret value into a text editor and verify that the value in the text editor matches the Azure portal.
25. Log in as a Triofox cluster-admin.
26. Go to "Settings" > "Sharepoint Online Integration" (See Step 3)
27. 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 Client  secrete 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.
28. Click on DASHBOARD at the top of the page.
29. Click on Add a Share:
    
30. Click Next
    
    
31. Paste the URL of the SharePoint Online site into the text box, then click on Get Authorization Code:
    Important Note:  The Share integration for SharePoint Online has been enhanced in later versions to support Published Shares 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.
32. Enable the Consent on behalf of your organization option then click the Accept button:
    
33. Click Finish
34. Click Publish 
35. Click Add Users. The users you added will have the published share in their Triofox drive.