Commit graph

1625 commits

Author SHA1 Message Date
Dave Herder
b50cbef42c
Update FAQ.md - remove Software Inventory instructions (#14153) 2023-09-27 15:47:57 -07:00
Mo Zhu
9d2c3f0870
Update Reference-Architectures.md (#14039)
Purpose of this change:
- Right now we don't have a guide for deploying on Azure. We want to
prompt people to ask for it by linking them to the Slack. That is a way
that we can kick off the process of writing a formal document.
2023-09-27 08:19:31 -07:00
Mo Zhu
f65d574955
state that CIS benchmark policy is tagged as level 1 and level 2 (#14156) 2023-09-26 16:12:32 -07:00
Rachael Shaw
9190975ada
Document behavior for hosts/report endpoint when filtered by policy_id but not policy_response (#14127)
Documents behavior reported in
https://github.com/fleetdm/fleet/issues/13998
2023-09-26 16:46:38 -05:00
Isabell Reedy
14d0df0f85
Specify that enroll secrets should be alphanumeric (#14030) 2023-09-26 14:38:35 -04:00
George Karr
68ac65f461
Add example errors to api docs for login (#13941) 2023-09-26 10:33:35 -05:00
Lucas Manuel Rodriguez
de4d76d09b
Documentation changes for #13926 (#14060)
Documentation changes for #13926.

---------

Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-09-26 11:49:45 -03:00
Lucas Manuel Rodriguez
2f0d0eb197
Documentation changes for #13287 (#14059)
Documentation changes for #13287.

---------

Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-09-26 11:49:30 -03:00
Isabell Reedy
81c3584bf4
Docs - mandate FileVault activation upon set-up (#13929) 2023-09-26 10:14:07 -04:00
Mo Zhu
9cce5ffd7f
2023-09-25 Update macOS supported version to match MDM (#14025) 2023-09-25 21:43:53 -05:00
Isabell Reedy
9ec5aae288
Docs - Add bytes option for Windows MDM config (#13933) 2023-09-25 17:22:52 -04:00
Luke Heath
1e1e28791f
Document milestone release ritual (#13932) 2023-09-25 14:35:36 -05:00
Jacob Shandling
5f2b83c5e6
Add documentation for using --local-wix-dir (#14070) 2023-09-25 11:05:11 -07:00
Mo Zhu
83810fb85c
Link to scalability testing for CIS benchmarks (#13799)
Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-09-25 10:59:09 -07:00
Mo Zhu
3cf57dfd3b
Document that fleet tested FLEET_OSQUERY_ENABLE_ASYNC_HOST_PROCESSING… (#13966)
Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-09-25 10:46:36 -07:00
Mo Zhu
56d4380ba6
State that latest version of osquery is supported (#13982)
.  ...
2023-09-25 10:34:42 -07:00
Mo Zhu
85082d7976
Remove version support from Fleet Desktop, consolidate version support (#14093)
Single place where host OS version support is listed: 


https://fleetdm.com/docs/using-fleet/supported-host-operating-systems#supported-host-operating-systems

..

Co-authored-by: Mike McNeil <mikermcneil@users.noreply.github.com>
2023-09-23 00:27:33 -05:00
Roberto Dip
e18b6bd52b
add missing docs for org_info (#13972)
As the title says, this adds missing docs for a feature we shipped a
while ago.

---------

Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-09-22 19:15:37 -03:00
Eric
1b25187453
Docs: add syntax highlighting keywords to code blocks (#13963)
Closes: #13691

Changes: 
- Added keywords for syntax highlighting to code blocks in documentation
Markdown files.

---------

Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
2023-09-22 16:57:40 -05:00
Rachael Shaw
433212dfed
Docs: Add vulnerability description to software api 2023-09-22 14:07:31 -06:00
Roberto Dip
c508209e11
document migration webhooks (#13900)
This documents a few migration webhooks we have built, so I'm not the
only person that can run them.
2023-09-18 19:39:00 -03:00
Mo Zhu
5e531d011b
Update Supported-host-operating-systems.md (#13944) 2023-09-18 11:49:57 -07:00
Mo Zhu
e0eed5fde9
State that Chrome installation is only for root groups, not sub-groups (#13764) 2023-09-18 11:40:10 -07:00
Tim Lee
5bc6d30aa8
Add Description text to CVE Metadata (#13856) 2023-09-15 11:24:10 -06:00
Isabell Reedy
35d233eee2
Docs - Automatically set enroll secret for team created via fleetctl apply (#13928) 2023-09-15 10:56:18 -04:00
Noah Talerman
93424e08c5
Tweak scripts docs (#13937)
- Tweak verbiage to make the docs look better.
2023-09-15 09:44:13 -04:00
Tim Lee
e80ea50240
Flock vulnerability false positive (#13827) 2023-09-14 10:38:36 -06:00
Noah Talerman
25af472c91
Fix rendering in MDM docs (#13920)
- Fix strange rendering in MDM docs
2023-09-14 09:43:33 -04:00
Mike Thomas
7a4737e459
migrate remaining docs pages (#13740)
Migrated remaining docs pages as part of the July 31st docs re-org
project. (See https://github.com/fleetdm/fleet/issues/13684)

Changes:

- Removed "Commands" section from fleet-server-configuration.md
- Moved systemd, using a proxy, SSO, and public IP content to the
"Deploy" docs and added stubs in the original file to preserve
bookmarked links.
- Changed the headings of the original stubs in the point above to be
wrapped in an HTML H2 tag to hide them from the "On this page
navigation."
- Updated left side-bar styling to match wireframes.

# Checklist for submitter
- [x] Manual QA for all new/changed functionality

---------

Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-09-13 16:06:35 -07:00
Katheryn Satterlee
c671143c97
Add docs for experimental feature (#13534)
Added documentation for experimental Orbit feature to silence errors
related to enrollment for #13071

# Checklist for submitter

Docs-only change

---------

Co-authored-by: Luke Heath <luke@fleetdm.com>
Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-09-13 16:21:13 -05:00
Rachael Shaw
066f4c95d7
Docs: Fix title (#13917)
Sentence-case fix
2023-09-13 15:57:30 -05:00
Noah Talerman
c481d67abb
Add docs for Fleet's Puppet module (#13837)
- Add doc page to explain setup and usage of Fleet's Puppet module
2023-09-13 16:39:41 -04:00
Roberto Dip
ea6b59f179
upgrade Go version to 1.21.1 (#13877)
For #13715, this:

- Upgrades the Go version to `1.21.1`, infrastructure changes are
addressed separately at https://github.com/fleetdm/fleet/pull/13878
- Upgrades the linter version, as the current version doesn't work well
after the Go upgrade
- Fixes new linting errors (we now get errors for memory aliasing in
loops! 🎉 )

After this is merged people will need to:

1. Update their Go version. I use `gvm` and I did it like:

```
$ gvm install go1.21.1
$ gvm use go1.21.1 --default
```

2. Update the local version of `golangci-lint`:

```
$ go install github.com/golangci/golangci-lint/cmd/golangci-lint@v1.54.2
```

3. (optional) depending on your setup, you might need to re-install some
packages, for example:

```
# goimports to automatically import libraries
$  go install golang.org/x/tools/cmd/goimports@latest

# gopls for the language server
$ go install golang.org/x/tools/gopls@latest

# etc...
```
2023-09-13 15:59:35 -03:00
George Karr
845bd6eef1
Update FAQ.md fix typo (#13828)
there is no `--osquery-channel` it's `--osqueryd-channel`
2023-09-13 12:50:51 -05:00
Dave Herder
38c31d536d
Update FAQ.md (#13713)
Added documentation about using fleetctl with context and mdm commands

---------

Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-09-12 15:35:35 -07:00
Noah Talerman
8600c8fe14
Add docs for script execution (#13807)
- Add doc page for run a script via CLI story (#9583).
2023-09-12 18:31:04 -04:00
Noah Talerman
6026130a8e
Update API docs: add get host by device token (#13761)
- Add get host by device token
- Remove this API route from the contributor docs
2023-09-12 17:13:09 -04:00
Noah Talerman
3dd85c6a6d
MDM docs: MDM commands (#13745)
- Add "NotNow" MDM status
2023-09-08 09:44:03 -04:00
Martin Angers
55148df9db
Update docs for the patch /config behavior of integrations (#13758)
Companion docs-only PR for https://github.com/fleetdm/fleet/pull/13743
2023-09-06 16:09:57 -04:00
Dave Herder
2edc04d60a
Update MDM-macOS-setup.md (#13513)
added clarification on SSO settings for EU Auth (MDM)

---------

Co-authored-by: Noah Talerman <noahtal@umich.edu>
Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-09-06 10:45:11 -07:00
Roberto Dip
3e61342e73
add docs for scripts results API (#13720)
sibling PR https://github.com/fleetdm/fleet/pull/13701

---------

Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-09-06 11:47:25 -03:00
Roberto Dip
541cc638e4
Add an activity log when an script execution is requested (#13655)
For #9553
2023-09-05 20:09:29 -03:00
Tim Lee
055f8847fd
Fix policies api doc (#13721) 2023-09-05 15:37:43 -06:00
Martin Angers
d2f8e16d7e
Add documentation for env var preventing orbit from deleting the script directory (#13602) 2023-09-05 08:53:51 -04:00
Mike Thomas
bca456eba4
migrate agent options docs content to agent configuration page (#13562)
See https://github.com/fleetdm/fleet/issues/13561 for context.

Changes:

- Created new docs page `agent-configuration.md` and migrated `agent
options` content from
https://fleetdm.com/docs/configuration/configuration-files#agent-options
- Added stub linking to the new page in the original agent options
location.
- Moved content "Update agent options" out of
[fleet-ui.md](https://fleetdm.com/docs/using-fleet/fleet-ui)
- ~Renamed `fleet-ui.md` to `queries.md` to reflect its content and set
up a redirect `'GET /docs/using-fleet/fleet-ui':
'/docs/using-fleet/queries',`~
- ~Added and updated `NavSection` and `pageOrderInSection` meta tags to
reflect new navigation structure.~
- Updated
[docs/Configuration/README.md](https://github.com/fleetdm/fleet/compare/docs-migrate-agent-options-to-agent-configuration-page?expand=1#diff-acd0a2b368992abbb3fd7b55a7a159ad824706e27e24aebed50a2d48e87b5ae2)
to include a link and description for the new agent-configuration page.

---------

Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-09-04 10:00:59 +09:00
Rachael Shaw
d7586a5742
Docs: Update deployment guide title (#13621)
Update page title for Cloud.gov deployment guide to match the other
deployment guides.
2023-08-31 10:52:06 -05:00
Rachael Shaw
7d0a85bd0a
Docs: Rename "Deploy Fleet on Cloud.gov" page in nav (#13619)
Rename "Deploy Fleet on Cloud.gov" to "Cloud.gov" to match updated names
for other deployment guides:
![Screenshot 2023-08-31 at 10 22 27
AM](https://github.com/fleetdm/fleet/assets/3065949/50e7e1a2-c439-46bc-a8f8-74a3a71e016b)
2023-08-31 10:23:06 -05:00
Mike Thomas
4e1218ba42
Migrate Deploy Fleet on Render to docs. (#13017)
Migrated the "Deploy Fleet on Render" guide to the docs.

- Moved content from `/articles/deploying-fleet-on-render.md` to
`/docs/deploy-on-render.md`
- Removed `/articles/deploy-fleet-on-render.md`
- moved images from the guide to `/docs/images` and renamed
- deleted redundant article cover image
- set up redirect in `routes.js` `/deploy/deploying-fleet-on-render` =>
`/docs/deploy/deploy-on-render`

# Checklist for submitter

- [x] Manual QA for all new/changed functionality

---------

Co-authored-by: Eric <eashaw@sailsjs.com>
Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-08-31 10:15:52 -05:00
Martin Angers
cbc3f32e9d
Adjust response payload, messages and validations for /scripts/run/* endpoints. (#13607) 2023-08-31 09:08:50 -05:00
Noah Talerman
6637ea6517
MDM docs: disk encryption (FileVault) (#13609)
- Update statuses to match updates we made to the UI (double check disk
encryption)
2023-08-31 09:23:22 -04:00
Mike Thomas
458dcfd366
Migrate Deploy Fleet on Hetzner Cloud (#13021)
This is the last of three PRs to migrate the deployment guides into the
docs.

Changes:

- Moved content from `/articles/deploying-fleet-on-hetzner-cloud.md` to
`/docs/deploy-on-hetzner-cloud.md`.
- Removed `/articles/deploy-fleet-on-hetzner-cloud.md`.
- Moved images from the guide to `/docs/images` and renamed.
- Deleted redundant images and article cover image.
- Set up a redirect `/deploy/deploying-fleet-on-hetzner-cloud` =>
`/docs/deploy/deploy-on-hetzner-cloud`.
- Set up a redirect `/deploy` => `/docs/deploy` to redirect "Deployment
guides" in the main nav to the docs.
- Updated display names (in the docs nav) for existing deployment guides
in the docs to match the naming convention (E.g., "Deploy Fleet on
CentOS" => "CentOS")
- Removed the deployment guides article category from the blog.

# Checklist for submitter

- [ ] Manual QA for all new/changed functionality

---------

Co-authored-by: Eric <eashaw@sailsjs.com>
Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-08-30 19:17:22 -05:00
Mike Thomas
79512076ae
Migrate Deploy Fleet on AWS to docs (#13020)
Migrated the "Deploy Fleet on AWS with Terraform" guide to the docs.

- Moved content from
`/articles/deploying-fleet-on-aws-with-terraform.md` to
`/docs/deploy-on-aws.md`.
- Removed `/articles/deploy-fleet-on-aws-with-terraform.md`.
- Moved images from the guide to `/docs/images` and renamed.
- Deleted redundant image and article cover image.
- Set up a redirect in `routes.js`
`/deploy/deploying-fleet-on-aws-with-terraform` =>
`/docs/deploy/deploy-on-aws`.

# Checklist for submitter

- [ ] Manual QA for all new/changed functionality

---------

Co-authored-by: Eric <eashaw@sailsjs.com>
Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-08-30 19:11:19 -05:00
Rachael Shaw
34474b2e1d
Docs: Move parameters tables for count policies REST API docs (#13610)
Moved "Parameters" section above "Example" for consistent order across
the page
2023-08-30 17:35:26 -05:00
Tim Lee
222b8f9f5c
paginate the policies API (#13459) 2023-08-30 16:30:17 -06:00
Roberto Dip
e6dbdf3855
document script execution flags (#13577)
docs for https://github.com/fleetdm/fleet/issues/13304 and it's sibling
PR: https://github.com/fleetdm/fleet/pull/13564
2023-08-30 10:34:45 -03:00
Sabrina Coy
9fe298700f
Update rest-api.md (#13545)
Removed superfluous "an" from line 3926.
2023-08-28 15:38:23 -04:00
Andrew Baker
ba25c5ef43
Update FAQ.md (#13529)
# Checklist for submitter

If some of the following don't apply, delete the relevant line.

- [ ] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- [ ] Documented any API changes (docs/Using-Fleet/REST-API.md or
docs/Contributing/API-for-contributors.md)
- [ ] Documented any permissions changes (docs/Using
Fleet/manage-access.md)
- [ ] Input data is properly validated, `SELECT *` is avoided, SQL
injection is prevented (using placeholders for values in statements)
- [ ] Added support on fleet's osquery simulator `cmd/osquery-perf` for
new osquery data ingestion features.
- [ ] Added/updated tests
- [ ] Manual QA for all new/changed functionality
  - For Orbit and Fleet Desktop changes:
- [ ] Manual QA must be performed in the three main OSs, macOS, Windows
and Linux.
- [ ] Auto-update manual QA, from released version of component to new
version (see [tools/tuf/test](../tools/tuf/test/README.md)).
2023-08-25 17:37:49 -04:00
Mo Zhu
479976460b
Clarify error logs will appear when not setting --fleet-url or --enroll-secret flags (#13500)
Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-08-25 10:04:28 -07:00
Roberto Dip
71c06f69f0
add links to RFC spec in docs (#13506) 2023-08-25 13:17:18 -03:00
Roberto Dip
4be557bb57
allow padded strings in mdm/apple/enqueue endpoint (#13502)
for #11384
2023-08-24 15:17:05 -03:00
Roberto Dip
5c7019cfc4
allow clients to report errors back to the server (#13478)
for #13189, #13238 and #13239
2023-08-24 13:04:27 -03:00
Martin Angers
4045116fac
Add orbit notification and API endpoints to send/receive scripts to hosts (part 2 of ticket) (#13447) 2023-08-23 16:47:47 -04:00
TomOstertag
699701a2db
Added note about Fleet’s webhook notifications about failing policies (#13207)
Added note to clairify the default policy time intervals for the Fleet
product, and help end-users configure a more personalized experience
with Fleet.

@Sampfluger88 @mikermcneil
2023-08-23 12:25:47 -05:00
Isabell Reedy
9d99b7fb05
Documentation: Modifying built-in labels with fleetctl or REST API (#13302)
Documenting closed bug: modifying built-in labels with fleetctl or REST
API causes UI errors (#12479)
2023-08-22 20:47:56 -07:00
Marko Lisica
5f9a7df518
Update manage-access.md (#13426)
Updated table rows related to MDM commands permission. Right now there
are just calling out macOS hosts and we're implementing MDM commands for
Windows. Additionally, there was a duplicate row in the table which I
removed.

# Checklist for submitter

If some of the following don't apply, delete the relevant line.

- [ ] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- [ ] Documented any API changes (docs/Using-Fleet/REST-API.md or
docs/Contributing/API-for-contributors.md)
- [ ] Documented any permissions changes
- [ ] Input data is properly validated, `SELECT *` is avoided, SQL
injection is prevented (using placeholders for values in statements)
- [ ] Added support on fleet's osquery simulator `cmd/osquery-perf` for
new osquery data ingestion features.
- [ ] Added/updated tests
- [ ] Manual QA for all new/changed functionality
  - For Orbit and Fleet Desktop changes:
- [ ] Manual QA must be performed in the three main OSs, macOS, Windows
and Linux.
- [ ] Auto-update manual QA, from released version of component to new
version (see [tools/tuf/test](../tools/tuf/test/README.md)).
2023-08-22 12:55:14 +02:00
Mo Zhu
cc14de012d
4.35 upgrade notes (#13392)
Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-08-21 13:30:56 -07:00
Martin Angers
de32faefdb
Add /scripts/run and scripts/run/sync API endpoints to run scripts (part 1) (#13417) 2023-08-21 14:47:19 -04:00
Eric
ba6dc0b524
Docs: Update tutorials and guides page (#13379)
Closes: #13126
2023-08-18 14:04:33 -05:00
Noah Talerman
6ea5455078
MDM docs: fix bug (#13370)
- Correct statuses for macOS settings
2023-08-18 13:39:52 -04:00
Eric
5c4f38d28a
Docs: Split server installation page into multiple deployment guides (#13321)
Related to #12627 

Changes:
- Removed the `docs/deploy/server-installation` page and moved the
content into three deployment guides.
- Updated links to the server installation page
- Renamed the Cloud.gov page ("Cloud.gov" » "Deploy Fleet on Cloud.gov")
2023-08-16 17:26:27 -05:00
Noah Talerman
a36cb76733
MDM docs: Add end user migration workflow (#13261)
- Add instructions for setting up end user migration workflow
- Break out a separate section to default migration workflow for
automatically enrolled (DEP hosts)
- Break out separate end user instructions for manually enrolled hosts,
automatically enrolled hosts - default migration workflow, and
automatically enrolled hosts - end user migration workflow.
2023-08-15 22:32:46 -04:00
Rachael Shaw
c5ce89f546
Docs: Update FAQ section about the "Packs" UI (#13194)
Update FAQ answer to better align with [more recent content about
packs](https://fleetdm.com/handbook/company/why-this-way#why-does-fleet-support-query-packs).
2023-08-09 11:57:00 -07:00
Martin Angers
37ba43d404
Add fleetctl upgrade-packs command to migrate 2017 packs to queries (#13078) 2023-08-08 08:21:57 -04:00
Noah Talerman
c18d04b5e0
MDM docs: typo (#13159)
Fix typo
2023-08-04 17:17:13 -04:00
RachelElysia
21961397f6
Fleet Documentation: Clarify SCEP docs (#13141) 2023-08-04 16:22:41 -04:00
Noah Talerman
06319f7453
MDM docs: End user auth (#13130)
- Add instructions for how to enable end user auth during automatic
enrollment for Macs
- Add instructions for how to add bootstrap package via UI
2023-08-04 15:44:14 -04:00
RachelElysia
b64f1b0d7a
Fleet Documentation: Remove docs about cgroups (#13143) 2023-08-04 14:40:29 -04:00
Eric
3a9d80b6a3
Docs: Update content on tutorials and guides documentation page (#13131)
Changes:
- Added links to guides to the tutorials and guides page.
2023-08-03 16:57:59 -05:00
RachelElysia
799792584a
MDM Docs: Update docs to include scep challenge and clarify environment variable naming (#13112)
---------

Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-08-03 12:42:09 -04:00
Gabriel Hernandez
926bdd30af
doc updates for oncall and mdm migration light/dark logo feature (#12964)
quick doc change to oncall and product feature mdm migration light/dark
logos

---------

Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-08-03 10:38:41 +01:00
Mo Zhu
f4bf8ba8bf
Format markdown to be a bulleted list. (#13097) 2023-08-02 17:00:43 -07:00
Mo Zhu
0098baa4cc
confirm that some packages may not have installed paths because we're… (#13105)
https://fleetdm.slack.com/archives/C01EZVBHFHU/p1689371170727919
2023-08-02 16:35:37 -07:00
Mo Zhu
43f5fc1c97
Describe 4.35 migration in deployment FAQs (#12971)
Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-08-01 13:36:07 -07:00
Eric
ee4ce28c02
Docs: Update documentation to reflect scheduled query changes. (#12884) 2023-07-31 16:06:07 -07:00
Mo Zhu
388d6511db
Updated REST API docs to reflect combined schedule and queries (#11742)
Co-authored-by: Rachael Shaw <r@rachael.wtf>
Co-authored-by: Lucas Rodriguez <lucas@fleetdm.com>
2023-07-31 16:05:16 -07:00
Dave Herder
d0caf81bca
Update API-for-contributors.md (#13027)
Updated the name options for the trigger endpoint
2023-07-28 14:18:45 -04:00
Eric
8fb22579ea
Reorganize Fleet documentation (#12871)
Closes: #12611

Changes:
- Added three new documentation sections `/docs/get-started/`,
`/docs/configuration` and `/docs/rest api/`
- Updated folder names: `/docs/Using-Fleet/` » `/docs/Using Fleet` and
`/docs/deploying` » `/docs/deploy/`
- Moved `/docs/using-fleet/process-events.md` to `/articles` and updated
the meta tags to change it into a guide.
- Added support for a new meta tag: `navSection`. This meta tag is used
to organize pages in the sidebar navigation on fleetdm.com/docs
- Moved `docs/using-fleet/application-security.md` and
`docs/using-fleet/security-audits.md` to the security handbook.
- Moved `docs/deploying/load-testing.md` and
`docs/deploying/debugging.md` to the engineering handbook.
- Moved the following files/folders:
- `docs/using-fleet/configuration-files/` »
`docs/configuration/configuration-files/`
- `docs/deploying/configuration.md` »
`docs/configuration/fleet-server-configuration.md`
    -  `docs/using-fleet/rest-api.md` » `docs/rest-api/rest-api.md`
- `docs/using-fleet/monitoring-fleet.md` » `docs/deploy/rest-api.md`
- Updated filenames:
- `docs/using-fleet/permissions.md` »
`docs/using-fleet/manage-access.md`
- `docs/using-fleet/adding-hosts.md` »
`docs/using-fleet/enroll-hosts.md`
    -  `docs/using-fleet/teams.md` » `docs/using-fleet/segment-hosts.md`
- `docs/using-fleet/fleet-ctl-agent-updates.md` »
`docs/using-fleet/update-agents.md`
- `docs/using-fleet/chromeos.md` »
`docs/using-fleet/enroll-chromebooks.md`
- Updated the generated markdown in `server/fleet/gen_activity_doc.go`
and `server/service/osquery_utils/gen_queries_doc.go`
- Updated the navigation sidebar and mobile dropdown links on docs pages
to group pages by their `navSection` meta tag.
- Updated fleetdm.com/docs not to show pages in the `docs/contributing/`
folder in the sidebar navigation
- Added redirects for docs pages that have moved.

.

---------

Co-authored-by: Mike Thomas <mthomas@fleetdm.com>
Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-07-27 17:40:01 -05:00
gillespi314
09e6bf9807
Update detail query ingestion and UI related to Windows MDM status (#12960) 2023-07-26 17:35:55 -05:00
Mo Zhu
8a2f44bc81
Close meta tag on "deploying fleet" > "FAQ" page (#12970) 2023-07-26 11:32:31 -05:00
Roberto Dip
02f70eb528
add instructions to develop and test the Puppet module (#12945) 2023-07-26 10:23:03 -03:00
Mo Zhu
90c0e28650
Update Fleet Desktop support (#12830)
Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-07-25 11:44:57 -04:00
Eric
fa1f4e96fe
Docs: Replace Orbit with Fleetd (#12443)
Changes:
- Replaced Orbit with Fleetd throughout Fleet's documentation
- Changed the name of three pages: `orbit.md` » `fleetd.md`,
`orbit-development-and-release-strategy.md` »
`fleetd-development-and-release-strategy.md`, and
`Run-Locally-Built-Orbit.md` » `Run-Locally-Built-Fleetd.md`
- Updated links to pages with changed names.
- Added redirects for pages with changed names

---------

Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-07-21 19:33:31 -05:00
Jarod Reyes
8477003a9e
Update Server-Installation.md (#12365)
Install instructions for vagrant.

# Checklist for submitter

If some of the following don't apply, delete the relevant line.

- [ ] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- [ ] Documented any API changes (docs/Using-Fleet/REST-API.md or
docs/Contributing/API-for-contributors.md)
- [ ] Documented any permissions changes
- [ ] Input data is properly validated, `SELECT *` is avoided, SQL
injection is prevented (using placeholders for values in statements)
- [ ] Added support on fleet's osquery simulator `cmd/osquery-perf` for
new osquery data ingestion features.
- [ ] Added/updated tests
- [ ] Manual QA for all new/changed functionality
  - For Orbit and Fleet Desktop changes:
- [ ] Manual QA must be performed in the three main OSs, macOS, Windows
and Linux.
- [ ] Auto-update manual QA, from released version of component to new
version (see [tools/tuf/test](../tools/tuf/test/README.md)).

---------

Co-authored-by: Rachael Shaw <r@rachael.wtf>
Co-authored-by: Eric <eashaw@sailsjs.com>
2023-07-19 13:51:12 -04:00
Noah Talerman
2f645b2d34
MDM docs: Fix code block (#12838)
- Update code block to use XML instead of YAML syntax highlighting
2023-07-19 13:29:10 -04:00
Noah Talerman
ca999349a7
MDM docs: Add instructions for triggering native macOS update reminders (#12816)
- Add instructions on how to trigger native macOS notifications for OS
updates
- Link to this section from the RSR section
2023-07-19 09:32:21 -04:00
Noah Talerman
a8318452dd
MDM docs: Add instructions for custom macOS Setup Assistant (#12812)
- Add instructions that walk IT admin through how to use Fleet to
customize and test the macOS Setup Assistant
2023-07-19 09:31:00 -04:00
Mo Zhu
48b0089d15
List future tables in Chrome (#12781) 2023-07-18 12:54:05 -04:00
Noah Talerman
c85192449f
MDM docs: Update statuses (#12806)
- Update statuses for custom settings (configuration profiles) to match
the current product
2023-07-18 12:21:11 -04:00
Noah Talerman
e51ff9aa16
Audit activities (#12807)
- Add note about Windows MDM features being in production
- Update doc generator to generate new title and meta tag
2023-07-18 09:25:19 -04:00
Eric
d7b17c7228
Update positioning in documentation readme and CTA example (#12464)
closes: #12422
Changes:
- Updated the positioning in the Fleet documentation readme
- Updated the example `<call-to-action>` component in the article
formatting guide.
2023-07-17 12:38:07 -07:00
Sharon Katz
a62e4c8172
Add documentation for deploying ChromeOS test extensions. (#12579)
Adding documentation

---------

Co-authored-by: Sampfluger88 <108141731+Sampfluger88@users.noreply.github.com>
Co-authored-by: Rachael Shaw <r@rachael.wtf>
Co-authored-by: Luke Heath <luke@fleetdm.com>
2023-07-14 13:44:36 -05:00
Roberto Dip
e8070e0bd8
properly report changed profiles in the Puppet module (#12719)
For #12480
2023-07-14 12:53:03 -03:00
Noah Talerman
0436391d5e
Configuration files: Add note about Windows MDM being off (#12755)
- Clarify that Windows MDM features are disabled by default (behind a
feature flag)
2023-07-14 09:58:44 -04:00
Roberto Dip
eb75e303ec
change how team assignment works for the Puppet module (#12566)
For #12532, all details of how this works/why is done are in the issue
description.
2023-07-13 15:00:45 -03:00
Eric
e420e34ce2
Website: Add meta descriptions to Fleet documentation. (#12586)
#11986


Changes: 
- Added meta descriptions to Fleet documentation pages.

---------

Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-07-13 11:57:17 -05:00
Dave Herder
12d25bcc42
Update API-for-contributors.md (#12500)
Added documentation around triggering a FV token rotation
2023-07-12 18:30:52 -05:00
Dave Herder
6ace2f05f0
Update MDM-macOS-updates.md (#12717)
Added statement around support for RSRs under the "known issues" section
of macos updates.

---------

Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-07-12 14:17:31 -07:00
Mike Thomas
ea5e7b92aa
Update README.md (#12715)
Unless I'm mistaking this for something I'm not aware of, this message
about MDM features not being available is out of date and needs to be
removed.

I also updated the sentence on line 293 for readability while I was in
the file.

---------

Co-authored-by: Rachael Shaw <r@rachael.wtf>
Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-07-12 10:44:37 -05:00
Mike McNeil
d62c082e40
Reference correct pricing tier, and other small changes (#12328)
The changes in this diff really need to be applied throughout the reset
of the doc, I only went down from lines 1-24.

Other things noticed (for now in this PR or to file as separate issues
to add to a sprint, up to @rachaelshaw):
- link to /orbit should be renamed, with redirect added in routes.js for
backwards compat.
- Fleet uses consistent capitalization everywhere, including article
titles.
- documentation and handbook markdown filenames should be kebab-cased
(lowercase with no spaces)




> Context: Here's how I ended up noticing this:
https://osquery.slack.com/archives/C01DXJL16D8/p1686708452290589?thread_ts=1686645495.586929&cid=C01DXJL16D8

---------

Co-authored-by: Sharon Katz <121527325+sharon-fdm@users.noreply.github.com>
Co-authored-by: Sampfluger88 <108141731+Sampfluger88@users.noreply.github.com>
2023-07-11 00:41:47 -05:00
Mo Zhu
5fbc368e46
Warning about installing extension on Chrome browsers (#12596)
Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-07-07 09:55:38 -07:00
Roberto Dip
2b4798c4ab
add activity items when a Windows host turns MDM on (#12635)
For #12427, and its sub-tasks #12288 and #12612



![image](https://github.com/fleetdm/fleet/assets/4419992/b4c019dd-fbd3-4c1d-a2ad-a0bb4ebac817)
2023-07-06 15:33:40 -03:00
Roberto Dip
9abd0a8fea
add documentation about how to test macOS bootstrap packages (#12531) 2023-06-28 19:50:05 -03:00
Mo Zhu
28654a352a
document docker 4.17 package generation error (#12485)
Part of https://github.com/fleetdm/fleet/issues/10700
2023-06-28 11:33:31 -07:00
Dave Herder
0bdee0d079
Update REST-API.md (#12515) 2023-06-28 10:02:02 -07:00
Martin Angers
f641c3ec57
Add activities when Windows MDM is turned on/off (#12533) 2023-06-28 12:53:46 -04:00
Marcos Oviedo
821f6b064f
Adding support for GetPolicies message (#12477)
This relates to #12262 

- [X] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- [X] Added/updated tests
- [X] Manual QA for all new/changed functionality
2023-06-27 12:59:33 -03:00
Marcos Oviedo
22bb16bf2e
Pushing initial support for MS-MDE2 Discovery message (#12387)
This PR requires the Windows MDM configuration changes - This will be
updated next week

- [x] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- [x] Documented any API changes (docs/Using-Fleet/REST-API.md or
docs/Contributing/API-for-contributors.md)
- [x] Documented any permissions changes
- [X] Added/updated tests
- [X] Manual QA for all new/changed functionality
  - For Orbit and Fleet Desktop changes:
2023-06-22 17:31:17 -03:00
Luke Heath
e494dc5c99
Fix broken link (#12438) 2023-06-22 10:07:43 -06:00
Dave Herder
08a0a4ec48
Update Security-audits.md (#12057) 2023-06-21 11:26:49 -07:00
Martin Angers
1c249b60da
Add support to configure and enable Windows MDM, notify elegible hosts (#12340) 2023-06-20 14:06:45 -04:00
Eric
dacabef2fd
Docs: Fix broken link in MDM setup documentation (#12399)
Changes:
- `(business.apple.com)[https://business.apple.com]` »
`[business.apple.com](https://business.apple.com)`
2023-06-20 11:16:21 -05:00
Sharon Katz
da71da3e63
CIS Windows documentation (#12307)
Co-authored-by: Mo Zhu <mo@fleetdm.com>
Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-06-16 13:14:23 -04:00
Rachael Shaw
74af345f74
Docs: fix heading indentation (#12373)
Added a newline to fix "List all sofware" heading indentation on the
website:
<img width="816" alt="Screenshot 2023-06-15 at 4 22 36 PM"
src="https://github.com/fleetdm/fleet/assets/3065949/4a0cc555-18c5-470b-8879-c535988b3243">
2023-06-15 19:03:30 -05:00
Sabrina Coy
b81d182841
Update Building-Fleet.md (#12345)
Added instructions for installing dependency - Rosetta 2.
2023-06-14 19:42:12 -04:00
Lucas Manuel Rodriguez
517acdad72
Add guide to configure process_file_events on CentOS 7 (#12322)
#11890

---------

Co-authored-by: Rachael Shaw <r@rachael.wtf>
2023-06-14 18:23:47 -03:00
Martin Angers
68fa60c54d
Add a transferred_hosts activity when hosts are transferred to a new team (#12287) 2023-06-14 08:15:05 -04:00
Rachael Shaw
d970a02723
Update MDM-migration-guide.md (#12326)
Fixes a couple spots where "&lt;organization&gt;" wasn't displaying
because it was treated as a custom HTML element (and also fixes a
front-end error from Vue)
2023-06-13 18:50:02 -05:00
Rachael Shaw
095d907e8b
Fix title formatting in nav for ChromeOS doc page (#12278)
Added <meta> tag with correct capitalization for the page title.
2023-06-12 11:20:35 -05:00
RachelElysia
d1e085f7ab
Fleet docs: Clarify to use chrome extension only on ChromeOS (#12266)
# Checklist for submitter

If some of the following don't apply, delete the relevant line.

- [x] Documented any permissions changes
2023-06-09 12:12:14 -07:00
Lucas Manuel Rodriguez
ed92176194
smtp_settings and sso_settings are not returned to non-global-admins anymore (#12256)
#12248
2023-06-09 15:29:11 -03:00
Mo Zhu
50746c6b48
Chrome docs (#11747) 2023-06-09 10:03:01 -07:00
Lucas Manuel Rodriguez
2a532ede94
Do not return empty SSO and SMTP settings for non-global-admins (#12180)
#11266

PS: I first attempted a serialization trick by introducing a new
`appConfigResponse` and implementing `json.Marshal` to exclude these
fields but it was too hacky and hard to maintain moving forward, so I'm
bitting the bullet now. Happy to hear other ideas.

- [X] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- ~[ ] Documented any API changes (docs/Using-Fleet/REST-API.md or
docs/Contributing/API-for-contributors.md)~
- ~[ ] Documented any permissions changes~
- ~[ ] Input data is properly validated, `SELECT *` is avoided, SQL
injection is prevented (using placeholders for values in statements)~
- ~[ ] Added support on fleet's osquery simulator `cmd/osquery-perf` for
new osquery data ingestion features.~
- [X] Added/updated tests
- [X] Manual QA for all new/changed functionality
  - ~For Orbit and Fleet Desktop changes:~
- ~[ ] Manual QA must be performed in the three main OSs, macOS, Windows
and Linux.~
- ~[ ] Auto-update manual QA, from released version of component to new
version (see [tools/tuf/test](../tools/tuf/test/README.md)).~
2023-06-07 16:06:36 -03:00
Martin Angers
f390055847
Fix table formatting of fleetctl get mdm-command-results output (#12197) 2023-06-07 14:35:48 -04:00
Martin Angers
68ddaafac0
Fix bug preventing gitops role from fleetctl applying macos setup assistant (and bootstrap package) (#12193) 2023-06-07 13:29:36 -04:00
Dave Herder
155f3f37eb
Update MDM-migration-guide.md (#12119)
Added clarification about the end user experience when walking through
migration in manual vs. automatic enrollment workflows.
2023-06-06 10:38:49 -07:00
gillespi314
372c77ff23
Add backend for verified MDM profiles (#12078) 2023-06-05 12:05:28 -05:00
Dave Herder
4a19f4954a
Update Application-security.md (#12100)
adding reference to SDLC
2023-06-02 10:09:15 -07:00
Robert Fairburn
d2b885e871
Initial helm documentation (#11956)
Co-authored-by: Luke Heath <luke@fleetdm.com>
2023-06-02 11:26:58 -05:00
Luke Heath
b9f0b6336e
Update host summary example response payload (#12103) 2023-06-02 09:55:11 -05:00
Martin Angers
2f59a8cde1
MDM docs: Instructions for viewing recent MDM commands (#12006)
- Add section for viewing recent MDM commands using fleetctl get mdm-commands
- Add example output for fleetctl get mdm-commands and fleetctl get mdm-command-results
2023-06-02 09:46:12 -04:00
Eric
ac8cd8e024
Website: Throw error if Markdown content contains a Vue template (#12096)
Changes:
- Updated the build-static-content script to throw an error if a
Markdown file contains a vue template (e.g., `{{ foo }}`)
- Updated an example in the "Using Fleet" FAQ to use single curly
brackets (`{{host}} ` » `{host}`)


Context: https://github.com/fleetdm/fleet/pull/12088
2023-06-01 14:06:02 -05:00
Lucas Manuel Rodriguez
03ce7dd940
Add guide to help troubleshoot live queries (#12082)
This guide are the lessons learned during the troubleshooting for
#10957.
It attempts to reduce pain for future oncall issues with live queries.

PS: AFAICS, this should close
https://github.com/fleetdm/fleet/issues/6141.
2023-06-01 14:27:58 -03:00
Martin Angers
4322a28f5a
Implement preassign endpoint as first step to match profiles and hosts to teams (#12046) 2023-05-31 09:24:22 -04:00
Juan Fernandez
43ab81ee11
Feature 11829: Tailor host table response to ChromeOS (#12002)
Updated ingestion logic and fixed ChromeOS virtual tables to accommodate the requested UI changes.
2023-05-30 22:13:42 -04:00
Lucas Manuel Rodriguez
33d61044b5
Change role of existing users only if SSO attributes are present in the SAMLResponse (#11966)
#10784

The removal of the now deprecated `sso_settings.enable_jit_role_sync`
config will be tackled in: #10688.

- [X] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- ~[ ] Documented any API changes (docs/Using-Fleet/REST-API.md or
docs/Contributing/API-for-contributors.md)~
- ~[ ] Documented any permissions changes~
- ~[ ] Input data is properly validated, `SELECT *` is avoided, SQL
injection is prevented (using placeholders for values in statements)~
- ~[ ] Added support on fleet's osquery simulator `cmd/osquery-perf` for
new osquery data ingestion features.~
- [X] Added/updated tests
- [X] Manual QA for all new/changed functionality
  - ~For Orbit and Fleet Desktop changes:~
- ~[ ] Manual QA must be performed in the three main OSs, macOS, Windows
and Linux.~
- ~[ ] Auto-update manual QA, from released version of component to new
version (see [tools/tuf/test](../tools/tuf/test/README.md)).~
2023-05-30 17:49:59 -03:00
Lucas Manuel Rodriguez
6acb567ade
Accept and ignore SSO role attributes with null value (#11959)
#10878

- [X] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- ~[ ] Documented any API changes (docs/Using-Fleet/REST-API.md or
docs/Contributing/API-for-contributors.md)~
- ~[ ] Documented any permissions changes~
- ~[ ] Input data is properly validated, `SELECT *` is avoided, SQL
injection is prevented (using placeholders for values in statements)~
- ~[ ] Added support on fleet's osquery simulator `cmd/osquery-perf` for
new osquery data ingestion features.~
- [X] Added/updated tests
- [X] Manual QA for all new/changed functionality
  - ~For Orbit and Fleet Desktop changes:~
- ~[ ] Manual QA must be performed in the three main OSs, macOS, Windows
and Linux.~
- ~[ ] Auto-update manual QA, from released version of component to new
version (see [tools/tuf/test](../tools/tuf/test/README.md)).~
2023-05-30 16:57:03 -03:00
Eric
d5f26fce89
Docs: Fix permission table headers (#11659)
Closes #11640 
Changes: 
- Removed the whitespace in between the permission role names and the
asterisk that was causing the table header to have a linebreak in the
permission roles table.
2023-05-30 12:24:53 -05:00
Mo Zhu
e1a0021e7a
remove address column from network_interfaces chromeos table (#11787)
Co-authored-by: Zach Wasserman <zach@fleetdm.com>
2023-05-26 16:47:19 -05:00
Rachael Shaw
344bd27218
Fix heading indentation in "Configuration files" docs (#11618)
Added an extra line before one of the section headings so it will align
with the content below and not the list items above it:
![Screenshot 2023-05-10 at 12 39 47
PM](https://github.com/fleetdm/fleet/assets/3065949/4ddf013e-97a3-4a60-bab0-b38d12a19e3e)

Co-authored-by: Eric <eashaw@sailsjs.com>
2023-05-25 12:02:51 -05:00
Lucas Manuel Rodriguez
6415f062c6
Reduce size of DistributedQueryResult to improve live query performance (#11882)
This was found while working on #10957.

When running a live query, a lot of unused host data is stored in Redis
and sent on every live query result message via websockets. The frontend
and fleetctl just need `id`, `hostname` and `display_name`. (This
becomes worse every time we add new fields to the `Host` struct.)

Sample of one websocket message result when running `SELECT * from
osquery_info;`:

size in `main`: 2234 bytes
```
a["{\"type\":\"result\",\"data\":{\"distributed_query_execution_id\":57,\"host\":
{\"created_at\":\"2023-05-22T12:14:11Z\",\"updated_at\":\"2023-05-23T12:31:51Z\",
\"software_updated_at\":\"0001-01-01T00:00:00Z\",\"id\":106,\"detail_updated_at\":\"2023-05-23T11:50:04Z\",
\"label_updated_at\":\"2023-05-23T11:50:04Z\",\"policy_updated_at\":\"1970-01-02T00:00:00Z\",
\"last_enrolled_at\":\"2023-05-22T12:14:12Z\",
\"seen_time\":\"2023-05-23T09:52:23.876311-03:00\",\"refetch_requested\":false,
\"hostname\":\"lucass-macbook-pro.local\",\"uuid\":\"BD4DFA10-E334-41D9-8136-D2163A8FE588\",\"platform\":\"darwin\",\"osquery_version\":\"5.8.2\",\"os_version\":\"macOS 13.3.1\",\"build\":\"22E261\",\"platform_like\":\"darwin\",\"code_name\":\"\",
\"uptime\":91125000000000,\"memory\":34359738368,\"cpu_type\":\"x86_64h\",\"cpu_subtype\":\"Intel x86-64h Haswell\",\"cpu_brand\":\"Intel(R) Core(TM) i7-1068NG7 CPU @ 2.30GHz\",\"cpu_physical_cores\":4,\"cpu_logical_cores\":8,\"hardware_vendor\":\"Apple Inc.\",\"hardware_model\":\"MacBookPro16,2\",\"hardware_version\":\"1.0\",
\"hardware_serial\":\"0DPQR4HMD1FZ\",
\"computer_name\":\"Lucas’s MacBook Pro\",\"public_ip\":\"\",
\"primary_ip\":\"192.168.0.230\",\"primary_mac\":\"68:2f:67:8e:b6:1f\",
\"distributed_interval\":1,\"config_tls_refresh\":60,\"logger_tls_period\":10,\"team_id\":null,
\"pack_stats\":null,\"team_name\":null,
\"gigs_disk_space_available\":386.23,\"percent_disk_space_available\":40,
\"issues\":{\"total_issues_count\":0,\"failing_policies_count\":0},
\"mdm\":{\"enrollment_status\":null,\"server_url\":null,\"name\":\"\",\"encryption_key_available\":false},
\"status\":\"online\",\"display_text\":\"lucass-macbook-pro.local\",\"display_name\":\"Lucas’s MacBook Pro\"},
\"rows\":[{\"build_distro\":\"10.14\",\"build_platform\":\"darwin\",
\"config_hash\":\"b7ee9363a7c686e76e99ffb122e9c5241a791e69\",\"config_valid\":\"1\",
\"extensions\":\"active\",\"host_display_name\":\"Lucas’s MacBook Pro\",
\"host_hostname\":\"lucass-macbook-pro.local\",\"instance_id\":\"cde5de81-344b-4c76-b1c5-dae964fdd4f2\",\"pid\":\"8370\",\"platform_mask\":\"21\",\"start_time\":\"1684757652\",
\"uuid\":\"BD4DFA10-E334-41D9-8136-D2163A8FE588\",
\"version\":\"5.8.2\",\"watcher\":\"8364\"}],\"error\":null}}"]
```

vs. size of the message result on this branch: 675 bytes
```
a["{\"type\":\"result\",\"data\":{\"distributed_query_execution_id\":59,
\"host\":{\"id\":106,\"hostname\":\"lucass-macbook-pro.local\",
\"display_name\":\"Lucas’s MacBook Pro\"},
\"rows\":[{\"build_distro\":\"10.14\",\"build_platform\":\"darwin\",
\"config_hash\":\"f80dee827635db39077a458243379b3ad63311fd\",
\"config_valid\":\"1\",\"extensions\":\"active\",\"host_display_name\":\"Lucas’s MacBook Pro\",
\"host_hostname\":\"lucass-macbook-pro.local\",
\"instance_id\":\"cde5de81-344b-4c76-b1c5-dae964fdd4f2\",\"pid\":\"8370\",\"platform_mask\":\"21\",
\"start_time\":\"1684757652\",\"uuid\":\"BD4DFA10-E334-41D9-8136-D2163A8FE588\",\"version\":\"5.8.2\",
\"watcher\":\"8364\"}]}}"]
```

Manual tests included running with an old fleetctl running with a new
fleet server, and vice-versa, a new fleetctl running against an old
fleet server.

- [X] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- [X] Documented any API changes (docs/Using-Fleet/REST-API.md or
docs/Contributing/API-for-contributors.md)
- ~[ ] Documented any permissions changes~
- ~[ ] Input data is properly validated, `SELECT *` is avoided, SQL
injection is prevented (using placeholders for values in statements)~
- ~[ ] Added support on fleet's osquery simulator `cmd/osquery-perf` for
new osquery data ingestion features.~
- [X] Added/updated tests
- [X] Manual QA for all new/changed functionality
  - ~For Orbit and Fleet Desktop changes:~
- ~[ ] Manual QA must be performed in the three main OSs, macOS, Windows
and Linux.~
- ~[ ] Auto-update manual QA, from released version of component to new
version (see [tools/tuf/test](../tools/tuf/test/README.md)).~
2023-05-25 08:11:53 -03:00
gillespi314
259d4fa1ac
Track host DEP assignments in new table (#11875) 2023-05-23 13:01:04 -05:00
Noah Talerman
75ad1ad06d
Docs: remove issuer_uri from end_user_authentication (#11639)
- `issuer_uri` isn't required for this feature and won't included in the
UI.
2023-05-23 10:59:28 -07:00
Noah Talerman
da3a42d053
Contributing docs: Remove outdated command (#11788)
- Remove the `fleetctl apple-mdm apple-mdm enrollment-profiles
create-automatic` command because it no longer exists in Fleet
2023-05-22 17:08:29 -07:00
Mo Zhu
d74a15642d
convenience link to team schedule in REST API docs (#11782) 2023-05-19 11:44:27 -07:00
Eric
a0876fe892
Docs: Update endpoint used for add users to a team example (#11658)
Closes #11436
Changes:
- Updated the example used for adding users to a team in the Rest API
docs.

---------

Co-authored-by: Luke Heath <luke@fleetdm.com>
2023-05-18 17:01:50 -05:00
Roberto Dip
8e532a5e76
pre-populate username/fullname during account creation (#11557)
Related to #10744, this pre-populates and disables the username/fullname
fields.

https://user-images.githubusercontent.com/4419992/236854781-ac67ee28-c19c-4130-a5e6-2872220501b5.mov


# Checklist for submitter

If some of the following don't apply, delete the relevant line.

- [x] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- [x] Documented any API changes (docs/Using-Fleet/REST-API.md or
docs/Contributing/API-for-contributors.md)
- [x] Added/updated tests
- [x] Manual QA for all new/changed functionality
2023-05-18 12:50:00 -03:00
Juan Fernandez
009a87d33e
Feature 10196: Add filepath to end-points and third party integrations (#11285)
Adds the software installed path property to the proper end-points and third party integrations (webhook, Zendesk and Jira).
2023-05-17 16:53:15 -04:00
Noah Talerman
7f61c82910
MDM docs: Custom macOS settings (#11713)
Changes address the feedback below:

> Disk encryption docs should say that you shouldn’t use custom settings
to enforce disk encryption (prevent user from trying to do filevault via
imazing)

I decided not to call this out in the docs because this is handled by
the product. The UI (and CLI) show this error if the user tries to use
custom settings to enforce disk encryption:
![Screenshot 2023-05-16 at 9 48 59
AM](https://github.com/fleetdm/fleet/assets/47070608/d5f5de9b-f3c2-4b4f-b8a0-30fbf5292b9e)

> Custom settings docs says randomly that it only works for macOS.
Should be obvious. No need to state?

I removed sentence about Fleet only supporting macOS
2023-05-17 11:34:19 -07:00
Reed Haynes
feeae2ad0c
Update require password reset REST-API.md (#11718)
For #11279.

# Checklist for submitter

If some of the following don't apply, delete the relevant line.

- [x] Documented any API changes (docs/Using-Fleet/REST-API.md or
docs/Contributing/API-for-contributors.md)
2023-05-17 11:09:31 -05:00
gillespi314
a7f02355fd
Add device-authenticated endpoint to trigger MDM migration webhook request (#11724) 2023-05-17 09:16:26 -05:00
Rachael Shaw
7f881f2765
Docs: Add stub for section about adding hosts on ChromeOS (#11728)
Added [a new
section](https://www.figma.com/file/hdALBDsrti77QuDNSzLdkx/%F0%9F%9A%A7-Fleet-EE-(dev-ready%2C-scratchpad)?type=design&node-id=16041%3A205158&t=61RnyHFztxjth1BT-1)
to "Adding hosts" to prepare for #10585 🔮
2023-05-16 16:51:26 -05:00
Jacob Shandling
31f8ecb489
Clean up docs for generate (#11687)
Just some small copy improvements

Co-authored-by: Jacob Shandling <jacob@fleetdm.com>
2023-05-16 13:40:55 -07:00
RachelElysia
cdf5843e76
Fleet UI Bug fix: Team admin/maintainer do not see save button for global policies (#11673) 2023-05-16 13:18:29 -04:00
Roberto Dip
4dd127d577
base logic to show/hide the new Migrate to Fleet FD menu (#11679)
Related to #11670
2023-05-15 17:00:52 -03:00
gillespi314
ceeb4c1ed5
Add mdm.macos_migration to app config endpoints (#11694) 2023-05-15 11:50:07 -05:00
Marko Lisica
f20cacc10f
Update REST API docs for activities (#11691)
Current REST API documentation for activities is outdated. Since we have
automatically generated documentation for activity types on the Audit
activities page, with all the necessary details I think it's a good idea
to link REST API docs to this one.

REST API docs will have a description of what will be returned with
example and specific information about each activity type can be found
on the Audit activities page, which is always up-to-date.

# Checklist for submitter

If some of the following don't apply, delete the relevant line.

- [ ] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- [ ] Documented any API changes (docs/Using-Fleet/REST-API.md or
docs/Contributing/API-for-contributors.md)
- [ ] Documented any permissions changes
- [ ] Input data is properly validated, `SELECT *` is avoided, SQL
injection is prevented (using placeholders for values in statements)
- [ ] Added support on fleet's osquery simulator `cmd/osquery-perf` for
new osquery data ingestion features.
- [ ] Added/updated tests
- [ ] Manual QA for all new/changed functionality
  - For Orbit and Fleet Desktop changes:
- [ ] Manual QA must be performed in the three main OSs, macOS, Windows
and Linux.
- [ ] Auto-update manual QA, from released version of component to new
version (see [tools/tuf/test](../tools/tuf/test/README.md)).
2023-05-15 18:35:29 +02:00
Jacob Shandling
70f5b2e444
Update Permissions.md (#11440)
- Specify that MDM commands are CLI-only
2023-05-15 09:55:29 -04:00
Eric
9db9eca551
Add required meta tag to docs page (#11662)
Changes: 
- Added the required `pageOrderInSection` meta tag to
`adding-new-ui-components.md`

I just guessed what the `pageOrderInSection` value should be. This PR is
just to fix the website deploy script caused by this page not having the
required meta tag.

FYI: @jacobshandling
2023-05-12 10:50:14 -05:00
Zay Hanlon
b9c05238f4
Update fleetctl-CLI.md (#11646)
Adding instructions for creating GitOps user to make it clearer for
customers (based on feedback from Epic)
2023-05-11 15:32:15 -04:00
Jacob Shandling
28600be584
Clarify permission description (#11438)
Clarify the descriptions of two permission
2023-05-11 12:24:10 -07:00
Jacob Shandling
59211901bf
Update MDM-commands.md (#11439)
copy edit
2023-05-11 12:23:55 -07:00
Jacob Shandling
25f1ede3e1
Create UI component generator (#11644)
## `generate`: a script to automatically generate UI component
boilerplate
<img width="2103" alt="Screenshot 2023-05-11 at 10 50 11 AM"
src="https://github.com/fleetdm/fleet/assets/61553566/d5570868-51b4-4602-90a0-2f7722b9d9ef">

* Putting in this PR now since @fleetdm/frontend folks seemed keen to
use this immediately
* TODO:
- create Makefile command for using this functionality from the project
root
  - improve documentation

---------

Co-authored-by: Jacob Shandling <jacob@fleetdm.com>
2023-05-11 12:00:27 -07:00
Dave Herder
0650aedcf9
Update Server-Installation.md (#11550)
location of redis has changed. Good catch by
https://github.com/eclectiqus
2023-05-11 09:54:35 -05:00
gillespi314
a9584dc32f
Allow end user authentication during automatic MDM enrollment to be enabled on a per-team basis (#11566) 2023-05-10 15:22:08 -05:00
Gabriel Hernandez
a6df488f0e
add more details to detail query docs (#11501)
quick doc update to add a bit more context around detail queries
2023-05-09 16:58:57 +01:00
Noah Talerman
a9f335edec
MDM docs: Update bootstrap package docs (#11526)
- Clarify that Fleet uses the URL to upload the package to Fleet
2023-05-05 14:31:27 -07:00
Roberto Dip
33d788caed
add support for displaying EULA during ADE/DEP (#11532)
Related to #11350 and the sub-tasks for stuff that happens in setup
assistant: #11477 and #11479

This adds back-end and UI logic to show an EULA during DEP enrollment if
one was uploaded via the UI, if an EULA wasn't uploaded, we just proceed
to enroll the device right after authentication.


https://user-images.githubusercontent.com/4419992/236316655-282ee74a-5f79-4095-a950-82b77b80a5c0.mov
2023-05-05 14:36:13 -03:00
Mo Zhu
cc2773afbf
Update MDM-disk-encryption.md based on some beta feedback (#11474)
* Be more explicit about sending migration instructions to end users
* Be explicit about activity being logged when disk encryption key is
viewed
2023-05-03 14:14:40 -04:00
Mo Zhu
0ffba95b15
Fix sub-bulleted list in MDM migration guide (#11473) 2023-05-03 10:39:44 -04:00
Mike Thomas
7e18bcce8c
Website docs style patch (#11286)
This PR is in response to https://github.com/fleetdm/fleet/issues/10420,
to improve the readability of the docs. In particular,
[docs/using-fleet/mdm-setup](https://fleetdm.com/docs/using-fleet/mdm-setup).

**CSS changes**
- Adjusted margins and paddings on `<ol>` and `<ul>` elements. As well
as h-tags and code blocks.
- Added styling to docs `<h3>` tags to help differentiate sub-sections.
This helps to make the docs pages easier to scan.
- Reduced the boldness of `<b>` and `<strong>` tags. The recently
updated font, Inter, renders bold a little too heavily. (This is a
site-wide change.)
- Changed the default font color to `@core-fleet-black-75` and made sure
that h-tags are set to `@core-fleet-black`. The softer contrast helps
reduce fatigue while reading large blocks of text (while still
conforming to recommended contrast levels). This site-wide change brings
the text styling in sync with Figma.

**Content changes**
- Reformatted content on
[docs/using-fleet/mdm-setup](https://fleetdm.com/docs/using-fleet/mdm-setup)
to fix Markdown issues that were causing sections to render incorrectly,
and were also breaking the "On this page" side nav.
- Made grammar and content fixes to improve readability and flow.

# Checklist for submitter

If some of the following don't apply, delete the relevant line.

- [x] Manual QA for all new/changed functionality

---------

Co-authored-by: Eric <eashaw@sailsjs.com>
2023-05-02 13:07:31 -05:00
Roberto Dip
beabd4873c
improve instructions for local testing of DEP SSO (#11387) 2023-05-02 10:21:44 -03:00
Roberto Dip
11356b2f15
add CRUD for EULA (#11274)
https://github.com/fleetdm/fleet/issues/10741
2023-05-02 10:09:33 -03:00
Mo Zhu
161648c983
Update MDM-disk-encryption.md (#11470) 2023-05-01 17:57:35 -07:00
Noah Talerman
cd5dfa23f8
MDM docs: move disk encryption to its own page (#11277)
- Add "MDM disk encryption" page and rename "MDM custom macOS settings"
page
- Clarify how to enforce on a team v. "No team"
- Add step to confirm
- Update Fleet UI to use new pages
- Add redirect on fleetdm.com
2023-05-01 11:52:57 -04:00
Lucas Manuel Rodriguez
8c0f5feefc
Amend GitOps permissions for the 4.31.0 release (#11453)
- Remove the  from Permissions page
2023-05-01 11:42:32 -04:00
Noah Talerman
31d7ccc365
Fleetctl docs: reference MDM commands page (#11298)
- Add link to MDM commands page
- Add instructions to install fleetctl with npm
- Remove anchor link section at the top of the page
2023-05-01 11:27:02 -04:00
Eric
873cc94ee2
Docs: Fix broken links in documentation (#11424)
Changes:
- Fixed 12 links in 8 documentation pages.
2023-04-28 16:04:33 -05:00
Eric
5ddfacaf45
Docs: Fix broken FAQ link (#11405)
Changes:
- Fixed a link in the contributing FAQ
2023-04-28 10:34:20 -05:00
Gabriel Hernandez
bd9176d67e
UI for bootstrap package flows (#11288)
relates to #10935

This is the UI for all the flows around adding, removing, downloading,
and viewing information about a bootstrap package for fleet mdm. This is
pretty comprehensive but includes:

### Backend

**Update `Get host/id`** to include bootstrap package name

```json
{
  "macos_setup": {
    ...
    "bootstrap_package_name": "test.pkg"
  }
}
```

### Frontend

**UI for ABM not being set up**:


![image](https://user-images.githubusercontent.com/1153709/234018772-3221e27b-50a4-454e-8e9f-b62c9d349010.png)

**UIs for uploading, downloading, and deleting bootstrap package**:


![image](https://user-images.githubusercontent.com/1153709/234017915-871f252f-bf80-4282-9acf-5ebea12c6efa.png)


![image](https://user-images.githubusercontent.com/1153709/234018029-322a5f30-dd22-44e3-b9ae-a4af7acb68b4.png)


![image](https://user-images.githubusercontent.com/1153709/234018163-4b84a2ce-a064-4952-a63d-0c8307391052.png)

**UIs for seeing bootstrap status aggregate data**


![image](https://user-images.githubusercontent.com/1153709/234018107-455d63ab-5b2c-4727-ad20-eef6b269c336.png)

**UIs for filtering hosts by bootstrap status**


![image](https://user-images.githubusercontent.com/1153709/234018334-170fe93a-700e-48eb-b198-2a1cc54d31a7.png)

**UIs for seeing package status on host details and my device page**:


![image](https://user-images.githubusercontent.com/1153709/234018488-7b515db4-1248-4be7-8de3-9b74bb5d4795.png)


![image](https://user-images.githubusercontent.com/1153709/234018525-d653cb2d-9ef9-437e-8eba-141e557f4f39.png)

- [x] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- [x] Manual QA for all new/changed functionality

---------

Co-authored-by: Roberto Dip <dip.jesusr@gmail.com>
Co-authored-by: gillespi314 <73313222+gillespi314@users.noreply.github.com>
Co-authored-by: Martin Angers <martin.n.angers@gmail.com>
2023-04-27 16:10:41 +01:00
Roberto Dip
a23d208b1d
gate DEP enrollment behind SSO when configured (#11309)
#10739

Co-authored-by: Gabriel Hernandez <ghernandez345@gmail.com>
Co-authored-by: gillespi314 <73313222+gillespi314@users.noreply.github.com>
2023-04-27 09:43:20 -03:00
Lucas Manuel Rodriguez
7dadec3ecf
Add mTLS support to fleetd (#11319)
#7970

- [X] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- ~[ ] Documented any API changes (docs/Using-Fleet/REST-API.md or
docs/Contributing/API-for-contributors.md)~
- ~[ ] Documented any permissions changes~
- ~[ ] Input data is properly validated, `SELECT *` is avoided, SQL
injection is prevented (using placeholders for values in statements)~
- ~[ ] Added support on fleet's osquery simulator `cmd/osquery-perf` for
new osquery data ingestion features.~
- [X] Added/updated tests
- [x] Manual QA for all new/changed functionality
  - For Orbit and Fleet Desktop changes:
- [x] Manual QA must be performed in the three main OSs, macOS, Windows
and Linux.
- [x] Auto-update manual QA, from released version of component to new
version (see [tools/tuf/test](../tools/tuf/test/README.md)).
2023-04-27 08:44:39 -03:00
gillespi314
8df5f26bea
Add user activity logs for MDM bootstrap package endpoints (#11302) 2023-04-26 13:40:14 -05:00
RachelElysia
09e166d973
Documentation: Update testing docs with instructions how to run live QA Wolf e2e tests (#11318) 2023-04-26 11:21:21 -04:00
Lucas Manuel Rodriguez
b9e6a84f24
Filter out non-observer_can_run queries for observers in fleetctl get queries command to match the UI. (#11251)
#11089

- [X] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- ~[ ] Documented any API changes (docs/Using-Fleet/REST-API.md or
docs/Contributing/API-for-contributors.md)~
- [X] Documented any permissions changes
- ~[ ] Input data is properly validated, `SELECT *` is avoided, SQL
injection is prevented (using placeholders for values in statements)~
- ~[ ] Added support on fleet's osquery simulator `cmd/osquery-perf` for
new osquery data ingestion features.~
- [x] Added/updated tests
- [X] Manual QA for all new/changed functionality
  - ~For Orbit and Fleet Desktop changes:~
- ~[ ] Manual QA must be performed in the three main OSs, macOS, Windows
and Linux.~
- ~[ ] Auto-update manual QA, from released version of component to new
version (see [tools/tuf/test](../tools/tuf/test/README.md)).~
2023-04-26 11:38:20 -03:00
Martin Angers
77855a5e1d
Add activities for macOS setup assistant. (#11310) 2023-04-26 10:37:03 -04:00
Noah Talerman
3dbe422ebf
MDM docs: bootstrap package (#11256)
Changes made based on feedback during MDM beta session.

- Correction: the URL doesn't have to be publicly accessible
- Clarify how to install the bootstrap package on a team v. "No
team"
- Add confirmation step
2023-04-26 10:01:09 -04:00
Roberto Dip
5e5976786b
Add missing backtick to custom mdm commands docs (#11324) 2023-04-25 20:59:47 -03:00
Noah Talerman
c10feec11b
Update Using Fleet FAQ (#11320)
- Remove "In progress" because MDM is in public beta
2023-04-25 14:06:16 -07:00
Roberto Dip
9068faf38f
Allow to configure SSO settings for MDM end user authentication (#11270)
Related to #10741, this adds a new key to app config named
`end_user_authentication`, which can be configured using the same keys
as the existing SSO feature.

Per the spec, if the feature is configured, it's implicitly enabled, at
least until we get to #10999.

Note that this only enables the SSO config, a second part of the ticket
with endpoints for the EULA will be tackled separately.
2023-04-25 12:16:33 -03:00
Martin Angers
582e85c876
Add support for the mdm.macos_setup.macos_setup_assistant key in fleetctl, API (#11296) 2023-04-25 09:36:01 -04:00