Follow

Upload your Workspace app in Teams

Table of Contents

 

Introduction

You can now integrate Workspace 365 and all its functionalities within Microsoft Teams. This will allow you to simplify access to all your applications, information and allows you to bring all the Micro Apps to Teams. It doesn’t matter if people start their day in the browser, intranet, Microsoft Teams, mobile or tablet. This functionality creates a unified Workspace which saves time for users, reduces the amount of sign-ins, switching between applications and more.

The manifest.json ZIP file is required including the app icons. It can be found under the Downloads section and is only available to our partners. Make sure you're logged in to our support portal first.

 

Configuration

As an admin, make sure that the Workspace app is available in the Teams App Store for the users in your tenant. 

To enable Single Sign-On, we have added a few more steps to our previous instruction: adding the "webApplicationInfo" in the manifest.json file (step 1) and creating a scope defined by this API and authorizing the client application (step 2) in Azure AD.
If you already had your Workspace app published in Teams for the users in your tenant, you must execute the steps in step 2 and edit/replace the manifest.json file, reupload the zip file in the Microsoft Teams admin center and publish the app.

 

Step 1. Edit and zip the manifest.json file

  • Download and unzip the Workspace365-Teams-App ZIP file.
  • Change the ContentURL to your own URL:
"contentUrl": "https://workspace365instance.url/environmentname/Embed/Teams",
  • You can change the display name of the Workspace app in Teams, which is determined by the short name. In the example below, the display name in Teams will be "WS 365". Bare in mind when choosing a name containing too many characters, it won't be fully displayed in Teams.
"name": {
 "short": "WS 365"
   "full": Workspace 365"
},
  • Go to your Workspace SSO app registration in Azure AD.
  • On the overview page, copy and save the Application (client) ID.
  • Add the following code to add new properties to your Teams application manifest:
"webApplicationInfo": {
"id": "00000000-0000-0000-0000-000000000000",
"resource": "https://workspace365instance.url/environmentname"
},
  • Zip the manifest.json file including the app icons.

Back to top

 

Step 2. Under your Workspace SSO app registration in Azure AD, create a scope defined by this API and authorize the client application

  • Under Manage, select Expose an API.
  • Select Add a scope. In the panel that opens, enter access_as_user as the Scope name.
    • In the Who can consent? box, enter Admins and users.
    • Enter the details in the boxes for configuring the admin and user consent prompts with values that are appropriate for the access_as_user scope:
      • Admin consent display name: Teams can access the user’s profile.
      • Admin consent description: Teams can call the app’s web APIs as the current user.
      • User consent display name: Teams can access your profile and make requests on your behalf.
      • User consent description: Teams can call this app’s APIs with the same rights as you have.

        add_a_scope.PNG

    • Ensure that State is set to Enabled.
    • Select Add scope to save the details.
  • In the Authorized client applications section, identify the applications that you want to authorize for your app’s web application.
    • Select Add a client application.
    • Enter each of the following client IDs and select the authorized scope you created in the previous step:
      • 1fec8e78-bce4-4aaf-ab1b-5451cc387264 (for Teams mobile or desktop application).
      • 5e3ce6c0-2b1f-4285-8d4b-75ee78787346 (for Teams web application).

        add_client_application.PNG
    •  
    • Select Add application.
    • For further detailed information about the SSO setup, click here.

Back to top


Step 3. Upload the zipfile in the Microsoft Teams admin center

  • Upload the created zipfile in the Microsoft Teams admin center:
    • Go to Teams apps and select Manage apps. 
    • Click on Upload to upload the ZIP file.
    • Click here for further detailed information.
  • Now the user can add the app themselves or you could create a policy to push the app to the users automatically.

Back to top

 

Setup policies

Once the app is uploaded in the Teams App Store, as an admin you can manage app setup policies. To create a policy, do the following:

  • Go to Teams apps.
  • Choose Setup policies.
  • Click on Add or change the current policy to add the Workspace 365 Teams app to the users left sidebar.


Automatically install the app for users

If you want to install the app for users automatically when they start Teams, follow these steps:

  • In the Add installed apps pane search for the app you want to automatically install. You can also filter apps by app permission policy.
  • Then, select Add.

    the Add installed apps pane

Back to top


Change app order in the Teams app navigation bar

It's also possible to arrange the apps in the order that you want them to appear in Teams.

  • Under Teams apps, select Setup policies.
  • Go to Pinned apps.
  • You can select an app and move it up- or downwards.
  • Then, select Save.

    mceclip0.png

Back to top

 

Add the Workspace app as a user

When the app has been made available in the Teams App Store by the admin, the users can now add the Workspace app to Teams.

  • Click on Apps and search for the app. 

    mceclip0.png

  • Click on Add to add it to Teams. 
  • The Workspace app is now added to Teams.

    mceclip3.png

Back to top