Commit Graph
183 Commits
Author SHA1 Message Date
Victor Lyuboslavsky c3efefa44a Updated locked_host activity docs. (#19792)
#19545
Updated locked_host activity docs.
2024-06-17 11:54:56 -05:00
Noah Talerman d7394aae6b Device management > Setup and Commands docs: iOS/iPadOS (#19590)
- Update "Setup" and "Commands" doc pages to mention iOS and iPadOS.
2024-06-12 18:30:46 -04:00
Noah Talerman 08c5867260 Update segment hosts (teams) docs (#19589)
- Add Fleet's best practice
2024-06-11 17:50:33 -04:00
Noah Talerman 6aef9520e9 MDM setup docs: APNs and ABM in the UI (#19463) 2024-06-07 14:33:00 -07:00
Rachael Shaw 97cc5d17ea Remove "available in Fleet Premium" note from scripts permissions docs (#19492)
Scripts are available to free users.
2024-06-06 11:15:56 -05:00
Marko Lisica 5ff86f0b8e Software permissions changes (#19405)
Adding new rows to manage access table to reflect new permissions added
with #14921
2024-06-06 10:12:12 -05:00
Roberto Dip 8bc79f8478 add documentation for edge case scenario (#19496)
for #16857
2024-06-05 13:55:53 -03:00
Marko Lisica 83edd57eca Update scripts docs (#19419)
With #17321 we added support for `zsh` interpreter and we want to
document this.

@spokanemac had a hard time understanding that we don't support `.zsh`
extension while dogfooding the feature. I added note to explain that
user must create `.sh` file with `/bin/zsh` interpreter specified.
2024-06-04 08:17:00 +02:00
Gabriel Hernandez af88da49bc Merge branch 'main' into feat-software-self-service 2024-05-31 18:15:19 +01:00
Eric 7b1a56f752 Docs: fix broken link (#19345)
Changes:
- Fixed a broken link on the "macOS setup experience" docs page.
2024-05-30 17:12:40 -05:00
Noah Talerman e26f1af309 Fix MDM setup docs (#19343)
- You only need the APNs cert for renewing APNs
2024-05-30 18:04:57 -04:00
Martin Angers 3e2f5e97e5 Regenerate docs 2024-05-29 16:15:51 -04:00
Martin Angers 6b9fecf172 Fix conflicts 2024-05-29 16:08:51 -04:00
Andrwe Lord Weber a8a1054b36 add linux platform tuxedo (#19011)
# Changes

I'm running orbit based osqueryd on a laptop with [Tuxedo
OS](https://www.tuxedocomputers.com/en/TUXEDO-OS_1.tuxedo#).
This OS identifies its platform via osquery as `tuxedo` and is therefore
not recognized by the Fleet server:

```json
{
    "err": "unrecognized platform",
    "hostID": 76,
    "level": "error",
    "platform": "tuxedo",
    "ts": "2024-05-15T13:17:34.513509387Z"
}
```

This causes policy and scheduled queries to not being run on my system.
With this PR Im adding `tuxedo` to all occurrences found when searching
for `kali`.

Additionally pre-commit checks were failing for me locally as it could
not find the hook-id `RuboCop`. This could be solved by using `rubocop`
instead.
Afterwards all pre-commit checks succeeded locally.

# Checklist for submitter

- [x] Added/updated tests

Signed-off-by: Andreas Ulm <andreas.ulm@prisma-capacity.eu>
2024-05-29 13:54:07 -03:00
Martin Angers 1b9f5a79a5 Software SS: activities (#19292) 2024-05-28 10:44:06 -04:00
Noah Talerman 95910d3e43 Update docs: Maintenance windows (Fleet in your calendar) (#19232)
Doc updates for the "Maintenance windows (Fleet in your calendar)" story
(#17230)
2024-05-23 17:07:53 -04:00
1dc53cfa93 Update Fleet-UI.md (#19135)
Added a note to warn UI users against using dot notation for column
names in their queries.

Closes https://github.com/fleetdm/confidential/issues/6506

(@dherder, please check my interpretation of the issue.)

---------

Co-authored-by: Dave Herder <27025660+dherder@users.noreply.github.com>
Co-authored-by: Rachael Shaw <r@rachael.wtf>
2024-05-23 15:45:27 -05:00
Noah TalermanandRachael Shaw 7bb215a0b1 Cleanup docs: Pre-fill and lock local account creation screen during out-of-the-box macOS setup (#19225)
Docs changes for "Pre-fill and lock local account creation screen during
out-of-the-box macOS setup" story (#9147)

See comment here for more context:
https://github.com/fleetdm/fleet/issues/9147#issuecomment-2127391460

---------

Co-authored-by: Rachael Shaw <r@rachael.wtf>
2024-05-23 10:33:09 -05:00
Noah Talerman 2406ab28cf Update Supported host operating systems (#19217)
- At least 2 of Fleet's largest customers use Windows Server 2012
2024-05-22 17:56:28 -04:00
Roberto Dip 8d9dcafbbc Merge remote-tracking branch 'origin/main' into feat-software-installers 2024-05-16 17:23:39 -03:00
Noah Talerman 1077255791 Vulnerability processing docs: Add VS Code extensions (#19070)
- Document that Fleet now detects vulns on VS Code extensions
2024-05-16 15:41:17 -04:00
Lucas Manuel Rodriguez bb310e685d Support Ubuntu 24.04 with Xorg (by detecting user's DISPLAY environment variable) (#18996)
#18925 (Should also fix #17660.)

Tests:
- Ubuntu 22.04.2
	- Wayland
		- Works with chrome  
		- Doesn't work with Firefox. 
	- Xorg
		- Works with Chrome.  
		- Works with Firefox. 
- Ubuntu 24.04
	- Wayland
		- Doesn't work with Chrome. 
		- Doesn't work with Firefox. 
- Xorg (when using Xorg it defaults to `DISPLAY=:1`, and with the
changes in this PR it works):
		- Works with Chrome.  
		- Works with Firefox.  
---

How to change between Wayland and Xorg:

- Set `WaylandEnable=false` in `/etc/gdm3/custom.conf` and reboot.

---

How to determine what's running:
```sh
$ loginctl
SESSION  UID USER SEAT  TTY 
      2 1000 luk  seat0 tty2
     c2 1000 luk        

$ loginctl show-session 2 -p Type
# will output
Type=wayland
or
Type=x11
```
---

- [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] 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.
- [x] Auto-update manual QA, from released version of component to new
version (see [tools/tuf/test](../tools/tuf/test/README.md)).
2024-05-16 08:39:30 -03:00
Roberto Dip 1ef19e4ff2 Merge remote-tracking branch 'origin/main' into feat-software-installers 2024-05-15 19:55:02 -03:00
Noah Talerman af6129cc16 Update Windows MDM setup article and MDM setup docs (#18981)
- Update docs to reflect that, in order to use Autopilot, you must have
one Intune license per host (from #fleetdm/confidential#6283)
- Make "MDM setup" doc page cross platform
- Cut content
2024-05-15 15:34:58 -04:00
Sam Pfluger 1b44927968 Fix broken markdown formatting (#18999)
Closes #18985 
...
2024-05-14 17:40:05 -05:00
Luke Heath 15ba5f3a20 Update supported browsers (#18960) 2024-05-13 17:10:21 -05:00
Rachael Shaw d1791518a4 Docs: Reduce words in a note (#18884)
published to nvd -> published
2024-05-09 13:43:11 -05:00
Jahziel Villasana-EspinozaandMartin Angers c88a7cf6b0 feat: software added and deleted global activities (#18798)
> Related issue: #18330 

# 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://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)
- [x] Added/updated tests
- [x] Manual QA for all new/changed functionality

## Notes
- ~I added an `includeTitle bool` parameter to
`ds.GetSoftwareInstallerMetadata`. This allows for the title of the
software (from the `software_titles` page) to be fetched in
`svc.DeleteSoftwareInstaller` without an additional call to the DB.~ We
wound up deciding to just fetch the title every time.

---------

Co-authored-by: Martin Angers <martin.n.angers@gmail.com>
2024-05-08 10:08:28 -04:00
Marko Lisica 643a3eb34a Docs: Reminder for APNs and ABM renewal (#16919)
Improve docs for APNs renewal:
- Learn users that they should check that Common name (CN) of
certificate in APNs portal should match one used in Fleet
2024-05-07 14:04:06 -04:00
Roberto Dip e5283ef2a8 Merge remote-tracking branch 'origin/main' into feat-software-installers 2024-05-07 13:37:29 -03:00
Martin Angers 7bb726ba8e Create and return upcoming/past host activities for software installs (#18772) 2024-05-07 11:28:16 -04:00
Rachael ShawandMarko Lisica 0bd2f00495 Permissions: Resend a configuration profile (#18724)
Fresh PR to avoid product design PRs messing with the PR open time KPI
(previously https://github.com/fleetdm/fleet/pull/17841)

Co-authored-by: Marko Lisica <83164494+marko-lisica@users.noreply.github.com>
2024-05-02 17:06:36 -05:00
Rachael ShawandEric 895d4bc2f7 Use "Fleet's agent (fleetd)" naming in the docs (#18138)
For #16512

---------

Co-authored-by: Eric <eashaw@sailsjs.com>
2024-04-29 11:12:03 -05:00
Marko Lisica 28e501cd3c Docs change: Use new Software Update (DDM) for macOS Sonoma (14) and higher (#17487)
Docs changes related to:

- #17295
2024-04-25 13:19:03 -05:00
Rachael Shaw 63d91526d2 A few capitalization fixes in the docs (#18416)
Sentence-casing.
2024-04-18 16:45:55 -05:00
Lucas Manuel Rodriguez e7f61305a9 New APIs to add/remove manual labels to/from a host (#18283)
#16767

To create a manual label:
```sh
cat labels.yml
---
apiVersion: v1
kind: label
spec:
  name: Manually Managed Example
  label_membership_type: manual
  hosts:
    - lucass-macbook-pro.local
```

To add/delete a manual label to/from a host:
```
curl -k -v -X POST -H "Authorization: Bearer $TEST_TOKEN" https://localhost:8080/api/latest/fleet/hosts/1/labels -d '{"labels": ["Manually Managed Example"]}'

curl -k -v -X DELETE -H "Authorization: Bearer $TEST_TOKEN" https://localhost:8080/api/latest/fleet/hosts/1/labels -d '{"labels": ["Manually Managed Example"]}'
```

API draft changes: https://github.com/fleetdm/fleet/pull/16979/files
Figma with error strings:
https://www.figma.com/file/JiWoAiuHlkt76s3o3Uyz6h/%2316767-API-endpoint-for-updating-a-host's-manual-labels?type=design&node-id=2-130&mode=design&t=pxRPhrn6E1bOCrEd-0

- [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)
~- [ ] Added support on fleet's osquery simulator `cmd/osquery-perf` for
new osquery data ingestion features.~
- [X] Added/updated tests
- ~[ ] 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`).~
- [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)).~
2024-04-16 06:37:58 -03:00
George Karr fa5e224a4a Add feature to resend MDM configuration profiles (#18280)
Includes PRs #18111, #18212, and #18271
2024-04-15 16:48:42 -05:00
Sarah Gillespie ecdcb7c2fb Add activity item for resend configuration profile (#18271) 2024-04-15 14:18:09 -05:00
Victor Lyuboslavsky 1dc1e23b65 Removed current_instance_checks from docs. (#18186)
#16661 

Removed current_instance_checks from docs.
2024-04-15 10:25:04 -05:00
Noah TalermanandRachael Shaw 0888cdb8de Update end user auth and SSO docs (#18127)
Docs improvements uncovered during
[dogfooding](https://github.com/fleetdm/confidential/issues/2506):

- Update end user auth docs to link to SSO docs. So the user knows what
do to get the necessary info from their IdP (create an Okta/GW app)
- Cut content from SSO docs and move Okta and Google Workspace to top
level headers
- "IDP" => "IdP"
- Use **bold** styling to indicate UI elements in docs (instead of
_italics_)

---------

Co-authored-by: Rachael Shaw <r@rachael.wtf>
2024-04-12 16:39:56 -05:00
Rachael Shaw 57a28ed18d #14916 Configuration change: Host status webhook per-team (#15612)
Adds `webhook_settings.host_status_webhook` options to team config for
#14916.

Also updated conceptual docs that reference this config (and cut down
some content to make room).
2024-04-10 15:28:17 -05:00
Noah Talerman 65ab7a896d Remove duplicate DEP profile example (#18114)
- Remove duplicate
- Add redirect so the example profile can move later w/o breaking links
- Update links
2024-04-09 09:47:47 -04:00
Roberto Dip 02f4d5c134 run make generate-docs for DDM activities (#17888) 2024-04-08 13:19:56 -03:00
Brock WaltersandVictor Lyuboslavsky 8d0d309a1f Update macos-install-wine.sh with codesign warning (#17982)
The Wine developer does have an Apple Develeoper certificate but the
"Wine Stable" app bundle is not code-signed or notarized post-install &
disables Gatekeeper for the install. This adds a warning to the script
user about the app not being signed. post-install

---------

Co-authored-by: Victor Lyuboslavsky <victor.lyuboslavsky@gmail.com>
2024-04-05 16:14:57 -04:00
Noah Talerman 4ae6b362b9 Cut content from CIS Benchmarks (#17887)
- Remove "Overview" header 
- Cut "MDM required" and "Fleetd required" sections
- Move "How to add" above "Requirements."
- Cut the "Audit vs. remediation" section
2024-04-01 11:34:39 -04:00
Katheryn Satterlee 2479c21622 Update fleetctl-CLI.md (#17975) 2024-04-01 08:53:00 -05:00
Dave Herder f4ab2125cc Update enroll-hosts.md (#17834) 2024-03-29 16:05:46 -07:00
George Karr 0752993c93 Update MDM-macOS-setup.md (#17807) 2024-03-26 12:36:38 -05:00
Rachael ShawandNoah Talerman 44c3ba83e5 Reduce CIS benchmark documentation page contents (#17108)
+ Move specific CIS benchmark details into READMEs
+ Reduce content in Using Fleet > CIS Benchmarks

---------

Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
2024-03-21 15:03:14 -05:00
Dante Catalfamo bd3e775e67 Windows MDM Fix Manual Detection (#17721)
#15565 

Replace the use of the isFederated registry key with a keys that check
for AAD (Azure Active Directory, now Entra ID)

Federated enrollment (`isFederated`) seems to be when windows uses a
Discovery MDM endpoint to get its policy and management endpoint
configuration. This is always the case when a client is enrolled with
fleet, so installations always show up as automatic.

It's being replaced by a different key, `AADResourceID`, which appears
to identify the resource that controls the automated deployment. In my
tests it only appears to be populated when the computer is enrolled
through automated deployments. This key appears on both Windows 10 and
11.

There is a similar key, `AADTenantID`, which appears to identify the
client (tenant) to the Azure cloud. I haven't seen this ID in our
systems, so it is likely exclusively used in Azure. Both this key and
`AADResourceID` seem to always be set at the same time, so we only
check for the `AADResourceID`.

I've also added documentation on the registry keys I've analyzed for future reference.
2024-03-21 15:09:05 -04:00