AccessConnector

Configure an Access Connector for proxying web traffic. When this policy is set, Firefox routes traffic through the server given by Host and Port. If MatchPatterns is set, only URLs matching those patterns are routed through the connector.

Values

Host: A string that defines the hostname or IP address of the proxy server to use.
Port: A number defining the port number of the proxy server (e.g., 443).
MatchPatterns: A list of URL match patterns for which traffic should be routed through the Access Connector. If this is not set, all traffic is routed through the connector. See Match patterns for syntax.
Locked: Prevents the user from changing Access Connector settings. Unlike most policies, this defaults to true. Set it to false to apply the settings as defaults that users can still change.

Examples

{
  "policies": {
    "AccessConnector": {
      "Host": "company-hq.company.com",
      "Port": 443
    }
  }
}

{
  "policies": {
    "AccessConnector": {
      "Host": "documents.company.com",
      "Port": 443,
      "MatchPatterns": [
        "/finance*",
        "/hr*"
      ],
      "Locked": true
    }
  }
}

JSON schema

{
  "type": "object",
  "properties": {
    "Host": {
      "type": "string"
    },
    "Port": {
      "type": "number"
    },
    "MatchPatterns": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "Locked": {
      "type": "boolean"
    }
  },
  "required": [
    "Host",
    "Port"
  ]
}

Windows (GPO)

Software\Policies\Mozilla\Firefox\AccessConnector\Host = "proxy.example.com"
Software\Policies\Mozilla\Firefox\AccessConnector\Port = 443
Software\Policies\Mozilla\Firefox\AccessConnector\MatchPatterns\1 = "https://*.example.com"
Software\Policies\Mozilla\Firefox\AccessConnector\Locked = 0x1 | 0x0

macOS

<dict>
  <key>AccessConnector</key>
  <dict>
    <key>Host</key>
    <string>proxy.example.com</string>
    <key>Port</key>
    <integer>443</integer>
    <key>MatchPatterns</key>
    <array>
      <string>https://*.example.com</string>
    </array>
    <key>Locked</key>
    <true/> | <false/>
  </dict>
</dict>

Compatibility

Firefox	Firefox ESR	Firefox Enterprise
Not supported	Not supported	Available since 149

CCK2 Equivalent: N/A
Preferences Affected: browser.ipProtection.autoStartEnabled, browser.ipProtection.enabled, browser.ipProtection.features.autoStart, browser.ipProtection.inclusion.match_patterns, browser.ipProtection.mode, browser.ipProtection.openedPanelWithLocation, browser.ipProtection.override.serverlist