Enterprise Deployment

Deploy Classroom Monitor with one Setup EXE via Active Directory Group Policy or Microsoft Intune. Same file as Force Update; no multi-file folder required.

Per-channel interactive install (Windows, browsers, Android): Setup guide.

One-file package

Download ClassroomMonitor-Setup from /downloads (or version-info.json setup_url / durable /downloads/installers/latest/setup.exe). An MSI is also published (msi_url / latest/setup.msi). Tip auto-update and Update / Downgrade use MSI when the client was MSI-installed; Setup installs keep Setup EXE.

/quiet /norestart INSTALLATION_TYPE=Student INSTALL_EXTENSION=1

  • Student (lab): INSTALLATION_TYPE=Student
  • Teacher (console): INSTALLATION_TYPE=Teacher
  • Server: INSTALLATION_TYPE=Server
  • Browser extension force-install: INSTALL_EXTENSION=1 (or /InstallExtension). Student fresh install defaults ON; Teacher/Server default OFF. MSI: same property. PowerShell: downloads/gpo/Install-ClassroomMonitor.ps1 -InstallExtension.

Group Policy Deployment

Preferred: Computer Configuration Startup scripts with the one Setup EXE. Optional: native Software Installation can use the published MSI (msiexec INSTALLATION_TYPE=Student|Teacher|Server).

  1. Copy the Setup EXE to a share readable by Domain Computers (example: \\fileserver\Software\ClassroomMonitor\).
  2. Create a GPO linked to the computer OU.
  3. Computer Configuration β†’ Policies β†’ Windows Settings β†’ Scripts (Startup/Shutdown) β†’ Startup β†’ Add the EXE (or a one-line .cmd that calls it).
  4. Parameters: /quiet /norestart INSTALLATION_TYPE=Student INSTALL_EXTENSION=1 (or Teacher / Server; omit or INSTALL_EXTENSION=0 to skip the browser extension).
  5. Scope Security Filtering, run gpupdate /force on a test PC, reboot, confirm Program Files\ClassroomMonitor and HKLM\SOFTWARE\NewsTargeted\ClassroomMonitor.

Install log: %ProgramData%\ClassroomMonitor\Logs\setup.log

Microsoft Intune Deployment

  1. Download the same Setup EXE (Win32 app package).
  2. Intune β†’ Apps β†’ Windows β†’ Add β†’ Windows app (Win32).
  3. Install command: ClassroomMonitor-Setup-vX.Y.Z.exe /quiet /norestart INSTALLATION_TYPE=Student INSTALL_EXTENSION=1
  4. Detect C:\Program Files\ClassroomMonitor\ClassroomMonitor.exe; assign to device groups.

Force-install Chrome and Edge extension (block Remove)

Students and teachers must not remove the Classroom Monitor browser extension without a valid unlock / exit code (from the Teacher Console) or an administrator / UAC / school policy change (GPO, Intune, MDM, or Setup clearing the policy). Extension v1.1.8+ gates in-extension Stop on the unlock code. Only browser enterprise policy with force_installed hides the stock Remove button on chrome://extensions / edge://extensions.

What blocks what

Action Without force_installed With force_installed (managed)
Stop in extension popup Needs unlock / exit code Same: unlock required
Disable toggle User can often turn the extension off Usually blocked (installType: admin)
Remove in browser extensions page Remove stays visible; the extension cannot hide it Remove hidden or blocked by the browser

There is no separate Chromium policy named "prevent removal". installation_mode: force_installed is what removes the user Remove control.

Store ID and sample JSON

  • Extension ID: mfckcopffcphadempnmcbagbnapdafhi
  • Update URL: https://classroom.newstargeted.com/downloads/extensions/update.xml
  • Sample ExtensionSettings JSON: chrome-edge-extension-settings.json (merge with your other extensions; do not overwrite unrelated keys)
{
  "mfckcopffcphadempnmcbagbnapdafhi": {
    "installation_mode": "force_installed",
    "update_url": "https://classroom.newstargeted.com/downloads/extensions/update.xml",
    "override_update_url": true
  }
}

Developer PCs that use Load unpacked get a different extension ID. Force-install policies must target the ID shown on edge://extensions (or Chrome). School Setup writes policies for the store ID after CRX force-install.

What Classroom Monitor Setup applies

Interactive Setup shows a checkbox: Install browser extension for Chrome and Edge (default ON for Student, OFF for Teacher/Server). Silent and GPO use INSTALL_EXTENSION=1 / 0 (or /InstallExtension / /NoInstallExtension). Preference is stored at HKLM\SOFTWARE\NewsTargeted\ClassroomMonitor\InstallBrowserExtension.

When opted in, Setup (admin) runs the extension bridge (tip 1.5.8.26+; force-install guards from extension 1.1.8+):

ClassroomMonitor.exe --register-extension-bridge

That step registers (packed CRX / update.xml path):

  • Native messaging host (HKCU, plus best-effort HKLM)
  • ExtensionInstallForcelist for Chrome and Edge
  • ExtensionSettings merge with installation_mode: force_installed
  • Optional InPrivate / incognito mandatory-extension lists (see school InPrivate policy notes)

Same-version reinstall (1.5.8.199+)

Operators can replace a published tip folder without bumping FileVersion when only content changes. version-info.json carries sha256_installer and build_id. After Setup/MSI installs, the client stores InstalledInstallerSha256. Tray Check for updates treats the same version with a different tip hash as Reinstall update and downloads again. Matching hashes stay Up to date.

Update-time heal (1.5.8.105+; Student default from 1.5.8.206)

On Check for Updates, Install Update Now, quiet Setup, silent ClassroomMonitorUpdate, remote force_update, MSI upgrade, or PowerShell upgrade:

  • If Chrome/Edge force-install for Classroom Monitor is missing, the client detects that and re-applies Setup force-install when allowed (--heal-extension-force-install / quiet Setup with INSTALL_EXTENSION=1).
  • InstallBrowserExtension=1 (or Teacher/Server already opted in): always heal when missing.
  • Student with preference unset: defaults ON so Allow List Only and reliable Block List keep working after update; preference is written to 1 after a successful heal.
  • Explicit InstallBrowserExtension=0 / INSTALL_EXTENSION=0: updates do not add the extension (school opt-out respected).
  • Heal failures (no admin, locked GPO) are logged and never crash the desktop update. Teacher/Server may see a tray note; Students stay silent.
  • Presence checks cover packed CRX id mfckcopffcphadempnmcbagbnapdafhi, Chrome Web Store id ckbjmljglifaigcppogdilfefnhfdbpo, and Edge policy entries.

Daily classroom use does not need repeated UAC. Only Setup, update service, or an elevated heal touches HKLM. For silent lab deploy of the desktop client first, see Group Policy and Intune above. Sideload steps for testing: Setup guide (Chrome and Edge).

Microsoft Edge (registry / policy)

Root: HKLM\SOFTWARE\Policies\Microsoft\Edge

  1. Set ExtensionSettings (REG_SZ) to the merged JSON above (or deploy the same via Edge Administrative Templates β†’ Configure extension settings).
  2. Optional legacy forcelist (Setup still sets this): ExtensionInstallForcelist\1 = mfckcopffcphadempnmcbagbnapdafhi;https://classroom.newstargeted.com/downloads/extensions/update.xml
  3. Run gpupdate /force (or wait for Intune sync), then open edge://policy and confirm both policies.
  4. Open edge://extensions: Classroom Monitor should show as installed by your organization, with no Remove.

Google Chrome (registry / policy)

Root: HKLM\SOFTWARE\Policies\Google\Chrome

Same keys as Edge:

  • ExtensionSettings (JSON above)
  • ExtensionInstallForcelist\1 (same forcelist string)

Confirm on chrome://policy and chrome://extensions.

GPO and Intune (extension only)

  1. Create or edit a GPO linked to student computer OUs (teachers may use a separate GPO without force-install).
  2. Computer Configuration β†’ Administrative Templates β†’ Microsoft Edge or Google Chrome.
  3. Enable Configure extension settings and paste the merged JSON.
  4. Enable Configure extension installation force list with the forcelist line above.
  5. Intune Settings catalog: use Control which extensions are installed silently / ExtensionSettings, plus the force-list entry. There is still no separate "prevent removal" toggle; force_installed is the control.

Unlock so Remove works again

  1. Teacher generates an unlock / exit code in the Teacher Console (same daily code flow as Android unlock).
  2. Student opens the extension popup β†’ Unlock stop / uninstall and enters the code.
  3. With the desktop client present, the bridge can clear force-install registry entries for Classroom Monitor after a valid code so browser Remove becomes available again.
  4. Without a desktop client, unlock still allows Stop presence, but Remove may stay blocked until IT removes the policy.

Verification checklist

  • edge://policy or chrome://policy: ExtensionSettings contains the store ID with force_installed
  • Extensions page: no Remove for Classroom Monitor (managed)
  • Popup with presence on: Stop disabled until unlock
  • Unmanaged Load unpacked: warning that the install is not force-installed; Remove still visible

Updates

After the first install, tip auto-update and Update / Downgrade use Setup EXE or MSI matching the install type. Replacing the share file and Startup path refreshes GPO deployments for new machines.