mirror of
https://github.com/fleetdm/fleet
synced 2026-04-21 13:37:30 +00:00
669be3a53c
Summary:
- Enroll hosts page refinement
- Since page was too long and had a lot of content I did following:
- Moved most important sections to the top
- Did some changes to make things more consistent, when possible having
UI and CLI sections with steps (ordered list)
- Moved `Add hosts with plain osquery` to contributor docs, since I
learned this approach is used just by couple of Fleet customers, and we
don't advise this as best practice anymore
- Added overview (table of contents) on the top to make easier to
navigate through the page
- Moved some technical (advanced) topics into separate section on the
bottom of the page
---------
Co-authored-by: Noah Talerman <noahtal@umich.edu>
Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
Co-authored-by: Rachael Shaw <r@rachael.wtf>
48 lines
1.4 KiB
Markdown
48 lines
1.4 KiB
Markdown
# Fleetd Chrome Extension
|
|
|
|
## Packaging the extension
|
|
Generate a .pem file to be the key for the chrome extension.
|
|
|
|
(In parent dir)
|
|
Run the following command to generate an extension.
|
|
|
|
``` sh
|
|
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --pack-extension=./fleetd-chrome --pack-extension-key=path/to/chrome.pem
|
|
```
|
|
|
|
## Adding Chrome to Fleet
|
|
To learn how to package and add hosts to Fleet, visit: https://fleetdm.com/docs/using-fleet/enroll-hosts#enroll-chromebooks.
|
|
|
|
## Debugging
|
|
|
|
### Service worker
|
|
|
|
View service worker logs in chrome://serviceworker-internals/?devtools (in production), or in chrome://extensions (only during development).
|
|
|
|
### Manual Enroll
|
|
|
|
> Steps 1 and 2 can be performed on your workstation. Step 3 and 4 are to be executed on the target Chromebook.
|
|
|
|
1. Create your .env file:
|
|
|
|
> IMPORTANT: The address in `FLEET_URL` must have a valid TLS certificate.
|
|
|
|
```sh
|
|
echo 'FLEET_URL="https://your-fleet-server.example.com"' >> .env
|
|
echo 'FLEET_ENROLL_SECRET="<your enroll secret>"' >> .env
|
|
```
|
|
|
|
To test with your local Fleet server, you can use ngrok:
|
|
```sh
|
|
ngrok http https://localhost:8080
|
|
```
|
|
|
|
2. Build the "unpacked extension":
|
|
```sh
|
|
npm install && npm run build
|
|
```
|
|
The above command will generate an unpacked extension in `./dist`.
|
|
|
|
3. Send the `./dist` folder to the target Chromebook.
|
|
|
|
4. In the target Chromebook, go to `chrome://settings`, toggle `Developer mode` and click on `Load unpacked` and select the `dist` folder.
|