Getting Started with CBManagement

CBManagement provides comprehensive Chromebook monitoring and filtering for educational institutions. This guide will help you get started quickly.

Prerequisites: You'll need Google Workspace admin access and the ability to deploy Chrome extensions via the Admin Console.

Installation

1 Deploy Chrome Extension

The CBManagement extension must be installed on all Chromebooks you want to monitor. This is done through the Google Admin Console.

Sign in to admin.google.com
Navigate to Devices → Chrome → Apps & extensions
Click Add Chrome app or extension
Enter the extension ID or upload the extension
Select the organizational units to deploy to
Set installation policy to Force install
Click Save

Tip: Use "Force install" to ensure the extension is automatically installed on all devices without user intervention.

2 Extension Auto-Configuration

The extension automatically detects and connects to your CBManagement server. No manual configuration needed!

That's it! Once deployed, the extension will automatically start tracking activity and enforcing policies.

Google Workspace Setup

3 Connect Google Workspace

Sync your organizational structure to easily manage policies by OU.

Log in to CBManagement
Navigate to Directory in the sidebar
Click Sync with Google Workspace
Sign in with your Google admin account
Grant the requested permissions
Wait for sync to complete

Note: The sync only requires read-only access to users and OUs. CBManagement cannot modify your Google Workspace data.

Activity Monitoring

Once installed, the extension automatically tracks all browsing activity on managed Chromebooks.

What Gets Tracked

URLs: Full URL of every page visited
Page Titles: Title of each webpage
Time Spent: Duration on each page (excludes minimized windows)
User Email: Which student was browsing
Device Serial: Which Chromebook was used
Session Info: Groups activity by browsing session
Timestamps: When activity occurred (local timezone)

Viewing Activity

Access activity reports from the dashboard:

Dashboard: Recent activity across all users
By User: All activity for a specific student
By Site: All visits to a specific website
By Device: All activity from a specific Chromebook

Website Filtering

Create policies to block inappropriate websites and enforce safe browsing.

Creating a Policy

Go to Policy Manager → Policies
Click Create New Policy
Enter a policy name (e.g., "Block Social Media")
Add websites to block (one per line)
Use wildcards for entire domains (e.g., *.youtube.com)
Save the policy

Wildcard Examples

*.facebook.com          # Blocks all Facebook
*://www.tiktok.com/*    # Blocks TikTok
*gaming*                # Blocks any URL with "gaming"
reddit.com              # Blocks reddit.com only

Policy Management

Creating Schedules

Schedules control when policies are active. For example, block social media during school hours but allow it after 3 PM.

Go to Policy Manager → Schedules
Select a policy
Click Add Schedule
Select days of week (Monday-Friday)
Set start time (e.g., 8:00 AM)
Set end time (e.g., 3:00 PM)
Save the schedule

Important: If no schedule is set, the policy is always active. Create schedules to enable time-based filtering.

Assigning Policies

Assign policies to organizational units or individual users:

Go to Policy Manager → Assignments
Select a policy from the dropdown
Choose OUs or users to assign to
Click Assign

Reports & Analytics

Time Filters

All reports support these time ranges:

Today: Activity from midnight to now
7 Days: Past week of activity
30 Days: Past month of activity
All Time: Complete history

Search & Filter

Use the search bar to filter results by user email, website URL, or device serial number.

Frequently Asked Questions

Does CBManagement track incognito/private browsing?

Yes, if the extension is deployed with "Allow in incognito" enabled in the Admin Console.

Can students disable the extension?

No. When deployed via Google Admin with "Force install", students cannot disable or remove it.

What happens when a Chromebook is offline?

Activity is queued locally and sent to the server once the device reconnects to the internet.

Can I export reports?

Yes, all reports can be exported to CSV for further analysis in Excel or other tools.

Troubleshooting

Extension not tracking activity

Verify the extension is installed (check chrome://extensions)
Ensure the Chromebook has internet connectivity
Check the Error Logs page in the dashboard
Verify the extension has the correct permissions

Policies not blocking websites

Verify the policy is assigned to the user's OU
Check if a schedule is active for the current time
Ensure wildcard patterns are correct
Check the Diagnostics page for blocking events

Google Workspace sync failing

Ensure you're signing in with an admin account
Check that Admin SDK API is enabled in Google Cloud Console
Verify OAuth redirect URIs match exactly
Clear browser cache and try again

Need more help? Contact support or check the System Health → Error Logs page for detailed error messages.