Integration Settings | Admin’s Manual

Quick Navigation


Watch the How-to Video


Getting the Data, we Need from MS Azure

Connecting/Integrating Classter with MS Teams requires the user to set up and retrieve information on MS Azure the cloud that accommodates both programs.

So, we begin by setting up MS Azure. We will need the codes generated from MS Azure to make our connection between our institutions Classter System and MS Teams (DashboardConfigurationAdvanced ConfigurationThird Party IntegrationsMS Teams button).

MS Teams Required Actions

The first step we need to follow is to create a class type team on MS Teams and retrieve the corresponding code for the class type team from MS Azure (Figure 1).

Figure 1

  • From the Teams tab of MS Teams, you need to click on the Join or Create Team button.
  • In the following page you will see (Figure 1) the box with the ‘Create Team’ button. Click on the button.
  • Once you Have clicked on the ‘Create Team’ button you will view a popup window (Figure 2).

Figure 2

On the screen you will see the following (Figure 2):

  • Here you can see the four different types of teams (Figure 2).
  • Click on the class type team (Figure 2).
  • Once you click on the class type team you will view the following popup window (Figure 3)

Figure 3

On the screen you will see the following (Figure 3):

  • Enter a name for your new class e.g Math 101.
  • Enter a description for this class e.g Basic Numbers, Fractions and Decimals.
  • Click on the ‘Next’ button to proceed further with the creation process.

Figure 4

On the screen you will see the following (Figure 4):

  • In the field enter the first letter of a name, to select a student or student.
  • Once selected, click on the add button to add them.
  • Once you are done click on the Teachers tab to add teachers (Figure 5).

Figure 5

On the screen you will see the following (Figure 5):

  • In the field enter the first letter of a name, to select a teacher or teacher.
  • Once selected, click on the add button to add them.
  • Once you are done click on the ‘Close’ button to finish the creation of the class type team.
  • You will be able to now view your new class (Figure 6).

Figure 6

MS Azure Required Actions

Step 2 requires that we login to MS Azure. We need to follow the link https://www.Portal.azure.com

Figure 7

In the screen you will see the following (Figure 7):

  • In the login page you must enter your email first.
  • Click on ‘Next’ to proceed to next step.
  • If you do not have an account, you can create one by clicking on the ‘Create One’ button.

Figure 8

In the screen you will see the following (Figure 8):

  • On this page, enter your unique password.
  • Click on ‘Sign in’ button to sign into MS Azure.
  • If you have forgotten your password, click on the forgot my password button and follow the retrieval process.

Welcome to the MS Azure environment. Now you can follow the steps required by the Classter third party integration page for MS Teams.

Figure 9

In the screen you will see the following (Figure 9):

  • This is the main page of MS Azure.
  • You must click on the menu button located in the top left of the screen, it’s the button with the three lines.
  • From the menu that you opened, click on the ‘Azure Active Directory’ button.
  • You will be transferred to the azure active directory page.

Figure 10

In the screen you will see the following (Figure 10):

  • From the menu bar of the azure active directory page, click on the Groups page.
  • Once you have clicked on the ‘Groups’ button you will be transferred to the corresponding page (Figure 11).

Figure 11

In the screen you will see the following (Figure 11):

  • Remember the class type team we created in MS Teams? Well from here you can select it.
  • Double click on the Class ‘Math 101’.
  • You will now be transferred to the Class page (Figure 12).

Figure 12

In the screen you will see the following (Figure 12):

  • On this page you can view data associated with the specific class you created earlier on MS Teams.
  • Click on the copy button next to the code in the Object Id field.
  • Keep this code handy as we will be using it, in the Classter part of our integration for MS Teams.

As not to keep you waiting, have a tab on your browser open with the Classter portal open.

In the Classter portal follow the path: DashboardConfigurationAdvanced ConfigurationThird Party IntegrationsMS Teams (Figure 13).

Figure 13

In the page in the Classter Portal you will see the following (Figure 13):

  • This page holds the fields that need to be filled in order to build the connection between Classter and MS Teams.
  • Remember the code you copied from ‘Math 101’ in AzureGroups page (Figure 12)? That code you will copy and past in the Template Id field here in Classter.

Step 3

Still on MS Azure we need to follow the procedure to acquire the rest of the codes we need to fill in in classter (Figure 13).

From the main page of MS Azure (Figure 14), we need to click on the Azure Active Directory once more.

Figure 14

Once we have clicked on the ‘Azure Active Directory’ button from the menu, we will be taken to the following page (Figure 15).

Figure 15

In the page you will see the following (Figure 15):

  • From this page, you must click on the ‘App registration’ button from the menu on your left side.
  • Once you do click on App registration you will be transferred to the following page (Figure 16).

Figure 16

In the page you will see the following (Figure 16):

  • Now you can see all expired and current app registrations.
  • Click on the ‘+New registration’ button to add a new registration.
  • Once you click on the new registration button you will be transferred to the following registration page (Figure 17).

Figure 17

In the page you will see the following (Figure 17):

  • Enter the name for this new registration e.g Classter Teams.
  • From the button options, click on the third one ‘Accounts in any organizational directory (Any Azure AD Directory – Multitenant) and personal Microsoft account (e.g Skype, Xbox)’.
  • Enter in the Redirect URI field the web URL https://snappy.appypie.com/app/onedrive.
  • Lastly click on the ‘Register’ button to complete new registration.

Figure 18

In the page you will see the following (Figure 18):

  • This page will appear once you have created your new registration.
  • Copy the code from the Application (Client) ID field.
  • Copy the code from the Directory (Tenant) ID field.
  • Switch to the Classter Portal (Figure 19).

Figure 19

In the page in the Classter Portal you will see the following (Figure 19):

  • In the Client ID field (Figure 19), you need to paste the code you copied in the previous step from the Application (Client) ID field in MS Azure (Figure 18).
  • In the Tenant ID field (Figure 19), you need to paste the code you copied in the previous step from the Directory (Tenant) ID field in MS Azure (Figure 18).
  • We have already filled in the Template ID Field in the previous step (Step 2).

Step 4

Now we will follow the process to fill in the final code we need, to fulfill the integration of Teams with Classter. We continue on MS Azure.

From the registration page we looked at earlier, we need to click on the Certificates & Secrets button from the menu on the left side of the page (Figure 20).

Figure 20

  • Once you click on the ‘Certificates & Secret’ you will be transferred to the following page (Figure 21).

Figure 21

In the page you will see the following (Figure 21):

  • From this page you need to click on the ‘New Client Secret’ button.
  • Once you click on the button you will view the following (Figure 22).

Figure 22

In the page you will see the following (Figure 22):

  • Select an expiration period for the client secret e.g 1 year.
  • Click on the Add button.
  • Once you have done this, you will see the client secret code (Figure 23).

Figure 23

In the page you will see the following (Figure 23):

  • Click on the ‘Copy’ button next to the code you see in the figure.
  • This code must be retained and placed in the team’s integration page of the Classter portal (Figure 24).

Figure 24

In the page you will see the following (Figure 24):

  • Here you can see all the codes have been entered into the Team’s integration page in the Classter portal.

Step 5

In this next part we will leave the certificates & secrets page by clicking on the API Permissions button from the menu on the left side of the page (Figure 25).

Figure 25

Figure 26

In the page you will see the following (Figure 26):

  • On the API Permissions page, you need to click on the options button next to the permission.
  • Click on ‘Remove all permissions’

Figure 27

  • In the warning window click on the ‘Yes, remove’ button.
  • Once you have removed the permissions, click on the ‘Add a Permission’ button (Figure 28).

Figure 28

  • Once you click on the ‘Add a Permission’ button (Figure 28), you will see a window popup from the right side of the screen (Figure 29).

Figure 29

  • Click on the ‘Microsoft Graph’ button (Figure 29).

F

Figure 30

  • Click on the ‘Application permissions’ button (Figure 30).
  • You will see options load in the ‘Request API permissions’ once you have clicked on the ‘Application permissions’ button (Figure 31).

Figure 31

In the page you will see the following (Figure 31):

  • Use the search field to locate User privileges e.g user.
  • Click on the User dropdown list and select ‘User.ReadWrite.All’.

Figure 33

In the page you will see the following (Figure 33):

  • Use the search field to locate Directory privileges e.g directory.
  • Click on the User dropdown list and select ‘Directory.ReadWrite.All’.

Figure 34

In the page you will see the following (Figure 34):

  • Use the search field to locate Group privileges e.g Group.
  • Click on the User dropdown list and select ‘Group.ReadWrite.All’.
  • Click on the ‘Add permissions’ button in the bottom of the page (Figure 35).

Figure 35

Once you have added the permissions, you will be returned to the main permission page.

You will notice that the permissions have not been granted consent.

You will click on the Grant admin consent for Vertitech button and you will see that all your permissions will turn green (Figure 36).

Figure 36

Step 6

Switch to the Classter portal from MS Azure. Follow the path DashboardConfigurationAdvanced ConfigurationThird Party IntegrationsMS Teams (Figure 37).

Figure 37

In the page you will see the following (Figure 37):

  • Teams can be created based on Groups/Classes, Year or Group/Class and Subject.
  • Depending on your classter terminology the terms you see may differ.
  • The Group/Class option will create teams based on groups/classes. It will add all students and teachers to the appropriate group/class.
  • The Year option will create teams based on the Year (Grade). It will add all students and teachers of the year/grade to the appropriate team.
  • The Group/Class and Subject option will create teams for the Group/Class based on the Subject. Each group/class will have its own team for each subject.
  • Choose the ‘Groups/Classes and Subjects’ option.
  • Click on the ‘Save’ button.

MS Office Required Actions

Step 7 requires use to move to the website of Office 365. Please use the link: https://www.office.com.

Figure 38

In the page you will see the following (Figure 38):

  • Once you enter the url in the browser and click on search you will land on the office homepage.
  • Enter the sign in page by clicking on the sign in button.

Once you click on sign in you will be asked to fill in your username and password to enter.

Figure 39

  • Click on the ‘Admin’ button.
  • You will be transferred to the Admins page (Figure 40).
  • Toggle off the New Admin Center (Figure 40).

Figure 40

Figure 21

In the page you will see the following (Figure 21):

  • Click on the settings tab to view the dropdown list.
  • From the settings dropdown list, click on the Services & add-ins option.
  • From the center of the page scroll down to Microsoft Teams and click on the button.
  • You will see a side window open (Figure 22).

Figure 22

In the page you will see the following (Figure 22):

  • From the dropdown box ‘Select the user/license type you want to configure’ choose Education – Faculty and Staff.
  • Toggle the option ‘Turn Microsoft Teams on or off for all users of this type’ on and off.
  • Once you have turned the option on and off, click on the ‘Save’ button.
  • Repeat the procedure, this time choose a different group (Figure 23).

Figure 23

In the page you will see the following (Figure 23):

  • From the dropdown box ‘Select the user/license type you want to configure’ choose Education – Student.
  • Toggle the option ‘Turn Microsoft Teams on or off for all users of this type’ on and off.
  • Once you have turned the option on and off, click on the ‘Save’ button.

You can now return to Classter Portal for the final step of the process.

Classter Required Actions

Once you are on the Classter Portal, you must navigate to the User Accounts page (Figure 24). Follow the path: DashboardManagementUser Accounts (Figure 24).

Figure 25

In the page you will see the following (Figure 25):

  • From Filters Select Teachers in the user type field and then click on search.
  • You will see the results in the list below, check on the number of teachers shown and make sure if the ‘Show X Entries’ option has more entries than you can see in the list change the number in the ‘Show X Entries’.
  • Click on the select all entries button, to select all teachers in the list.
  • Now with all the teachers selected open the Bulk Actions dropdown button and select the ‘Sync External Provider/Moodle Data’ button.

Figure 26

  • Once you have synced the data you will see that in the pending changes column of the list all ‘No’s’ have turned to ‘Yes’ (Figure 26).
  • You will repeat this process with the Students this time (Figure 27).

Figure 27

In the page you will see the following (Figure 27):

  • From Filters Select Students in the user type field and then click on search.
  • You will see the results in the list below, check on the number of Students show. If Students are more than 1000 (max number managed with show x entries option), you will have to repeat the process again.
  • Click on the select all entries button, to select all students in the list.
  • Now with all the students selected open the Bulk Actions dropdown button and select the ‘Sync External Provider/Moodle Data’ button.

Figure 28

  • Once you have synced the data you will see that in the pending changes column of the list all ‘No’s’ have turned to ‘Yes’ (Figure 28).

Note: This Process may take up to 24hours to go through.