Deploy the OneNote Class Notebook add-in using Group Policy templates: A guide for IT admins

IT admins can use this guide to deploy the OneNote Class Notebook add-in across a school or district, using Group Policy templates. With this approach, IT admins push out default settings for a particular Learning Management System (LMS) or Student Information System (SIS) or Gradebook. By deploying this Group Policy, teachers have less to set up themselves to get started with assignment and grade integration with the Class Notebook add-in.

Getting started

Download the Class Notebook Add-in Group Policy templates.

This file contains a single language-neutral ClassNotebook.admx file and multiple language-specific ClassNotebook.adml files, one for each of the 43 languages that the Class Notebook add-in supports.

For information about using ADMX and ADML files for Windows 7 and Windows Server 2008 and above, see Managing Group Policy ADMX Files Step-by-Step Guide.

Managing LMS/SIS connections

The Class Notebook add-in allows teachers to connect to their school’s or district’s LMS/SIS. When teachers click the Connections button in the Class Notebook add-in, they are prompted for connection settings that will allow the Class Notebook add-in to connect to their LMS/SIS, as shown in the following screenshot.

Connections dialog of the OneNote Class Notebook add-in with Group Policy not configured

With this Group Policy, an IT administrator can set these settings for every teacher in the school or district. Once enabled, teachers will not need to enter the settings manually. The following screenshot shows the Manage Connections dialog with a Group Policy enabled.

Connections dialog of the OneNote Class Notebook add-in with Group Policy enabled.

The following sections describe these settings in detail and how they apply to each of the LMS/SIS that the Class Notebook add-in supports.

Group Policy settings

The following table lists the group policy settings that are included in the above templates.

Setting name

Registry path and value name

Description

LMS Name

HKEY_CURRENT_USER\Software\Policies\Microsoft\OneNoteClassNotebook\Lms

This policy setting specifies the LMS or SIS that the Class Notebook add-in connects to.

For the list of allowed values for this setting, refer to the section LMS/SIS settings below.

LMS Host URL

HKEY_CURRENT_USER\Software\Policies\Microsoft\OneNoteClassNotebook\LmsHost

This policy setting specifies the host URL of the LMS or SIS. Some LMS and SIS have constant host URLs while others have host URLs that are specific to a school or a district.

Refer to the section LMS/SIS settings below to see which LMS or SIS have school- or district-specific host URLs.

Client ID

HKEY_CURRENT_USER\Software\Policies\Microsoft\OneNoteClassNotebook\ClientId

This policy setting specifies the client ID (sometimes referred to as the app ID) that the Class Notebook add-in requires in order to call the Application Programming Interface (API) of some LMS or SIS. Client IDs are typically generated by the IT admin within the LMS/SIS user interface along with the client secret.

Refer to the section LMS/SIS settings below to see which LMS or SIS require a client ID.

Client Secret

HKEY_CURRENT_USER\Software\Policies\Microsoft\OneNoteClassNotebook\ClientSecret

This policy setting specifies the client secret (sometimes referred to as the app secret) that the Class Notebook add-in requires in order to call the Application Programming Interface (API) of some LMS or SIS.

Client secrets are typically generated by the IT admin within the LMS/SIS user interface along with the client ID.

Refer to the section LMS/SIS settings below to see which LMS or SIS require a client secret.

Access Token

HKEY_CURRENT_USER\Software\Policies\Microsoft\OneNoteClassNotebook\AccessToken

This policy setting specifies the access token (sometimes referred to as the user token) that the Class Notebook add-in requires in order to call the Application Programming Interface (API) of some LMS or SIS.

Access tokens are typically generated by the IT admin within the LMS/SIS admin settings.

Refer to the section LMS/SIS settings below to see which LMS or SIS require an access token.

School Code

HKEY_CURRENT_USER\Software\Policies\Microsoft\OneNoteClassNotebook\SchoolCode

This policy setting specifies the school code that the Class Notebook add-in for OneNote requires in order to call the Application Programming Interface (API) of some LMS or SIS.

The value of this setting is typically obtained from the LMS/SIS admin settings.

Refer to the section LMS/SIS settings below to see which LMS or SIS require a school code.

School Year

HKEY_CURRENT_USER\Software\Policies\Microsoft\OneNoteClassNotebook\SchoolYear

This policy setting specifies the school year that the Class Notebook add-in for OneNote requires in order to call the Application Programming Interface (API) of some LMS or SIS.

The value of this setting is typically obtained from the LMS/SIS admin settings.

Refer to the section LMS/SIS settings below to see which LMS or SIS require a school year.

LMS/SIS settings

The following sections list the group policy settings required by each of the LMS/SIS supported by the Class Notebook add-in.

A setting value in bold indicates that the value must be entered verbatim. For example, the value for the setting LMS Name.

A setting value in italics indicates that the value is specific to your school’s or district’s LMS/SIS instance and is typically obtained from the admin's settings. For example, the value for the setting LMS Host URL.

Aeries

Setting name

Setting type

Value

LMS Name

String

Aeries

Brightspace

Setting name

Setting type

Value

LMS Name

String

Brightspace

LMS Host URL

String

The URL of your school’s or district’s Brightspace instance. For example: https://contoso.brightspace.com

Client ID

String

Generated within your Brightspace instance. See this guide for information about how to generate the client ID.

Client Secret

String

Generated within your Brightspace instance. See this guide for information about how to generate the client secret.

Canvas

Setting name

Setting type

Value

LMS Name

String

Canvas

LMS Host URL

String

The URL of your school’s or district’s Canvas instance. For example: https://contoso.instructure.com

Classter

Setting name

Setting type

Value

LMS Name

String

Classter

Edmodo

Setting name

Setting type

Value

LMS Name

String

Edmodo

EDUonGo

Setting name

Setting type

Value

LMS Name

String

EDUonGo

LMS Host URL

String

The URL of your school’s or district’s EDUonGo instance. For example: https://contoso.eduongo.com

Firefly Learning

Setting name

Setting type

Value

LMS Name

String

FireflyLearning

LMS Host URL

String

The URL of your school’s or district’s Firefly Learning instance. For example: https://contoso.firefly.com

Google Classroom

Setting name

Setting type

Value

LMS Name

String

GoogleClassroom

LMS365

Setting name

Setting type

Value

LMS Name

String

Lms365

LMS Host URL

String

The URL of your school’s or district’s LMS365 instance. For example: https://contoso.sharepoint.com

Microsoft Classroom

Setting name

Setting type

Value

LMS Name

String

MicrosoftClassroom

Moodle

Setting name

Setting type

Value

LMS Name

String

Moodle

LMS Host URL

String

The URL of your school’s or district’s Moodle instance. For example: https://contoso.moodle.com

Access Token

String

Generated within your Moodle instance. See this guide for information about how to generate the access token.

OpenLearning

Setting name

Setting type

Value

LMS Name

String

OpenLearning

PowerSchool

Setting name

Setting type

Value

LMS Name

String

PowerSchool

Rediker

Setting name

Setting type

Value

LMS Name

String

Rediker

LMS Host URL

String

The URL of your school’s or district’s Moodle instance. For example: https://www.plusportals.com/contoso

School Code

String

Obtained from your Rediker instance. See https://aka.ms/classnotebookaddinrediker.

School Year

String

Obtained from your Rediker instance. See https://aka.ms/classnotebookaddinrediker.

School Bytes

Setting name

Setting type

Value

LMS Name

String

SchoolBytes

Schoology

Setting name

Setting type

Value

LMS Name

String

Schoology

LMS Host URL

String

The URL of your school’s or district’s Schoology instance. For example: https://contoso.schoology.com

Client ID

String

Generated within your Schoology instance. See https://aka.ms/classnotebookaddinschoology

Client Secret

String

Generated within your Schoology instance. See https://aka.ms/classnotebookaddinschoology

Sebit VCloud

Setting name

Setting type

Value

LMS Name

String

Sebit

Skyward

Setting name

Setting type

Value

LMS Name

String

Skyward

SunGard

Setting name

Setting type

Value

LMS Name

String

SunGard

Teacher Dashboard

Setting name

Setting type

Value

LMS Name

String

TeacherDashboard

LMS Host URL

String

The URL of your school’s or district’s Teacher Dashboard instance. For example: https://contoso.teacherdasboard365.com

WinjiGo

Setting name

Setting type

Value

LMS Name

String

WinjiGo

Share Facebook Facebook Twitter Twitter Email Email

Was this information helpful?

Great! Any other feedback?

How can we improve it?

Thank you for your feedback!

×