Chrome Extension Integration

The Chrome extension is the core component that enforces policies in the browser. This guide covers advanced configuration and management.

Extension Overview

The extension:

• Monitors AI platform interactions
• Enforces policies in real-time
• Reports events to dashboard
• Works offline with cached policies

Installation Options

Individual Installation

Users install from Chrome Web Store:

1. Share installation link from dashboard
2. User clicks "Add to Chrome"
3. Extension connects automatically

MDM Push

Deploy via device management:

• Intune Setup
• Jamf Setup
• Google Workspace Setup

Group Policy (Windows)

Deploy via Windows GPO:

{
  "ExtensionInstallForcelist": {
    "Value": ["extension_id;update_url"]
  }
}

Configuration

Organization Settings

Configure at Integrations > Chrome Extension:

Setting	Description
Organization ID	Auto-assigned identifier
Update Channel	Stable, Beta, or Dev
Policy Cache Duration	How long policies cached offline
Heartbeat Interval	Health check frequency

Extension Behavior

Setting	Description	Default
Block UI Style	How blocks appear to users	Modal
Warn UI Style	How warnings appear	Toast
Show Badge	Display alert count on icon	Yes
Sound Alerts	Play sound on block	No

Policy Sync

Setting	Description	Default
Sync Interval	How often to fetch updates	5 minutes
Offline Mode	Behavior when disconnected	Cache
Conflict Resolution	When policies conflict	Most restrictive

Advanced Configuration

Custom Messages

Customize user-facing messages:

Block Message

Your organization's AI usage policy prevents this action.
Policy: {policy_name}
Contact your administrator for assistance.

Warn Message

This content may violate policy: {policy_name}
Are you sure you want to continue?

Corporate Notice

Professional

Display a notice on AI platforms:

1. Go to Integrations > Site Controls
2. Click Corporate Notice
3. Enter your message:

   AI Usage Notice: All interactions are monitored
   per company policy. Do not share confidential data.

4. Choose display style (banner, modal, etc.)
5. Save

Allowlist/Blocklist

Control where the extension operates:

Allowlist Mode

• Only enforce on listed platforms
• Useful for piloting

Blocklist Mode

• Enforce everywhere except listed
• Exclude internal tools

Monitoring

Health Dashboard

View extension health:

• Connected devices count
• Version distribution
• Error rates
• Sync status

Alerts

Get notified of issues:

• Devices disconnecting
• Version skew
• Sync failures
• Error spikes

Troubleshooting

Extension Not Working

1. Check Installation

   • Verify extension is installed
   • Confirm it's enabled
   • Check for conflicts

2. Check Connection

   • Click extension icon
   • Verify "Connected" status
   • Try "Reconnect" option

3. Check Policies

   • Open extension options
   • View cached policies
   • Force policy sync

4. Check Permissions

   • Extension needs site access
   • Verify in Chrome settings
   • Grant required permissions

Common Error Codes

Code	Meaning	Solution
E001	Not authenticated	Sign in again
E002	Network error	Check connectivity
E003	Policy sync failed	Wait and retry
E004	Invalid organization	Contact admin
E005	Extension outdated	Update extension

Logs

Access extension logs:

1. Right-click extension icon
2. Select "Options"
3. Click "Debug Logs"
4. Export for support

Updates

Automatic Updates

Extensions update automatically via Chrome.

Version Channels

• Stable: Production-ready
• Beta: Pre-release testing
• Dev: Experimental features

Forcing Updates

MDM can force specific versions:

{
  "ExtensionSettings": {
    "extension_id": {
      "minimum_version_required": "1.5.0"
    }
  }
}

Security

Permissions

Extension requests minimal permissions:

• activeTab - Current tab access
• storage - Save settings
• webRequest - Monitor AI requests

Data Handling

• Policies processed locally
• Content never leaves browser
• Only metadata reported

Code Security

• Signed by Containment.AI
• Chrome Web Store verified
• Regular security audits

Related Topics

• Quick Start - Initial setup
• MDM Integration - Enterprise deployment
• Site Controls - Per-site configuration