Commit graph

416 commits

Author SHA1 Message Date
Katheryn Satterlee
96c2e46acd
Update agent_options.overrides (#10939)
Corrected indentation for `agent_options.overrides` and added contents
to `agent_options.config.options`.

Documentation-only change.
2023-04-03 11:55:00 -05:00
Mo Zhu
7c126b4cfb
MDM docs: Update macOS updates
- Add table to make Nudge behavior more readable
- Add image to better illustrate end user experience
2023-03-31 10:05:53 -04:00
Katheryn Satterlee
af6b2559e9
Updating security link (#10882)
Documentation-only change:

Updated link and description for security section of Using-Fleet README
2023-03-30 11:13:26 -05:00
Dave Herder
c61aa8475e
MDM docs: Update set up instructions (#10805)
- Tell user they have they have to first deploy Fleet and add hosts to
use MDM features
2023-03-29 12:20:23 -04:00
Martin Angers
0e2c9bb873
finalize mdm commands part 1: support fleetctl get hosts --mdm and --mdm-pending (#10796) 2023-03-29 08:30:49 -04:00
Juan Fernandez
aecc2fed75
Feature 9834: Add published date to vulnerability object (#10434)
This only applies to Premium users, we want to show the vulnerabilities' published date anywhere vulnerabilities are shown including API endpoints and third party integrations.
2023-03-28 16:11:31 -04:00
Mo Zhu
8a1a700383
Clarify that it will take one to store disk encryption key in Fleet (#10810) 2023-03-28 15:53:09 -04:00
Jacob Shandling
f5fcd77359
UI: Remove unused 'Issuer URI' field from UI (#10766)
## Addresses #10257 

Removed the 'Issuer URI' field and its associated code. Manually
confirmed that enabling single sign-on still works as expected.

<img width="525" alt="Screenshot 2023-03-24 at 4 32 56 PM"
src="https://user-images.githubusercontent.com/61553566/227661519-c2684a68-8b66-48f9-a6ab-a24f02f07080.png">


# Checklist for submitter

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

- [x] Changes file added for user-visible changes
- [x] Manual QA for all new/changed functionality

---------

Co-authored-by: Jacob Shandling <jacob@fleetdm.com>
2023-03-27 10:31:30 -07:00
William Theaker
470c401fca
missing letter in word in documentation (#10714)
I didn't test this.

Co-authored-by: Mike McNeil <mikermcneil@users.noreply.github.com>
2023-03-25 02:26:20 -05:00
Mo Zhu
c280c5e011
Revert "Specify that Fleet will sign the profile" (#10761)
Reverts fleetdm/fleet#10752

Learned that we are not currently doing this, so it is not true.
2023-03-24 14:14:20 -07:00
Mo Zhu
e244cba8ef
Specify that Fleet will sign the profile (#10752) 2023-03-24 12:51:47 -07:00
Mo Zhu
9488817ee5
Match style guide in MDM doc titles (#10751) 2023-03-24 15:27:41 -04:00
Noah Talerman
071cd5d373
Update MDM docs (#10735)
- Update section title to use sentence case:
https://fleetdm.com/handbook/marketing/content-style-guide#sentence-case
2023-03-24 09:44:35 -07:00
Eric
f970f6fb8d
Website: Remove extra dashes from markdown links (#10657)
Closes: #10458

Changes:
- Updated the generated id's for headings in Markdown content to remove
extra dashes in words that have multiple letter casings (e.g., `#my-sql`
» `#mysql`, `#git-hub-security` » `#github-security`)
- Updated links to Markdown headings that have changed.
.  ..

---------

Co-authored-by: Mike McNeil <mikermcneil@users.noreply.github.com>
2023-03-22 19:34:59 -05:00
Mo Zhu
80237a0262
fix casing of bullets 2023-03-22 09:43:24 -07:00
Eric
c98cb2761b
Website: Fix pageOrderInSection meta tag on MDM docs page. (#10648)
Changes:
- Removed the backtick from the pageOrderInSection meta tag in
`docs/using-fleet/mobile-device-management.md`
2023-03-21 12:24:50 -05:00
Mo Zhu
e330c7e6ff
re-create the landing page for MDM (#10646) 2023-03-21 09:43:10 -07:00
Mo Zhu
d2dd93bcb6
MDM beta doc updates (#10593) 2023-03-20 15:20:47 -04:00
Mo Zhu
e632725a44
Break up MDM docs to be smaller articles for improved readability. (#10538)
- Broke up the single MDM doc into multiple ones organized by category
- Changed any links to point to the new docs

---------

Co-authored-by: Noah Talerman <noahtal@umich.edu>
Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2023-03-17 12:34:35 -07:00
Noah Talerman
8262878644
MDM docs: Fix bugs (#10535)
- Click “here” link to the team YAML docs was broken
- `minimum_version` and `deadline` value should be quoted in the
documentation. Fleet expects strings
- Updated "Team settings" section name to "Teams"
2023-03-16 13:51:46 -04:00
Mike McNeil
166ed7281e
this doesn't show up on the website, let's save time (#10402)
Co-authored-by: Katheryn Satterlee <me@ksatter.com>
2023-03-14 20:55:52 -05:00
Martin Angers
276c767ab9
Update aggregated_stats to support "no team" in addition to "all teams" (#10466) 2023-03-14 17:01:16 -04:00
Lucas Manuel Rodriguez
6d918d1366
Add enable_jit_role_sync config (#10478)
#8411

We decided to only update roles for existing accounts if enabled by a
new setting (disabled by default) `sso_settings.enable_jit_role_sync`.

- ~[ ] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.~
- ~[ ] Documented any API changes (docs/Using-Fleet/REST-API.md or
docs/Contributing/API-for-contributors.md)~
- ~[ ] Documented any permissions changes~
- ~[ ] 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.~
- [X] Added/updated tests
- [X] Manual QA for all new/changed functionality
  - ~For Orbit and Fleet Desktop changes:~
- ~[ ] 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)).~
2023-03-14 17:17:08 -03:00
Roberto Dip
8c2bd476af
add download link to fleetctl docs (#10464) 2023-03-14 11:54:41 -03:00
JD
a039e1d686
Add meta tag for proper page title name. (#10457)
meta tag update to properly set the page title to `CIS Benchmarks`.

---------

Co-authored-by: Eric <eashaw@sailsjs.com>
2023-03-13 15:10:32 -07:00
Noah Talerman
6b985da9e1
Contributor docs: Fix broken link (#10431)
- Fink link to point to correct section of MDM doc page
2023-03-13 17:03:08 -04:00
Mo Zhu
ea8c30a270
MDM docs: Clarify behavior of profile upload (#10450) 2023-03-13 15:27:14 -04:00
Noah Talerman
ddb5ba4e07
Update Permissions docs (#10440)
- Global observers can read configuration via the API (not the UI)
- Team observers can read team configuration via the API (not the UI)
2023-03-13 15:26:06 -04:00
Lucas Manuel Rodriguez
3757aace08
Add UUID to Fleet errors and clean up error msgs (#10411)
#8129 

Apart from fixing the issue in #8129, this change also introduces UUIDs
to Fleet errors. To be able to match a returned error from the API to a
error in the Fleet logs. See
https://fleetdm.slack.com/archives/C019WG4GH0A/p1677780622769939 for
more context.

Samples with the changes in this PR:
```
curl -k -H "Authorization: Bearer $TEST_TOKEN" -H 'Content-Type:application/json' "https://localhost:8080/api/v1/fleet/sso" -d ''
{
  "message": "Bad request",
  "errors": [
    {
      "name": "base",
      "reason": "Expected JSON Body"
    }
  ],
  "uuid": "a01f6e10-354c-4ff0-b96e-1f64adb500b0"
}
```
```
curl -k -H "Authorization: Bearer $TEST_TOKEN" -H 'Content-Type:application/json' "https://localhost:8080/api/v1/fleet/sso" -d 'asd'
{
  "message": "Bad request",
  "errors": [
    {
      "name": "base",
      "reason": "json decoder error"
    }
  ],
  "uuid": "5f716a64-7550-464b-a1dd-e6a505a9f89d"
}
```
```
curl -k -X GET -H "Authorization: Bearer badtoken" "https://localhost:8080/api/latest/fleet/teams"
{
  "message": "Authentication required",
  "errors": [
    {
      "name": "base",
      "reason": "Authentication required"
    }
  ],
  "uuid": "efe45bc0-f956-4bf9-ba4f-aa9020a9aaaf"
}
```
```
curl -k -X PATCH -H "Authorization: Bearer $TEST_TOKEN" "https://localhost:8080/api/latest/fleet/users/14" -d '{"name": "Manuel2", "password": "what", "new_password": "p4ssw0rd.12345"}'
{
  "message": "Authorization header required",
  "errors": [
    {
      "name": "base",
      "reason": "Authorization header required"
    }
  ],
  "uuid": "57f78cd0-4559-464f-9df7-36c9ef7c89b3"
}
```
```
curl -k -X PATCH -H "Authorization: Bearer $TEST_TOKEN" "https://localhost:8080/api/latest/fleet/users/14" -d '{"name": "Manuel2", "password": "what", "new_password": "p4ssw0rd.12345"}'
{
  "message": "Permission Denied",
  "uuid": "7f0220ad-6de7-4faf-8b6c-8d7ff9d2ca06"
}
```

- [X] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- [X] Documented any API changes (docs/Using-Fleet/REST-API.md or
docs/Contributing/API-for-contributors.md)
- ~[ ] Documented any permissions changes~
- ~[ ] 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.~
- [X] Added/updated tests
- [X] Manual QA for all new/changed functionality
  - For Orbit and Fleet Desktop changes:
- [X] 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)).~
2023-03-13 13:44:06 -03:00
Martin Angers
28c02448bf
Various mdm-related documentation fixes (#10398) 2023-03-09 09:53:40 -06:00
Martin Angers
0d6b9b98d4
Add mdm.macos_settings disk encryption fields to the response of GET /hosts/{id} and device. (#10371) 2023-03-08 15:42:23 -05:00
Noah Talerman
50125b7ac3
Using Fleet docs: Add turn off MDM FAQ (#10237)
- Add FAQ that informs the user what does turning off MDM means and how
do I turn it back on

Addresses docs for the Turn off MDM story:
https://github.com/fleetdm/fleet/issues/8206#issuecomment-1448728160
2023-03-08 12:19:04 -08:00
Luke Heath
182846a686
Add disclaimer about setting FLEET_DEV_MDM_ENABLED (#10315)
- Required feature flag for MDM beta
2023-03-08 09:06:49 -05:00
Martin Angers
765c8754b6
Add enabled/disabled disk encryption activities and trigger profiles generation (#10319) 2023-03-08 08:31:53 -05:00
Roberto Dip
9fb8fa464c
restore restrictive permissions for GET /mdm/apple and adjust UI (#10282)
Related to #10121 this reverts #10107, and modifies the UI to use
`mdm.enabled_and_configured` instead of the `GET /mdm/apple` endpoint so
we don't face permissions issues and Maintainers are able to see the
Controls page.

More details and rationale in
https://github.com/fleetdm/fleet/issues/10121#issuecomment-1450335235

Tested with Admins, Maintainers and Observers
2023-03-06 16:54:37 -03:00
Martin Angers
50a2739609
Allow updating enable_disk_encryption via the Modify Team endpoint (#10208) 2023-03-06 09:54:51 -05:00
gillespi314
36ac72d697
Add mdm profiles status filter to hosts endpoints (#10246) 2023-03-03 18:19:46 -06:00
Noah Talerman
57f628e6e7
MDM docs: Add MDM server in Apple Business Manager (#10236)
- Add instructions for creating an MDM server in ABM
2023-03-02 14:02:06 -05:00
Sharon Katz
a19d73511e
MAC CIS 13_2.1.1.1 (#10120) 2023-03-02 09:54:37 -05:00
Noah Talerman
8f84442b9a
MDM docs: End user UX for OS updates (#10078)
- Explain that Fleet automatically downloads the macOS update for the
end user
- Explain how to troubleshoot the scenario when the Mac says it's up to
date when it isn't
2023-03-01 09:56:37 -08:00
Martin Angers
4593c49ec4
Add disk_encryption option to config and team YAML (#10185) 2023-02-28 15:34:46 -05:00
gillespi314
6fec539fbf
Update API responses for hosts and labels endpoints to include host mdm info (#10141)
Issue #10126 

- Add mdm solution name to host mdm inf
- Add host mdm info in labels API response;
2023-02-27 18:40:34 -03:00
gillespi314
9031ee569d
Adjust permissions for Apple BM endpoints (#10107) 2023-02-24 19:25:26 -06:00
Noah Talerman
103edb11f0
MDM docs: Custom settings (profiles) (#10055)
Addresses:
- #9908

Changes:
- Add instructions for enforcing custom settings to macOS hosts using
profiles
- Add instructions for using iMazing Profile Creator to create profiles
- Add instructions for adding profiles to Fleet (UI and CLI)
- Add instructions for migrating settings that were enforced using the
old MDM solution to Fleet
- Update link in Fleet UI (**Custom settings** page) to point to docs

---------

Co-authored-by: Mo Zhu <mozhu888@gmail.com>
2023-02-24 16:09:14 -08:00
Juan Fernandez
7e366272c0
Feature 9386: Parse the Mac Office release notes for vulnerability processing (#9993)
This PR adds the capability of parsing the release notes posted in https://learn.microsoft.com/en-us/officeupdates/release-notes-office-for-mac into a JSON metadata file (to be released in the NVD repo) and use it for detecting vulnerabilities on Mac Office apps.
2023-02-24 14:18:25 -04:00
Noah Talerman
ecf730d9be
MDM docs: Reset Mac password with recovery key (#10033)
- Update the instructions
2023-02-23 09:50:00 -05:00
Lucas Manuel Rodriguez
f4df9b58a4
Add docs for cis benchmarks macOS 13 (#9987)
See #9974.

---------

Co-authored-by: Mo Zhu <mo@fleetdm.com>
2023-02-22 18:07:36 -03:00
Katheryn Satterlee
066a0cbe4b
Update flags for plain osquery hosts (#10014)
Updated the recommended flags for osquery hosts to use unversioned
endpoint
2023-02-22 10:29:03 -06:00
Lucas Manuel Rodriguez
b3e8b6007a
Update docs for device_mapping, works on all OSs (with fleetd) (#9982)
The `google_chrome_profiles` table is present in the three OSs. The one
requirement is that the user must use fleetd.
2023-02-22 08:41:50 -03:00
Noah Talerman
bb1ae51128
Turn on MDM: Update end user instructions (#9959)
- Update docs
- Update instructions on My device page
2023-02-21 12:27:54 -05:00
gillespi314
345a1f4c36
Update docs with permissions for MDM configuration profiles (#9906) 2023-02-17 13:26:39 -06:00
Benjamin Edwards
0db432f7e3
vuln processing distinct command (#9813)
closes https://github.com/fleetdm/fleet/issues/3723

Add new vuln processing command, configs, and documentation on how to utilize.
2023-02-17 10:00:57 -05:00
Noah Talerman
070f551070
MDM docs: Add supported macOS versions (#9887)
- Fleet supports MDM features on macOS 12+
2023-02-16 16:39:35 -05:00
Katheryn Satterlee
717f79f279
Update Fleet-desktop.md (#9891)
Add note for self-remediation
2023-02-16 15:23:54 -06:00
Lucas Manuel Rodriguez
b757e447bc
Fix private IP ingestion in network_interface_unix and network_interface_windows. (#9884)
#8924

This is reproduced in dogfood for `dogfood-centos-box` and
`dogfood-ubuntu-box` where their "Private IP" is also their "Public IP".
Given that these hosts have their "Primary IP" configured to be their
"Public IP" alongside their "Private IP", the `network_interface_unix`
and `network_interface_windows` queries are now changed to ingest only
private IPs for the "Private IP" field.

- [X] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- ~[ ] Documented any API changes (docs/Using-Fleet/REST-API.md or
docs/Contributing/API-for-contributors.md)~
- ~[ ] Documented any permissions changes~
- ~[ ] 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~
- [X] Manual QA for all new/changed functionality
  - ~For Orbit and Fleet Desktop changes:~
- ~[ ] 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)).~
2023-02-16 17:16:40 -03:00
Martin Angers
4a1f3988f0
Add "edited macos profiles" activity when applying custom settings via fleetctl (#9862)
#9587 and #9639
2023-02-16 13:53:26 -03:00
Katheryn Satterlee
112e5ec05a
Add Packs entry to FAQ (#9825)
# Checklist for submitter

Documentation only change
2023-02-14 15:30:47 -06:00
gillespi314
8daead3ef5
Update route for hosts encryption key (#9821) 2023-02-14 12:17:31 -06:00
Noah Talerman
1c44d54454
MDM docs: Update migration instructions (#9820)
- For automatically enrolled hosts, add extra step to
first unassigned hosts from old MDM and then assign hosts to Fleet
2023-02-14 11:51:35 -05:00
RachelElysia
2c4c3a87ea
Fleet Documentation: Update agent options and enrollment secret documentation (#9565) 2023-02-13 10:45:37 -05:00
Mo Zhu
3de7b0c3d4
Update macos nudge docs (#9801) 2023-02-10 16:31:22 -05:00
Roberto Dip
7cd581866a
add API endpoint to see disk encryption key (#9713)
https://github.com/fleetdm/fleet/issues/8708
2023-02-08 20:20:23 -03:00
Jacob Shandling
5c0f635966
clarify Teams > MDM settings docs (#9754)
Co-authored-by: Jacob Shandling <jacob@fleetdm.com>
2023-02-08 11:49:01 -08:00
Noah Talerman
f4dd05d3ee
Docs: Fix images on Mobile device management page (#9734)
- Update links so that images render correctly
2023-02-07 14:00:32 -08:00
Noah Talerman
9ae5941d8c
Docs: MDM - pending hosts (#9728)
- Explain what MDM status "Pending" means
- Explain default team and how to update
2023-02-07 16:03:30 -05:00
Noah Talerman
b87c28726a
Docs: Add instructions for MDM migration (#9708)
These docs address 5 out of 7 requirements in the "Docs for MDM
migration" issue here: #9009

Docs also add an "Instructions for end users" section to address docs
for "Manual enrollment" issue:
https://github.com/fleetdm/fleet/issues/7957#issuecomment-1416262879

- Add instructions for IT admins on how to switch MDM solutions for
hosts manually enrolled to the old MDM solution
- Add instructions for IT admins on how to switch MDM solutions for
hosts automatically enrolled (DEP) to the old MDM solution
- Add information for IT admins about how Fleet treats Activation Lock
Bypass codes
- Add instructions for end users on how to switch MDM solutions for
hosts manually and automatically enrolled to the old MDM solution (same
instructions)
2023-02-07 13:53:14 -06:00
RachelElysia
f721e0daf5
Docs: Add disk encryption section to MDM page
- Add disk encryption section
- Update transparency section of website under here's what osquery can see on your device > file contents dropdown
2023-02-03 10:37:02 -05:00
Benjamin Edwards
dbcb638809
update file carver block size and various MySQL references (#9625)
Update the default file carver block size to be compatible with MySQL 8
& S3.
Update surrounding docs.
Various other updates to references of MySQL versions (all terraform
deploys are now defaulted MySQL 8 in AWS)

# Checklist for submitter

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

- [X] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
2023-02-02 01:01:34 -05:00
Roberto Dip
e06b00df11
Add readonly MDM.EnabledAndConfigured to app config and device responses (#9575)
Related to #9571, this adds a new value to both responses which is
calculated when the Fleet server is started, and only set to `true` if
the server is properly configured for MDM.

This helps the UI to determine wether or not we should show certain UI
elements that we only want to show to servers with MDM enabled.
2023-02-01 14:47:52 -03:00
Martin Angers
f47b7f538f
Mention that the min macos version activity is created when deadline is modified too (#9608)
Tiny follow-up to https://github.com/fleetdm/fleet/pull/9594
2023-02-01 09:10:29 -05:00
Martin Angers
c805ea2154
Record activity when the macos minimum version requirement is edited (#9594) 2023-01-31 16:36:18 -06:00
Katheryn Satterlee
ee0d93a80f
Add best practice for updating team config (#9580)
Documentation only changes.
2023-01-31 13:47:10 -05:00
Martin Angers
8a137e2b5b
Move host details mdm properties to new mdm object (#9505) 2023-01-30 16:40:11 -06:00
Juan Fernandez
e376d53294
Bug 9386: Docs chrome extension has the wrong CPE. (#9524)
Related to #9386 - this should fix one of the three reported problems.

* Add the ability to add exclusion rules to cpe_translations.
* Added exclusion rule for Docs chrome extension.
2023-01-27 15:11:20 -04:00
Roberto Dip
0c9a79b248
Adjust Nudge configuration to match the specification (#9519)
Related to #9013 this adjusts the Nudge configuration to match the spec.
2023-01-26 19:52:03 -03:00
Martin Angers
d0e6891d10
Add endpoint to trigger CSR request for APNs on fleetdm.com (#9494) 2023-01-25 14:44:29 -05:00
Katheryn Satterlee
0c1ec16dc4
Include information on flags for fleetctl apply (#9493)
Added details on using flags to change behavior when applying team and
config specs using fleetctl
2023-01-25 10:43:46 -06:00
Marcos Oviedo
980fbcc003
Adding more notes to overrides behavior in agent settings (#9482)
Adding notes on the agent_options.overrides behavior
2023-01-25 09:57:56 -03:00
Martin Angers
84717de461
Document APNs and ABM setup and renewal (#9471) 2023-01-24 15:20:41 -05:00
Roberto Dip
2d25a3f48d
add mdm root key and macos_updates to app and team configs (#9442)
Related to https://github.com/fleetdm/fleet/issues/9345,
https://github.com/fleetdm/fleet/issues/9358 and
https://github.com/fleetdm/fleet/issues/9346 this adds:

1. The ability to configure `mdm.macos_updates` via `PATCH /config` and
`PATCH /teams/{id}`
3. The ability to configure `mdm.macos_updates` by using `fleetctl apply
-f` for teams and global config.
2023-01-24 13:20:02 -03:00
Reagan Evans
5947bd74f4
FAQ.md:Add new entry related to default UI sorting (#9004)
Add question regarding the use of an ORDER BY clause to explain why that
sort may not match what the UI shows as results are received from hosts.

# Checklist for submitter: n/a

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>
Co-authored-by: Mike McNeil <mikermcneil@users.noreply.github.com>
2023-01-23 15:12:12 -06:00
Katheryn Satterlee
39db759c8a
8887 remove packs from docs (#9453)
Docs only chznge
2023-01-20 16:55:48 -06:00
Katheryn Satterlee
96ea1d6aae
Remove packs from docs (#9452)
Documentation only change, updating docs to reflect #8887
2023-01-20 16:47:24 -06:00
Lucas Manuel Rodriguez
328004d679
Log failed login attempts as activities (#9430)
#9119

To test the SSO changes locally you can use:

https://github.com/fleetdm/fleet/blob/main/docs/Contributing/Testing-and-local-development.md#testing-sso

@RachelElysia Please take a look at the UI changes (All I did was
copy/paste and amend the changes for the new activity type.)

IMO we shouldn't display an avatar because there's no "actual user"
involved in these failed login attempts activities (by "actual user" I
mean the user attributed to the activity):

<img width="446" alt="Screenshot 2023-01-19 at 10 41 05"
src="https://user-images.githubusercontent.com/2073526/213524771-b85901ce-eec0-4cf3-919c-73162285e20b.png">

- [X] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- [X] Documented any API changes (docs/Using-Fleet/REST-API.md or
docs/Contributing/API-for-contributors.md)
- ~[ ] Documented any permissions changes~
- ~[ ] 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.~
- [X] Added/updated tests
- [X] Manual QA for all new/changed functionality
  - ~For Orbit and Fleet Desktop changes:~
- ~[ ] 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)).~
2023-01-20 12:43:22 -03:00
Noah Talerman
f11a905a09
Docs: MVP for MDM page (#9417)
- Add new "Mobile device management (MDM)" page to "Using Fleet" section
- Adds docs for OS updates
2023-01-19 17:50:06 -05:00
Lucas Manuel Rodriguez
1cdfe2d351
Add summary of hardcoded detail queries (#9425)
Adds a process to generate a summary of the hardcoded Fleet queries.
2023-01-19 17:44:03 -03:00
Noah Talerman
d513763445
Docs: Update MDM settings and configuration (#9416)
- Add callout that MDM features are currently under development
- Rename sections
2023-01-19 13:34:18 -05:00
Lucas Manuel Rodriguez
49fccdb7b0
Fix broken links in Adding-hosts.md and Orbit.md (#9230)
Hi folks!

I wanted to share some docs to a user and I got a 404:
The "cleanup script" link on
https://fleetdm.com/docs/using-fleet/orbit#mac-os click returns a 404.

- I used the "Markdown All in One" VS code extension to re-generate (and
fix) the indexes in those files.
- I used https://github.com/tcort/markdown-link-check to check for
broken links:
```
markdown-link-check Orbit.md
markdown-link-check Adding-hosts.md
```
2023-01-18 10:04:44 -06:00
Gabriel Hernandez
7d4653baaa
add attribute to GET /activities endpoint with pagination metadata (#9279)
relates to https://github.com/fleetdm/fleet/issues/8928

This adds a new `meta` attribute to the "GET /activities" endpoint that
includes pagination metadata. This can allow clients to know if there
are additional items to request.


- [x] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- [x] Documented any API changes (docs/Using-Fleet/REST-API.md or
docs/Contributing/API-for-contributors.md)
- [x] Added/updated tests
- [x] Manual QA for all new/changed functionality
2023-01-18 12:57:11 +00:00
Artemis Tosini
caa6b05c92
docs: Remove deprecated vulnerability_settings options (#9281)
Fixes #8697
2023-01-17 15:28:36 -08:00
gillespi314
fba3607c4a
Add mdm status and server url to host endpoint responses (#9320) 2023-01-16 17:08:24 -06:00
Katheryn Satterlee
d12c9bb5a2
Update FAQ.md (#9303)
Added entry for package generation on M1 Macs

# Checklist for submitter

Documentation only change
2023-01-12 14:15:51 -06:00
Tomas Touceda
65783d49c7
Add feature to change or disable Fleet's hardcoded detail queries (#9117)
#8984

- [x] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- [x] Added/updated tests

Co-authored-by: Lucas Rodriguez <lucas@fleetdm.com>
2023-01-09 08:56:10 -03:00
Tomas Touceda
398bb38da7
Add software_updated_at field to host (#9116)
#9012

- [x] Changes file added for user-visible changes in `changes/` or
`orbit/changes/`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- [x] Documented any API changes (docs/Using-Fleet/REST-API.md or
docs/Contributing/API-for-contributors.md)
- [x] Added/updated tests

Co-authored-by: Lucas Rodriguez <lucas@fleetdm.com>
2023-01-09 08:55:43 -03:00
Luke Heath
abb5a332c5
UI hackathon: transitions, tooltips, empty states, buttons, bookmarks (#9195) 2023-01-06 17:08:48 -06:00
Martin Angers
656e5bfc70
Flag when the Apple BM terms have expired (#9091)
#8862 

Co-authored-by: Roberto Dip <dip.jesusr@gmail.com>
Co-authored-by: gillespi314 <73313222+gillespi314@users.noreply.github.com>
2023-01-06 17:44:20 -03:00
gillespi314
f9f1a94b48
Update mdm enrollment status API response (#9189) 2023-01-05 15:52:46 -06:00
Gabriel Hernandez
71a2e8f517 merge in main 2023-01-05 17:48:46 +00:00
Lucas Manuel Rodriguez
08aafe821e
Remove duplicate FAQ document (#9185)
* Remove duplicate FAQ document

* Remove entries that are already present in docs/Deploying/FAQ.md

* Fix index
2023-01-04 17:30:44 -03:00
RachelElysia
68aefc8e56
Fleet UI Hackathon: Empty states (#9094) 2023-01-04 14:16:34 -05:00
Lucas Manuel Rodriguez
a506a8e66b
Update outdated Orbit and osquery logging documentation (#9064)
* Update some outdated Orbit and osquery logs

* Revert index change
2023-01-04 08:46:28 -03:00
Frank Sievertsen
91c90b4caa
Add new configuration option to set default team for Apple Business Manager (#9062) 2023-01-03 16:14:18 -06:00
gillespi314
b990121fdc
Add mdm enrollment pending filter to API endpoints (#9137) 2023-01-03 11:26:23 -06:00
Roberto Dip
1b47f9e700
add activities when a host is enrolled/unenrolled from MDM (#9127)
#8996
2022-12-28 16:41:18 -03:00
Lucas Manuel Rodriguez
34b62cc43e
Fix panic in hosts/{id}/mdm endpoint when host does not have MDM data (#9123) 2022-12-27 16:22:37 -03:00
Lucas Manuel Rodriguez
e1bbcfcfda
Generate audit logs for activities (#9001)
* Generate audit logs for activities

* Fix config tests

* Fix TestGetConfig/IncludeServerConfig

* Fix use of AddAttributes in results only

* Stream activities asynchronously

* Fix index and add logging

* Revert change

* Documentation fixes
2022-12-23 19:04:13 -03:00
Lucas Manuel Rodriguez
39f1029390
Make activities typed and auto-generate docs for each type (#9069)
* Make activities type and auto-generate docs for each type

* Add pageOrderInSection to not break site

* Add do not edit note to generated file

* Add make generate-doc step

* Fix main merge
2022-12-23 13:05:16 -03:00
Sharvil Shah
082bf024ea
docs update (#9104) 2022-12-23 01:28:56 +05:30
Noah Talerman
6533c59d1b
In docs, link to reference for managing osquery extensions (#9099)
- Update "Manage extensions" from 🔜 to  
- Add a "Osquery extensions" section to Using Fleet > Orbit doc page
- Link to reference page in docs
2022-12-22 12:32:06 -05:00
Sharvil Shah
72aaf14a3b
docs for orbit extensions autoupdate (#9103)
Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2022-12-22 22:51:26 +05:30
RachelElysia
cf52f189c5
Fleet UI: Delete host flow prevent re-enrollment information (#9044) 2022-12-16 16:43:08 -05:00
Gabriel Hernandez
3c136e3f47
Add MDM Card to Windows and All Dashboards and change mdm data source on host details page (#8960) 2022-12-16 15:12:11 -06:00
Frank Sievertsen
7ebb97cd70
Fire automations for hosts that failed before automation enabled (#9028) 2022-12-16 22:00:54 +01:00
Eric
45da29cfb5
Change email addresses used in examples to @example.com (#9026) 2022-12-14 16:13:12 -06:00
Martin Angers
f18a320bd5
Add command get mdm-apple-bm to fleetctl (#8949) 2022-12-12 15:45:53 -05:00
Mike McNeil
8b762c5622
Add more color to FAQ + propose a naming decision (#8674) 2022-12-10 23:56:24 -06:00
Frank Sievertsen
a228dcb170
Add critical policies as a premium feature (#8959)
* add premium feature critical policies

* update documentation

* add test for premium-only field

* update old change-file

* test policies more comprehensively

* also test team policies

* PATCH returns wrong timestamp, updating test
2022-12-09 19:23:08 +01:00
Roberto Dip
e68535d468
report errors that can occur during file carving (#8972)
related to https://github.com/fleetdm/fleet/issues/8117
2022-12-09 13:21:30 -03:00
Sharvil Shah
9ee09cd133
Document usage of command_line_flags (#8398) 2022-12-07 13:01:03 +05:30
Martin Angers
d4a3730610
Add new configuration options for Apple Business Manager (#8886) 2022-12-06 15:50:56 -05:00
Frank Sievertsen
e0766d21a3
Add ability to mark policy as critical. (#8896) 2022-12-06 15:59:20 +01:00
Martin Angers
866829dbfa
Implement fleetctl get mdm-apple (#8786) 2022-12-05 11:35:45 -05:00
Katheryn Satterlee
f5a417d244
Move Orbit docs (#8403)
* Move Orbit docs

* Update docs/Deploying/fleetctl-agent-updates.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update docs/Using-Fleet/Adding-hosts.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update docs/Using-Fleet/Adding-hosts.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update docs/Using-Fleet/Adding-hosts.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update docs/Using-Fleet/Adding-hosts.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update docs/Using-Fleet/Adding-hosts.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update docs/Using-Fleet/Orbit.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update docs/Using-Fleet/Orbit.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update docs/Using-Fleet/Orbit.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update docs/Using-Fleet/Orbit.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update docs/Using-Fleet/Orbit.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Applying grammatical edits

* Fix relative links

* Fix relative links

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>
Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
2022-11-18 08:56:52 -06:00
Mo Zhu
3a7dd42f11
Link to our maintained tables (#8675) 2022-11-11 13:42:05 -08:00
Katheryn Satterlee
c413c9d162
Improve agent options documentation (#8666)
* Improve agent options documentation

* Update FAQ.md
2022-11-10 17:51:57 -06:00
Katheryn Satterlee
d04d65d725
Add yaml flag to code blocks (#8540)
Added `yaml` tag to appropriate code blocks to ensure consistent formatting. Also fixes display issue in `features.additional_queries`.
2022-11-09 10:29:31 -06:00
Guillaume Ross
a42dd708d6
Adding troubleshooting info about full disk access (#7938)
* Adding troubleshooting info about full disk access

* Apply suggestions from code review

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>
2022-11-09 16:14:44 +00:00
Frank Sievertsen
0dbbad8e10
Exclude windows servers from mdm aggregation and lists (#8585) 2022-11-08 10:29:40 +01:00
Frank Sievertsen
4743d31870
Support low_disk_space filter for endpoint /labels/{id}/hosts (#8598) 2022-11-08 09:19:34 +01:00
Martin Angers
7fbe394b94
Ingest disk encryption flag for hosts, return in GET /hosts/{id} endpoint (#8526) 2022-11-02 15:44:02 -04:00
Frank Sievertsen
baa1ddc0f2
Add MDM detection for windows and mdm endpoints (#8479) 2022-11-01 18:22:07 +01:00
Roberto Dip
2f6b1523de
add a faq entry about slow rollout of features (#8470)
* add a faq entry about slow rollout of features

* Update docs/Using-Fleet/FAQ.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>
2022-10-31 13:40:24 -05:00
Eric
52da2a3108
change relative links in documentation (#8441) 2022-10-26 18:26:49 -05:00
Roberto Dip
defe1d03f1
add documentation about token rotation (#8435)
Related to #6064 and #6993 this adds documentation about token rotation.
2022-10-26 11:51:28 -03:00
Katheryn Satterlee
1f39b73b2d
Docs: Add information related to #8443 (#8445)
* Add information for 8443

* Add information for 8443
2022-10-25 16:07:22 -05:00
Martin Angers
229b349118
Fix more hosts filters-related API docs (#8335) 2022-10-25 08:17:51 -04:00
Katheryn Satterlee
b2a9c78c92
Update instructions for osquery configuration (#8190)
* Update instructions for osquery configuration

Removed a note that caused some confusion and made a quick editing pass.

* Update docs/Using-Fleet/Adding-hosts.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update docs/Using-Fleet/Adding-hosts.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update docs/Using-Fleet/Adding-hosts.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update docs/Using-Fleet/Adding-hosts.md

osqueryd is correct there.

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update docs/Using-Fleet/Adding-hosts.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update docs/Using-Fleet/Adding-hosts.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

* Update docs/Using-Fleet/Adding-hosts.md

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>

Co-authored-by: Chris McGillicuddy <108031970+chris-mcgillicuddy@users.noreply.github.com>
2022-10-24 13:58:58 -05:00
gillespi314
881194b3b4
Add orbit version and osquery version usage statistics (#8229) 2022-10-24 11:12:56 -05:00
Martin Angers
7cfec513a3
Fix docs inaccuracies for List Hosts endpoint (#8319) 2022-10-24 08:46:23 -04:00
Katheryn Satterlee
a2204cf506
Add FAQ for team additional_queries (#8380)
Added information to the FAQ about the loss of additional_queries for teams after update to 4.20.0`
2022-10-21 17:29:46 -04:00
RachelElysia
0faa546f17
Fleet UI: Consistency between global and team agent options forms (#8334) 2022-10-20 13:39:47 -04:00
Eric
6b211faa74
Change h3 headings to h2 (#8318)
- Changed the h3 headings to h2 headings in `log-destination.md` so they appear in the "On this page" links on fleetdm.com/docs.
2022-10-18 15:48:44 -04:00
Noah Talerman
c576b9de20
Update log destination docs (#8242)
- Rename "Osquery logs" page to "Log destinations"
- Use exact product names in the log destination docs
- Move anchor links to the top of the page so that fleetdm.com/docs/log-destinations renders a sidebar
2022-10-18 13:18:15 -04:00
Frank Sievertsen
a2c47cf4f4
add host_display_name to live query rows (#8251) 2022-10-17 15:52:25 +02:00
Katheryn Satterlee
58e12ef367
Update /hosts/identifier response (#8244) 2022-10-14 16:22:04 -05:00
gillespi314
59876d37ea
Add usage statistics to measure policy violations (#8199) 2022-10-14 13:55:37 -05:00
Katheryn Satterlee
62981480ae
Add orbit update url (#8047)
Added information about where orbit gets updates to FAQ.
2022-10-14 10:20:13 -05:00
Katheryn Satterlee
412375b21e
Update code signing instructions (#7950)
Added context about update channel to note about orbit's install path.
2022-10-14 10:19:02 -05:00
Martin Angers
d321cfc68e
Add inherited policies to the team's list policies response payload (#8068) 2022-10-12 08:35:36 -04:00
Juan Fernandez
351d2c93c4
Add new page explaining how osquery children process are terminated (#8134)
Add new page explaining how osquery children process are terminated
2022-10-11 14:09:56 -04:00