Setting Up System Policies - Foulest/Osprey GitHub Wiki

If you're installing Osprey on a locked-down computer and want to disable certain settings or features, here's how:

Chrome

Windows (Registry Editor)

  1. Open chrome://extensions, turn on Developer mode, and copy Osprey's extension ID.
  2. Open the Registry Editor and navigate to HKLM\SOFTWARE\Policies\Google\Chrome\3rdParty\Extensions\<extensionID>\policy. Make sure to replace the ` field with the ID you copied in the previous step. If this key doesn't exist, which it likely doesn't, you need to create it manually.
  3. Right-click the background and click New > and then DWORD (32-bit Value). Input the name of the key you want to add. The available keys and their descriptions can be found in the policies.json file.
  4. If the key is a boolean, setting the Value data to 0 means false, and 1 means true. If the key is an integer, set the Value data to your desired number and make sure to change the Base to Decimal.
  5. Reload Osprey in chrome://extensions to apply your changes.

Windows (Group Policy)

...

Mac

...

Linux

...

Edge

Windows (Registry Editor)

  1. Open edge://extensions, turn on Developer mode, and copy Osprey's extension ID.
  2. Open the Registry Editor and navigate to HKLM\SOFTWARE\Policies\Microsoft\Edge\3rdParty\Extensions\<extensionID>\policy. Make sure to replace the ` field with the ID you copied in the previous step. If this key doesn't exist, which it likely doesn't, you need to create it manually.
  3. Right-click the background and click New > and then DWORD (32-bit Value). Input the name of the key you want to add. The available keys and their descriptions can be found in the policies.json file.
  4. If the key is a boolean, setting the Value data to 0 means false, and 1 means true. If the key is an integer, set the Value data to your desired number and make sure to change the Base to Decimal.
  5. Reload Osprey in chrome://extensions to apply your changes.

Windows (Group Policy)

...

Mac

...

Linux

...

Firefox

Windows (Group Policy)

...

Windows (policies.json)

Note: This method will not work if Firefox is already being managed using Group Policy.

  1. Navigate to the directory where Firefox is installed in your File Explorer.
  2. Create a folder named distribution if it doesn't already exist.
  3. Create a text file titled policies.json and place it into the distribution folder.
  4. Modify the template below to your liking, and save the file. Ensure that you validate it using https://jsonlint.com.
{
  "policies": {
    "3rdparty": {
      "Extensions": {
        "[email protected]": {
          "adminSettings": {
            "DisableNotifications": true/false,
            "DisableContextMenu": true/false,
            "HideContinueButtons": true/false,
            "HideReportButton": true/false,
            "LockProtectionOptions": true/false,
            "DisableClearAllowedSites": true/false,
            "IgnoreFrameNavigation": true/false,
            "CacheExpirationSeconds": 60 - 2592000 (default is 86400)
          }
        }
      }
    }
  }
}

Mac (policies.json)

  1. Navigate to the Firefox.app/Contents/Resources directory.
  2. Create a folder named distribution if it doesn't already exist.
  3. Create a text file titled policies.json and place it into the distribution folder.

TODO: Finish and validate this on a Mac installation.

Linux (policies.json)

  1. Navigate to the directory where Firefox is installed in your File Explorer.
  2. Create a folder named distribution if it doesn't already exist.
  3. Create a text file titled policies.json and place it into the distribution folder.

TODO: Finish and validate this on a Linux installation.