Team whereabouts
Team holidays
Manage hot desking
Work planner
Pricing
Log In
Who we are
Get in touch
Support and guides
Blog
Back to main menu
Back

MICROSOFT TEAMS APP AND AZURE

Setting up Azure

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

Environment

URL

Test https://test.scim.team-today.com/scim/v1
Prod https://scim.team-today.com/scim/v1

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.

Team Today Attributes

Matching precedence

 

Notes

userName  

1

 
 

Should be the user's primary email

 
 

externalId

 
 2

User's unique ID (What Microsoft refer to as the ObjectID)

 
 

active

  Boolean: true | false
Is account active
 

preferredLanguage

 
 

active

 

active

 
 

name.givenName

 
 

active

 
 

active

 
 

emails[type eq "work"].value

 
 active

Users primary work email address

 
 urn:ietf:params:scim:
schemas:extension:
enterprise:2.0:User:
department

active

 

Users department, this attribute is used to place the user into a team (or create a team if it does not exist).

 

sendWelcomeEmail

 
 

active

 

(Default true)This is a boolean value and can be added as a constant. You will have to click on “edit attribute list” and add it before you can add a new mapping.Setting this value to false will suppress the welcome email, allowing you to manage that part of the onboarding internally.

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.

Robin Gibson
Co-Founder and Director of Design