jamf/Setup-Manager
1
0
Fork 0
mirror of https://github.com/jamf/Setup-Manager.git synced 2026-02-03 14:13:24 +00:00
Code Issues 37 Actions Packages Projects Releases Wiki Activity

updated for v1.2beta3

Browse Source
This commit is contained in:
Armin Briegel
2025-03-05 14:12:35 +01:00
parent 89d9033c15
commit 407d7f32dc
4 changed files with 29 additions and 24 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
ChangeLog.md
View File

@@ -1,7 +1,7 @@
# Setup Manager - Change Log # Setup Manager - Change Log
v1.2beta2 v1.2beta3
(2025-02-26) (2025-03-05)
### New Features ### New Features
- Setup Manager can send [webhooks](Docs/Webhooks.md) on start and finish, (#70) - Setup Manager can send [webhooks](Docs/Webhooks.md) on start and finish, (#70)
@@ -16,6 +16,10 @@ v1.2beta2
- `message` and help:`message` now interpret [markdown formatting](ConfigurationProfile.md#markdown) (#46) - `message` and help:`message` now interpret [markdown formatting](ConfigurationProfile.md#markdown) (#46)
### Fixes and Improvements ### Fixes and Improvements
- (beta3) return key connected to button in Setup Manager interface, (#93)
- (beta3) added an `event` field to standard webhook data, (#94)
- (beta3) "facts" in Teams message are no longer in random order
- (beta3) improved reliablity of running at login window (#77)
- (beta2) an empty `userEntry` dictionary in the profile no longer chokes the UI (#85) - (beta2) an empty `userEntry` dictionary in the profile no longer chokes the UI (#85)
- (beta2) MDM check more resilient to certain profile configs (#87) - (beta2) MDM check more resilient to certain profile configs (#87)
- (beta2) the `name` field in WebHook data was shortened from `SetupManagerFinished` and `SetupManagerStarted` to `Finished` and `Started` - (beta2) the `name` field in WebHook data was shortened from `SetupManagerFinished` and `SetupManagerStarted` to `Finished` and `Started`

2
Docs/FAQ.md
View File

@@ -20,7 +20,7 @@ There can be many causes for this. A few common causes are:
No. No.
Setup Manager will run fine without Jamf Connect. You can even build 'single-touch' style workflows with Setup Manager without Jamf Connect. Some features, such as pre-assigning a device to a specific user require Jamf Connect, though. Setup Manager will run fine without Jamf Connect. You can even build 'single-touch' style workflows with Setup Manager without Jamf Connect. Some workflows, such as pre-assigning a device to a specific user require Jamf Connect, though.
## How can I use the icon for an app before the app is installed? ## How can I use the icon for an app before the app is installed?

38
Docs/Webhooks.md
View File

@@ -48,17 +48,18 @@ For the `started` webhook, Setup Manager attaches this data:
```json ```json
{ {
"name": "Started", // string "name": "Started", // string
"timestamp": "2025-01-14T15:11:28Z", // time setup manager started, date as string, iso8601 "event": "com.jamf.setupmanager.started" // string
"started": "2025-01-14T15:11:27Z", // time webhook was sent, date as string, iso8601 "timestamp": "2025-01-14T15:11:28Z", // time setup manager started, date as string, iso8601
"modelName": "MacBook Air", // string "started": "2025-01-14T15:11:27Z", // time webhook was sent, date as string, iso8601
"modelIdentifier": "Mac14,2", // string "modelName": "MacBook Air", // string
"macOSBuild": "24C101", // string "modelIdentifier": "Mac14,2", // string
"macOSVersion": "15.2.0", // string "macOSBuild": "24C101", // string
"serialNumber": "ABCD1234DE", // string "macOSVersion": "15.2.0", // string
"setupManagerVersion": "1.2" // string "serialNumber": "ABCD1234DE", // string
"jamfProVersion": "11.13.0" // optional, only for Jamf Pro, string "setupManagerVersion": "1.2" // string
"jssID": 1234 // optional, only when `jssID` is set in profile, string "jamfProVersion": "11.13.0" // optional, only for Jamf Pro, string
"jssID": 1234 // optional, only when `jssID` is set in profile, string
} }
``` ```
@@ -66,20 +67,21 @@ The data for the `finished` webhook includes the same as above, with some additi
```json ```json
{ {
"name": "Finished", // string "name": "Finished", // string
"duration": 53, // integer "event": "com.jamf.setupmanager.finished" // string
"finished": "2025-01-14T15:12:20Z", // time Setup Manager finished, date as string, iso8601 "duration": 53, // integer
"computerName": "Mac-123456" // computer name, only when set through Setup Manager "finished": "2025-01-14T15:12:20Z", // time Setup Manager finished, date as string, iso8601
"userEntry": { // data entered by the user "computerName": "Mac-123456" // computer name, only when set through Setup Manager
"userEntry": { // data entered by the user
"department": "IT", "department": "IT",
"computerName": "IT-ABC123", "computerName": "IT-ABC123",
"userID": "a.b@example.,com", "userID": "a.b@example.,com",
"assetTag": "abc54321" "assetTag": "abc54321"
}, },
"enrollmentActions": [ // array of enrollmentActions with status "enrollmentActions": [ // array of enrollmentActions with status
{ {
"label": "Microsoft 365", "label": "Microsoft 365",
"status": "finished" // status: "finished" or "failed" "status": "finished" // status: "finished" or "failed"
}, },
{ {
"label": "Google Chrome", "label": "Google Chrome",

5
README.md
View File

@@ -32,8 +32,8 @@ Setup Manager provides:
- user initiated enrollment - user initiated enrollment
- handsfree deployment with AutoAdvance (beta) - handsfree deployment with AutoAdvance (beta)
- customized branding - customized branding
- localized interface and custom text - localized interface and localizable custom text
- support for Jamf Pro and Jamf School - works with Jamf Pro and Jamf School
## Installation and Configuration ## Installation and Configuration
@@ -63,7 +63,6 @@ Setup Manager requires macOS 12.0.0 or higher. It will work only with Jamf Pro o
- Setup Manager will **_not_** launch at enrollment with Auto-Advance enabled, use the option to run at login window - Setup Manager will **_not_** launch at enrollment with Auto-Advance enabled, use the option to run at login window
- Setup Manager may **_not_** launch or launch and quit quickly when you disable _all_ Setup Assistant screens, leave at least one Setup Assistant option enabled, or use the option to run at login window - Setup Manager may **_not_** launch or launch and quit quickly when you disable _all_ Setup Assistant screens, leave at least one Setup Assistant option enabled, or use the option to run at login window
- Policies that are triggered by `enrollmentComplete` may delay or even disrupt Setup Manager running from Prestage/Automated Device Enrollment. Disable or unscope policies triggered by `enrollmentComplete` on devices using Setup Manager. - Policies that are triggered by `enrollmentComplete` may delay or even disrupt Setup Manager running from Prestage/Automated Device Enrollment. Disable or unscope policies triggered by `enrollmentComplete` on devices using Setup Manager.
- In some deployments, Setup Manager attempts to start while Jamf Pro is still installing. Try adding a 30-60 second `wait` action as the first action.
--- ---