How to deploy CreateTeam App into Teams
Create Team is provided as an Microsoft Teams App which needs to be uploaded to your organisation’s Apps section within Microsoft Teams.
NOTE: Some of the steps below require making changes to your Microsoft Online Tenant which can sometimes take a few hours to take effect
Admin Consent for CreateTeam App API
For the App to be able to create teams in the target Teams Tenant, it is a requirement that a Office 365 Global Admin of that tenant grants admin consent.
This is achieved by clicking on the following link and logging in with a Global Administrator account, this will consent to the AAD APP 1 permisions below (for the API). Note AAD App 2 below (for the client) does not require admin consent.
Provide Admin Consent
These are the permissions that will be required
#### AAD App 1 (for the API) : Application Permisions Directory.ReadWrite.All Read and write directory data - Allows the app to read and write data in your organization’s directory, such as users, and groups, without a signed-in user. Does not allow user or group deletion.
Groups.ReadWrite.All Read and write all groups - Allows the app to create groups, read all group properties and memberships, update group properties and memberships, and delete groups. Also allows the app to read and write group calendar and conversations. All of these operations can be performed by the app without a signed-in user.
#### AAD App 2 (for the client) : Delegated Permisions (no consent required) openid Sign in and read user profile - Allows users to sign-in to the app, and allows the app to read the profile of signed-in users. It also allows the app to read basic company information of signed-in users.
The Admin Consent for AAD App 1 (for the API) that you just consented to, will be visible within the Enterprise Applications section of Azure AD
- From Microsoft Teams go to the Apps section
Then select Upload for [YOUR ORGANISATION NAME]
Then select the App package provided by Modality Systems as a zip file
The App should then appear within your companies Apps section
NOTE: To update an App that has already been installed, navigate to the App within your companies Apps section then hover your mouse pointer over the app, click on the … in the top right corner and click Update
Allow App to be installed within Microsoft Teams
Now that the App has been added to your Microsoft Teams Tenant, your Global policy may need to be adjusted to allow it to be installed by users.
From the Microsoft Teams Admin Center, under Teams apps click Permission policies
Click on Global (Org-wide default) (or whatever policy is applied to your organisation)
Make sure the Tenant apps policy is set to Allow all apps
NOTE: You could also specify a list of allowed apps here
Pin App within Microsoft Teams
To improve the end user experience it is recommended to pin the App to the main Microsoft Teams list of Apps
From the Microsoft Teams Admin Center, under Teams apps click Setup policies
Either edit Global (Org-wide default) or create a new policy and give it a name
Click Add apps, select Permissions policy from previous step, search for TG and click Add
If you created a new Setup policy in step 2 then you will need to assign users to the policy
From the Microsoft Teams Admin Center, under Teams apps click Setup policies, click on the tick next to the required policy name
Click Manage users and add the required users
Further information about managing app setup policies in Microsoft Teams is available:
Manage app setup policies in Microsoft Teams
NOTE A user can only be assigned to 1 app settings policy so this will remove them from the policy that they are currenlty assigned too
User Consent for CreateTeam App Client
When a user first launches the App from within Microsoft Team, they are required to provide consent for their details to be accessed by the App
Enabling Users to create teams with Guest Access
If this feature is enabled for your tenant you can enable users in the following steps.
- Login to Azure Portal
- Click Azure Active Directory
- Click Enterprise Applications
- Search for Modality TG API
- Click Users and Groups
- Click Add user
- Find your users
- Select the Guest Admin role
Changing default settings
This application looks at your default tenant settings to determine the default value of certain fields. To change your default tenant settings read the following guide. https://docs.microsoft.com/en-us/graph/api/resources/groupsetting?view=graph-rest-1.0
The following fields look at tenant default values
- External Checkbox looks at AllowToAddGuests value