Skip to content

ChromeOS with Google Chrome Enterprise

You can mass deploy the LimaCharlie Sensor for ChromeOS with Google Workspace and Google Chrome Enterprise.

Configuration

  1. Log into Google Workspace Admin and go to Devices -> Chrome -> Apps & extensions -> Users & Browsers.
  2. In the Users & browsers tab click the "+" button in the bottom right, then choose the option to "Add from Chrome Web Store".
  3. Search for the LimaCharlie Sensor extension and click Select.
  4. Click on the LimaCharlie Sensor app to show the installation policy.
  5. Set the "Installation Policy" to "Force install".
  6. Set the "Policy for extensions" value as follows:
{
    "installation_key": {
        "Value": "\"KEY\""
    }
}

IMPORTANT: Replace the text "KEY" with the actual value of your Installation Key, in particular the Chrome Key which you can obtain from within the LimaCharlie web app.

Example App_Management_-_Admin_Console.png

Policy File Example

On Chrome or Chromium without Google Workspace, you can set the same policy in a managed policy file, such as /etc/opt/chrome/policies/managed/limacharlie.json for Chrome on Linux or /etc/chromium/policies/managed/limacharlie.json for Chromium. A complete file looks like this:

{
    "ExtensionInstallForcelist": [
        "ljdgkaegafdgakkjekimaehhneieecki;https://clients2.google.com/service/update2/crx"
    ],
    "3rdparty": {
        "extensions": {
            "ljdgkaegafdgakkjekimaehhneieecki": {
                "installation_key": "\"KEY\""
            }
        }
    }
}

The installation_key value must be the key wrapped in escaped quotes, exactly as shown. The extension parses the value as JSON. If you set the bare key ("KEY"), the extension still installs but never enrolls, and its service worker console logs SyntaxError: ... is not valid JSON every 30 seconds. If you generate the file with a script, encode the key as a JSON string first, for example json.dumps(key) in Python.

A key typed into the extension's options page is used as-is and does not need the extra quotes.

Verifying Configuration

ChromeOS endpoints should now start appearing within the related LimaCharlie Organization's sensor list.

You can verify that the configuration was completed successfully by verifying on an individual endpoint.

  1. Confirm that the LimaCharlie Sensor extension appears in the list of extensions.
  2. Verify that the installation key got applied on the endpoint by going to: chrome://policy and look for the LimaCharlie Sensor. There you should see the Policy name set to installation_key and the Policy Value set with your installation key. The Source should list "Cloud".

endpoint.png