Leverage
switftDialog
and Jamf Pro Policy Script Parameters to easily display engaging end-user messages
Introduction
Using Bart Reardon’s swiftDialog
and Jamf Pro Policy Script Parameters, creating engaging end-user messages is easy.
When you really want to get your user’s attention, one of favorite options is --blurscreen
, which “will blur the background of the display while dialog is showing.”
Configuration
Complete the following steps to display messages to your users with swiftDialog
.
A. Add the Display Message with swiftDialog script to your Jamf Pro server
- Add the
Display Message via swiftDialog
script to your Jamf Pro server - Edit
--infobuttonaction
to the correct URL for your organization - Specify the following for Options > Parameter Labels
- Parameter 4:
Title
- Parameter 5:
Message
- Parameter 6:
Icon (Absolute Path; leave blank to display Self Service's icon)
- Parameter 7:
Button 1 Text (i.e., Details)
- Parameter 8:
Button 2 Text (i.e., Close)
- Parameter 9:
Info Button Text (i.e., KB008675309)
- Parameter 10:
Extra Flags (i.e., --iconsize 128 --timer 60 --blurscreen --quitoninfo --ignorednd --overlayicon /path/to/icon.icns
- Parameter 11:
Action (i.e., jamfselfservice://content?entity=policy&id=17&action=view )
- Parameter 4:
- Click Save
Latest version availble on GitHub.
#!/bin/bash #################################################################################################### # # Display Message via swiftDialog # # Purpose: Displays an end-user message via swiftDialog # See: https://snelson.us/2022/10/display-message-swiftdialog-003/ # #################################################################################################### # # HISTORY # # Version 0.0.1, 18-Feb-2022, Dan K. Snelson (@dan-snelson) # Original version # # Version 0.0.2, 06-Apr-2022, Dan K. Snelson (@dan-snelson) # Default icon to Jamf Pro Self Service if not specified # # Version 0.0.3, 19-Oct-2022, Dan K. Snelson (@dan-snelson) # Validate Operating System # Check for / install dialog (thanks, @acodega) # Added Client-side Script Logging # Changed Jamf Pro Script Parameters # - Friendly error message when Title or Message are not populated # - Changed Action (Parameter 11) to be optional (thanks for the idea, @eosrebel!) # # Version 0.0.4, 03-Nov-2022, Dan K. Snelson (@dan-snelson) # Reverted `action` code to version 0.0.2 # #################################################################################################### #################################################################################################### # # Variables # #################################################################################################### scriptVersion="0.0.4" scriptLog="/var/tmp/org.churchofjesuschrist.log" export PATH=/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin/ loggedInUser=$( echo "show State:/Users/ConsoleUser" | scutil | awk '/Name :/ { print $3 }' ) osVersion=$( sw_vers -productVersion ) osMajorVersion=$( echo "${osVersion}" | awk -F '.' '{print $1}' ) dialogApp="/usr/local/bin/dialog" dialogMessageLog=$( mktemp /var/tmp/dialogWelcomeLog.XXX ) if [[ -n ${4} ]]; then titleoption="--title"; title="${4}"; fi if [[ -n ${5} ]]; then messageoption="--message"; message="${5}"; fi if [[ -n ${6} ]]; then iconoption="--icon"; icon="${6}"; fi if [[ -n ${7} ]]; then button1option="--button1text"; button1text="${7}"; fi if [[ -n ${8} ]]; then button2option="--button2text"; button2text="${8}"; fi if [[ -n ${9} ]]; then infobuttonoption="--infobuttontext"; infobuttontext="${9}"; fi extraflags=${10} action=${11} # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # Default icon to Jamf Pro Self Service if not specified # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # if [[ -z ${icon} ]]; then iconoption="--icon" icon=$( defaults read /Library/Preferences/com.jamfsoftware.jamf.plist self_service_app_path ) fi #################################################################################################### # # Functions # #################################################################################################### # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # Client-side Script Logging # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # function updateScriptLog() { echo -e "$( date +%Y-%m-%d\ %H:%M:%S ) ${1}" | tee -a "${scriptLog}" } # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # JAMF Display Message (for fallback in case swiftDialog fails to install) # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # function jamfDisplayMessage() { updateScriptLog "Jamf Display Message: ${1}" /usr/local/jamf/bin/jamf displayMessage -message "${1}" & } # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # Check for / install swiftDialog (thanks, Adam!) # https://github.com/acodega/dialog-scripts/blob/main/dialogCheckFunction.sh # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # function dialogCheck(){ # Get the URL of the latest PKG From the Dialog GitHub repo dialogURL=$(curl --silent --fail "https://api.github.com/repos/bartreardon/swiftDialog/releases/latest" | awk -F '"' "/browser_download_url/ && /pkg\"/ { print \$4; exit }") # Expected Team ID of the downloaded PKG expectedDialogTeamID="PWA5E9TQ59" # Check for Dialog and install if not found if [ ! -e "/Library/Application Support/Dialog/Dialog.app" ]; then updateScriptLog "Dialog not found. Installing..." # Create temporary working directory workDirectory=$( /usr/bin/basename "$0" ) tempDirectory=$( /usr/bin/mktemp -d "/private/tmp/$workDirectory.XXXXXX" ) # Download the installer package /usr/bin/curl --location --silent "$dialogURL" -o "$tempDirectory/Dialog.pkg" # Verify the download teamID=$(/usr/sbin/spctl -a -vv -t install "$tempDirectory/Dialog.pkg" 2>&1 | awk '/origin=/ {print $NF }' | tr -d '()') # Install the package if Team ID validates if [ "$expectedDialogTeamID" = "$teamID" ] || [ "$expectedDialogTeamID" = "" ]; then /usr/sbin/installer -pkg "$tempDirectory/Dialog.pkg" -target / else jamfDisplayMessage "Dialog Team ID verification failed." exit 1 fi # Remove the temporary working directory when done /bin/rm -Rf "$tempDirectory" else updateScriptLog "swiftDialog version $(dialog --version) found; proceeding..." fi } # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # Quit Script (thanks, @bartreadon!) # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # function quitScript() { updateScriptLog "Quitting …" echo "quit: " >> "${dialogMessageLog}" sleep 1 updateScriptLog "Exiting …" # brutal hack - need to find a better way killall tail # Remove dialogMessageLog if [[ -e ${dialogMessageLog} ]]; then updateScriptLog "Removing ${dialogMessageLog} …" rm "${dialogMessageLog}" fi updateScriptLog "Goodbye!" exit "${1}" } #################################################################################################### # # Program # #################################################################################################### # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # Client-side Logging # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # if [[ ! -f "${scriptLog}" ]]; then touch "${scriptLog}" echo "$( date +%Y-%m-%d\ %H:%M:%S ) *** Created log file via script ***" >>"${scriptLog}" fi # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # Logging preamble # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # updateScriptLog "Display Message via Dialog (${scriptVersion})" # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # Validate Operating System # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # if [[ "${osMajorVersion}" -ge 11 ]] ; then updateScriptLog "macOS ${osMajorVersion} installed; proceeding ..." scriptResult="${scriptResult} macOS ${osMajorVersion} installed; proceeding;" else updateScriptLog "macOS ${osVersion} installed; exiting." jamfDisplayMessage "Display Message via swiftDialog (${scriptVersion}) by Dan K. Snelson macOS ${osVersion} installed; macOS Big Sur 11 (or later) required" exit 1 fi # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # Validate Script Parameters # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # if [[ -z "${title}" ]] || [[ -z "${message}" ]]; then updateScriptLog "Either Parameter 4 or Parameter 5 are NOT populated; displaying instructions …" extraflags="--width 825 --height 400 --moveable --timer 75 --position topright --blurscreen --titlefont size=26 --messagefont size=13 --iconsize 125" titleoption="--title" title="Title [Parameter 4] goes here" messageoption="--message" message="### Message [Parameter 5] goes here \n\n**Note:** Please review this [blog post](https://snelson.us/2022/03/display-message-via-swiftdialog/) for additional information. \n\n--- \n\nDisplaying with the following \"extraflags:\" \n\n${extraflags} \n\nThank you, [Bart Reardon](https://www.buymeacoffee.com/bartreardon), for making [swiftDialog](https://github.com/bartreardon/swiftDialog)! (Two words: **Rock. Star.**)" button1option="--button1text" button1text="Button 1 [Parameter 7]" button2option="--button2text" button2text="Button 2 [Parameter 8]" infobuttonoption="--infobuttontext" infobuttontext="Infobutton [Paramter 9]" else updateScriptLog "Both \"title\" and \"message\" Parameters are populated; proceeding ..." fi # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # Check for / install swiftDialog # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # dialogCheck # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # Display Message: Dialog # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # updateScriptLog "Title: ${title}" updateScriptLog "Message: ${message}" ${dialogApp} \ ${titleoption} "${title}" \ ${messageoption} "${message}" \ ${iconoption} "${icon}" \ ${button1option} "${button1text}" \ ${button2option} "${button2text}" \ ${infobuttonoption} "${infobuttontext}" \ --infobuttonaction "https://servicenow.company.com/support?id=kb_article_view&sysparm_article=${infobuttontext}" \ --messagefont "size=14" \ --commandfile "$dialogMessageLog}" \ ${extraflags} returncode=$? case ${returncode} in 0) ## Process exit code 0 scenario here echo "${loggedInUser} clicked ${button1text}" updateScriptLog "${loggedInUser} clicked ${button1text};" if [[ -n "${action}" ]]; then su - "${loggedInUser}" -c "open \"${action}\"" fi quitScript "0" ;; 2) ## Process exit code 2 scenario here echo "${loggedInUser} clicked ${button2text}" updateScriptLog "${loggedInUser} clicked ${button2text};" quitScript "0" ;; 3) ## Process exit code 3 scenario here echo "${loggedInUser} clicked ${infobuttontext}" updateScriptLog "${loggedInUser} clicked ${infobuttontext};" ;; 4) ## Process exit code 4 scenario here echo "${loggedInUser} allowed timer to expire" updateScriptLog "${loggedInUser} allowed timer to expire;" ;; *) ## Catch all processing echo "Something else happened; Exit code: ${returncode}" updateScriptLog "Something else happened; Exit code: ${returncode};" quitScript "1" ;; esac updateScriptLog "End-of-line." quitScript "0"
B. Create a Jamf Pro Policy to display an end-user message
- Create a new Jamf Pro Policy, using the following as a guide for Options > General:
- Set Display Name to
macOS Ventura 13 Installer Notification
- Set Trigger to
Recurring Check-in
- Set Execution Frequency to the desired value
- Set Display Name to
- Select the Scripts payload and add the
Display Message via swiftDialog
script - Specify the Parameter Values
- Title:
Upgrade to macOS Ventura
- Message:
**macOS Ventura 13** \n\n**Works smarter. Plays harder. Goes further.** \n\nmacOS Ventura makes the things you do most on Mac even better, with powerful new ways to get more done, share and collaborate in your favorite apps, immerse yourself in next‑level games, and take full advantage of your other devices. \n\nClick **Details** to learn more before upgrading. \n\nIf you need assistance, please contact the Global Services Department, \n+1 (801) 555-1212, and mention KB008675309.
- Icon:
/Applications/Install macOS Ventura.app/Contents/Resources/InstallAssistant.icns
- Button 1 Text:
Details
- Button 2 Text:
Close
- Info Button Text:
KB008675309
- Extra Flags:
--timer 120 --blurscreen --quitoninfo --ignorednd --overlayicon /path/to/icon.icns
- Action:
jamfselfservice://content?entity=policy&id=363&action=view
- Title:
- Adjust Scope to your liking
- Click Save
Updates
0.0.3
(19-Oct-2022)
- Validate Operating System
- Check for / install dialog (thanks, acodega)
- Added Client-side Script Logging
- Changed Jamf Pro Script Parameters
- Changed Action (Parameter 11) to be optional (thanks for the idea, eosrebel!)
- Friendly error message when Title or Message are not populated (thanks, Bart. Two words: Rock. Star.)
0.0.4
(03-Nov-2022)
- Reverted
action
code to version0.0.2