Importing your users with Microsoft Azure Active Directory integration

This article will help you to sync your Microsoft Azure Active Directory and import your users quickly and easily.

This article is for ADMINISTRATORS. 💾

🎓 This feature is only available for ENGAGE ENTERPRISE tier clients. Read this article for more about the Engage tiers.

With Snapplify’s Microsoft integration, Microsoft institutions signed up for Engage are able to pull all users from their Microsoft Azure Active Directory and link these to Snapplify so that users can use their Microsoft accounts to sign in to Engage. 👥➡️💻

NOTE
 To use this feature, you must have the following user privileges on your Microsoft Account ('User.ReadBasic.All' and 'Group.Read.All') and have access to your institution’s Microsoft Azure Active Directory. A standard user without these privileges won’t be able to run this import.

Enabling your Microsoft Azure Active Directory for integration

  1. Head over to portal.azure.com and sign in with your admin details.
  2. Ensure that the user that will be signing into Engage to authorise with Microsoft has the following Assigned Roles:

    - Application administrator
    - Global reader

  3. Navigate to Azure Active Directory and click ‘Groups’.
  4. Setup your Groups and assign the relevant users
  5. Copy the Group `Object ID` (you will need this soon).

Importing your users via Microsoft integration

  1. Once signed in to Engage, navigate to ‘Import Users’ in Engage (you’ll find this under ‘Admin’ in the toolbar on the left-hand side of your screen).
  2. Under ‘Microsoft’, click the ‘Connect’ button. This will allow your Microsoft account to connect to your Engage platform. MS int 1
  3. If required, enter your group Object ID path to import only specific units within the directory; otherwise, you can leave this blank to import all directory users.
  4. Click ‘Save’.
  5. You will be redirected to Microsoft sign in. Click `Allow` when asked to allow snapplify.com to access your info. You will be directed back to Engage, where your users will begin to import.

Once connected, Engage will continue to sync with Microsoft, and update user information accordingly. As users are added, updated or deleted, the systems will remain in sync.

MS int 2

Note: You are able to change your organisational unit settings at any time by clicking on ‘Activities’ within the ‘Import Users’ section on the Microsoft Integration block. From there, you can add additional Object Ids as well as remove any that you no longer need.


What's next?

👩👨👧👦🤔 When users are imported into Engage, they are all automatically assigned the 'Learner' role in Engage. After adding users to the Engage platform, you will need to assign user roles (e.g. Teacher, Librarian, Admin, Learner, or Finance) to give users like librarians or teachers additional permissions.

Need help? Use the live chat in the bottom right corner of your screen or email us at help@snapplify.com.