---
title: "Access CTERA Portal as a Tab in Microsoft Teams"
slug: "access-ctera-portal-as-a-tab-in-microsoft-teams"
updated: 2025-07-10T11:29:36Z
published: 2025-07-10T11:29:36Z
canonical: "kb.ctera.com/access-ctera-portal-as-a-tab-in-microsoft-teams"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://kb.ctera.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrate CTERA Portal in Microsoft Teams

Access to a CTERA Portal, from CTERA Portal version 8.1.x, can be added to Microsoft Teams as part of a channel or a group chat inside a team or as a personal tab for an individual user.

          **Note**

          

When the CTERA Portal is integrated with Microsoft Teams, you can only define SAML if the portal can be accessed using a public DNS.

[Video](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/ctera_for_teams_integration_052324a%20(1080p).mp4?sv=2026-02-06&spr=https&st=2026-11-11T04%3A29%3A10Z&se=2026-11-11T05%3A29%3A10Z&sr=c&sp=r&sig=sXi74BdMNjzmf2QfgmNvk%2FNCzV4E60aDMsZiFEJFwDI%3D)

For earlier versions of CTERA Portal, see [Setting Up Microsoft Teams as a Website](/v1/docs/access-ctera-portal-as-a-tab-in-microsoft-teams#setting-up-microsoft-teams-as-a-website).

## Setting Up CTERA Portal as an App in Microsoft Teams

From CTERA Portal version 8.1.x, the portal global administrator can configure the portal so that it can be added as an app in Microsoft Teams.

To enable integrating the CTERA Portal as an app in Microsoft Teams you have to specify the microsoft team domain in the team portal settings and run a command to enable the portal to be embedded in an inline frame (iframe).

### Limitations

When access to the CTERA Portal is single sign-on (SSO), note the following:

- Internet access is required.
- It is supported from Windows devices but **not** from macOS devices.
- When using OKTA to manage SSO, under **Customizations** in OKTA, check **Allow IFrame embedding**.
- When using Microsoft Entra ID to manage SSO:
  - When Microsoft Entra ID is synced to the local Active Directory, the user must sign in to the portal with the same user as the Teams user or the sign in will fail.
  - Sign out is not supported.

### Provisioning Requirements

To access the portal cloud drive directly, the user must have a subscription plan that includes the **Cloud Drive Connect** service. To access the portal cloud drive directly and enable sending a public link or permalink within Microsoft Teams, from CTERA Portal 8.2.x, the **Cloud Drive Full** service is required.

### Step-by-step guide

          **Note**

          

The following procedure should be done by the enterprise IT department together with the portal global administrator so that it is available to every Microsoft Teams user.

**To add CTERA Portal as an app in Microsoft Teams:**

1. Sign in to the CTERA Portal version 8.1.x or higher as a global administrator.
2. Select **Settings** in the navigation pane.
3. Select **Global Settings**, under **SETTINGS** in the **Control Panel** content page.
4. In the **Security** section, check **Allow embedding End User Services Portal**.
5. Select **Virtual Portal**, under **SETTINGS** in the **Control Panel** content page.
6. In the **Microsoft Teams Integration** section specify the Microsoft Teams domains to use for the CTERA Portal as an app.
7. Specify the domains that are allowed when integrating a CTERA Portal as an app in Microsoft Teams.  

For Microsoft Teams: `teams.microsoft.com`  

When single sign-on (SSO) is defined for the portal that you want to integrate, you must also specify the SSO provider domain, for example `teams.microsoft.com,*.okta.com`  

Separate domains with a comma (,).
          **Note**

          

You can set **Microsoft Teams Integration** for every team portal or for a specific team portal.
8. Restart the application server.
9. Go to the [Download Center](/v1/docs/download-center) and download the **Microsoft Teams Integration Files**.
10. Change the **color.png** file and **outline.png** file to files that match your branding.  

**color.png** must be 192x192 pixels and the symbol in the png file must be 96*96 pixels, in the center.  

**outline.png** must be 32x32 pixels and either white (the default), or transparent.
11. Make changes to the **manifest.json** file as follows:
  1. Under the `icons` section, change the **color.png** file and **outline.png** file to files that match your branding.
  2. Under the `name` section, change the **short** and **full** descriptions to match your branding.
  3. Under the `description` section, change the **short** and **full** descriptions to match your branding.
  4. Under the `staticTabs` section, change the **contentUrl** file and **websiteUrl** to the team portal URL to create as an App in Microsoft Teams.
  5. Under the `validDomains` section, change  **localhost:53000** to the team portal URL to create as an App in Microsoft Teams.
  6. Optionally, change the accent colour by changing the value of `accentColor`
  7. Save the **manifest.json** file.
12. Zip the files **manifest.json**, **color.png**, and **outline.png** and get the Microsoft Teams administrator to upload the zip file in the Microsoft Teams APP repository.

All users can now include the CTERA Portal as an app.

### Making the CTERA Portal App Available

Once the CTERA Portal app is available in Microsoft Teams, end users can access the portal from within teams.

1. In Microsoft Teams, click **Apps**.
2. Click **Add** on the app to open.
3. Click **Add**.  

After adding the app, you click **Open** and not **Add**.
4. Right-clicking the app displays a menu with the option to pin the app to the navigation bar or open it in a new Microsoft Teams window.

#### Example

In the following example, **Apps** in Microsoft Teams navigation menu was clicked to display all the apps that can be integrated. ![image.png](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/image-WQGUT44V.png?sv=2026-02-06&spr=https&st=2026-11-11T04%3A29%3A10Z&se=2026-11-11T05%3A29%3A10Z&sr=c&sp=r&sig=sXi74BdMNjzmf2QfgmNvk%2FNCzV4E60aDMsZiFEJFwDI%3D) Clicking **CTERA-QAlocal** displays the following: ![image.png](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/image-9D6TQYLZ.png?sv=2026-02-06&spr=https&st=2026-11-11T04%3A29%3A10Z&se=2026-11-11T05%3A29%3A10Z&sr=c&sp=r&sig=sXi74BdMNjzmf2QfgmNvk%2FNCzV4E60aDMsZiFEJFwDI%3D) And clicking **Add** adds the portal as an app, with access from the Microsoft Teams navigation menu.

          **Note**

          

You can add more than one portal as an app and, depending on the app definition, you can restrict access to a team, chat or meeting.

### Adding a Public Link or Permalink From a CTERA Portal App Integrated in Microsoft Teams

From CTERA Portal version 8.2.x, when a portal is integrated within Microsoft Teams, you can create a public link or permalink and share it directly in Microsoft Teams.

For public link details, see *Making Content Public* in the *CTERA Portal End User Guide* under *Sharing Files* for your CTERA Portal version (for example for CTERA Portal version 8.2.x, see [Making Content Public](/v1/docs/making-content-public-7#adding-a-public-link-from-a-ctera-portal-app-integrated-in-microsoft-teams)). For permalink details, see *Setting Up Collaboration Directly to the Content (Permalinks)* in the *CTERA Portal End User Guide* under *Sharing Files* for your CTERA Portal version (for example for CTERA Portal version 8.2.x, see [Setting Up Collaboration Directly to the Content (Permalinks)](/v1/docs/setting-up-collaboration-directly-to-the-content-permalinks-4#adding-a-permalink-from-a-ctera-portal-app-integrated-in-microsoft-teams)).

## Setting Up Microsoft Teams as a Website

The following procedure can be done by any Microsoft Teams user to include any CTERA Portal version as a website in a tab in Microsoft Teams.

### Step-by-step guide

**To add a tab in Microsoft Teams to access a CTERA Portal:**

1. In Microsoft Teams go to the team to which you want to add access to the CTERA Portal.  

![image.png](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/image-CMFIMZ2I.png?sv=2026-02-06&spr=https&st=2026-11-11T04%3A29%3A10Z&se=2026-11-11T05%3A29%3A10Z&sr=c&sp=r&sig=sXi74BdMNjzmf2QfgmNvk%2FNCzV4E60aDMsZiFEJFwDI%3D)
2. Click the plus (+) sign at the top of the window, or if there hasn't been a conversation yet, click the **Add tab** plus (+) button.  

![image.png](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/image-E9U7CC43.png?sv=2026-02-06&spr=https&st=2026-11-11T04%3A29%3A10Z&se=2026-11-11T05%3A29%3A10Z&sr=c&sp=r&sig=sXi74BdMNjzmf2QfgmNvk%2FNCzV4E60aDMsZiFEJFwDI%3D)
3. Click **Website** if it is displayed or search for `website` in the search box at the top of the window and then click **Website**.  

The **Website** window is displayed.  

![image.png](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/image-YTIU79S4.png?sv=2026-02-06&spr=https&st=2026-11-11T04%3A29%3A10Z&se=2026-11-11T05%3A29%3A10Z&sr=c&sp=r&sig=sXi74BdMNjzmf2QfgmNvk%2FNCzV4E60aDMsZiFEJFwDI%3D)
4. Enter a name for the tab and the URL to access the CTERA Portal.
          **Note**

          

The URL must start with `https://`. Use the name and not the IP address.
5. Click **Save**.  

The tab is added to the list at the top of the team. Clicking the tab opens the portal page in the tab.  

![image.png](https://cdn.document360.io/30792387-cdcb-4791-aa14-94929bbcd3fe/Images/Documentation/image-F0XWZYQ5.png?sv=2026-02-06&spr=https&st=2026-11-11T04%3A29%3A10Z&se=2026-11-11T05%3A29%3A10Z&sr=c&sp=r&sig=sXi74BdMNjzmf2QfgmNvk%2FNCzV4E60aDMsZiFEJFwDI%3D)

**To add a tab in Microsoft Teams to access a Specific CTERA Portal Folder:**

1. Create a public link to the folder to include in Teams, as described in the *CTERA Portal End User Guide* under *Sharing Files*.
2. Follow the instructions for adding a tab to access a CTERA Portal, above, and for the URL to access the folder, use the public link URL.