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

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.

Enterprise Application Setup

1. Set up an account in Team Today
   Log in and complete the onboarding process.
   ‍
2. Visit Azure Enterprise App Marketplace
   and add the Team Today Azure app
   ‍‍
3. ‍Email the company Azure Tenant ID to support@team-today.com
   Or Customers Azure Tenant ID if you are a reseller
   ‍
4. ‍Team Today will then provide a secret API Key
   ‍‍
5. Open the Team Today Azure app
   ‍
6. On the left menu expand “Manage”
   ‍
7. Select "Provisioning" from the menu on the left
   ‍
8. Select "Automatic" from the dropdown menu
   ‍
9. Enter "https://scim.team-today.com/scim/v1" for the URL
   ‍
10. Enter the secret API key provided by Team Today
    ‍
11. Click on "Test connection" and if then if its working, Save
    ‍
12. Click on overview on the menu to the left
    ‍
13. You can now click "Start" to run the provisioning

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. See the Limited Rollout instructions below for a step by step process

Endpoints

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. On the left menu expand “Manage”
3. Click “Provisioning" in the left menu

This is the Team Today provisioning page

1. On the left menu expand “Manage”
2. Click “Provisioning”
3. In the main panel
4. Expand “Settings”
5. Change the scope to “Sync only assigned users and groups”
   This will limit SCIM provisioning to explicitly selected users and groups.

Once thats done, from the Team Today Provisioning Page

1. Expand “Manage”
2. Click on “Users and groups”
3. On the main panel
4. Click on “Add user/group”
5. Search for users and groups you wish to add
   ‍Note. You cannot add embedded groups.

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.

‍Update to SCIM integration

Overview

SCIM integration has been updated to provide the following support:

• users job title
• users line manager
• departments
  

Once Microsoft approves the modified Team Today app, we will also support importing Groups from Active Directory (which also includes adding provisioned users to their relevant groups).

There is a new setting in your Team Today account which can be found in Settings > Company Settings, if this is enabled along with SCIM integration being configured when a user is provisioned they will be added to their relevant Department rather than in a Team with the departments name. When a users department is changed in AD, it will automatically be updated in Team Today. A user will have to be manually added into a team.‍

Configuration instructions‍

Until the Team Today app is updated in the Azure marketplace, you must follow these instructions for the new fields.‍

Users job title

1. Navigation to the Team Today Enterprise app in Azure
2. Go to provisioning
3. Edit provisioning
4. Expand "Mappings"
5. Click on "Provision Azure Active Directory Users"
6. Click on "Show advanced options"
7. Click on "Edit attribute list for customappsso"
8. On the table enter a new row with the following:
   1. Name: "jobTitle"
   2. Type: "String"
9. Click save
10. Click "Add New Mapping"
11. Fill out the form with the following details:
    1. Mapping type: "Direct"
    2. Source attribute: "jobTitle"
    3. Target attribute: "jobTitle"
12. Click Ok
13. Click Save
14. Return to Provisioning and click "Restart Provisioning"

Users line manager

1. Navigation to the Team Today Enterprise app in Azure
2. Go to provisioning
3. Edit provisioning
4. Expand "Mappings"
5. Click on "Provision Azure Active Directory Users"
6. Click on "Show advanced options"
7. Click on "Edit attribute list for customappsso"
8. On the table enter a new row with the following:
   1. Name:
   "urn:ietf:params:scim:schemas:extension:enterprise:2.0:
   User:manager.value"
   2. Type: "String"
9. Click save
10. Click "Add New Mapping"
11. Fill out the form with the following details:
    1. Mapping type: "Direct"
    2. Source attribute: "manager"
    3. Target attribute:
    "urn:ietf:params:scim:schemas:extension:enterprise:2.0:
    User:manager.value"
12. Click Ok
13. Click Save
14. Return to Provisioning and click "Restart Provisioning"
    

Department

By default, department should already be in the Attribute list. You will need to edit it always to apply the mapping.

Before doing this enable "Provision users into Departments from SCIM integration" in Team Today.

!!! If you do not do this, users Teams will all be updated !!!

1. Navigation to the Team Today Enterprise app in Azure
2. Go to provisioning
3. Edit provisioning
4. Expand "Mappings"
5. Click on "Provision Azure Active Directory Users"
6. On the row with the Team Today Attribute of
   "urn:ietf:params:scim:schemas:extension:enterprise:2.0:
   User:department"
   click on "Edit"
7. Change "Apply this mapping" to "Always"
8. Click Ok
9. Click Save
10. Return to Provisioning and click "Restart Provisioning"

Getting support

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