diff --git a/docs/Get started/FAQ.md b/docs/Get started/FAQ.md index 2b3858f556..d321a461fd 100644 --- a/docs/Get started/FAQ.md +++ b/docs/Get started/FAQ.md @@ -127,6 +127,28 @@ Anyone is free to contribute to the free or paid features of the project. We are The only way we are able to partner as a business to provide support and build new open source and paid features is through customers purchasing Fleet Premium. +# Why is my EDR flagging the fleetd agent (orbit)? + +EDR products such as SentinelOne and CrowdStrike may occasionally flag the fleetd agent (orbit) after an update. This is a known false-positive scenario that can occur when changes to the agent's behavior trigger heuristic-based detections. + +It's common for security products to be falsely flagged as malicious because they need to access security-sensitive data (keychains, certificates, system configurations) to do their intended work. This is a known pattern across the industry and is not unique to Fleet; endpoint agents from many vendors encounter the same heuristic-based false positives. + + + +Fleet is in active communication with EDR vendors to resolve false-positive flagging of the fleetd agent. If you notice a new flag against the orbit binary, please contact your EDR vendor support team to report the false positive. They will let you know the best path forward to address any exceptions you may want to make. + +### SLSA provenance attestation 🌶️ + +Fleet's orbit binaries are built via GitHub Actions and include SLSA (Supply-chain Levels for Software Artifacts) provenance attestations. These attestations allow customers to cryptographically verify that a given binary was produced from a specific GitHub build job and source commit—providing confidence that the binary has not been tampered with. + +You can verify the attestation using the `gh` CLI: + +```bash +gh attestation verify --repo fleetdm/fleet +``` + +This gives your security team an additional signal when triaging EDR alerts: if the attestation verifies successfully, the binary is the authentic artifact produced by Fleet's CI pipeline. + ## How can I uninstall fleetd? See the ["How to uninstall fleetd" guide](https://fleetdm.com/guides/how-to-uninstall-fleetd). @@ -177,17 +199,6 @@ Fleet is actively tested with Redis 6.2 and 7 (specifically engine_version 7.1 o Fleet deploys v1.4.1 of the [Mac Admins osquery extension](https://github.com/macadmins/osquery-extension), with full support for the tables currently available in Fleet. For a list of supported tables, see the [Fleet tables reference](https://fleetdm.com/tables). -## Why is my EDR flagging Fleet? - -Fleet and your EDR have overlapping interests with opposite jobs. - -Your EDR's job is to detect anomalous behavior on the host — usually through behavioral heuristics, signatures, or machine learning. Anything that touches keychains, walks process trees, reads memory regions, or replaces binaries on disk is exactly what it's looking for. - -Fleet's role is to give you visibility into what's happening on the host — and that means gathering the same types of data that your EDR monitors. This is by design, on every endpoint you manage. - -If you notice a new flag or detection against Fleet, osquery, or orbit by your EDR, please contact your EDR vendor support team to report the false positive. They will let you know the best path forward to address any exceptions you may want to make. - -