Rehearsal Online Homework — IT Admin Setup & Google Whitelisting Sheet
Zero-Friction Classroom Deployment Guide for Google Workspace & School Networks
OAuth Scopes:
openid email profile1. Optional Google Sign-In Whitelisting in Google Admin Console
Current Launch Status: Google Sign-In is disabled by default in the current deployment — teachers use 6-digit email verification codes and students use 6-character Class + Student Codes, so no Google Admin Console whitelisting is required right now.
- If your district later enables custom Google OAuth, sign in at admin.google.com as a Super Administrator.
- Navigate to Security → Access and data control → API controls → Manage Third-Party App Access.
- Click Add app → OAuth App Name Or Client ID, then enter your deployment's verified Google OAuth Web Client ID.
- Select Trusted (recommended for assigned student/music OUs) or Limited so students and teachers on restricted school Google accounts can sign in cleanly.
Non-Sensitive Scopes Requested: openid, email, profile ONLY. Rehearsal never requests Google Drive, Google Classroom, Gmail, or Contacts scopes for Online Homework.
2. Network, Firewall & Email Filter Allowlist
| Endpoint / Host | Protocol | Purpose |
|---|---|---|
https://app.rehearsalmusic.com/ (and custom school origin if self-hosted) |
HTTPS (443) | Rehearsal Web App, Demo (hw-demo.html) & Student Homework Portal (hw.html / /hw) |
Online Homework API domain (https://api.rehearsalmusic.com) |
HTTPS (443) | Assignment fetch, server-verified grading, R2 audio uploads & Gradebook streaming |
https://accounts.google.com, https://apis.google.com |
HTTPS (443) | Optional Google Identity Services sign-in flow |
Sender: [email protected] (or configured FROM_EMAIL) |
Email / SPF/DKIM | Teacher 6-digit sign-in verification codes (allowlist against aggressive spam quarantines) |
3. Chromebook, iPad & Desktop Readiness
- Microphone Access: Ensure
getUserMediamicrophone access is allowed for the Student Portal origin on student Chromebooks and iPads. - Offline Drop Protection: Student recordings queue locally in browser IndexedDB if school Wi-Fi drops mid-class and auto-upload on reconnect.
- Mac / Windows Desktop App: Teacher Google Sign-In opens the system default browser via 60-second one-time OAuth handoff polling — no embedded WebView login blocks.
4. Data Governance Summary for IT
- 90-Day Media Expiry: Student audio blobs expire automatically in 90 days (R2 lifecycle + daily cron).
- FERPA Export & Purge: One-click student JSON export, Gradebook CSV, and cascading deletion available to teachers anytime.
- Full Privacy Docs:
privacy.html& 1-page SDPC briefprivacy-sdpc.html.