Introducing KyberOS — Digital safety + Physical security in one platform.Learn more →
CHROMEBOOK GUIDE

Deploy KyberGate on Chromebooks

Force-install the KyberGate Chrome extension across your fleet using Google Admin Console. No student interaction required.

Open Chrome Web Store aodjgiobchlnlmicciieahkfnmkoojef

Prerequisites

Google Workspace for Education account
Google Admin Console access (super admin)
Chrome Education Upgrade on managed Chromebooks
KyberGate organization ID (from your dashboard)
1

Open Google Admin Console

Go to admin.google.com and sign in with your super admin account. Navigate to Devices → Chrome → Apps & extensions.

💡 You can also access this at: admin.google.com/ac/chrome/apps/user

2

Select Your Organizational Unit

In the left panel, select the OU that contains your student Chromebooks. You can apply to the entire domain or specific OUs (e.g., 'Students', 'Grade 6-8').

💡 Tip: Start with a small test OU before rolling out to the entire school.

3

Add the KyberGate Extension

Click the + icon → 'Add from Chrome Web Store'. Search for 'KyberGate' or enter the extension ID directly. Select it and click 'Add'.

💡 Extension ID: aodjgiobchlnlmicciieahkfnmkoojef

4

Set Installation Policy

Click on the KyberGate extension in the list. Under 'Installation Policy', select 'Force install'. This silently installs the extension on all Chromebooks in the selected OU — students cannot remove it.

💡 Force install + pin to toolbar is recommended so students can see the protection status.

5

Configure Extension Policy (JSON)

Under 'Policy for extensions', paste the JSON configuration from your KyberGate dashboard. This sets your org ID and proxy URL so the extension connects to your account automatically.

6

Upload Root CA Certificate

Go to Devices → Networks → Certificates. Click 'Create Certificate', upload the KyberGate Root CA (.pem file), and in the Certificate Authority section check 'Enabled for Chromebook' (Google's current equivalent of the older 'Use as an HTTPS certificate authority' option), then click Add. This allows Chrome OS to trust KyberGate's SSL inspection certificates.

💡 Download the Root CA from: proxy.kybergate.com/api/ca.pem

7

Configure Proxy (PAC URL)

Go to Devices → Networks → Wi-Fi (or Ethernet). Edit your network profile and under Proxy settings, select 'Automatic proxy configuration'. Enter your PAC URL from the KyberGate dashboard. This routes Chromebook traffic through KyberGate for full SSL inspection and the 8-layer detection engine.

💡 PAC URL format: https://proxy.kybergate.com/api/pac/YOUR_ORG_ID

8

Verify Deployment

Open a managed Chromebook and check that the KyberGate extension icon appears in the toolbar. Open the popup to verify it shows 'Connected' with your org name. Visit a blocked site (e.g. tiktok.com) to confirm the KyberGate block page appears. In the KyberGate dashboard, the device should appear under Devices within 60 seconds.

5b

Extension Policy JSON

Copy this into the "Policy for extensions" field. Replace YOUR_ORG_ID with your organization ID from the KyberGate dashboard.

{
  "orgId": {
    "Value": "YOUR_ORG_ID"
  },
  "proxyUrl": {
    "Value": "https://proxy.kybergate.com"
  },
  "deviceId": {
    "Value": "${DEVICE_SERIAL_NUMBER}"
  }
}

SSL Inspection & Proxy Setup

Required for full content inspection — enables the 8-layer detection engine, AI content analysis, and zero-day site blocking.

6

Upload Root CA Certificate

The Root CA certificate allows Chrome OS to trust KyberGate's SSL inspection. Without it, students will see certificate warnings.

  1. Download the Root CA: kybergate-root-ca.pem
  2. In Google Admin, go to Devices → Networks → Certificates
  3. Click "Add Certificate" and upload the .pem file
  4. Name it "KyberGate Root CA"
  5. In the Certificate Authority section, check "Enabled for Chromebook" (Google's current equivalent of the older "Use as an HTTPS certificate authority" option)
  6. Click Save

💡 Apply the certificate to the same OU as the extension for consistent coverage.

7

Configure Proxy (PAC URL)

The PAC (Proxy Auto-Configuration) file routes Chromebook web traffic through KyberGate's inspection proxy for full SSL content analysis.

  1. In Google Admin, go to Devices → Networks
  2. Select or create a Wi-Fi or Ethernet network configuration for your Chromebooks
  3. Under Proxy settings, select "Automatic proxy configuration"
  4. Enter your PAC URL (replace YOUR_ORG_ID with your org ID from the KyberGate dashboard):
https://proxy.kybergate.com/api/pac/YOUR_ORG_ID

💡 Find your Organization ID in the KyberGate dashboard under Settings → School Info.

8

Verify Deployment

Open a managed Chromebook and verify: (1) the KyberGate extension icon appears in the toolbar and shows "Connected", (2) visit a blocked site like tiktok.com to confirm the KyberGate block page appears, and (3) check the KyberGate dashboard — the device should appear under Devices within 60 seconds.

What You Get

Full SSL inspection via proxy (Root CA + PAC URL)
8-layer AI game detection engine
Zero-day site classification (Google Gemini AI)
Syncs filtering policies from KyberGate every 5 minutes
Blocks domains, keywords, and content categories in real-time
Detects 30+ game engines (Unity, Phaser, Godot, etc.)
Enforces SafeSearch on Google, Bing, and YouTube
Captures screenshots on teacher request
Monitors safety keywords (KyberPulse-lite)
Sends heartbeat every 30 seconds (online status)
Executes classroom commands (lock, unlock, push URL, focus mode)
Shows branded block page for blocked content

Troubleshooting

Extension not appearing on Chromebook

Allow up to 15 minutes for Google Admin policy to propagate. Force a policy refresh: chrome://policy → 'Reload policies'. Ensure the Chromebook is in the correct OU.

Extension shows 'Not Connected'

Verify the orgId in the extension policy JSON matches your KyberGate organization ID. Check that proxy.kybergate.com is accessible from the school network (not blocked by another filter).

Device not showing in dashboard

The heartbeat takes up to 30 seconds. Check the extension popup for errors. Ensure the orgId is correct and the Chromebook has internet access.

Student removed the extension

If 'Force install' is set correctly in Google Admin, students cannot remove the extension. If they're using a personal Google account, the extension won't be enforced — use managed guest sessions or force sign-in with school accounts.

SSL certificate errors after proxy setup

Ensure the KyberGate Root CA certificate was uploaded in Devices → Networks → Certificates with 'Enabled for Chromebook' checked in the Certificate Authority section (this replaced the older 'Use as an HTTPS certificate authority' checkbox). The certificate must be applied to the same OU as your Chromebooks. Allow 15 minutes for policy propagation.

Where is the SSL inspection toggle?

SSL inspection is handled by the KyberGate proxy — not Chrome OS. Upload the Root CA under Devices → Networks → Certificates, then configure the PAC URL in your network profile's proxy settings. No Chrome OS SSL inspection setting is needed.

Proxy not working / pages loading slowly

Verify the PAC URL is correct and includes your org ID. Ensure proxy.kybergate.com port 8443 is allowed through your school firewall. Test by visiting proxy.kybergate.com/health in a browser — it should return a healthy status.

Ready to Deploy?

Start your free 30-day pilot. We'll help you configure Google Admin and verify deployment.