Open device management
Find a file
Victor Lyuboslavsky eada583ff1
Updating CPE generator to use new NVD API. (#15018)
Loom explaining changes (hit 5 min limit):
https://www.loom.com/share/e59b63bf638e4d9cad7984ef589b878d?sid=111fff75-115a-4a44-ae4f-6f25fede0d51

#14887

- [x] Need to merge fleetdm/nvd PR
https://github.com/fleetdm/nvd/pull/25 before this one.

# Checklist for submitter

- [x] Added/updated tests
- [x] Manual QA for all new/changed functionality
- Manually tested (with corresponding fleetdm/fleet changes) in my
personal fork: https://github.com/getvictor/nvd/releases

# QA Plan (must be done before merging this PR, and after merging the
nvd PR)
- [ ] Fork https://github.com/fleetdm/nvd and point `generate.yml` to
this branch.
[example](9d8e54930b/.github/workflows/generate.yml (L26))
- [ ] Add NVD_API_KEY to nvd secrets, and run the the nvd generate
GitHub action. Get key:
https://nvd.nist.gov/developers/request-an-api-key
- [ ] Compare the generated `cpe-###.sqlite.gz` to the previous one. One
way is to open it up with sqlite3 and `select * from cpe_2 order by
cpe23;` and dump results to a CSV file. Known differences are:
   - New file has ~2,500 more records
- Backslashes are handled differently for `Backpack\CRUD` and `Philips
In.Sight B120\37` products -- not a new issue since we do not support
those products right now
- `cpe:2.3🅰️moodle:moodle:4.2.0:*:*:*:*:*:*:*` -- this appears OK.
Also, it is a PHP plugin, and we don't support these currently.
- [ ] Record the existing vulnerabilities of current hosts.
- [ ] Stop any running fleet server. Delete `/tmp/vulndbs/cpe.sqlite`.
Can also delete other files there, or not delete this file -- it should
be overwritten by the new file. Also delete all rows in software_cpe and
software_cve DB tables. (Or can just spin up a fresh fleet server with
fresh DB, and re-enroll hosts (after setting the new env variable
below))
- [ ] Find the path to the generated `cpe-###.sqlite.gz` file
- [ ] Set `FLEET_VULNERABILITIES_CPE_DATABASE_URL` environment variable
to the above path, and start fleet server.
- [ ] After server's vulnerabilities cron job runs, the new
vulnerabilities should match the previous vulnerabilities
2023-11-20 16:10:00 -06:00
.github Update fleetctl-workstations to min macOS 14.1.1 (#15209) 2023-11-20 12:50:52 -05:00
.storybook Update storybook versions (#14841) 2023-11-01 10:54:26 +00:00
.vscode generate js coverage report in CI (#12029) 2023-06-01 17:46:25 +01:00
articles Enroll hosts docs improvements (#14862) 2023-11-20 19:39:41 +01:00
assets update gif for mdm migration (#14471) 2023-10-12 09:28:43 -03:00
changes Implement windows custom profiles in fleet UI (#15205) 2023-11-20 18:35:46 -03:00
charts Modifying chart to include dependencies (#14758) 2023-11-07 11:16:33 -06:00
cmd Updating CPE generator to use new NVD API. (#15018) 2023-11-20 16:10:00 -06:00
docs Website: Update usage statistics webhook inputs and HistoricalUsageSnapshot model. (#15180) 2023-11-20 15:34:19 -06:00
ee Enroll hosts docs improvements (#14862) 2023-11-20 19:39:41 +01:00
frontend Implement windows custom profiles in fleet UI (#15205) 2023-11-20 18:35:46 -03:00
git-hooks Optional git hooks (#14074) 2023-10-31 09:59:47 -06:00
handbook Handbook: Update "Testing changes" section on communications page (#15157) 2023-11-15 16:10:25 -06:00
infrastructure Host IDP Metadata in dogfood/s3 (#15132) 2023-11-14 13:45:32 -06:00
mdm_profiles Update password profile (#15191) 2023-11-17 13:13:49 -06:00
orbit Downgrade osquery-go due to panics in Shutdown and add more logging (#15017) 2023-11-13 18:29:45 -03:00
pkg Feat windows msmdm (#14837) 2023-11-01 11:13:12 -03:00
proposals Add Fleet server FIPS 140-2 v1 proposal (#13919) 2023-09-19 13:05:14 -03:00
schema (2023-11-17) Regenerate osquery_fleet_schema.json (#15189) 2023-11-17 13:23:11 -06:00
scripts add on-call script (#4781) 2022-03-28 10:00:33 -06:00
server Updating CPE generator to use new NVD API. (#15018) 2023-11-20 16:10:00 -06:00
terraform add module to enable bringing your own bucket file carving destination (#15206) 2023-11-20 11:26:43 -05:00
test/upgrade Bump github.com/docker/docker from 20.10.23+incompatible to 23.0.4+incompatible (#11259) 2023-04-21 14:53:55 -07:00
tools Add GET /mdm/profiles/summary endpoint (#15077) 2023-11-17 10:49:30 -06:00
website Website: Update usage statistics webhook inputs and HistoricalUsageSnapshot model. (#15180) 2023-11-20 15:34:19 -06:00
.dockerignore Added support to read jwt and mysql password from a file (#141) 2021-01-04 07:58:43 -08:00
.eslintrc.js Complete removal of Cypress (#13389) 2023-08-18 11:06:12 -06:00
.gitattributes Windows friendly changes after walking through getting started guide (#1441) 2021-07-21 20:49:44 -04:00
.gitignore Modifying chart to include dependencies (#14758) 2023-11-07 11:16:33 -06:00
.gitpod.yml Add gitpod yml (#2915) 2021-11-19 10:03:56 -03:00
.golangci.yml Add Kolide osquery tables 2023-11-01 20:11:35 -06:00
.goreleaser-snapshot.yml use image containing installer deps for fleetdm/fleetctl (#7040) 2022-08-24 12:10:16 +00:00
.goreleaser.yml remove deprecated fields from .goreleaser.yml (#12726) 2023-07-12 10:00:47 -07:00
.npmignore Move fleetdm.com into main Fleet repo (#83) 2020-12-02 14:48:03 -06:00
.prettierignore Complete removal of Cypress (#13389) 2023-08-18 11:06:12 -06:00
.prettierrc.json add prettier and have it format all fleet application code (#625) 2021-04-12 14:32:25 +01:00
.trivyignore 8241 trivy ignore file action (#8345) 2022-10-31 10:50:29 -04:00
babel.config.json Fleet Frontend: Create integration tests QuerySidePanel.tests.tsx (#12179) 2023-06-07 12:01:59 -04:00
CHANGELOG.md Enroll hosts docs improvements (#14862) 2023-11-20 19:39:41 +01:00
CODE_OF_CONDUCT.md Remove @fleetdm.com emails from fleetdm/fleet repo (#882) 2021-05-27 17:19:14 -04:00
codecov.yml Revert codecov changes (#13921) 2023-09-13 16:59:26 -05:00
CODEOWNERS Make Rachael Shaw CODEOWNER of docs (#15129) 2023-11-14 22:53:49 -06:00
docker-compose-redis-cluster.yml Move Redis cluster docker yml to separate file (#11162) 2023-04-12 15:14:28 -04:00
docker-compose.yml Schedule queries on hosts even if automations off (given we now store results) (#14411) 2023-10-11 15:20:06 -03:00
Dockerfile Bump alpine from 3.17.3 to 3.18.2 (#12367) 2023-06-23 12:33:29 -07:00
Dockerfile-desktop-linux Fix fleet desktop linux build (#14877) 2023-11-01 15:29:32 -06:00
Dockerfile.osquery-perf Bump golang from 1.20.3-alpine to 1.20.5-alpine (#12206) 2023-06-23 12:31:37 -07:00
go.mod Updating CPE generator to use new NVD API. (#15018) 2023-11-20 16:10:00 -06:00
go.sum Updating CPE generator to use new NVD API. (#15018) 2023-11-20 16:10:00 -06:00
LICENSE Update LICENSE (#10) 2020-11-04 19:57:51 -06:00
Makefile Orbit kolide table build fixes (#14972) 2023-11-06 17:53:02 -03:00
manifest.yml.cloudgov.example cloud.gov deployment (#7611) 2022-09-07 13:30:06 -05:00
package.json Bump axios from 1.2.3 to 1.6.0 (#15088) 2023-11-10 14:07:31 -06:00
postcss.config.js Upgrade Bourbon to 5.1.0 and fix deprecation warnings (#1973) 2019-01-03 12:46:55 -08:00
README.md Link to some of our fav open source repos (#13476) 2023-08-23 07:18:43 -07:00
SECURITY.md Editing security policy (#5333) 2022-05-05 20:29:06 -05:00
tools.go Update notarization to use notarytool (#7962) 2022-09-27 08:25:42 -07:00
tsconfig.json Fleet UI: Convert URLs in Policy resolution text to be clickable links (#13023) 2023-08-18 09:15:23 -04:00
webpack.config.js Upgrade webpack to v5 (#11173) 2023-04-14 07:58:54 -07:00
yarn.lock Bump axios from 1.2.3 to 1.6.0 (#15088) 2023-11-10 14:07:31 -06:00

Fleet logo, landscape, dark text, transparent background

News   ·   Report a bug   ·   Handbook   ·   Why open source?   ·   Art

Open-source platform for IT and security teams with thousands of computers. Designed for APIs, GitOps, webhooks, YAML, and humans.

A glass city in the clouds

What's it for?

Organizations like Fastly and Gusto use Fleet for vulnerability reporting, detection engineering, device management (MDM), device health monitoring, posture-based access control, managing unused software licenses, and more.

Explore data

To see what kind of data you can use Fleet to gather, check out the table reference documentation.

Out-of-the-box policies

Fleet includes out-of-the box support for all CIS benchmarks for macOS and Windows, as well as many simpler queries.

Take as much or as little as you need for your organization.

Supported platforms

Here are the platforms Fleet currently supports:

  • Linux (all distros)
  • macOS
  • Windows
  • Chromebooks
  • Amazon Web Services (AWS)
  • Google Cloud (GCP)
  • Azure (Microsoft cloud)
  • Data centers
  • Containers (kube, etc)
  • Linux-based IoT devices

Lighter than air

Fleet is lightweight and modular. You can use it for security without using it for MDM, and vice versa. You can turn off features you are not using.

Openness

Fleet is dedicated to flexibility, accessibility, and clarity. We think everyone can contribute and that tools should be as easy as possible for everyone to understand.

Good neighbors

Fleet has no ambition to replace all of your other tools. (Though it might replace some, if you want it to.) Ready-to-use, enterprise-friendly integrations exist for Snowflake, Splunk, GitHub Actions, Vanta, Elastic Jira, Zendesk, and more.

Fleet plays well with Munki, Chef, Puppet, and Ansible, as well as with security tools like Crowdstrike and SentinelOne. For example, you can use the free version of Fleet to quickly report on what hosts are actually running your EDR agent.

While most folks prefer to use one or the other, Fleet can also coexist peacefully with Rapid7 and other agent-based vulnerability scanners. This can be useful during migrations.

Free as in free

The free version of Fleet will always be free. Fleet is independently backed and actively maintained with the help of many amazing contributors.

Longevity

The company behind Fleet is founded (and majority-owned) by true believers in open source. The company's business model is influenced by GitLab (NYSE: GTLB), with great investors, happy customers, and the capacity to become profitable at any time.

In keeping with Fleet's value of openness, Fleet Device Management's company handbook is public and open source. You can read about the history of Fleet and osquery and our commitment to improving the product.

Is it any good?

Fleet is used in production by IT and security teams with thousands of laptops and servers. Many deployments support tens of thousands of hosts, and a few large organizations manage deployments as large as 400,000+ hosts.

Chat

Please join us in MacAdmins Slack or in osquery Slack.

The Fleet community is full of kind and helpful people. Whether or not you are a paying customer, if you need help, just ask.

Contributing   Run Tests   Go Report Card   CII Best Practices   Twitter Follow  

The landscape of cybersecurity and IT is too complex. Let's open it up.

Contributions are welcome, whether you answer questions on Slack / GitHub / StackOverflow / LinkedIn / Twitter, improve the documentation or website, write a tutorial, give a talk at a conference or local meetup, give an interview on a podcast, troubleshoot reported issues, or submit a patch. The Fleet code of conduct is on GitHub.

What's next?

To see what Fleet can do, head over to fleetdm.com and try it out for yourself, grab time with one of the maintainers to discuss, or visit the docs and roll it out to your organization.

Production deployment

Fleet is simple enough to spin up for yourself. Or you can have us host it for you. Premium features are available either way.

Documentation

Complete documentation for Fleet can be found at https://fleetdm.com/docs.

License

The free version of Fleet is available under the MIT license. The commercial license is also designed to allow contributions to paid features for users whose employment agreements allow them to contribute to open source projects. (See LICENSE.md for details.)

Fleet is built on osquery, nanoMDM, Nudge, and swiftDialog.