Microsoft Intune Deployment

Deploy PromptFence to Microsoft Edge browsers across your Windows/macOS fleet using Intune configuration profiles.

⏱️ Estimated Time: 20-30 minutes
👤 Required Access: Intune Administrator or Global Administrator
📦 Deployment Method: Configuration Profile (Settings Catalog)

Prerequisites

Deployment Options

You can deploy PromptFence to Edge using either:

  1. Settings Catalog (Recommended): Modern UI-based policy configuration
  2. Administrative Templates (ADMX): Traditional Group Policy-style deployment

This guide covers Settings Catalog which is the recommended approach for modern management.

Step-by-Step Deployment (Settings Catalog)

1Access Microsoft Intune Admin Center

Navigate to intune.microsoft.com and sign in with your administrator account.

2Create Configuration Profile

  1. In the left sidebar, go to Devices → Configuration profiles
  2. Click + Create profile
  3. Select Platform: Windows 10 and later (or macOS)
  4. Select Profile type: Settings catalog
  5. Click Create

3Name the Profile

Enter a descriptive name such as:

PromptFence Extension - Force Install

Click Next

4Add Extension Settings

  1. Click + Add settings
  2. Search for: Microsoft Edge
  3. Expand Microsoft Edge → Extensions
  4. Check the following settings:
    • ✅ Control which extensions are installed silently
    • ✅ Configure extension management settings
  5. Click Close

5Configure Force Install

For "Control which extensions are installed silently":

  1. Click + Add
  2. Enter the Extension ID from Edge Add-ons store
  3. Or use Chrome Web Store format: EXTENSION_ID;https://clients2.google.com/service/update2/crx
⚠️ Extension ID: Replace with the actual Extension ID once PromptFence is published to Edge Add-ons or Chrome Web Store. Edge supports both Edge Add-ons IDs and Chrome Web Store IDs.

6Configure Managed Settings (License Key)

For "Configure extension management settings":

  1. Click + Add to add a JSON configuration
  2. Paste the following JSON:
{ "EXTENSION_ID_HERE": { "license_key": "YOUR_LICENSE_KEY_HERE", "api_url": "https://promptfence-backend-production.up.railway.app", "managed_mode": true, "block_mode": false } }

Replace:

📋 Find Your License Key:
Log in to app.promptfence.io → Settings → License

7Assign to Devices/Users

  1. Click Next to go to the Assignments page
  2. Under Included groups, click + Add groups
  3. Select the Azure AD groups to deploy to (e.g., "All Users" or "IT Department")
  4. Click Select
💡 Pilot Deployment: Start with a small test group before deploying organization-wide.

8Review and Create

  1. Click Next through Applicability Rules (leave default)
  2. Review your configuration
  3. Click Create

9Wait for Policy Sync

Intune policies sync automatically:

Alternative: Deploy via Registry (Advanced)

For advanced scenarios, you can deploy registry keys directly using PowerShell scripts in Intune:

# Force install PromptFence extension $RegPath = "HKLM:\Software\Policies\Microsoft\Edge\ExtensionInstallForcelist" New-Item -Path $RegPath -Force | Out-Null Set-ItemProperty -Path $RegPath -Name "1" -Value "EXTENSION_ID;https://clients2.google.com/service/update2/crx" # Configure managed settings $ExtRegPath = "HKLM:\Software\Policies\Microsoft\Edge\3rdparty\extensions\EXTENSION_ID\policy" New-Item -Path $ExtRegPath -Force | Out-Null Set-ItemProperty -Path $ExtRegPath -Name "license_key" -Value "YOUR_LICENSE_KEY" Set-ItemProperty -Path $ExtRegPath -Name "managed_mode" -Value 1

Deploy this via Devices → Scripts → + Add in Intune.

User Experience

What your users will see:

Verification

Confirm successful deployment:

  1. Check Policy Status:
    • Go to Devices → Configuration profiles
    • Click on the PromptFence profile
    • View Device status to see deployment progress
  2. Test on a Device:
    • Have a user open Edge and go to edge://extensions
    • PromptFence should appear with note: "Managed by your organization"
  3. Check Dashboard:
    • Visit app.promptfence.io
    • You should see events from your users as they visit AI platforms

Troubleshooting

Extension not installing?

Extension installed but not activated?

Policy shows error?

Need help?

Contact PromptFence support: [email protected]

✅ Deployment Complete!
Your Windows/macOS fleet is now protected by PromptFence. Monitor activity in your dashboard.

Multi-Browser Support

To deploy to Chrome alongside Edge in your Intune environment:

  1. Create a separate configuration profile for Chrome
  2. Use Settings catalog → Google Chrome instead of Microsoft Edge
  3. Follow the same force-install process with Chrome-specific settings

Or use the Active Directory GPO guide for domain-joined machines.

Next Steps

Back to Deployment Overview