Skip to main content

Set up Microsoft Entra ID for your organisation (single sign-on and SCIM)

Connect Microsoft Entra ID to Mana so your team signs in with their work Microsoft account and staff are added and removed automatically.

M
Written by Marlon Randeniya

If your organisation uses Microsoft Entra ID (formerly Azure Active Directory), you can connect it to Mana. Once it's set up:

  • Your team signs in with their work Microsoft account. Your own Microsoft sign-in rules, such as multi-factor authentication, apply when they sign in to Mana.

  • Your email domain is protected. Once your domain is verified, nobody can create a Mana account with that domain outside your organisation.

  • Staff are managed from Entra ID. With directory sync (SCIM), people added to your Microsoft groups get access to Mana with the right role, and people you remove in Entra ID are removed from Mana. No more invitations or bulk uploads.

Before you start

  • You need to be an organisation owner in Mana. Only organisation owners can change the Microsoft connection, domains and single sign-on.

  • You need a Microsoft admin who can approve apps for your organisation. This is often someone in your IT team, so it's easiest to do the setup together.

  • Know which email domain(s) your team uses to sign in (for example, yourorganisation.com.au).

  • If you plan to use directory sync, decide which Microsoft groups should get which Mana roles.

Step 1: Open the Identity settings

  1. Sign in to Mana and switch to your organisation. Select Account, then Switch, and choose Manage organisation.

  2. Select Settings in the menu.

  3. Under Features, select Identity ("Set up single sign-on and SCIM").

If you only see the message "Only organisation owners can change the Microsoft connection, domains and single sign-on", you're not an organisation owner. Ask an owner in your organisation, or contact us, to continue.

Step 2: Connect your Microsoft organisation

  1. Under Microsoft connection, select Connect Microsoft.

  2. Sign in with your Microsoft admin account and accept the request to approve Mana for your organisation.

  3. You'll come back to the Identity page in Mana.

Step 3: Choose your email domains

  1. Under Domain management, choose which email domains sign in with Microsoft.

  2. Your domains appear under Verified domains, with their status.

A verified domain belongs to your organisation in Mana. It also stops anyone with that email domain from creating a separate Mana account outside your organisation.

Step 4: Turn on Sign in with Microsoft

  1. Under Single sign-on, turn on Sign in with Microsoft.

  2. People with an email address on your verified domains now sign in to Mana with their work Microsoft account.

Step 5: Set up directory sync (SCIM)

Directory sync keeps your Mana users up to date with Entra ID, so you don't need to invite or remove people in Mana yourself.

  1. Under SCIM provisioning, next to Microsoft directory, select Open WorkOS Admin Portal.

  2. Follow the steps in the portal to connect your Microsoft directory. WorkOS is the service Mana uses to connect securely to Entra ID.

  3. Under Group mappings, map each Microsoft group to the Mana role it should give. People in a Microsoft group get that group's Mana role.

Once directory sync is on, changes you make in Entra ID flow through to Mana. You can see the latest updates under Recent activity on the Identity page.

Tips

  • Start with a trial period. We recommend working with the Mana team to check that people and roles come through as expected before you rely on directory sync to add and remove staff.

  • Keep your groups tidy. Because roles come from your Microsoft groups, keeping group membership up to date in Entra ID keeps access in Mana up to date too.

Need help?

Message us through the chat in Mana or email [email protected], and we'll be happy to work through the setup with you and your IT team.

Did this answer your question?