Microsoft Teams App

Last updated July 27

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.

Availability:

  • US and EU/UK SaaS platforms
  • Enterprise File Fabric Appliance, coming soon!

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.

Team's Channel Tab

When working within a Team's channel, you access your File Fabric storage through a Tab that can be made available for all users with access to that channel. The following screenshot provides an example of this.

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.

Chat Tab

Similar to the Team's Channel Tab, a Tab can also be installed in your 1-to-1 or Group Chats within Teams.

Users involved in the Chat will see the visible Tab. The ability to copy special deep links is also provided through this Tab.

Personal App

The app also has a “personal app” capability allowing it's use outside of a channel or chat, but still within Teams. This application will be available through the 'Apps' section in the left sidebar.

The Personal app provides a standalone experience and exposes functionality like Tags, Search and Tasks. The Personal app can only be added by individual users, and cannot be setup globally across the organization.

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.

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:

  1. Login as the appladmin account on your File Fabric appliance
  2. Visit the Settings menu and select the Site Functionality
  3. From the list of available options, turn on the Microsoft Teams option from the list and save the change.
  4. Through your User Packages ensure that Microsoft Teams is enabled as a package option for the packages you require
  5. 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 Privacy URL - This is the URL presented to users for your Privacy Policy.
  • App Terms Of Use URL - This is the URL presented to users for your Terms of Use.
  • 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 file download to your desktop. You should save this locally, without uncompressing it.

2. 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.microsoft.com/

After you have logged in with your administrative account, select Teams from the menu under Admin Centers.

In the Microsoft Teams Admin Center area, 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.

One the application is uploaded, it should be listed on the screen.

The installation is now complete, and the application will be available to your Microsoft Teams users.

Adding the Tab to a Team

First, open a channel within a pre-existing team.

Click the + icon at the top, as indicated here:

Search and click on your application that you named earlier.

You will be prompted to select a Tab name. This tab name will be visible to users who have access.

Click Save.

The Tab will now be present at the top of the screen.

When you login you will be able see your File Fabric folders and files.

You will now be able to share files into your Teams channel 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 your Posts tab of the channel, and you can now paste this link 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.

Adding the Tab to a Chat

First, open a 1-to-1 chat or a Group Chat.

Click the + icon at the top, as indicated here:

Search and click on your application that you named earlier.

You will be prompted to select a Tab name. This tab name will be visible to users who have access.

Click Save.

The Tab will now be present at the top of the screen.

When you login you will be able see your File Fabric folders and files.

You will now be able to share files into your 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 Chat or Share folder link for Chat depending on whether you are sharing a File or Folder.

Microsoft Teams will now popup a dialog with a special deep link ready to copy. Copy the link using Ctrl+C / CMD+C.

Visit your Chat tab in the channel, and you can now paste this link into the chat.
Please note that this deep link should only be posted in the Chat to which the Tab is installed on. The link may not work for accessing the file or folder from other Chats.

Personal Application

To add the personal application within Microsoft Teams, select the three dots from the left sidebar. 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.

The Personal Application is configured individually by each user.

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.

This website uses cookies. By using the website, you agree with storing cookies on your computer. Also you acknowledge that you have read and understand our Privacy Policy. If you do not agree leave the website.More information about cookies