mirror of
https://github.com/fleetdm/fleet
synced 2026-05-24 09:28:54 +00:00
6a3578ce46
Discussed at https://macadmins.slack.com/archives/C0214NELAE7/p1769719765777279 - The endpoints for marking a device as unmanaged and sending an unmanage command were deprecated and no longer work. The endpoint for looking up a device by serial number was also deprecated, so I've proactively updated it. - The whole story is now refactored and simplified. - Also fixed a link in the `tines` README.
41 lines
1.9 KiB
Markdown
41 lines
1.9 KiB
Markdown
# Tines Stories
|
|
|
|
## Best practices
|
|
|
|
These are best practices to be followed by Fleeties when creating and sharing Stories.
|
|
|
|
- Include a note with what credentials/resources need to be set before running.
|
|
- Remove your email from the monitoring section.
|
|
- If actions are device-specific, prefix the Story with the platform. Examples:
|
|
- `windows-story.json`
|
|
- `mac-update.json`
|
|
- `apple-device-location.json` — If the command applies to more than just Macs, use `apple` as the prefix.
|
|
- After exporting, open the .json file and:
|
|
- Double-check to make sure your Fleet email (or any other confidential information) isn't in the contents.
|
|
- Add an empty newline at the bottom of the file.
|
|
|
|
|
|
## [Apple device location](apple-device-location.json)
|
|
|
|
A custom MDM command sent through Fleet to get a device's location. It pauses for 30 seconds after sending the command, so that the device can report back its location before Fleet attempts to retrieve it.
|
|
|
|
A device needs to be [locked](#lock-commands) (known as "Lost Mode" in the Apple world) before the location can be requested.
|
|
|
|
Apple's documentation for this command can be found at [Device Location](https://developer.apple.com/documentation/devicemanagement/device-location-command).
|
|
|
|
Originally created for `customer-reedtimmer`.
|
|
|
|
|
|
## [Lock commands](lock-commands.json)
|
|
|
|
Fleet API commands to lock and unlock hosts.
|
|
|
|
Originally created for `customer-reedtimmer`.
|
|
|
|
## [MDM Migration (Jamf Pro)](mdm-migration-jamf-pro.json)
|
|
|
|
Used when migrating from Jamf Pro to Fleet. This receives the migration web hook from Fleet, looks up that serial number in Jamf Pro via Jamf's API, then sends an unenroll command from Jamf.
|
|
|
|
## [Import IdP users](import-idp-users.json)
|
|
|
|
An example workflow for mapping Fleet hosts to the associated user in asset management. This workflow iterates over hosts in Fleet, uses the Oomnitza API to retrieve the assigned user, and updates Fleet's device mapping with the correct user.
|