Commit Graph
1956 Commits
Author SHA1 Message Date
Noah Talerman d3b3784620 Mark App Store apps API endpoints as experimental (#21379)
API endpoints are associated with the following experimental features:
- #19447
- #18867 

Fleet's handbook
[here](https://fleetdm.com/handbook/company/product-groups#experimental-features):
![Screenshot 2024-08-16 at 1 25
33 PM](https://github.com/user-attachments/assets/e0c76309-aae3-4c2d-9685-5f046060115a)
2024-08-17 11:20:06 -07:00
2171544ad1 Docs quick reference optimization (#21331)
This PR closes https://github.com/fleetdm/fleet/issues/21108

@noahtalerman, I double-checked all redirects, and they are working.
Clicking through the URLs in [this
spreadsheet](https://docs.google.com/spreadsheets/d/1djVynIMuJK4pT5ziJW12CluVqcaoxxnCLaBO3VXfAt4/edit?usp=sharing)
is a pretty quick way to go through them all. Note that "Audit logs" and
"Understanding host vitals" redirect to the contributor docs on GitHub,
so they will throw a 404 until this is merged.

Some new guides benefitted from a name change, so they make more sense
as stand-alone guides, and also so that we don't have to mess around
with more redirects later. Those name changes followed [this
convention](https://fleetdm.com/handbook/company/communications#headings-and-titles),
which was recently documented in the handbook.

Have fun!

---------

Co-authored-by: Eric <eashaw@sailsjs.com>
Co-authored-by: Noah Talerman <noahtal@umich.edu>
2024-08-16 15:30:31 -05:00
Noah Talerman 934c02a5c2 API design: Install App Store apps on iOS/iPadOS (#20892)
API changes for the "Install App Store apps on iOS/iPadOS" story
(#19447)
2024-08-16 10:33:24 -07:00
Noah Talerman d3805abe41 Fleet Desktop is supported on CentOS 8+ (#21167)
https://github.com/fleetdm/fleet/pull/20679#issuecomment-2273539991
2024-08-15 18:06:13 -07:00
Brock Walters 2eb755918f Update MDM-setup.md (#21349)
Clarify verbiage in the ABM section on MDM Status.
2024-08-15 17:53:40 -04:00
Victor Lyuboslavsky d2dba3386d Added "Sources" section to vulnerability processing page. (#21243)
# Docs for #19857
2024-08-14 19:55:25 +02:00
Dante Catalfamo 9a5e5372eb SSVPP Backend and CLI (#21132)
#19882 and #20532
2024-08-14 10:25:32 -04:00
Noah Talerman e9b2217ae8 Update Fleet server configuration docs (#21283)
- Osquery configuration isn't server config
- Condense top section by removing examples
2024-08-13 13:56:04 -07:00
Noah Talerman dc6ad94de3 Guide: "Enforce disk encryption when macOS hosts automatically enroll" and "Rotate FileVault (disk encryption) key w/o prompt" (#21202)
- Guide update for the "Enforce disk encryption when macOS hosts
automatically enroll" (#16866) and "Rotate FileVault (disk encryption)
key w/o prompt" (#13157) stories.
2024-08-13 11:40:15 -07:00
Martin Angers 08763d59f1 Feature branch for the Store Bootstrap Packages in S3 story (#21260) 2024-08-13 08:27:10 -04:00
Roberto Dip b3eba15291 add "cache" prefix for Redis AWS Reference-Architectures.md (#21249) 2024-08-12 19:59:51 -03:00
Sharon Katz 8fdfb9a004 Add AI features, maintenance window, and Fleet Desktop to usage statistics Story #19693 (#21131)
Additional statistics as described in
https://github.com/fleetdm/fleet/pull/20091 :

`aiFeaturesDisabled`:
Whether server_settings.ai_features_disabled is set to true in the
config.

`maintenanceWindowsEnabled`:
Whether at least one team has
integrations.google_calendar.enable_calendar_events set to true

`maintenanceWindowsConfigured`:
Maintenance windows are considered "configured" if:
configuration has value set for integrations.google_calendar[0].domain
configuration has value set for
integrations.google_calendar[0].api_key_json

`numHostsFleetDesktopEnabled`:
The number of hosts with Fleet desktop installed.
2024-08-12 15:12:28 -04:00
RachelElysia dbfee02f78 Docs: OS updates for iOS/iPadOS (#20754)
Doc changes for the "OS updates for iOS/iPadOS" story
(https://github.com/fleetdm/fleet/issues/19852)
2024-08-09 17:07:20 -07:00
Noah Talerman 0fd892e296 API design: Ability to add software to "No Team" (#20489) 2024-08-09 12:54:09 -07:00
Marko Lisica 0a2a48b6d8 API design: Install Apple App Store apps on macOS (#19291) 2024-08-09 10:00:21 -07:00
Noah Talerman accfd7d4e8 API design: OS updates for iOS/iPadOS (#20460) 2024-08-09 09:59:31 -07:00
Marko Lisica e69e0522f5 App Store apps ID string instead of integer (#20875) 2024-08-09 08:47:02 -07:00
JoGSalandNoah Talerman 1b4e4f44c5 Documentation: Add introduction for new users regarding querying (#20727)
Feedback Row 14: Brief introduction for new users regarding querying

# Checklist for submitter

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

---------

Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2024-08-08 13:36:04 -05:00
Zach Wasserman 5c2fceef87 Update Activation Lock information (#21138)
Apple recently added the ability to manage Activation Lock via ABM.
2024-08-07 16:36:25 -07:00
Noah Talerman 82532ec4d6 API reference docs: Parts of Get software are experimental (#21164)
- We forgot to mark this endpoint as having experimental features
2024-08-07 16:25:45 -07:00
Noah Talerman d5c9caa5b9 API reference docs: clarify profiles and labels (#21162)
- Only one of either `labels_include_all` or `labels_exclude_any` can be
included in the request.
- Add missing labels `id` in `GET /configuration_profiles` and `GET
/configuration_profiles/:uuid`
2024-08-07 16:25:31 -07:00
JoGSal 3ae4b3d94e Documentation: Add clarity on MSI package creation command (#20724)
Feedback Row 10: Make it clear that the command should be run to
generate install packages, not to enroll the device, Clarify that
Windows can only generate an MSI package.

# Checklist for submitter

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

<!-- Note that API documentation changes are now addressed by the
product design team. -->
2024-08-07 17:42:42 -05:00
Lucas Manuel Rodriguez 68ea52a764 Update docs: minimum Aurora version supported (#21130)
From https://github.com/fleetdm/fleet/pull/20225#discussion_r1702942048
2024-08-07 19:01:39 -03:00
Noah Talerman dc24c43575 API docs cleanup (#21072)
- Update sentence to be clearer
2024-08-06 16:05:17 -07:00
Mike Thomas e488a26dc7 Update tutorials-and-guides.md (#21078)
I have updated the list of tutorials and guides in the docs.

Although the brief stated the cut down the list to only the top 10,
@nonpunctual and I whittled the list down to curate the top 20 guides
that we believe are relevant to users who are deploying and setting up
Fleet. We listed them in order of operation as much as possible.

Closes https://github.com/fleetdm/confidential/issues/7343
2024-08-07 07:56:13 +09:00
Luke Heath 12132b3a50 Make contributor API warning clearer (#20814) 2024-08-06 14:34:11 -07:00
RachelElysia 357dc91c42 Fleet docs: Add API validations to doc for patching app config (#20758) 2024-08-06 10:28:28 -04:00
Tim LeeandVictor Lyuboslavsky a6a9a2e1c2 no team software gitops (#20847)
#20464 

Adding gitops support for a top level `software` key to be used to
manage installable software into "no team".

- [ ] Changes file added for user-visible changes in `changes/`,
`orbit/changes/` or `ee/fleetd-chrome/changes`.
See [Changes
files](https://github.com/fleetdm/fleet/blob/main/docs/Contributing/Committing-Changes.md#changes-files)
for more information.
- [X] Added/updated tests
- [X] Manual QA for all new/changed functionality

---------

Co-authored-by: Victor Lyuboslavsky <victor.lyuboslavsky@gmail.com>
2024-08-05 14:39:10 -03:00
Ian Littman 8362c328a1 Fix grammar on load balancer documentation in deploy docs (#21032)
Checklist deleted as items are irrlevant for docs updates.
2024-08-05 11:23:26 -05:00
Eric 1517b285ec Docs: Add fleetdm.com/guides link to tutorials-and-guides docs page. (#21026)
Related to: https://github.com/fleetdm/confidential/issues/7343

Changes:
- Added a fleetdm.com/guides link to the tutorials and guides docs page.
2024-08-02 18:35:23 -05:00
Noah Talerman 0f41fc1a8d API design: Hide "Self-service" if there's no self-service software (#20908) 2024-08-02 12:49:20 -07:00
Noah Talerman a28e4d800b Supported operating systems docs (#20679)
- Google Chrome and a gnome extension have to
be installed to use Fleet Desktop + Firefox on Fedora.
- You don't have to set Google Chrome as the default browser.
2024-08-01 13:43:07 -04:00
Marko Lisica 5820d028e0 API design: Improve host identifiers in the docs, CLI and API (#19752)
API design for: #19127
2024-08-01 11:11:07 -04:00
Georg Schölly a41fb636bc Detect software from deb_packages which is 'on hold' (#20751)
The list of installed software was missing packages put ['on
hold'](https://askubuntu.com/questions/18654/how-to-prevent-updating-of-a-specific-package)

The reason for this is that the old query looks for the status

    install ok installed

but there are other valid status which are also installed, like `hold ok
installed`. The syntax is `<desired> <error> <status>` so we only need
to look at the last or two last parts and ignore the first one.

See https://man7.org/linux/man-pages/man1/dpkg-query.1.html for a list
of status.

# Checklist for submitter

- [X] Changes file added for user-visible changes in `changes/`,
`orbit/changes/` or `ee/fleetd-chrome/changes`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- [X] Input data is properly validated, `SELECT *` is avoided, SQL
injection is prevented (using placeholders for values in statements)
2024-08-01 11:39:01 -03:00
Grant Bilstad 8b5094ff37 Fix link for fleetctl install (#20835) 2024-07-31 16:10:46 -06:00
Roberto Dip 42ff57d059 UI/Docs changes to rotate keys using Escrow Buddy (#20843)
UI portion for #13157

# Checklist for submitter

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

<!-- Note that API documentation changes are now addressed by the
product design team. -->

- [x] Added/updated tests
- [x] Manual QA for all new/changed functionality
2024-07-31 16:49:24 -03:00
Victor Lyuboslavsky 31224ccd34 Added VPP support for iOS/iPadOS (#20837)
#19447 
iOS and iPadOS apps can be installed using Apple's VPP (Volume Purchase
Program)

VPP apps are now using a composite primary key (Adam ID and platform)
because we want to keep iOS/iPadOS/macOS separate. It is possible for
one app to be installable on all Apple platforms.

# Checklist for submitter

- [x] Changes file added for user-visible changes in `changes/`,
`orbit/changes/` or `ee/fleetd-chrome/changes`.
See [Changes
files](https://github.com/fleetdm/fleet/blob/main/docs/Contributing/Committing-Changes.md#changes-files)
for more information.
- [x] Input data is properly validated, `SELECT *` is avoided, SQL
injection is prevented (using placeholders for values in statements)
- [x] Added/updated tests
- [x] If database migrations are included, checked table schema to
confirm autoupdate
- For database migrations:
- [x] Checked schema for all modified table for columns that will
auto-update timestamps during migration.
- [x] Confirmed that updating the timestamps is acceptable, and will not
cause unwanted side effects.
- [x] Ensured the correct collation is explicitly set for character
columns (`COLLATE utf8mb4_unicode_ci`).
- [x] Manual QA for all new/changed functionality
2024-07-30 22:43:51 +02:00
Marko Lisica bec4072ca7 GitOps docs: Configuration profiles - target hosts by excluding any label (#20779)
Changes related to: #17315
2024-07-30 09:13:02 -04:00
Noah Talerman 935f489397 Guide and API reference: Show iOS & iPadOS as supported platforms in the UI (#20746)
Guide and API reference changes for the following story:
- #19319
2024-07-26 16:04:35 -04:00
Marko LisicaandNoah Talerman 36c1b918d3 API design: Scope configuration profiles to hosts by excluding any label (#20614)
API design for:  #17315

Old PR: #18844

---------

Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2024-07-26 12:32:02 +02:00
Noah Talerman b77f9070be API design: Add host's next scheduled maintenance window to "Get host" (#20745)
API changes for the following story:
- #18554
2024-07-25 18:28:24 -04:00
Noah Talerman 7195126ce6 API reference: Wipe iOS/iPadOS (#20766) 2024-07-25 15:26:13 -07:00
Marko Lisica 7ff93583e8 API changes: Increase timeout limit for scripts (#20650)
API changes for:  #16645
2024-07-25 18:25:48 -04:00
Noah Talerman 0a37118660 API design: Filters for fleetctl get mdm-commands (#20623)
API design for:
-  #19143
2024-07-25 18:13:49 -04:00
Marko Lisica 5b88c7d754 Agent configuration docs: Increase timeout limit for scripts (#20651)
Docs changes related to: #16645
2024-07-25 16:56:36 -04:00
Jahziel Villasana-Espinoza 6a31d4eb44 feat: Apple App Store (VPP) apps (#20643)
> Related issue: #18867

# Checklist for submitter

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

<!-- Note that API documentation changes are now addressed by the
product design team. -->

- [x] Changes file added for user-visible changes in `changes/`,
`orbit/changes/` or `ee/fleetd-chrome/changes`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- [x] Input data is properly validated, `SELECT *` is avoided, SQL
injection is prevented (using placeholders for values in statements)
- [x] Added/updated tests
- [x] If database migrations are included, checked table schema to
confirm autoupdate
- [x] Manual QA for all new/changed functionality
2024-07-25 12:52:49 -04:00
Noah Talerman 316de4b15f GitOps reference (#20681)
- Clarify how to edit a team name via GitOps

Story: #18471
2024-07-25 12:19:42 -04:00
Dale Ribeiro 67852a0280 added link to available options for update channels (#20529)
# Checklist for submitter

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

<!-- Note that API documentation changes are now addressed by the
product design team. -->

- [ ] Changes file added for user-visible changes in `changes/`,
`orbit/changes/` or `ee/fleetd-chrome/changes`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- [ ] 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
- [ ] If database migrations are included, checked table schema to
confirm autoupdate
- For database migrations:
- [ ] Checked schema for all modified table for columns that will
auto-update timestamps during migration.
- [ ] Confirmed that updating the timestamps is acceptable, and will not
cause unwanted side effects.
- [ ] Ensured the correct collation is explicitly set for character
columns (`COLLATE utf8mb4_unicode_ci`).
- [ ] Manual QA for all new/changed functionality
- For Orbit and Fleet Desktop changes:
- [ ] Orbit runs on macOS, Linux and Windows. Check if the orbit
feature/bugfix should only apply to one platform (`runtime.GOOS`).
- [ ] 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)).
2024-07-25 10:04:37 -04:00
Dale Ribeiro 2481849669 Updated broken links for Using Fleet and Deploying (#20655)
# Checklist for submitter

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

<!-- Note that API documentation changes are now addressed by the
product design team. -->

- [ ] Changes file added for user-visible changes in `changes/`,
`orbit/changes/` or `ee/fleetd-chrome/changes`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- [ ] 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
- [ ] If database migrations are included, checked table schema to
confirm autoupdate
- For database migrations:
- [ ] Checked schema for all modified table for columns that will
auto-update timestamps during migration.
- [ ] Confirmed that updating the timestamps is acceptable, and will not
cause unwanted side effects.
- [ ] Ensured the correct collation is explicitly set for character
columns (`COLLATE utf8mb4_unicode_ci`).
- [ ] Manual QA for all new/changed functionality
- For Orbit and Fleet Desktop changes:
- [ ] Orbit runs on macOS, Linux and Windows. Check if the orbit
feature/bugfix should only apply to one platform (`runtime.GOOS`).
- [ ] 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)).
2024-07-25 10:04:18 -04:00
Marko Lisica e385f2c75a Mark software API endpoints as experimental (#20658)
- Mark new API endpoints or API endpoints that were changed as part of
Fleet's first app management feature (#14921) as experimental.
- Call out what is experimental exactly (the endpoint or new keys/values) and
point to changes
2024-07-24 18:35:57 -04:00