Menu Close

Setup Your Mac (1.6.0) via swiftDialog

Update: February 2023

Help mitigate zero-day attacks with the new “Outdated OS Action” in Setup Your Mac (1.7.0) which easily allows Mac Admins to specify a minimum OS version


Setup Your Mac (1.6.0) introduces “live” Jamf Pro policy validation to answer the question:

“I can see it’s installed … is it running?

Setup Your Mac (1.6.0) screencast (01:48; no audio; edited for time)

Introduction

Apple’s Automated Device Enrollment helps to streamline Mobile Device Management (MDM) enrollment and device Supervision during activation, enabling IT to manage enterprise devices with “zero touch.”

Setup Your Mac aims to simplify initial device configuration by leveraging swiftDialog and Jamf Pro Policy Custom Events to allow end-users to self-complete Mac setup post-enrollment.

Implementation

While Setup Your Mac was originally designed to be executed via a Jamf Pro Self Service policy, version 1.5.1 introduced additional checks to better execute with the Jamf Pro “Enrollment Complete” policy trigger.

Prior to using Setup Your Mac, we were using Jamf Pro policies triggered by enrollmentComplete (i.e., “Enrollment Complete Immediately after a computer completes the enrollment process”), but the successful execution of these policies was too unreliable for our needs.

Policies with an Enrollment Complete trigger do not run upon completion of enrollment under certain circumstances.

Jamf Pro Known Issues PI100009 - PI-004775

Currently — as can be observed in the first several seconds of the Setup Your Mac screencast — a device is initially considered as “non-compliant” and is only offered two policies:

  1. Setup Your Mac
  2. Update Computer Inventory

The successful execution of Setup Your Mac results in a compliant Mac.

Additionally, we require login to Self Service — including Multi-Factor Authentication — for every other policy; enabling Setup Your Mac at Enrollment Complete would bypass the required user login on the very first policy the user experiences. (See also: Setup Your Mac, please.)

PreStage Enrollments

Thanks to Robert Schroeder for the excellent write-up on using Setup Your Mac with Jamf Pro PreStage Enrollments.

Prerequisites

If the core functionality of Setup Your Mac meets your needs, writing code should not be required.

However, you must be comfortable modifying scripts before implementing this approach in production (i.e., customizing existing settings for your use-case, reading and editing JSON, etc.).

The Jamf Training Catalog, which is free to all Jamf customers, is a great place to start learning the basics.

Configuration

Complete the following steps to provide your users a seamless post-enrollment experience when setting up their new Macs.

A. Conduct a dry-run of the Setup Your Mac script

Complete the following steps on a virtual machine or non-production physical Mac.

  1. Open the macOS Terminal.
  2. Download the latest production version of Setup Your Mac using the following command. (The script will be saved to your Downloads folder as Setup-Your-Mac-via-Dialog-reference.bash):
curl -o ~/Downloads/Setup-Your-Mac-via-Dialog-reference.bash https://raw.githubusercontent.com/dan-snelson/dialog-scripts/main/Setup%20Your%20Mac/Setup-Your-Mac-via-Dialog.bash
  1. Execute the Setup Your Mac script using the following command:
bash ~/Downloads/Setup-Your-Mac-via-Dialog-reference.bash
  1. Observe the output (i.e., This script must be run as root; exiting.)
This script must be run as root; exiting.
  1. Execute the Setup Your Mac script with elevated privileges via sudo !!:
sudo !!
  1. Wait while the latest production version of swiftDialog is automatically installed and the personalized “Welcome” dialog is displayed:
Setup Your Mac (1.6.0) "Welcome" dialog
Setup Your Mac (1.6.0) “Welcome” dialog
  1. After reviewing and interacting with the input fields, click Quit.
  2. Observe the output in Terminal (i.e., WELCOME DIALOG: dan clicked Quit at Welcome dialog):
sudo bash ~/Downloads/Setup-Your-Mac-via-Dialog-reference.bash

Password:
Caffeinating this script (PID: 966)
Setup Assistant is no longer running; proceeding …
Finder & Dock are running; proceeding …
/Users/dan/Downloads/Setup-Your-Mac-via-Dialog-reference.bash: line 112: dialog: command not found
2023-01-07 12:56:11.298 defaults[991:11526] 
The domain/default pair of (/Library/Preferences/com.jamfsoftware.jamf.plist, self_service_app_path) does not exist
2023-01-07 12:56:11 - *** Created log file via script ***
2023-01-07 12:56:11 - 

###
# DEBUG MODE | Dialog: v • Setup Your Mac: v1.6.0
###

2023-01-07 12:56:12 - Dialog not found. Installing...
installer: Package name is Dialog
installer: Installing at base path /
installer: The install was successful.
2023-01-07 12:56:23 - swiftDialog version 2.0.1.3814 installed; proceeding...
2023-01-07 12:57:05 - WELCOME DIALOG: dan clicked Quit at Welcome dialog
2023-01-07 12:57:05 - Exiting …
2023-01-07 12:57:05 - De-caffeinate …
2023-01-07 12:57:05 - Attempting to terminate the 'caffeinate' process …
2023-01-07 12:57:05 - (Termination message indicates success.)
/Users/dan/Downloads/Setup-Your-Mac-via-Dialog-reference.bash: line 1117:   968 Terminated: 15          caffeinate -dimsu -w $$
2023-01-07 12:57:05 - Removing /var/tmp/dialogWelcome.PTX …
2023-01-07 12:57:05 - Removing /var/tmp/dialogSetupYourMac.FuI …
2023-01-07 12:57:05 - Removing /var/tmp/dialogFailure.Uuh …
2023-01-07 12:57:05 - Removing default dialog file …
  1. Re-execute the Setup Your Mac script with elevated privileges by pressing the Up Arrow once and then pressing Return.
  2. Populate the input fields and click Continue:
Setup Your Mac (1.6.0) "Welcome" dialog with input fields populated
Setup Your Mac (1.6.0) “Welcome” dialog with input fields populated
  1. Wait while Setup Your Mac runs in Debug Mode (displayed in the bottom, left-hand corner) and observe the expected failures (since Custom Triggers for the Jamf Pro policies have not yet been configured):
Setup Your Mac (1.6.0) “Debug Mode” expected failures
Setup Your Mac (1.6.0) “Failure” dialog with user instructions
Setup Your Mac (1.6.0) "Debug Mode" completionActionOption
Setup Your Mac (1.6.0) “Debug Mode” completionActionOption
  1. Review the client-side Setup Your Mac log file via Console:
open /var/tmp/org.churchofjesuschrist.log 

Note: When Debug Mode is set to true, Jamf Pro policies do not execute (which is why the validation checks fail); review the client-side log for the following:

SETUP YOUR MAC DIALOG: Confirm Policy Execution: DEBUG MODE: Skipping 'run_jamf_trigger
B. Testing Tips

Simulating Failures

When testing Setup Your Mac on an enrolled Mac, you may not observe any failures, even though that’s what you want.

Temporarily replacing some (or all) instances of Info.plist with Info.plist.failed can easily simulate failures.

Simulate failures by replacing Info.plist with Info.plist.failed

Completion Actions

While Debug Mode can prove helpful during initial testing, eventually you’ll want to test-drive real-world scenarios (and, as you can imagine, testing forced-restarts includes some inherent inconvenience).

A trick I stumbled on is to first launch Terminal and elevate to root prior to testing.

With an elevated Terminal, you’ll first be prompted for confirmation to forcibly quit Terminal, which you can cancel and continue testing.

Unexpected Computer Inventory Delay

While testing via Terminal, you may observe the Computer Inventory step taking longer than expected. Type Command k to quit the active dialog and you may find Terminal is requesting access to any number of user-specific items. After responding to each access request, proceed with your testing.

C. Review the default Welcome dialog

The input fields in the “Welcome” dialog are controlled by a single welcomeJSON variable (thanks to Bart Reardon) and you can add, modify or remove fields as required.

Setup Your Mac (1.6.0) “Welcome” dialog

Note: With the exception of Asset Tag, the included input fields are examples only and should be thoroughly tested before being deployed in production.

####################################################################################################
#
# Welcome dialog
#
####################################################################################################

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
# "Welcome" dialog Title, Message and Icon
# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

welcomeTitle="Welcome to your new Mac, ${loggedInUserFirstname}!"
welcomeMessage="To begin, please enter the required information below, then click **Continue** to start applying settings to your new Mac.  \n\nOnce completed, the **Wait** button will be enabled and you'll be able to review the results before restarting your Mac.  \n\nIf you need assistance, please contact the Help Desk: +1 (801) 555-1212."

# Welcome icon set to either light or dark, based on user's Apperance setting (thanks, @mm2270!)
appleInterfaceStyle=$( /usr/bin/defaults read /Users/"${loggedInUser}"/Library/Preferences/.GlobalPreferences.plist AppleInterfaceStyle 2>&1 )
if [[ "${appleInterfaceStyle}" == "Dark" ]]; then
    welcomeIcon="https://cdn-icons-png.flaticon.com/512/740/740878.png"
else
    welcomeIcon="https://cdn-icons-png.flaticon.com/512/979/979585.png"
fi



# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
# "Welcome" JSON (thanks, @bartreardon!)
# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

welcomeJSON='{
    "title" : "'"${welcomeTitle}"'",
    "message" : "'"${welcomeMessage}"'",
    "icon" : "'"${welcomeIcon}"'",
    "iconsize" : "198.0",
    "button1text" : "Continue",
    "button2text" : "Quit",
    "infotext" : "'"${scriptVersion}"'",
    "blurscreen" : "true",
    "ontop" : "true",
    "titlefont" : "size=26",
    "messagefont" : "size=16",
    "textfield" : [
        {   "title" : "Comment",
            "required" : false,
            "prompt" : "Enter a comment",
            "editor" : true
        },
        {   "title" : "Computer Name",
            "required" : false,
            "prompt" : "Computer Name"
        },
        {   "title" : "User Name",
            "required" : false,
            "prompt" : "User Name"
        },
        {   "title" : "Asset Tag",
            "required" : true,
            "prompt" : "Please enter the seven-digit Asset Tag",
            "regex" : "^(AP|IP)?[0-9]{7,}$",
            "regexerror" : "Please enter (at least) seven digits for the Asset Tag, optionally preceed by either AP or IP."
        }
    ],
  "selectitems" : [
        {   "title" : "Department",
            "default" : "Please select your department",
            "values" : [
                "Please select your department",
                "Asset Management",
                "Australia Area Office",
                "Board of Directors",
                "Business Development",
                "Corporate Communications",
                "Creative Services",
                "Customer Service / Customer Experience",
                "Engineering",
                "Finance / Accounting",
                "General Management",
                "Human Resources",
                "Information Technology / Technology",
                "Investor Relations",
                "Legal",
                "Marketing",
                "Operations",
                "Product Management",
                "Production",
                "Project Management Office",
                "Purchasing / Sourcing",
                "Quality Assurance",
                "Risk Management",
                "Sales",
                "Strategic Initiatives & Programs",
                "Technology"
            ]
        },
        {   "title" : "Select B",
            "values" : [
                "B1",
                "B2",
                "B3"
            ]
        },
        {   "title" : "Select C",
            "values" : [
                "C1",
                "C2",
                "C3"
            ]
        }
    ],
    "height" : "635"
}'

The processing of user input is handled later in the script and will most likely require additional customization, which, again, should be thoroughly tested before being deployed in production (i.e., see code comments UNTESTED, UNSUPPORTED "YOYO" EXAMPLE):

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
# Display Welcome dialog and capture user's input
# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

if [[ "${welcomeDialog}" == "true" ]]; then

    welcomeResults=$( eval "${dialogApp} --jsonfile ${welcomeCommandFile} --json" )

    if [[ -z "${welcomeResults}" ]]; then
        welcomeReturnCode="2"
    else
        welcomeReturnCode="0"
    fi

    case "${welcomeReturnCode}" in

        0)  # Process exit code 0 scenario here
            updateScriptLog "WELCOME DIALOG: ${loggedInUser} entered information and clicked Continue"

            ###
            # Extract the various values from the welcomeResults JSON
            ###

            comment=$(get_json_value_welcomeDialog "$welcomeResults" "Comment")
            computerName=$(get_json_value_welcomeDialog "$welcomeResults" "Computer Name")
            userName=$(get_json_value_welcomeDialog "$welcomeResults" "User Name")
            assetTag=$(get_json_value_welcomeDialog "$welcomeResults" "Asset Tag")
            department=$(get_json_value_welcomeDialog "$welcomeResults" "Department" "selectedValue")
            selectB=$(get_json_value_welcomeDialog "$welcomeResults" "Select B" "selectedValue")
            selectC=$(get_json_value_welcomeDialog "$welcomeResults" "Select C" "selectedValue")



            ###
            # Output the various values from the welcomeResults JSON to the log file
            ###

            updateScriptLog "WELCOME DIALOG: • Comment: $comment"
            updateScriptLog "WELCOME DIALOG: • Computer Name: $computerName"
            updateScriptLog "WELCOME DIALOG: • User Name: $userName"
            updateScriptLog "WELCOME DIALOG: • Asset Tag: $assetTag"
            updateScriptLog "WELCOME DIALOG: • Department: $department"
            updateScriptLog "WELCOME DIALOG: • Select B: $selectB"
            updateScriptLog "WELCOME DIALOG: • Select C: $selectC"



            ###
            # Evaluate Various User Input
            ###

            # Computer Name
            if [[ -n "${computerName}" ]]; then

                # UNTESTED, UNSUPPORTED "YOYO" EXAMPLE
                updateScriptLog "WELCOME DIALOG: Set Computer Name …"
                currentComputerName=$( scutil --get ComputerName )
                currentLocalHostName=$( scutil --get LocalHostName )

                # Sets LocalHostName to a maximum of 15 characters, comprised of first eight characters of the computer's
                # serial number and the last six characters of the client's MAC address
                firstEightSerialNumber=$( system_profiler SPHardwareDataType | awk '/Serial\ Number\ \(system\)/ {print $NF}' | cut -c 1-8 )
                lastSixMAC=$( ifconfig en0 | awk '/ether/ {print $2}' | sed 's/://g' | cut -c 7-12 )
                newLocalHostName=${firstEightSerialNumber}-${lastSixMAC}

                if [[ "${debugMode}" == "true" ]]; then

                    updateScriptLog "WELCOME DIALOG: DEBUG MODE: Renamed computer from: \"${currentComputerName}\" to \"${computerName}\" "
                    updateScriptLog "WELCOME DIALOG: DEBUG MODE: Renamed LocalHostName from: \"${currentLocalHostName}\" to \"${newLocalHostName}\" "

                else

                    # Set the Computer Name to the user-entered value
                    scutil --set ComputerName "${computerName}"

                    # Set the LocalHostName to `newLocalHostName`
                    scutil --set LocalHostName "${newLocalHostName}"

                    # Delay required to reflect change …
                    # … side-effect is a delay in the "Setup Your Mac" dialog appearing
                    sleep 5
                    updateScriptLog "WELCOME DIALOG: Renamed computer from: \"${currentComputerName}\" to \"$( scutil --get ComputerName )\" "
                    updateScriptLog "WELCOME DIALOG: Renamed LocalHostName from: \"${currentLocalHostName}\" to \"$( scutil --get LocalHostName )\" "

                fi

            else

                updateScriptLog "WELCOME DIALOG: ${loggedInUser} did NOT specify a new computer name"
                updateScriptLog "WELCOME DIALOG: • Current Computer Name: \"$( scutil --get ComputerName )\" "
                updateScriptLog "WELCOME DIALOG: • Current Local Host Name: \"$( scutil --get LocalHostName )\" "

            fi

            # User Name
            if [[ -n "${userName}" ]]; then
                # UNTESTED, UNSUPPORTED "YOYO" EXAMPLE
                reconOptions+="-endUsername \"${userName}\" "
            fi

            # Asset Tag
            if [[ -n "${assetTag}" ]]; then
                reconOptions+="-assetTag \"${assetTag}\" "
            fi

            # Department
            if [[ -n "${department}" ]]; then
                # UNTESTED, UNSUPPORTED "YOYO" EXAMPLE
                reconOptions+="-department \"${department}\" "
            fi

            # Output `recon` options to log
            updateScriptLog "WELCOME DIALOG: reconOptions: ${reconOptions}"

            ###
            # Display "Setup Your Mac" dialog (and capture Process ID)
            ###

            eval "${dialogSetupYourMacCMD[*]}" & sleep 0.3
            dialogSetupYourMacProcessID=$!
            ;;

        2)  # Process exit code 2 scenario here
            updateScriptLog "WELCOME DIALOG: ${loggedInUser} clicked Quit at Welcome dialog"
            completionActionOption="Quit"
            quitScript "1"
            ;;

        3)  # Process exit code 3 scenario here
            updateScriptLog "WELCOME DIALOG: ${loggedInUser} clicked infobutton"
            osascript -e "set Volume 3"
            afplay /System/Library/Sounds/Glass.aiff
            ;;

        4)  # Process exit code 4 scenario here
            updateScriptLog "WELCOME DIALOG: ${loggedInUser} allowed timer to expire"
            quitScript "1"
            ;;

        *)  # Catch all processing
            updateScriptLog "WELCOME DIALOG: Something else happened; Exit code: ${welcomeReturnCode}"
            quitScript "1"
            ;;

    esac

else

    ###
    # Display "Setup Your Mac" dialog (and capture Process ID)
    ###

    eval "${dialogSetupYourMacCMD[*]}" & sleep 0.3
    dialogSetupYourMacProcessID=$!

fi
D. Review the default Setup Your Mac dialog

Review the default Setup Your Mac dialog.

Setup Your Mac (1.6.0) main dialog

The list of Jamf Pro policies to be executed is controlled by policy_array (thanks to Obi-James Smith).

First, configure the setupYourMacPolicyArrayIconPrefixUrl to the fully qualified domain name of the server which hosts your icons, including any required sub-directories. (See Jamf’s Cloud Services Connection: Icon Service.)

Next, for each configuration step, specify:

  • listitem: The text to be displayed in the list
  • icon: The hash of the icon to be displayed
  • progresstext: The text to be displayed below the progress bar
  • trigger: The Jamf Pro Policy Custom Event Name
  • validation:
    • {absolute path} (simulates pre-1.6.0 behavior, for example:
      "/Applications/Microsoft Teams.app/Contents/Info.plist")
    • Local (for validation within the Setup Your Mac script, for example: "filevault")
    • Remote (for validation validation via a single-script Jamf Pro policy, for example: "symvGlobalProtect")
    • None (for triggers which don’t require validation, for example: recon; always evaluates as successful)
# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
# "Setup Your Mac" policies to execute (Thanks, Obi-@smithjw!)
#
# For each configuration step, specify:
# - listitem: The text to be displayed in the list
# - icon: The hash of the icon to be displayed on the left
#   - See: https://vimeo.com/772998915
# - progresstext: The text to be displayed below the progress bar
# - trigger: The Jamf Pro Policy Custom Event Name
# - validation: [ {absolute path} | Local | Remote | None ]
#   See: https://snelson.us/2023/01/setup-your-mac-validation/
#       - {absolute path} (simulates pre-v1.6.0 behavior, for example: "/Applications/Microsoft Teams.app/Contents/Info.plist")
#       - Local (for validation within this script, for example: "filevault")
#       - Remote (for validation validation via a single-script Jamf Pro policy, for example: "symvGlobalProtect")
#       - None (for triggers which don't require validation, for example: recon; always evaluates as successful)
# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

# The fully qualified domain name of the server which hosts your icons, including any required sub-directories
setupYourMacPolicyArrayIconPrefixUrl="https://ics.services.jamfcloud.com/icon/hash_"

# shellcheck disable=SC1112 # use literal slanted single quotes for typographic reasons
policy_array=('
{
    "steps": [
        {
            "listitem": "Rosetta",
            "icon": "8bac19160fabb0c8e7bac97b37b51d2ac8f38b7100b6357642d9505645d37b52",
            "progresstext": "Rosetta enables a Mac with Apple silicon to use apps built for a Mac with an Intel processor.",
            "trigger_list": [
                {
                    "trigger": "rosettaInstall",
                    "validation": "None"
                }
            ]
        },
        {
            "listitem": "Rosetta Services (Local)",
            "icon": "8bac19160fabb0c8e7bac97b37b51d2ac8f38b7100b6357642d9505645d37b52",
            "progresstext": "Locally validating Rosetta service …",
            "trigger_list": [
                {
                    "trigger": "rosetta",
                    "validation": "Local"
                }
            ]
        },
        {
            "listitem": "FileVault Disk Encryption",
            "icon": "f9ba35bd55488783456d64ec73372f029560531ca10dfa0e8154a46d7732b913",
            "progresstext": "FileVault is built-in to macOS and provides full-disk encryption to help prevent unauthorized access to your Mac.",
            "trigger_list": [
                {
                    "trigger": "filevault",
                    "validation": "Local"
                }
            ]
        },
        {
            "listitem": "Sophos Endpoint",
            "icon": "c70f1acf8c96b99568fec83e165d2a534d111b0510fb561a283d32aa5b01c60c",
            "progresstext": "You’ll enjoy next-gen protection with Sophos Endpoint which doesn’t rely on signatures to catch malware.",
            "trigger_list": [
                {
                    "trigger": "sophosEndpoint",
                    "validation": "/Applications/Sophos/Sophos Endpoint.app/Contents/Info.plist"
                }
            ]
        },
        {
            "listitem": "Sophos Endpoint Services (Local)",
            "icon": "c05d087189f0b25a94f02eeb43b0c5c928e5e378f2168f603554bce2b5c71209",
            "progresstext": "Locally validating Sophos Endpoint services …",
            "trigger_list": [
                {
                    "trigger": "sophosEndpointServices",
                    "validation": "Local"
                }
            ]
        },
        {
            "listitem": "Sophos Endpoint Services (Remote)",
            "icon": "c05d087189f0b25a94f02eeb43b0c5c928e5e378f2168f603554bce2b5c71209",
            "progresstext": "Remotely validating Sophos Endpoint services …",
            "trigger_list": [
                {
                    "trigger": "symvSophosEndpointRTS",
                    "validation": "Remote"
                }
            ]
        },
        {
            "listitem": "Palo Alto GlobalProtect",
            "icon": "fcccf5d72ad9a4f6d3a4d780dcd8385378a0a8fd18e8c33ad32326f5bd53cca0",
            "progresstext": "Use Palo Alto GlobalProtect to establish a Virtual Private Network (VPN) connection to Church headquarters.",
            "trigger_list": [
                {
                    "trigger": "globalProtect",
                    "validation": "/Applications/GlobalProtect.app/Contents/Info.plist"
                }
            ]
        },
        {
            "listitem": "Palo Alto GlobalProtect Services (Local)",
            "icon": "709e8bdf0019e8faf9df85ec0a68545bfdb8bfa1227ac9bed9bba40a1fa8ff42",
            "progresstext": "Locally validating Palo Alto GlobalProtect services …",
            "trigger_list": [
                {
                    "trigger": "globalProtect",
                    "validation": "Local"
                }
            ]
        },
        {
            "listitem": "Palo Alto GlobalProtect Services (Remote)",
            "icon": "709e8bdf0019e8faf9df85ec0a68545bfdb8bfa1227ac9bed9bba40a1fa8ff42",
            "progresstext": "Remotely validating Palo Alto GlobalProtect services …",
            "trigger_list": [
                {
                    "trigger": "symvGlobalProtect",
                    "validation": "Remote"
                }
            ]
        },
        {
            "listitem": "Microsoft Teams",
            "icon": "dcb65709dba6cffa90a5eeaa54cb548d5ecc3b051f39feadd39e02744f37c19e",
            "progresstext": "Microsoft Teams is a hub for teamwork in Office 365. Keep all your team’s chats, meetings and files together in one place.",
            "trigger_list": [
                {
                    "trigger": "microsoftTeams",
                    "validation": "/Applications/Microsoft Teams.app/Contents/Info.plist"
                }
            ]
        },
        {
            "listitem": "Zoom",
            "icon": "be66420495a3f2f1981a49a0e0ad31783e9a789e835b4196af60554bf4c115ac",
            "progresstext": "Zoom is a videotelephony software program developed by Zoom Video Communications.",
            "trigger_list": [
                {
                    "trigger": "zoom",
                    "validation": "/Applications/zoom.us.app/Contents/Info.plist"
                }
            ]
        },
        {
            "listitem": "Google Chrome",
            "icon": "12d3d198f40ab2ac237cff3b5cb05b09f7f26966d6dffba780e4d4e5325cc701",
            "progresstext": "Google Chrome is a browser that combines a minimal design with sophisticated technology to make the Web faster.",
            "trigger_list": [
                {
                    "trigger": "googleChrome",
                    "validation": "/Applications/Google Chrome.app/Contents/Info.plist"
                }
            ]
        },
        {
            "listitem": "Final Configuration",
            "icon": "00d7c19b984222630f20b6821425c3548e4b5094ecd846b03bde0994aaf08826",
            "progresstext": "Finalizing Configuration …",
            "trigger_list": [
                {
                    "trigger": "finalConfiguration",
                    "validation": "None"
                },
                {
                    "trigger": "reconAtReboot",
                    "validation": "None"
                }
            ]
        },
        {
            "listitem": "Computer Inventory",
            "icon": "90958d0e1f8f8287a86a1198d21cded84eeea44886df2b3357d909fe2e6f1296",
            "progresstext": "A listing of your Mac’s apps and settings — its inventory — is sent automatically to the Jamf Pro server daily.",
            "trigger_list": [
                {
                    "trigger": "recon",
                    "validation": "None"
                }
            ]
        }
    ]
}
')
E. Customize the Setup Your Mac script

After adding Custom Events to your Jamf Pro Policies as required, use your favorite editor to modify ~/Downloads/Setup-Your-Mac-via-Dialog-reference.bash for your environment:

  1. “Welcome” dialog
    1. “Welcome” dialog Title, Message and Icon
    2. “Welcome” JSON
      • Note: Due to the variables included in welcomeJSON, external validation will most likely fail; first replace "'" with "
  2. “Setup Your Mac” dialog
    1. “Setup Your Mac” dialog Title, Message, Overlay Icon and Icon
    2. “Setup Your Mac” dialog Settings and Features
    3. “Setup Your Mac” policies to execute
      1. setupYourMacPolicyArrayIconPrefixUrl (i.e., the fully qualified domain name of the server which hosts your icons, including any required sub-directories; see Jamf’s Cloud Services Connection: Icon Service.)
      2. policy_array
        • listitem: The text to be displayed in the list
        • icon: The hash of the icon to be displayed on the left
        • progresstext: The text to be displayed below the progress bar
        • trigger: The Jamf Pro Policy Custom Event Name
        • validation: [ {absolute path} | Local | Remote | None ]
        • Note: You can validate the JSON by copying everything between the beginning and ending curly braces { … } and pasting at jsonlint.com
  3. “Failure” dialog
    • “Failure” dialog Title, Message and Icon
    • “Failure” dialog Settings and Features
Setup Your Mac (1.6.0) Failure dialog
  1. finalise function
    • dialogUpdateSetupYourMac "title: Sorry ${loggedInUserFirstname}, something went sideways"
    • dialogUpdateFailure "message: A failure has been detected, ${loggedInUserFirstname}.
F. Add your customized Setup Your Mac script to your Jamf Pro server
  1. Add your customized script to your Jamf Pro server
  2. Specify the following for Options > Parameter Labels
    • Parameter 4: Script Log Location [ /var/tmp/org.churchofjesuschrist.log ]
    • Parameter 5: Debug Mode [ true (default) | false ]
    • Parameter 6: Welcome dialog [ true (default) | false ]
    • Parameter 7: Completion Action [ wait | sleep (with seconds) | Shut Down | Shut Down Attended | Shut Down Confirm | Restart | Restart Attended (default) | Restart Confirm | Log Out | Log Out Attended | Log Out Confirm ]
  3. Click Save
Setup Your Mac (1.6.0) Script Parameter Labels
Setup Your Mac (1.6.0) Script Parameter Labels

Completion Actions

In addition to the previous wait and sleep options, Setup Your Mac (1.4.0) introduced the following Completion Action options:

Log OutRestartShut Down
 User is forcibly logged outComputer is forcibly restartedComputer is forcibly shut down
AttendedUser is forcibly logged out, after interacting with Setup Your Mac dialogsComputer is forcibly restarted, after user interacts with Setup Your Mac dialogsComputer is forcibly shut down, after user interacts with Setup Your Mac dialogs
ConfirmUser is prompted to Log Out via the dismissible, built-in macOS dialog boxUser is prompted to Restart via the dismissible, built-in macOS dialog boxUser is prompted to Shut Down via the dismissible, built-in macOS dialog box

Dynamic Button Label & Progress Text

Additionally, the label for the default button, button1text, and the message below the progress bar, progresstext, are dynamically updated based on the specified Completion Action:

Setup Your Mac dialogFailure dialog
SuccessfulFailure
Shut DownShutting Down …Continue …Shut Down
Shut Down AttendedShut Down
Shut Down Confirm
RestartRestarting …Restart
Restart AttendedRestart
Restart Confirm
Log OutLogging Out …Log Out
Log Out AttendedLog Out
Log Out Confirm

G. Create a Jamf Pro Policy to Setup Your Mac
Setup Your Mac (1.6.0) Jamf Pro Policy Overview
  1. Create a new Jamf Pro Policy, using the following as a guide for Options > General:
    • Set Display Name to Enrollment: @Setup Your Mac (1.6.0)
    • Set Execution Frequency to Ongoing
  2. Select the Scripts payload and add your customized _Setup Your Mac via swiftDialog (1.6.0) script, specifying the following Parameter Values
    • Script Log Location: /var/log/com.company.log
    • Debug Mode: true
    • Welcome dialog: true
    • Completion Action: Restart Attended
Setup Your Mac (1.6.0) Jamf Pro Policy Script Payload
Setup Your Mac (1.6.0) Jamf Pro Policy Script Payload
  1. Specify Scope as desired
    • Targets: All Computers
    • Limitations: No Limitations
    • Exclusions:
      • All Jamf Pro Compliant Computers
      • macOS 10.15.Catalina and earlier
      • Setup Your Mac: Complete
  2. Use the following for Self Service
    • Self Service Display Name: Setup Your Mac (1.6.0)
    • Button Name Before Initiation: Setup
    • Button Name After Initiation: Setup
    • Icon: Setup Your Mac icon (download)
    • Description:
## Welcome to your new Mac!
  
Please click **Setup** to apply Church settings to your Mac. (Once completed, you'll be prompted to restart your Mac.)
  
Use this app, the **Workforce App Store**, to install your Church-assigned software and to configure your Mac.
    
**FileVault** is built-in to macOS and provides full-disk encryption using XTS-AES-128 encryption with a 256-bit key to help prevent unauthorized access to the information on your startup disk.
  
You'll enjoy next-gen protection with **Sophos Endpoint** which doesn’t rely on signatures to catch malware and means it catches zero-day threats without adversely affecting the performance of your device. You'll be protected before exploits even arrive.
  
Use **Palo Alto GlobalProtect** to establish a Virtual Private Network (VPN) connection to Church headquarters.
  
**Microsoft Teams** is a hub for teamwork in Office 365. Keep all your team’s chats, meetings, files, and apps together in one place.
  
**Zoom** is a videotelephony software program developed by Zoom Video Communications.
  
**Google Chrome** is a browser that combines a minimal design with sophisticated technology to make the web faster, safer, and easier.
  
**Pro Tip:** By default, the listing of your computer's currently installed apps and system settings — its inventory — is automatically sent to the Jamf Pro server daily.
Setup Your Mac (1.6.0) Jamf Pro Policy Self Service Configuration
Setup Your Mac (1.6.0) Jamf Pro Policy Self Service Configuration
  1. Click Save
H. Troubleshooting
1. Welcome dialog doesn’t display

If in your Jamf Pro policy you’ve set Welcome dialog (i.e., Parameter 6) to true, but it doesn’t display as expected, the issue is most often invalid JSON. Please double-check the following:

  1. Confirm the Welcome dialog displays when the script is executed via Terminal using a freshly downloaded, timestamped copy of Setup Your Mac
    • Enter your password when prompted
    • Click Quit
timestamp=$( date '+%Y-%m-%d-%H%M%S' ) ; curl -o ~/Downloads/Setup-Your-Mac-via-Dialog-$timestamp.bash https://raw.githubusercontent.com/dan-snelson/dialog-scripts/main/Setup%20Your%20Mac/Setup-Your-Mac-via-Dialog.bash ; sudo bash ~/Downloads/Setup-Your-Mac-via-Dialog-$timestamp.bash
  1. Re-run your customized version of Setup Your Mac and review the client-side logs for entries which contain: WELCOME DIALOG
2022-12-26 07:03:38 - WELCOME DIALOG: dan entered information and clicked Continue
execution error: Error: SyntaxError: JSON Parse error: Unexpected identifier "JSON" (-2700)
  1. If you observe JSON Parse error in the logs, copy your entire welcomeJSON variable and paste into a new, blank document, then make the following modifications:
    • Delete welcomeJSON=' (being careful to retain the opening curly brace {)
    • Find "'" and replace with " (so the welcome-related variables will pass validation)
    • Delete the trailing single quote '
    • Validate the JSON by copying everything between the beginning and ending curly braces { … } and pasting at jsonlint.com
    • Review the displayed results and remediate as necessary until you observe Valid JSON
2. Setup Your Mac policy list doesn’t display

If the Setup Your Mac dialog displays — but its policy list does not — the issue is most often invalid JSON.

Invalid JSON preventing policy list from displaying
Invalid JSON preventing policy list from displaying

Please double-check the following:

  1. Confirm the Setup Your Mac policy list (i.e., policy_array) displays when the script is executed via Terminal using a freshly downloaded, timestamped copy of Setup Your Mac:
    • Enter your password when prompted
    • Specify an Asset Tag
    • Click Continue
timestamp=$( date '+%Y-%m-%d-%H%M%S' ) ; curl -o ~/Downloads/Setup-Your-Mac-via-Dialog-$timestamp.bash https://raw.githubusercontent.com/dan-snelson/dialog-scripts/main/Setup%20Your%20Mac/Setup-Your-Mac-via-Dialog.bash ; sudo bash ~/Downloads/Setup-Your-Mac-via-Dialog-$timestamp.bash
  1. Re-run your customized version of Setup Your Mac and review the client-side logs for entries which contain: JSON Parse error (Note: If progress_total does not end in an integer, there is almost certainly invalid JSON in policy_array.)
execution error: Error: SyntaxError: JSON Parse error: Expected ']' (-2700)
2022-12-26 08:09:10 - SETUP YOUR MAC DIALOG: progress_total=
  1. If you observe JSON Parse error in the logs:
    • Copy the policy_array variable between the beginning and ending curly braces { … }
    • Paste at jsonlint.com
    • Review the displayed results and remediate as necessary until you observe Valid JSON
3. Setup Your Mac dialog displays briefly, then “disappears”

If the Setup Your Mac dialog displays briefly, “disappears,” and the Jamf Pro policies continue to execute, the issue is most often invalid icons. (See swiftDialog Issue No. 208.)

Invalid icons cause Setup Your Mac dialog to briefly display

Please double-check the following:

  1. Confirm the Setup Your Mac dialog and icons display as expected when the script is executed via Terminal using a freshly downloaded, timestamped copy of Setup Your Mac:
    • Enter your password when prompted
    • Specify an Asset Tag
    • Click Continue
timestamp=$( date '+%Y-%m-%d-%H%M%S' ) ; curl -o ~/Downloads/Setup-Your-Mac-via-Dialog-$timestamp.bash https://raw.githubusercontent.com/dan-snelson/dialog-scripts/main/Setup%20Your%20Mac/Setup-Your-Mac-via-Dialog.bash ; sudo bash ~/Downloads/Setup-Your-Mac-via-Dialog-$timestamp.bash
  1. Re-run your customized version of Setup Your Mac via Terminal, watching for the brief appearance of the Setup Your Mac dialog, then search the Terminal output for the following error:
/usr/local/bin/dialog: line 2: 10577 Trace/BPT trap: 5 /Library/Application\ Support/Dialog/Dialog.app/Contents/MacOS/Dialog "$@"
  1. Review the Terminal output for the icon URLs and validate they each work as expected in your default browser:
2022-12-27 00:17:40 - SETUP YOUR MAC DIALOG: listitem: index: 0, icon: https://companyName.jamfcloud.com/icon/hash_f9ba35bd55488783456d64ec73372f029560531ca10dfa0e8154a46d7732b913, status: pending, statustext: Pending …
2022-12-27 00:17:40 - SETUP YOUR MAC DIALOG: listitem: index: 1, icon: https://companyName.jamfcloud.com/icon/hash_c70f1acf8c96b99568fec83e165d2a534d111b0510fb561a283d32aa5b01c60c, status: pending, statustext: Pending …
2022-12-27 00:17:40 - SETUP YOUR MAC DIALOG: listitem: index: 2, icon: https://companyName.jamfcloud.com/icon/hash_c05d087189f0b25a94f02eeb43b0c5c928e5e378f2168f603554bce2b5c71209, status: pending, statustext: Pending …
2022-12-27 00:17:40 - SETUP YOUR MAC DIALOG: listitem: index: 3, icon: https://companyName.jamfcloud.com/icon/hash_c05d087189f0b25a94f02eeb43b0c5c928e5e378f2168f603554bce2b5c71209, status: pending, statustext: Pending …
2022-12-27 00:17:40 - SETUP YOUR MAC DIALOG: listitem: index: 4, icon: https://companyName.jamfcloud.com/icon/hash_fcccf5d72ad9a4f6d3a4d780dcd8385378a0a8fd18e8c33ad32326f5bd53cca0, status: pending, statustext: Pending …
2022-12-27 00:17:40 - SETUP YOUR MAC DIALOG: listitem: index: 5, icon: https://companyName.jamfcloud.com/icon/hash_709e8bdf0019e8faf9df85ec0a68545bfdb8bfa1227ac9bed9bba40a1fa8ff42, status: pending, statustext: Pending …
2022-12-27 00:17:40 - SETUP YOUR MAC DIALOG: listitem: index: 6, icon: https://companyName.jamfcloud.com/icon/hash_709e8bdf0019e8faf9df85ec0a68545bfdb8bfa1227ac9bed9bba40a1fa8ff42, status: pending, statustext: Pending …
2022-12-27 00:17:40 - SETUP YOUR MAC DIALOG: listitem: index: 7, icon: https://companyName.jamfcloud.com/icon/hash_dcb65709dba6cffa90a5eeaa54cb548d5ecc3b051f39feadd39e02744f37c19e, status: pending, statustext: Pending …
2022-12-27 00:17:40 - SETUP YOUR MAC DIALOG: listitem: index: 8, icon: https://companyName.jamfcloud.com/icon/hash_be66420495a3f2f1981a49a0e0ad31783e9a789e835b4196af60554bf4c115ac, status: pending, statustext: Pending …
2022-12-27 00:17:40 - SETUP YOUR MAC DIALOG: listitem: index: 9, icon: https://companyName.jamfcloud.com/icon/hash_12d3d198f40ab2ac237cff3b5cb05b09f7f26966d6dffba780e4d4e5325cc701, status: pending, statustext: Pending …
2022-12-27 00:17:40 - SETUP YOUR MAC DIALOG: listitem: index: 10, icon: https://companyName.jamfcloud.com/icon/hash_00d7c19b984222630f20b6821425c3548e4b5094ecd846b03bde0994aaf08826, status: pending, statustext: Pending …
2022-12-27 00:17:40 - SETUP YOUR MAC DIALOG: listitem: index: 11, icon: https://companyName.jamfcloud.com/icon/hash_90958d0e1f8f8287a86a1198d21cded84eeea44886df2b3357d909fe2e6f1296, status: pending, statustext: Pending …
  1. Consider enabling your Jamf Pro instance’s Cloud Services Connection for the available Icon Service.
4. Unexpected Jamf Pro Policy Execution

If your Jamf Pro policies aren’t executing as expected, complete the following steps to enable verbose policy execution:

  1. Ensure debug mode is set to false (since policies do not actually execute when debug mode is set to true)
  2. Search for and comment-out the following (shown as Line 807 below):
    eval "${jamfBinary} policy -trigger ${trigger}"
  3. Uncomment the following (shown as Line 808 below):
    eval "${jamfBinary} policy -trigger ${trigger} -verbose | tee -a ${scriptLog}"
  4. Re-run your customized Setup Your Mac script
  5. Review the client-side logs for the problematic policies
# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
# Execute Jamf Pro Policy Custom Events (thanks, @smithjw)
# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

function run_jamf_trigger() {

    trigger="$1"

    if [[ "${debugMode}" == "true" ]]; then

        updateScriptLog "SETUP YOUR MAC DIALOG: DEBUG MODE: TRIGGER: $jamfBinary policy -trigger $trigger"
        if [[ "$trigger" == "recon" ]]; then
            updateScriptLog "SETUP YOUR MAC DIALOG: DEBUG MODE: RECON: $jamfBinary recon ${reconOptions}"
        fi
        sleep 1

    elif [[ "$trigger" == "recon" ]]; then

        dialogUpdateSetupYourMac "listitem: index: $i, status: wait, statustext: Updating …, "
        updateScriptLog "SETUP YOUR MAC DIALOG: Updating computer inventory with the following reconOptions: \"${reconOptions}\" …"
        eval "${jamfBinary} recon ${reconOptions}"

    else

        updateScriptLog "SETUP YOUR MAC DIALOG: RUNNING: $jamfBinary policy -trigger $trigger"
        eval "${jamfBinary} policy -trigger ${trigger}"                                     # Add comment for policy testing
        # eval "${jamfBinary} policy -trigger ${trigger} -verbose | tee -a ${scriptLog}"    # Remove comment for policy testing

    fi

}
5. Jamf Pro Remote Policy Validation Failures

When troubleshooting remote Jamf Pro Policy Validation failures, ensure the keyword Running is returned by your validation script / policy.

###
# Remote
# Validation via a Jamf Pro policy which has a single-script payload, for example: "symvGlobalProtect"
# See: https://vimeo.com/782561166
###

"Remote" )
    if [[ "${debugMode}" == "true" ]]; then
        updateScriptLog "SETUP YOUR MAC DIALOG: DEBUG MODE: Remotely Confirm Policy Execution: Skipping 'run_jamf_trigger ${trigger}'"
        dialogUpdateSetupYourMac "listitem: index: $i, status: error, statustext: Debug Mode Enabled"
        sleep 0.5
    else
        updateScriptLog "SETUP YOUR MAC DIALOG: Remotely Validate '${trigger}' '${validation}'"
        dialogUpdateSetupYourMac "listitem: index: $i, status: wait, statustext: Checking …"
        result=$( "${jamfBinary}" policy -trigger "${trigger}" | grep "Script result:" )
        if [[ "${result}" == *"Running"* ]]; then
            dialogUpdateSetupYourMac "listitem: index: $i, status: success, statustext: Running"
        else
            dialogUpdateSetupYourMac "listitem: index: $i, status: fail, statustext: Failed"
            jamfProPolicyTriggerFailure="failed"
            exitCode="1"
            jamfProPolicyNameFailures+="• $listitem  \n"
        fi
    fi
    ;;
6. Various “Restart” Completion Actions not Restarting as Expected

Background

Some Mac Admins using an Enrollment Complete trigger for Setup Your Mac have reported that the various “restart” Completion Actions fail to actually restart the computer, after an otherwise successful execution.

Each Completion Action includes alternative code options which should result in the desired behavior.

Restart

The Restart Completion Action includes three options to restart the computer, show below as lines:

  • 1178
  • 1179 (default)
  • 1180
"Restart" )
    updateScriptLog "Restart sans user interaction"
    killProcess "Self Service"
    # runAsUser osascript -e 'tell app "System Events" to restart'
    sleep 5 && runAsUser osascript -e 'tell app "System Events" to restart' &
    # shutdown -r +1 &
    ;;

If the default code option of Line 1179 does not work as expected, comment it out, then uncomment either Line 1178 or Line 1180 and re-test.

Restart Attended

The Restart Attended Completion Action also includes three options to restart the computer, show below as lines:

  • 1187
  • 1188 (default)
  • 1189
"Restart Attended" )
    updateScriptLog "Restart, requiring user-interaction"
    killProcess "Self Service"
    wait
    # runAsUser osascript -e 'tell app "System Events" to restart'
    sleep 5 && runAsUser osascript -e 'tell app "System Events" to restart' &
    # shutdown -r +1 &
    ;;

If the default code option of Line 1188 does not work as expected, comment it out, then uncomment either Line 1187 or Line 1189 and re-test.

With Inspiration and Code from

Support, Feature Requests & Bug Reports

Support

The #setup-your-mac Channel on the Mac Admins Slack and is a great resource when implementing Setup Your Mac in your environment.

“YOYO” Code

To the best of my recollection, Setup Your Mac (1.5.0) was the first time I’d publicly posted code which I considered to be knowingly incomplete and not fully untested (for the simple reason that we don’t use the additional input fields introduced in version 1.5.0 in our environment).

When you observe code blocks which include the following comment, please be aware that “you’re on your own.”

# UNTESTED, UNSUPPORTED "YOYO" EXAMPLE

Feature Requests

Please submit feature requests on GitHub and note that while all requests are welcome, finding available cycles to custom-code a feature we won’t use in our production environment is always challenging.

Bug Reports

Before submitting a Setup Your Mac bug report on GitHub, please review the open swiftDialog issues to help determine the source of the issue.

Feature History

1.6.0 (09-Jan-2023)

  • Addresses Issue No. 21
    • 🔥 Breaking Change 🔥 (for users of Setup Your Mac prior to 1.6.0)
      • policy_array‘s path has been replaced with validation
    • 🆕 The confirmPolicyExecution function confirms if the policy needs to be executed
    • 🆕 The validatePolicyResult function validates if the policy succeeded and the related service is running, based on the specified validation option
    • Validation Options:
      • {absolute path} (simulates pre-1.6.0 behavior, for example: "/Applications/Microsoft Teams.app/Contents/Info.plist")
      • Local (for validation within this script, for example: "filevault")
      • Remote (for validation validation via a single-script Jamf Pro policy, for example: "symvGlobalProtect")
      • None (for triggers which don’t require validation, for example: recon; always evaluates as successful)
  • Enhanced policy logging options to address Issue No. 25
    • Search for and comment-out the following (shown as Line 782):
      eval "${jamfBinary} policy -trigger ${trigger}"
    • Uncomment the following (shown as Line 783):
      eval "${jamfBinary} policy -trigger ${trigger} -verbose | tee -a ${scriptLog}"
    • Ensure debug mode is set to false
  • Added Rosetta 2 policy execution and validation
  • Enhanced logging

1.5.1 (07-Dec-2022)

  • Updates to “Pre-flight Checks”
    • Moved section to start of script
    • Added additional check for Setup Assistant (for Mac Admins using an “Enrollment Complete” trigger)

1.5.0 (28-Nov-2022)

  • 🆕 Prompt user for additional fields at Welcome dialog
    • New fields are included in a single welcomeJSON variable (thanks for all your efforts and feedback, @drtaru and @iDrewbs!)
    • Dynamic reconOptions based on user’s input at Welcome dialog
    • Thanks for your patience, @remusache, @midiman1000, @erikmadams, @colorenz, @benphilware
  • 🔥 Breaking Changes 🔥 (for users of Setup Your Mac prior to 1.5.0)
    • Script Parameter Reordering (sorry; I’ll strive not to ever do this again)
      • Parameter 4: Script Log Location [ /var/tmp/org.churchofjesuschrist.log ]
      • Parameter 5: Debug Mode [ true (default) | false ]
      • Parameter 6: Welcome Screen [ true (default) | false ]
      • Parameter 7: Completion Action [ wait | sleep (with seconds) | Shut Down | Shut Down Attended | Shut Down Confirm | Restart | Restart Attended(default) | Restart Confirm | Log Out | Log Out Attended | Log Out Confirm ]
  • Miscellaneous Improvements
    • Moved code blocks and variables to better reflect the Welcome > Setup Your Mac > Failure workflow
    • Random code clean-up

1.4.0 (21-Nov-2022)

  • Significantly enhanced Completion Action options
    • ✅ Addresses Issue 15 (thanks, @mvught, @riddl0rd, @iDrewbs and @master-vodawagner)
    • 🎉 Dynamically set button1text based on the value of completionActionOption (thanks, @jared-a-young)
    • 🥳 Dynamically set progresstext based on the value of completionActionOption (thanks, @iDrewbs)
    • 🆕 Three new flavors: Shut DownRestart or Log Out
      • 🚨 Forced: Zero user-interaction
        • Added brute-force killProcess "Self Service"
        • Added hack to allow Policy Logs to be shipped to Jamf Pro server
      • ⚠️ Attended: Forced, but only after user-interaction (thanks, @owainiorwerth)
        • Added hack to allow Policy Logs to be shipped to Jamf Pro server
      • 👤 Confirm: Displays built-in macOS user-dismissible dialog box
    • Sleep
    • Wait (default)
  • Improved Debug Mode behavior
    • 🐛 DEBUG MODE | now only displayed as infotext (i.e., bottom, left-hand corner)
    • completionAction informational-only with simple dialog box (thanks, @_____???)
    • Swapped blurscreen for moveable
    • General peformance increases
  • Miscellaneous Improvements
    • Removed jamfDisplayMessage function and reverted dialogCheck function to use osascript (with an enhanced error message)
    • Replaced “Installing …” with “Updating …” for recon-flavored trigger
    • Changed “Updating Inventory” to “Computer Inventory” for recon-flavored listitem
    • Changed exit code to 1 when user quits “Welcome” screen
    • Changed welcomeIcon URLs
    • Changed URL for Harvesting Self Service icons screencast (thanks, @nstrauss)

1.3.0 (09-Nov-2022)

  • Script Parameter Changes:
    • ⚠️ Parameter 4: debug mode enabled by default
    • 🆕 Parameter 7: Script Log Location
  • 🆕 Embraced drastic speed improvements in 🚅swiftDialog v2💨
  • Caffeinated script (thanks, @grahampugh!)
  • Enhanced wait exiting logic
  • Personalized dialogs
  • General script standardization

1.2.10 (05-Oct-2022)

  • Modifications for swiftDialog v2 (thanks, @bartreardon!)
    • Added I/O pause to dialog_update_setup_your_mac
    • Added list: show when displaying policy_array
    • Re-ordered Setup Your Mac progress bar commands
  • More specific logging for various dialog update functions
  • Confirm Setup Assistant complete and user at Desktop (thanks, @ehemmete!)

1.2.9 (03-Oct-2022)

  • Added setupYourMacPolicyArrayIconPrefixUrl variable (thanks for the idea, @mani2care!)
  • Removed unnecessary listitem icon updates (thanks, @bartreardon!)
  • Output swiftDialog version when running in debug mode
  • Updated URL for Zoom icon

1.2.8 (19-Sep-2022)

  • Replaced “ugly” completionAction if … then … else with “more readabale” case statement (thanks, @pyther!)
  • Updated “method for determining laptop/desktop” (thanks, @acodega and @scriptingosx!)
  • Additional tweaks discovered during internal production deployment

1.2.7 (10-Sep-2022)

1.2.6 (29-Aug-2022)

  • Adjust I/O timing (for policy_array loop)

1.2.5 (24-Aug-2022)

  • Resolves #3 (thanks, @pyther!)

1.2.4 (18-Aug-2022)

  • Swap “Installing …” and “Pending …” status indicators (thanks, @joncrain)

1.2.3 (15-Aug-2022)

  • Updates for switftDialog v1.11.2
  • Report failures in Jamf Pro Policy Triggers

1.2.2 (07-Jun-2022)

  • Added “dark mode” for logo (thanks, @mm2270)
  • Added “compact” for --liststyle

1.2.1 (01-Jun-2022)

  • Made Asset Tag Capture optional (via Jamf Pro Script Paramter 5)

1.2.0 (30-May-2022)

  • Changed --infobuttontext to --infotext
  • Added regex and regexerror for Asset Tag Capture
  • Replaced @adamcodega’s apps with @smithjw’s policy_array
  • Added progress update
  • Added filepath validation

1.1.0 (19-May-2022)

  • Added initial “Welcome Screen” with Asset Tag Capture and Debug Mode

1.0.0 (30-Apr-2022)

  • First “official” release
Posted in Device Management, Jamf Pro, macOS, Scripts, Tips & Tricks

Related Posts