By using Microsoft Azure sync, you can effortlessly incorporate new team members and remove departing ones from Team Today through your standard onboarding procedures.

This is especially beneficial for bigger organisations where manually handling a large volume of new joiners and leavers could pose challenges.
‍

Overview

You will need to contact us at support@team-today.com before proceeding with this to obtain an API Key and increase the limits placed on your account.

Endpoints

‍

Enterprise Application Setup

1. Set up an account in Team Today
   Log in and complete the onboarding process.
   ‍
2. Grant consent to your users so they are able to use Team Today
   Azure > App registrations > Team Today > API Permissions > Grant admin consent for Team Today (See installing MS Teams app for admins).
   ‍
3. Contact us about integrating Team Today and your AD account using SCIM integration
   We’ll provide an API Key to integrate (support@team-today.com).
   ‍
4. Go to Enterprise Applications (Azure > Enterprise applications)
   ‍
5. Click on “New application”
   ‍
6. Click on Create your own application
   Enter “Team Today” in the input name field.
   ‍
7. Select “Integrate any other application you don't find in the gallery (Non-gallery)”
   ‍
8. Click on the “Create” button at the bottom

‍

SKIM Integration -Setup

1. Under “Manage” select the “Provisioning” blade
   ‍
2. Click “Get started”
   ‍
3. Select “Automatic”
   ‍
4. Enter the provided URL and Secret Token that we provided you.
   ‍
5. Click “Save”
   ‍
6. Under “Mapping” click on “Provision Azure Active Directory Groups” and change the “Enabled” slider to “No”
   You will now be able to start configuring the application to automatically provision users.

‍

SKIM Integration - User Provisioning

1. Click on “Provision Azure Active Directory Users” and set up the attributes as per the table below.

‍

SCIM Settings

• Under “Settings” enter your email to be notified when provisioning fails.
• You can configure which users you want to config, under “Scope” by selecting “Sync only assigned users and groups” you will be able to explicitly select which users you want to be provisioned.
• This “Sync only assigned users and groups” setting is ideal for testing and initial setup.

‍

SKIM Integration - Field mapping

The default field mappings based on `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User` almost cover all required fields.

Example User Setup

Additional attributes can be added at request, this document will be updated as and when new attributes are integrated.

‍

SKIM Integration -Limited rollout

Should you wish to roll out Team Today to a subset of users/groups this can be achieved with the following steps:

1. Go to the Team Today SCIM application in Enterprise applications that you set up earlier
2. Under “Manage” select the “Provisioning” blade
3. Click on “Edit Provisioning”
4. Click on “Settings”
5. Change “Scope” to “Sync only assigned users and groups”
   This will limit SCIM provisioning to explicitly selected users and groups.
6. Under “Mapping” click on “Provision Azure Active Directory Groups” and change the “Enabled” slider to “No”
   You will now be able to start configuring the application to automatically provision users.

To select users and groups follow these following steps:

1. Go to the Team Today SCIM application in Enterprise applications that you set up earlier
2. Under “Manage” select “Users and groups”
3. Click on “Add user/group”
4. Select the users and/or groups you wish to be provisioning to Team Today.

Once done go back to Provisioning and start/restart provisioning.

SKIM Integration -Limited rollout

Should you wish to roll out Team Today to a subset of users/groups this can be achieved with the following steps:

1. Go to the Team Today SCIM application in Enterprise applications that you set up earlier
2. Under “Manage” select the “Provisioning” blade
3. Click on “Edit Provisioning”
4. Click on “Settings”
5. Change “Scope” to “Sync only assigned users and groups”
   This will limit SCIM provisioning to explicitly selected users and groups.
6. Under “Mapping” click on “Provision Azure Active Directory Groups” and change the “Enabled” slider to “No”
   You will now be able to start configuring the application to automatically provision users.

To select users and groups follow these following steps:

1. Go to the Team Today SCIM application in Enterprise applications that you set up earlier
2. Under “Manage” select “Users and groups”
3. Click on “Add user/group”
4. Select the users and/or groups you wish to be provisioning to Team Today.

Once done go back to Provisioning and start/restart provisioning.

Notes

By default there are hard limits enforced on how many users each account can have to ensure the integrity of the platform. Please contact us at support@team-today.com to have these lifted.

Workgroups cannot currently be provisioned. TeamAdmins and CompanyAdmins have the ability to create teams and workgroups and move people around.

We are looking at adding more mappings at the request of our customers.

Getting support

Simply contact support@team-today.com for onboarding advice.