From d3cab6fa7cd56eb39afbb0ae69eb1cd68934f8b2 Mon Sep 17 00:00:00 2001 From: Dale Ribeiro Date: Tue, 29 Apr 2025 15:27:23 -0400 Subject: [PATCH] Updated human-device mapping deprecation info (#28653) # Checklist for submitter If some of the following don't apply, delete the relevant line. - [ ] 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 - [ ] A detailed QA plan exists on the associated ticket (if it isn't there, work with the product group's QA engineer to add it) - [ ] 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. --- docs/REST API/rest-api.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/docs/REST API/rest-api.md b/docs/REST API/rest-api.md index b3241c1287..ccaec2e25f 100644 --- a/docs/REST API/rest-api.md +++ b/docs/REST API/rest-api.md @@ -2241,8 +2241,6 @@ None. - [Transfer hosts to a team by filter](#transfer-hosts-to-a-team-by-filter) - [Turn off MDM for a host](#turn-off-mdm-for-a-host) - [Batch-delete hosts by filter or ids](#batch-delete-hosts-by-filter-or-ids) -- [Get human-device mapping](#get-human-device-mapping) -- [Update custom human-device mapping](#update-custom-human-device-mapping) - [Get host's device health report](#get-hosts-device-health-report) - [Get host's mobile device management (MDM) information](#get-hosts-mobile-device-management-mdm-information) - [Get mobile device management (MDM) summary](#get-mobile-device-management-mdm-summary) @@ -3049,7 +3047,7 @@ Returns the information of the specified host. > - `fleet_desktop_version: ""` means this agent is a fleetd agent but does not have fleet desktop > - `scripts_enabled: null` means this agent is not a fleetd agent, or this agent is version <=1.23.0 which is not collecting the scripts enabled info -> Note: [Get human-device mapping](https://github.com/fleetdm/fleet/blob/62dc32454f6a40e81fe229abdfc370d3bf7a56c6/docs/REST%20API/rest-api.md?plain=1#L3518) and [Update custom human-device mapping endpoints](https://github.com/fleetdm/fleet/blob/62dc32454f6a40e81fe229abdfc370d3bf7a56c6/docs/REST%20API/rest-api.md?plain=1#L3564) are deprecated. End user information is available as part of the [Get host](#get-host) endpoint. +> Note: [Get human-device mapping](https://github.com/fleetdm/fleet/blob/62dc32454f6a40e81fe229abdfc370d3bf7a56c6/docs/REST%20API/rest-api.md?plain=1#L3518) and [Update custom human-device mapping endpoints](https://github.com/fleetdm/fleet/blob/62dc32454f6a40e81fe229abdfc370d3bf7a56c6/docs/REST%20API/rest-api.md?plain=1#L3564) are deprecated as of Fleet 4.67.0. They are maintained for backwards compatibility. Please use the [Get host](#get-host) endpoint to get human-device mapping. ### Get host by identifier