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 Enterprise 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. 


To use this feature, you must:

  • Have 'User.ReadBasic.All' and 'Group.Read.All' user privileges activated on your Institution's Directory Group Settings
  • Have access to your institution’s Microsoft Azure Active Directory
  • Have your Snapplify Engage Account set up with Admin User Role.

A standard user without these privileges won’t be able to run this import.


Enabling your Microsoft Azure Active Directory for integration

  1. Navigate to portal.azure.com and sign in with your admin details.
  2. Ensure that the user who will be signing in to Engage to authorise with Microsoft has the following assigned roles:

    - Application administrator
    - Global reader
  3. Navigate to Azure Active Directory and click ‘Groups’.
  4. Set up 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. After logging in to Engage, navigate to the settings section by clicking the cog icon in the top right-hand corner of your screen.
  2. On the left-hand side of your screen, navigate to 'Google' in the section called Snappsync.
  3. In 'Microsoft Integration', click the ‘Authoriset’ button. This will allow your Microsoft account to connect to your Engage platform.
  4. 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.
  5. Click ‘Authorize’.
  6. 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.
You are able to change your organisational unit settings at any time by clicking on ‘Activities’ within the 'Microsoft' option in the Snappsyn section on the Microsoft Integration block. From there, you can add additional Object IDs as well as remove any that you no longer need.


Troubleshooting

If you have selected authorize in Engage and receive the following screen then the account you are using does not have the Microsoft Azure permissions as indicated above, please contact your Microsoft Azure Admin to update these.



When importing a user that already exists in the system, a pending user is created for approval. To merge a user that is in a pending state with the existing user, you'll need to click the 'Approve' button to ensure that only one user remains in Engage. 


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 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 [email protected].