Skip to content

cadeyrn/enterprise-policy-generator

Repository files navigation

Firefox Add-on: Enterprise Policy Generator

Logo

Support the development

Please consider making a donation to support the further development of Enterprise Policy Generator. Thank you very much!

Description

Generates enterprise policies for Firefox.

With Firefox 60, Mozilla introduced enterprise policies. One way to configure Firefox using enterprise policies is through a file named policies.json. The advantage of this file over Group Policy Objects (GPO) is that this method works across Windows, macOS, and Linux.

While this extension is not directly related to CCK2 Wizard, it shares the same idea for enterprise policies in Firefox 60 and later. The Enterprise Policy Generator helps you create the configuration file, without studying all documentation and options in depth.

Enterprise Policy Generator is a WebExtension and compatible with Firefox 60 and later. The latest release requires Firefox 140 or later.

Features

  • Configure Firefox enterprise policies via an intuitive user interface
  • Import existing policies.json files and continue editing supported policies in Enterprise Policy Generator, with an import report when a file cannot be fully converted
  • View generated output with syntax highlighting or fullscreen mode, download it as policies.json, or copy it to the clipboard
  • Save, load, rename, delete, reorder, export, and import generator configurations
  • Get clear confirmation feedback after common actions such as copying, saving, loading, importing, or deleting
  • Search policy names, options, and descriptions, with matching results highlighted
  • Validate fields that require specific values, including URLs, required values
  • Drag and drop for fields and saved configurations that support reordering
  • Get version notices, additional information, links, and security warnings where appropriate
  • Keyboard shortcuts and accessible controls throughout the interface
  • Controls for number fields to increase or decrease values without typing

Keyboard shortcuts

The interface can be accessed via the toolbar button or the keyboard. Use Shift + F10 to open the interface. You can also open the interface via a menu entry in the "Tools" menu.

You can use Shift + F to focus the filter field, and Shift + G to focus the button to generate the policies.

Fields that allow multiple values can be moved using the keyboard: Press Space to pick up an item. Use Arrow Up and Arrow Down to move it. Press Space or Enter to drop. Press Escape to cancel.

Languages

The add-on is currently available in the following languages:

  • English
  • German
  • French (Thanks, Rom and Toinane!)
  • Simplified Chinese (Thanks, fang5566 and yfdyh000!)
  • Russian (Thanks, wvxwxvw and solokot!)
  • Upper Sorbian (Thanks, milupo!)
  • Lower Sorbian (Thanks, milupo!)

Roadmap

You can view the roadmap and request new features in the issues tracker.

Contributing

Contributions are welcome. If you want to add or change Firefox policies, see the policy documentation for details about the structure of src/policies/firefox.json, supported schema types, validations, localization, and tests.

Permissions

Enterprise Policy Generator requires several permissions to work properly.

Mandatory Permissions

No special permissions are required to install and use Enterprise Policy Generator!

Optional Permissions

This permission is not required to install and use Enterprise Policy Generator, but Enterprise Policy Generator will ask you at runtime when the following permission is required:

download files and read and modify the browser's download history

This permission is required to provide the option to download the generated “policies.json” file or to export configurations.

Silent Permissions

Enterprise Policy Generator requires additional permissions, but Firefox does not prompt for the following permissions:

menus

The menus permission is required to provide a menu entry in the "Tools" menu to access Enterprise Policy Generator's user interface.

storage

(since 2.0.0)

The storage permission is required so that you can save and load configurations.

Download

Download Enterprise Policy Generator

Release Notes

Release Notes

About

The Enterprise Policy Generator helps administrators configure Firefox using a configuration file.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Sponsor this project

Contributors