Table of Contents
Microsoft Teams Integration
The File Fabric Teams App extends Microsoft Teams collaboration to data outside of Microsoft 365, allowing access to and sharing of files stored on Azure Blob Storage, Amazon S3, Azure Files, mounted file systems including SMB, and dozens of other storage systems.
Users can search, browse folders, and share links right from within Teams desktop, mobile, and web applications. They can edit documents from the app using Cloud Edit or Microsoft Office Online. Teams “deep links” allow users to navigate to specific files and folders directly from conversations and wikis for example.
- US and EU/UK SaaS platforms
- Enterprise File Fabric Appliance (from version 2106.03)
For SaaS customers a Microsoft Teams app is available through the Microsoft AppSource site. The app supports both US and EU/UK sites.
Enterprise appliance customers (IaaS and self-hosted) will customize and deploy their own Teams app following the instructions below.
Please see below for a short five-minute introduction to some of the Microsoft Teams File Fabric features.
The File Fabric provides three main ways of integrating within Microsoft Teams supporting secure collaboration with internal and external users including guests.
- Share to Team - Post file and folder permalinks to a person, group, or channel.
- Teams App – Run the complete File Fabric web app within MS Teams within a channel or chat, or as a Personal App.
- Teams Shared Folder – Provides a dedicated collaboration space within a channel or a chat. Supports Deep Links. (no login to File Fabric required)
Share to Team
The “Share to Team” feature allows permalinks to be posted to Microsoft Teams directly from the File Manager. When a permalink is clicked the web application is opened and the item highlighted. A user will require a login with the File Fabric.
From the File Explorer view in the File Manager select the file or folder you want to share and then Share to Team*.
A dialog will ask you to select a person, group, or channel, and to edit the message before posting.
Teams App (Shared)
The full File Fabric Teams app can be shared with a team or group by adding it as a channel or chat tab.
To share with users in a team choose “Add a tab” from a channel or chat and then search for and select the “File Fabric” application:
Then choose “Full File Manager”
The app running from a Tab will ask for each user's credentials.
Teams App (Personal)
Individual users can add the File Fabric to their workspace as a “Personal App”. To add the web app as a Personal App choose “Apps”. Start entering the name of the application to begin the search for it.
When the application appears, select it to add it to your account.
Tip: Right-clicking on the icon, and selecting Pin will ensure that the application stays within the menu bar.
Teams Shared Folder
A folder can be added to a channel or chat as a tab, creating a collaboration space using your own storage. Any user with access to the Team channel or chat can access the shared folder without additional authentication.
To share the folder we create a sharing code and then use that sharing code to create a tab. To create the sharing code first select the target folder and then from the share menu, “Create MS Teams Shared Folder”. (If you do this from within the Teams App you'll be able to restrict the folder share to a specific channel.)
A popup dialog will show a number of options for the share:
Make changes as needed and select “Create”.
- Restrict To current tab - Only allows the sharing code to be used in the channel from where it was created.
- Allow files to be uploaded (drop folder) - Allows files to be changed and added by members and guests
- Hide existing files - Available when “Allow files to be uploaded” is enabled. Users can only upload files.
- Manage Share Links - Lists existing shared links and allows them to be deleted.
When a specific File Fabric folder is shared within a channel, the tab can be named (as in the screenshot example below) and the content can be read-only or read-write depending on your requirements.
The File Fabric also supports generating special Teams 'deep links' that can be copied into the channel's conversation stream. Users clicking these links will be taken to the installed tab and the file/folder opened.
You will now be able to share files into your Teams channel or chat from this interface. To do this, first select a File or a Folder. From the Share menu, select the option Share file link for Team or Share folder link for Team depending on whether you are sharing a File or Folder.
Microsoft Teams will now pop up a dialog with a special deep link ready to copy. Copy it using Ctrl+C / CMD+C.
Visit the Posts tab of the channel, and this link can now be pasted into the chat.
Please note that this deep link should only be posted in the Channel on which the Tab is installed. The link may not work for accessing the file or folder from other channels.
Getting Started - SaaS
For SaaS customers, a Microsoft Teams app is available through the Microsoft AppSource site. The app supports both US and EU/UK sites.
Enterprise appliance customers (IaaS and self-hosted) will customize and deploy their own Teams app following the instructions in the section after this one.
1. Enable "Microsoft Teams" Policy
A user with administrator permission can enable teams support from the Organization > Policies menu. Enter teams in the search box or navigate to the File Sharing Policy tab.
If the option is not visible (for SaaS) please contact support. If you are not using SaaS see the instructions below for enabling on an appliance.
2. Install App
Visit the Teams app store on the Microsoft AppSource site, and search for “File Fabric”.
Select the app and follow instructions to install.
Scroll down to the Configuration section to continue.
Getting Started - Appliance Customers
If you are looking for the enterprise compatible application, please continue with the following instructions.
Before proceeding, you will require:
- An active Microsoft 365 subscription
- An account that has access to the Microsoft 365 Admin centre, with permissions to manage Microsoft Teams
1. Enable Microsoft Teams Support
The first step is to generate a MS Teams application for your File Fabric appliance:
- Login as the appladmin account on your File Fabric appliance
- Visit the Settings menu and select the Site Functionality
- From the list of available options, turn on the Microsoft Teams option from the list and save the change.
- Through your User Packages ensure that Microsoft Teams is enabled as a package option for the packages you require
- On the Settings menu a Microsoft Teams App option should now be presented.
2. Generate Teams App
The Settings screen allows you to to generate a Microsoft Teams application specifically for your organisation. Either retain the default values or complete the fields as follows:
- App Title - This will be the name of the application displayed to users within Microsoft Teams.
- App Description - This will be the description of the application displayed to users within Microsoft Teams.
- Icon Outline Image - This icon is displayed to users in the sidebar. This image is required to be a transparent 32×32 PNG outline icon (without background).
- Icon Background Color - This controls the background colour of your outline icon.
- App Image - This image is shown when a larger version of the icon is required, for example in the title and “About” screens.
- App Package - This is an automatically generated package codename for your application. Generally this should be left as-is.
- App Developer Name - This can be set to the name of your company.
- App Developer URL - This is the URL given to users when they select “Website” from the app's “About” screen.
- App Valid Domains - This controls the domains the Teams app is allowed to access. Generally this should be left as-is. If, however, your users are logging in using a SAML-based auth system, then the SAML system's domains will need to be added to the App Valid Domains.
Once the necessary information has been completed, click Generate.
This will cause a ZIP archive to be downloaded to your desktop. You must save this locally as a zip file, without uncompressing it.
If your web browser automatically uncompresses the downloaded archive you must recreate it making sure the manifest.json is first. For example,
zip FileFabric.zip manifest.json outline.png color.png
3. Upload Teams App
When you have the Microsoft Teams application downloaded, you should then visit the Microsoft 365 Admin Centre to install it: https://admin.teams.microsoft.com/
After you have logged in with your administrative account, select Teams from the menu under Admin Centers. You may need to click “Show All…” to see these. If Teams is still not visible click All Admin Centers and search for Teams.
From the Microsoft Teams admin center navigation pane expand the Teams apps menu, and choose Manage apps.
Above the list of available applications is an + Upload button. Press this button, and select the compressed ZIP that was generated in a previous step.
Once the application is uploaded, you can search for it by name on this page.
The installation is now complete, and the application will be available to your Microsoft Teams users.
There's no manifest file in your app package - The file manifest.json must be the first in the zip archive. This won't be the case if you create the zip through a GUI. Create the zip from the command line instead:
zip myapp.zip manifest.json color.png outline.png
Cookies - Note that if Microsoft Teams is opened in an incognito tab then you will need to be able cookies for the File Fabric Teams integration to work.
Upgrading Teams App
You must upgrade the application in-place in order to preserve shared folder tabs.
Locate the existing application under the Teams Administration portal (https://admin.teams.microsoft.com/) through “Manage Apps”.
The user interface lists all public applications as well so you will need to use a search filter like “File Fabric”. Ignore the public “File Fabric” app as that's for our SaaS customers.
Select your application to bring up the detail page.
Select Update and follow the prompts to upload the new zip file.
SAML and Teams
Administrators at enterprises using the File Fabric's Teams integration and SAML for File Fabric authentication should be aware of two additional points:
- The MS Teams application that the appliance administrator generates must include on its list of permitted domains all of the domains that your SAML provider uses.
- Teams requires that identity providers' login screens be integrated using web page components known as “IFrames”. Some SAML identity providers do not allow their web interfaces to be used in IFrames. In some cases the identity provider's restriction on IFrames is a default that may be overridden.
For help with using SAML authentication with your File Fabric Teams application, please contact SME support.