Browser Extension Deployment

Overview

GuardAxion security is enforced through browser extensions that must be installed on user devices. This guide covers deployment methods for different browsers.

Supported Browsers

• Google Chrome
• Microsoft Edge
• Mozilla Firefox
• Brave
• Opera

Extension Download

Extensions are available from:

1. GuardAxion Dashboard: Setup & Deployment > Extension Updates
2. Direct Links: Provided by administrator
3. Enterprise Stores: For managed deployments

Manual Installation

Chrome/Edge/Brave

1. Download extension file (.crx)
2. Open browser extensions page:
   • Chrome: chrome://extensions
   • Edge: edge://extensions
   • Brave: brave://extensions
3. Enable Developer mode
4. Drag and drop .crx file
5. Click Add extension

Firefox

1. Download extension file (.xpi)
2. Open Firefox Add-ons page (about:addons)
3. Click gear icon > Install Add-on From File
4. Select .xpi file
5. Click Add

Enterprise Deployment

Chrome Enterprise Policy

1. Upload extension to Google Admin Console
2. Configure force-install policy:

{
  "ExtensionInstallForcelist": [
    "[EXTENSION_ID];https://your-server.com/updates.xml"
  ]
}

Microsoft Intune (Edge)

1. Create configuration profile
2. Add Edge extension policy
3. Deploy to user groups

Firefox Enterprise

1. Create policies.json file
2. Add extension configuration:

{
  "policies": {
    "Extensions": {
      "Install": [
        "https://your-server.com/extension.xpi"
      ]
    }
  }
}

User Enrollment

Step 1: Install Extension

User installs extension using method above

Step 2: Enter Enrollment Key

1. Extension icon appears in browser
2. Click extension icon
3. Enter enrollment key provided by admin
4. Click Enroll

Step 3: Verify Enrollment

1. Extension shows "Protected" status
2. Policies begin syncing
3. User appears in admin dashboard

Configuring Extension Updates

Automatic Updates

1. Dashboard > Extension Updates
2. Enable Auto-update
3. Set update interval
4. Upload new extension versions

Update XML Configuration

<?xml version='1.0' encoding='UTF-8'?>
<gupdate xmlns='http://www.google.com/update2/response' protocol='2.0'>
  <app appid='[EXTENSION_ID]'>
    <updatecheck codebase='https://server.com/extension.crx' version='1.2.0' />
  </app>
</gupdate>

Extension Permissions

Required Permissions

• webRequest: Monitor web traffic
• webRequestBlocking: Block policy violations
• storage: Store policies locally
• tabs: Monitor browsing activity
• identity: User authentication

Privacy Considerations

• No personal data collected
• Policies stored locally
• Encrypted communication
• Audit logs for compliance

Monitoring Deployment

Enrollment Status

1. Dashboard > User Management
2. Filter by enrollment status
3. View enrolled browsers per user
4. Check policy sync status

Extension Health

1. Analytics > System Health
2. Monitor:
   • Extension version distribution
   • Policy sync failures
   • Offline browsers
   • Update compliance

Troubleshooting

Extension Not Installing

• Check browser version compatibility
• Verify download not corrupted
• Disable conflicting extensions
• Try incognito mode first

Enrollment Fails

• Verify enrollment key valid
• Check network connectivity
• Confirm server reachable
• Review browser console errors

Policies Not Syncing

• Check extension version
• Verify service class assignment
• Force policy refresh
• Review sync interval settings

Extension Disabled

• Check enterprise policies
• Verify not flagged as malware
• Re-enable in browser settings
• Contact administrator

Best Practices

• Test in pilot group first
• Provide user documentation
• Offer helpdesk support
• Monitor enrollment progress
• Keep extensions updated
• Regular deployment audits
• Backup enrollment keys
• Document deployment process

Uninstalling Extension

User Removal

1. Open browser extensions
2. Find GuardAxion extension
3. Click Remove
4. Confirm removal

Admin Unenrollment

1. Dashboard > User Management
2. Find enrolled browser
3. Click Unenroll
4. Policies stop enforcing immediately

Deployment Checklist

• [ ] Choose deployment method
• [ ] Generate enrollment keys
• [ ] Test with pilot users
• [ ] Prepare user documentation
• [ ] Configure auto-updates
• [ ] Set up monitoring alerts
• [ ] Train helpdesk staff
• [ ] Roll out to all users
• [ ] Verify enrollment completion
• [ ] Monitor for issues