Commit graph

716 commits

Author SHA1 Message Date
Ian Littman
79d5e605ed
Fail CI if Markdown files have "here" or "click here" as link anchors (#30027)
Also includes fixes for outstanding failing links. See earlier builds
for proof that this is catching problems.

For #30019.
2025-06-19 10:12:31 -05:00
Savannah Friend
408986eb1b
Renamed end of article title to "for vulnerability automation" (#30090) 2025-06-17 12:08:25 -05:00
Ian Littman
ce9332aa00
Add links to YAML settings that will now be cleared if not set (#30072) 2025-06-17 09:14:54 -05:00
Sarah Gillespie
4ab8208231
Update documentation for custom SCEP proxy (#29971) 2025-06-16 12:00:27 -05:00
Noah Talerman
d54147f02a
New guide: Manage software using GitOps (#30047) 2025-06-16 10:52:14 -05:00
Rachael Shaw
ac16428f3c
4.69.0 doc changes (#28937) 2025-06-14 14:26:45 -05:00
Noah Talerman
524d66775b
Release article: 4.69.0 (#29530)
Co-authored-by: Onasis Munro <Onasis.munro@gmail.com>
Co-authored-by: Luke Heath <luke@fleetdm.com>
Co-authored-by: Ian Littman <iansltx@gmail.com>
2025-06-14 14:26:04 -05:00
Eric
9d08753665
Website: reduce website slug size (#30010)
related to: #30005

Changes:
- Compressed and resized large gifs in the "Preventing Mistakes with
GitOps" article
- Removed unused website assets
2025-06-13 16:43:06 -05:00
Ian Littman
6f772a4405
Clean up "here" link anchors for docs, ee, and frontend dirs (#29742)
More work to fix #29720.

---------

Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2025-06-13 15:05:52 -05:00
Brock Walters
f238292ba7
Update mdm-just-got-better.md (#29990)
Cleaned up a little. :)
2025-06-13 10:43:45 -04:00
Noah Talerman
7877133935
macOS setup experience: document latency (#29623)
More context:
- https://github.com/fleetdm/fleet/issues/27450#issuecomment-2894664665
2025-06-12 08:24:46 -05:00
Irena Reedy
cb745144d9
New article: MDM just got better: Apple’s biggest IT updates at WWDC25 (#29929) 2025-06-12 12:41:55 +02:00
Mike Thomas
6fe0206a08
Update large-gaming-company-enhances-server-observability-with-fleet.md (#29951)
Updated quote attribution.
2025-06-12 12:24:20 +09:00
Dale Ribeiro
74a422481c
Added password sync info (#29831)
- Added section to address using PSSOe for password sync
- Changed headings to use sentence case, to be consistent with Fleet's
writing style
(https://fleetdm.com/handbook/company/communications#sentence-case)
- Changed instances of "Entra" to "Entra ID" which is how Microsoft
refers to the product.

# 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://github.com/fleetdm/fleet/blob/main/docs/Contributing/guides/committing-changes.md#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.
- [ ] If paths of existing endpoints are modified without backwards
compatibility, checked the frontend/CLI for any necessary changes
- [ ] If database migrations are included, checked table schema to
confirm autoupdate
- For new Fleet configuration settings
- [ ] Verified that the setting can be managed via GitOps, or confirmed
that the setting is explicitly being excluded from GitOps. If managing
via Gitops:
- [ ] Verified that the setting is exported via `fleetctl
generate-gitops`
- [ ] Added the setting to [the GitOps
documentation](https://github.com/fleetdm/fleet/blob/main/docs/Configuration/yaml-files.md#L485)
- [ ] Verified that the setting is cleared on the server if it is not
supplied in a YAML file (or that it is documented as being optional)
- [ ] Verified that any relevant UI is disabled when GitOps mode is
enabled
- 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`).
- [ ] Added/updated automated tests
- [ ] Manual QA for all new/changed functionality
- For Orbit and Fleet Desktop changes:
- [ ] Make sure fleetd is compatible with the latest released version of
Fleet (see [Must
rule](https://github.com/fleetdm/fleet/blob/main/docs/Contributing/workflows/fleetd-development-and-release-strategy.md)).
- [ ] 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)).
- [ ] For unreleased bug fixes in a release candidate, confirmed that
the fix is not expected to adversely impact load test results or alerted
the release DRI if additional load testing is needed.
2025-06-11 18:31:02 -05:00
jacobshandling
c9ed0026d9
Refine query result webhook docs (#29884)
## Follow up for #29834

---------

Co-authored-by: Jacob Shandling <jacob@fleetdm.com>
Co-authored-by: Rachael Shaw <r@rachael.wtf>
2025-06-10 13:35:50 -07:00
jacobshandling
45a8308d26
Docs: Webhook logging destination (#29844)
## #29834

---------

Co-authored-by: Jacob Shandling <jacob@fleetdm.com>
2025-06-09 14:37:10 -07:00
Ian Littman
c8e3a3b208
Clean up "here" link anchors in articles (#29755) 2025-06-09 09:48:27 -04:00
Noah Talerman
0e4cd029fa
Setup experience guide: document wrong callback URL (#29791)
Document what happens if the URL is set incorrectly.
2025-06-06 12:19:15 -04:00
Irena Reedy
45ac47a067
I work in operations. I deployed Fleet in minutes - article (#29764)
This week's article by Nate for the website

---------

Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
2025-06-05 20:44:57 -04:00
Noah Talerman
67666e2636
OS updates guide: connect to good Wi-Fi during macOS automatic enrollment (#29703)
- Learned during product group offsite. During new iPhone setup we saw a
"couldn't download software update" message and we think the WeWork
Wi-Fi isn't allowing large downloads
2025-06-02 15:52:58 -06:00
Ian Littman
7a54a2de22
Include non-primary CVSS scores from NVD when a primary score doesn'texist for a given CVSS version (#29199)
Fixes #28261.

~~Of note, this logic will prefer a non-primary CVSSv3.1 score over a
primary CVSSv3.0 score if 3.1 doesn't have primary but 3.0 does. I
haven't seen any evidence of this in our dataset (looked at 2024
output).~~

Updated with logic that will prefer a primary CVSSv3.0 score over a
secondary CVSSv3.1 score for a given vulnerability. In the test dataset
(2023 vuln snapshot, ~20k vulns) there were no cases where this
situation presented itself, so output was identical to the prior
implementation.

Validated by comparing a vulns run from GitHub Actions to a local run
with the new code, and confirmed that existing v3 scores weren't
replaced when they already existed (just got adds of v2 when only v3
existed, and v2/v3 adds when no scoring existed).

Confirmed that all three CVEs mentioned in #28261 show up in feed data.
Added spot-checks for secondary CVSS scores to the feed validator tool.

# 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] Manual QA for all new/changed functionality
2025-05-29 13:03:19 -05:00
Noah Talerman
6d03dc3ef5
Fleet auto renews certificates (#29525)
- NDES, DigiCert, and Custom SCEP
2025-05-28 15:05:44 -04:00
Noah Talerman
8553643bf1
fleetd guide: updates.fleetdm.com (#29364)
Fleet changes the URL from `tuf.fleetctl.com` => `updates.fleetdm.com`

Co-authored-by: Dale Ribeiro <dale@fleetdm.com>
2025-05-28 12:14:15 -04:00
Irena Reedy
814310cdcf
Create new article: not-everything-runs-in-kubernete.mds (#29515)
Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
2025-05-27 21:59:41 -04:00
Brock Walters
2689758d1e
Update mdm-commands.md (#29498)
Cleaned up minor typos / grammar.

---------

Co-authored-by: Rachael Shaw <r@rachael.wtf>
2025-05-27 18:37:01 -04:00
Gabriel Hernandez
89c8472bc6
bulk resend profiles guide (#29378)
For [#28764](https://github.com/fleetdm/fleet/issues/28764)

guid for the bulk resend profile feature

---------

Co-authored-by: Eric <eashaw@sailsjs.com>
2025-05-27 17:03:38 +01:00
Noah Talerman
bc266a288f
Android MDM setup: Fix wrong feature flag (#29401) 2025-05-23 19:33:17 -05:00
Rachael Shaw
cbeb311b97
4.68.0 doc changes (#29393)
Documentation updates for v4.68.0

---------

Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
Co-authored-by: Marko Lisica <83164494+marko-lisica@users.noreply.github.com>
Co-authored-by: Scott Gress <scottmgress@gmail.com>
Co-authored-by: Ian Littman <iansltx@gmail.com>
Co-authored-by: Jahziel Villasana-Espinoza <jahziel@fleetdm.com>
Co-authored-by: Eugene <eugene@fleetdm.com>
Co-authored-by: dantecatalfamo <dante.catalfamo@gmail.com>
Co-authored-by: Konstantin Sykulev <konst@sykulev.com>
Co-authored-by: Luke Heath <luke@fleetdm.com>
2025-05-22 16:20:56 -05:00
Savannah Friend
12ae60ab1c
Update case study with ROI (#29390) 2025-05-22 15:20:19 -05:00
Noah Talerman
ef6720a029
Release: Fleet 4.68.0 (#28908) 2025-05-22 13:01:09 -05:00
Brock Walters
5e8c5a52f3
Update mdm-commands.md (#29252)
Top down rewrite of the MDM command article with the intended purpose of
giving a clear example on using the API to deliver an MDM command in
addition to using fleetctl.
2025-05-20 13:54:24 -04:00
Luke Heath
7380919dc3
Organize contributor docs and establish ADR process and template (#29101) 2025-05-17 15:03:52 -05:00
Marko Lisica
7032a70865
[Feature guide] Setup Android MDM (#27688)
Related to:

- #23231
2025-05-17 11:56:37 -04:00
Josh Roskos
357ddf7893
Update foreign-vitals-map-idp-users-to-hosts.md (#29166)
Fixed typo

Co-authored-by: Sam Pfluger <108141731+Sampfluger88@users.noreply.github.com>
2025-05-16 16:01:20 -05:00
Noah Talerman
3a7c45ca35
Uninstall fleetd (#29202)
Local instructions
2025-05-16 10:22:52 -04:00
JD
3dec7d58ba
Article: how to use maintenance windows (Fleet in your calendar) (#20974) 2025-05-15 11:51:11 -04:00
Patrick Gallagher
305f1b1b67
Update macos-setup-experience.md (#28903)
Added note regarding the need to sign the Munki package or use the
signed version on the MacAdmins project
2025-05-14 15:55:24 -05:00
Patrick Gallagher
8ef0a00178
Update cis-benchmarks.md (#28947)
Malformed link
2025-05-14 14:00:47 -05:00
Jorge Falcon
a31e2a8ba6
Update how-to-configure-logging-destinations.md (#28980)
- Fixing broken links in the `how-to-configure-logging-destinations.md`
guide for setting up kinesis or firehose logging.
2025-05-14 10:51:30 -05:00
Dale Ribeiro
88cb3ba352
Fix markdown error causing a broken link to https://gdmf.apple.com/v2… (#29099)
…/pmv

# 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://github.com/fleetdm/fleet/blob/main/docs/Contributing/Committing-Changes.md#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.
- [ ] If paths of existing endpoints are modified without backwards
compatibility, checked the frontend/CLI for any necessary changes
- [ ] 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`).
- [ ] Added/updated automated tests
- [ ] Manual QA for all new/changed functionality
- For Orbit and Fleet Desktop changes:
- [ ] Make sure fleetd is compatible with the latest released version of
Fleet (see [Must
rule](https://github.com/fleetdm/fleet/blob/main/docs/Contributing/fleetd-development-and-release-strategy.md)).
- [ ] 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)).
- [ ] For unreleased bug fixes in a release candidate, confirmed that
the fix is not expected to adversely impact load test results or alerted
the release DRI if additional load testing is needed.

Co-authored-by: Sam Pfluger <108141731+Sampfluger88@users.noreply.github.com>
2025-05-14 10:15:23 -04:00
Dale Ribeiro
899115d202
Too many the's (#29106)
# 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://github.com/fleetdm/fleet/blob/main/docs/Contributing/Committing-Changes.md#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.
- [ ] If paths of existing endpoints are modified without backwards
compatibility, checked the frontend/CLI for any necessary changes
- [ ] 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`).
- [ ] Added/updated automated tests
- [ ] Manual QA for all new/changed functionality
- For Orbit and Fleet Desktop changes:
- [ ] Make sure fleetd is compatible with the latest released version of
Fleet (see [Must
rule](https://github.com/fleetdm/fleet/blob/main/docs/Contributing/fleetd-development-and-release-strategy.md)).
- [ ] 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)).
- [ ] For unreleased bug fixes in a release candidate, confirmed that
the fix is not expected to adversely impact load test results or alerted
the release DRI if additional load testing is needed.

Co-authored-by: Sam Pfluger <108141731+Sampfluger88@users.noreply.github.com>
2025-05-14 10:14:58 -04:00
Noah Talerman
e31accfe68
Bootstrap package and fleetd are installed in other scenarios (#28803)
When? MDM migration and `sudo profiles renew -type enrollment`
2025-05-09 14:58:56 -04:00
Noah Talerman
51fe1d20b7
Fleet-maintained apps guide (#28854)
Remove extra comma
2025-05-07 09:09:31 -04:00
Marko Lisica
e69883fb65
Update foreign vitals guide (IdP) (#28630)
Added note that IdP username can be added only to macOS hosts during ADE
if end user authentication is enabled.
2025-05-02 09:30:53 -04:00
Ian Littman
1f312188b7
Document more reliable way of pulling logged-in username on user (un)installs (#28612)
This matches the change to Brave tested Friday and merged in #28552.
@jmwatts's machine wasn't getting username via the previous command but
both her machine and others without that issue work with the revised
command here.
2025-04-30 13:12:16 -05:00
Noah Talerman
e4bbe185a8
Update reference docs/guides: reset automations (#28677)
Update guides to clarify current behavior and best practice.

More context here:
https://github.com/fleetdm/fleet/issues/28611#issuecomment-2841952742
2025-04-30 13:00:00 -05:00
Noah Talerman
664c6f3e8c
Update "Roadmap preview, April 2025" (#28514)
- Replace easier agent downloads with host vital variables. Why? More
demand from customers

More info in the OKRs sheet
[here](https://docs.google.com/spreadsheets/d/1Hso0LxqwrRVINCyW_n436bNHmoqhoLhC8bcbvLPOs9A/edit?gid=1846478041#gid=1846478041&range=F625).
2025-04-28 09:27:23 -04:00
Mason Buettner
5444193971
Update connect-end-user-to-wifi-with-certificate.md (#28415)
Linked the GitOps documentation on integrations, which includes specific
keys to add certificate authorities.

# Checklist for submitter

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

N/A, documentation-only request.

---------

Co-authored-by: Marko Lisica <83164494+marko-lisica@users.noreply.github.com>
2025-04-25 11:42:58 -07:00
Rachael Shaw
7ae8b9a3da
Documentation changes for v4.67.0 (#28528)
Docs for the 4.67.0 release.

---------

Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
Co-authored-by: Marko Lisica <83164494+marko-lisica@users.noreply.github.com>
Co-authored-by: Eugene <eugene@fleetdm.com>
Co-authored-by: Ian Littman <iansltx@gmail.com>
Co-authored-by: Drew Baker <89049099+Drew-P-drawers@users.noreply.github.com>
Co-authored-by: Scott Gress <scottmgress@gmail.com>
Co-authored-by: Lucas Manuel Rodriguez <lucas@fleetdm.com>
Co-authored-by: Martin Angers <martin.n.angers@gmail.com>
2025-04-24 16:10:41 -05:00
Noah Talerman
10a1e9c9c6
Release article: 4.67.0 (#28348) 2025-04-24 16:09:31 -05:00