ExtensionSettings

Extension management settings

Supported on:

  • Chrome (Windows) since version 62

Description:

Setting the policy controls extension management settings for Samsung Browser, including any controlled by existing extension-related policies.

This policy maps an extension ID or an update URL to its specific setting only. A default configuration can be set for the special ID "*", which applies to all extensions without a custom configuration in this policy.

This policy can override per-extension config from legacy policies.

Note that any per-ID extension setting from either ExtensionInstallForcelist, ExtensionInstallAllowlist, ExtensionInstallBlocklist, or ExtensionSettings will only inherit 'installation_mode' and 'update_url' from the "*" defaults. It will not inherit any other properties. With an update URL, configuration applies to extensions with the exact update URL stated in the extension manifest. If the 'override_update_url' flag is set to true, the extension is installed and updated using the "update" URL specified in the ExtensionInstallForcelist policy or in 'update_url' field in this policy. The flag 'override_update_url' is ignored if the 'update_url' is a Chrome Web Store url.

On Microsoft® Windows® instances, apps and extensions from outside the Chrome Web Store can only be forced installed if the instance is joined to a Microsoft® Active Directory® domain, joined to Microsoft® Azure® Active Directory® or enrolled in Samsung Browser.

Note: This policy only applies to platforms that support extensions.

Supported features:

  • Applied to browser without restart. Note that some ongoing tasks may not be affected.
  • Applied at Samsung Browser profile level.

Data type:

Dictionary
Windows:REG_SZ

Windows registry location:

Software\Policies\Samsung\Internet\ExtensionSettings

Schema:

{
  "patternProperties": {
    "^[a-p]{32}(?:,[a-p]{32})*,?$": {
      "properties": {
        "allowed_permissions": {
          "id": "ListOfPermissions",
          "items": {
            "pattern": "^[a-z][a-zA-Z0-9._]*$",
            "type": "string"
          },
          "type": "array"
        },
        "blocked_install_message": {
          "description": "text that will be displayed to the user in the chrome webstore if installation is blocked.",
          "type": "string"
        },
        "blocked_permissions": {
          "items": {
            "pattern": "^[a-z][a-zA-Z0-9._]*$",
            "type": "string"
          },
          "type": "array"
        },
        "file_url_navigation_allowed": {
          "type": "boolean"
        },
        "installation_mode": {
          "enum": [
            "blocked",
            "allowed",
            "force_installed",
            "normal_installed",
            "removed"
          ],
          "type": "string"
        },
        "minimum_version_required": {
          "pattern": "^[0-9]+([.][0-9]+)*$",
          "type": "string"
        },
        "override_update_url": {
          "type": "boolean"
        },
        "runtime_allowed_hosts": {
          "id": "ListOfUrlPatterns",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "runtime_blocked_hosts": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "toolbar_pin": {
          "enum": [
            "force_pinned",
            "default_unpinned",
            "default_pinned"
          ],
          "type": "string"
        },
        "update_url": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "^update_url:": {
      "properties": {
        "allowed_permissions": {
          "items": {
            "pattern": "^[a-z][a-zA-Z0-9._]*$",
            "type": "string"
          },
          "type": "array"
        },
        "blocked_permissions": {
          "items": {
            "pattern": "^[a-z][a-zA-Z0-9._]*$",
            "type": "string"
          },
          "type": "array"
        },
        "installation_mode": {
          "enum": [
            "blocked",
            "allowed",
            "removed"
          ],
          "type": "string"
        }
      },
      "type": "object"
    }
  },
  "properties": {
    "*": {
      "properties": {
        "allowed_types": {
          "items": {
            "enum": [
              "extension",
              "theme",
              "user_script",
              "hosted_app",
              "legacy_packaged_app",
              "platform_app"
            ],
            "type": "string"
          },
          "type": "array"
        },
        "blocked_install_message": {
          "type": "string"
        },
        "blocked_permissions": {
          "items": {
            "pattern": "^[a-z][a-zA-Z0-9._]*$",
            "type": "string"
          },
          "type": "array"
        },
        "install_sources": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "installation_mode": {
          "enum": [
            "blocked",
            "allowed",
            "removed"
          ],
          "type": "string"
        },
        "runtime_allowed_hosts": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "runtime_blocked_hosts": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "type": "object"
    }
  },
  "type": "object"
}

Schema documentation: https://www.chromium.org/administrators/policy-list-3/extension-settings-full

Example value:

{
  "*": {
    "allowed_types": [
      "hosted_app"
    ],
    "blocked_install_message": "Custom error message.",
    "blocked_permissions": [
      "downloads",
      "bookmarks"
    ],
    "install_sources": [
      "https://company-intranet/chromeapps"
    ],
    "installation_mode": "blocked",
    "runtime_allowed_hosts": [
      "*://good.example.com"
    ],
    "runtime_blocked_hosts": [
      "*://*.example.com"
    ]
  },
  "abcdefghijklmnopabcdefghijklmnop": {
    "blocked_permissions": [
      "history"
    ],
    "installation_mode": "allowed",
    "minimum_version_required": "1.0.1",
    "toolbar_pin": "force_pinned",
    "file_url_navigation_allowed": true
  },
  "bcdefghijklmnopabcdefghijklmnopa": {
    "allowed_permissions": [
      "downloads"
    ],
    "installation_mode": "force_installed",
    "runtime_allowed_hosts": [
      "*://good.example.com"
    ],
    "runtime_blocked_hosts": [
      "*://*.example.com"
    ],
    "update_url": "https://example.com/update_url"
  },
  "cdefghijklmnopabcdefghijklmnopab": {
    "blocked_install_message": "Custom error message.",
    "installation_mode": "blocked"
  },
  "defghijklmnopabcdefghijklmnopabc,efghijklmnopabcdefghijklmnopabcd": {
    "blocked_install_message": "Custom error message.",
    "installation_mode": "blocked"
  },
  "fghijklmnopabcdefghijklmnopabcde": {
    "blocked_install_message": "Custom removal message.",
    "installation_mode": "removed"
  },
  "ghijklmnopabcdefghijklmnopabcdef": {
    "installation_mode": "force_installed",
    "override_update_url": true,
    "update_url": "https://example.com/update_url"
  },
  "update_url:https://www.example.com/update.xml": {
    "allowed_permissions": [
      "downloads"
    ],
    "blocked_permissions": [
      "wallpaper"
    ],
    "installation_mode": "allowed"
  }
}

More policies under Extensions: