Commit graph

1971 commits

Author SHA1 Message Date
Rachael Shaw
f5720d38a4
Docs: Use consistent naming for parameter types (#21787)
bool ➡️ boolean
list ➡️ array
2024-09-03 14:40:58 -05:00
Noah Talerman
904234251f
App deployment API endpoints are experimental (#21615)
App deployment features are experimental features:
https://fleetdm.com/handbook/company/product-groups#experimental-features
2024-09-03 12:33:09 -04:00
Noah Talerman
aa952962b5
API design: Fleet MDM features depend on MDM name (#21279)
API design for this bug: #18977 

Documentation story is here: 
- #20373
2024-09-03 12:32:39 -04:00
Noah Talerman
d44d675568
Fix API docs bug (#21263)
Broken label's don't have an `id` (they've been deleted):
https://github.com/fleetdm/fleet/pull/21162#discussion_r1713715452
2024-09-03 12:32:18 -04:00
Ian Littman
29af66076a
Add docs for --dev default MinIO buckets (#21721)
I noticed this wasn't documented when i went hunting for what I figured
were defaults baked into `--dev`; thanks @jahzielv for pointing me in
the right direction!
2024-08-30 16:12:43 -05:00
JoGSal
50cc41c7f9
Documentation: Internationalize Render deployment guide (#20725)
Row 11: Internationalize Render deployment guide. Updated language to
reflect need to be aware of regional settings when outside the United
States.

# 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. -->

Co-authored-by: Eric <eashaw@sailsjs.com>
2024-08-30 16:06:55 -05:00
Jahziel Villasana-Espinoza
a00559e732
feat: enable multiple ABM and VPP tokens (#21693)
> Related issue: #9956 

# 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://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 paths of existing endpoints are modified without backwards
compatibility, checked the frontend/CLI for any necessary changes
- [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

---------

Co-authored-by: Martin Angers <martin.n.angers@gmail.com>
Co-authored-by: Gabriel Hernandez <ghernandez345@gmail.com>
Co-authored-by: Roberto Dip <rroperzh@gmail.com>
Co-authored-by: Sarah Gillespie <73313222+gillespi314@users.noreply.github.com>
Co-authored-by: Dante Catalfamo <43040593+dantecatalfamo@users.noreply.github.com>
Co-authored-by: Roberto Dip <dip.jesusr@gmail.com>
2024-08-29 18:51:46 -04:00
Luke Heath
b59918d8c4
Use consistent experimental wording in REST API docs (#21600) 2024-08-27 17:14:38 -04:00
Luke Heath
fae3dec60f
Set software as experimental in yaml docs (#21602) 2024-08-27 14:09:07 -05:00
Ian Littman
5500f3362e
Update vulnerability processing docs to reference goval-dictionary (#21536)
Docs PR for #20934, split from #21506
2024-08-26 21:38:03 -05:00
Lucas Manuel Rodriguez
f6b2ec8793
Remove unused toxiproxy service (#21554)
Everyone running this thing by default when doing `docker compose up`
does not make sense. I added it and used once a few years ago.
2024-08-26 13:28:51 -03:00
Victor Lyuboslavsky
6b20dade95
Added endpoints for downloading software package. (#21346)
Updated contributor docs for #19561
2024-08-21 14:14:08 -05:00
Joanne Stableford
abee4954d7
Handbook: Adding 2024 pen test document to security audit page (#21393) 2024-08-21 11:15:37 -04:00
Gabriel Hernandez
e1e425a2ab
add UI to support self service VPP software (#21174) (#21415)
relates to #19883

implements UI to support self service VPP apps. 

**Self service checkbox in add software modal**



![image](https://github.com/user-attachments/assets/bb6f3b3b-61aa-4a78-a223-e73ad2c2c5b9)

The rest of the changes are the same as the original self service
feature.

- [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] Manual QA for all new/changed functionality
2024-08-20 15:51:36 +01:00
Ian Littman
ac38d9ca99
Fix YAML-in-Markdown formatting in Team scripts area of fleetctl apply docs (#21382) 2024-08-19 13:58:16 -05:00
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
Mike Thomas
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
JoGSal
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 Lee
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