Nudge 2.0.12.81807

Notes

This is a version of Nudge created by GitHub Actions.
Nudge.app has been signed and notarized. The package has been signed, notarized and stapled.

By default Nudge looks for a com.github.macadmins.Nudge.json file located in /Library/Preferences. If you would like to use an alternative path, please read the README or the WIKI

About the LaunchAgent

This is a basic launch agent that opens Nudge twice an hour, every 30 minutes.
If you would like to reduce the amount of times Nudge launches per day, it is recommended to create your own LaunchAgent.

Changelog

Requires macOS 12.0 and higher.

Fixed

• When cached SOFA feed is malformed, attempt to retry downloading and invalidate for future Nudge runs

Changes

• 501a7ea - v2.0.12 - better handling of bad cached sofa feeds
• 533186b - Update german (de) localization (#649)

Nudge 2.0.11.81805

Notes

This is a version of Nudge created by GitHub Actions.
Nudge.app has been signed and notarized. The package has been signed, notarized and stapled.

By default Nudge looks for a com.github.macadmins.Nudge.json file located in /Library/Preferences. If you would like to use an alternative path, please read the README or the WIKI

About the LaunchAgent

This is a basic launch agent that opens Nudge twice an hour, every 30 minutes.
If you would like to reduce the amount of times Nudge launches per day, it is recommended to create your own LaunchAgent.

Changelog

Requires macOS 12.0 and higher.

Changed

• German localization improvements
  • Thanks to northalpha Mirko Steinbrecher and for the changes!
  • 648
• SOFA SLA Logging improvements
  • Thanks to Eric Holtam for the changes!
  • 647

Changes

• 74ee4e2 - Update Localizable.xcstrings
• c8a2ff3 - Added logging to show which case is detected and what value is being used to extend requiredInstallationDate for easier troubleshooting.
• 8497853 - Fix Typo
• ac23b5b - Merge pull request #648 from northalpha/enhance-de-locals
• babfc5a - Merge pull request #647 from poundbangbash/moar-logging
• 726804a - v2.0.11

Nudge 2.0.10.81799

Notes

This is a version of Nudge created by GitHub Actions.
Nudge.app has been signed and notarized. The package has been signed, notarized and stapled.

By default Nudge looks for a com.github.macadmins.Nudge.json file located in /Library/Preferences. If you would like to use an alternative path, please read the README or the WIKI

About the LaunchAgent

This is a basic launch agent that opens Nudge twice an hour, every 30 minutes.
If you would like to reduce the amount of times Nudge launches per day, it is recommended to create your own LaunchAgent.

Changelog

Requires macOS 12.0 and higher.

Fixed

• When using latest or latest-supported, under active exploitation minor updates were not correctly assessed, resulting in SLA extensions defaulting to the 90 day SLA default value

Changes

• af64468 - add case for active exploit cve on current version
• f96c882 - v2.0.10
• b9c0e2e - Merge pull request #645 from macadmins/development

Nudge 2.0.9.81796

Notes

This is a version of Nudge created by GitHub Actions.
Nudge.app has been signed and notarized. The package has been signed, notarized and stapled.

By default Nudge looks for a com.github.macadmins.Nudge.json file located in /Library/Preferences. If you would like to use an alternative path, please read the README or the WIKI

About the LaunchAgent

This is a basic launch agent that opens Nudge twice an hour, every 30 minutes.
If you would like to reduce the amount of times Nudge launches per day, it is recommended to create your own LaunchAgent.

Changelog

Requires macOS 12.0 and higher.

Fixed

• When using latest or latest-supported, major upgrades were not correctly assessed, resulting in SLA extensions defaulting to the 90 day SLA default value

Changed

• Additional Japenese localization changes

Changes

• f768985 - update japanase text
• 970bef7 - fix japanese text
• 787fea6 - Merge branch 'main' into optimization-japanase-text
• 269e807 - Merge pull request #642 from enpipi/optimization-japanase-text
• 2e5c7eb - correct SLA computation for major upgrades
• 6c6a948 - v2.0.9
• 21fa025 - Merge pull request #643 from macadmins/development

Nudge 2.0.8.81789

Notes

This is a version of Nudge created by GitHub Actions.
Nudge.app has been signed and notarized. The package has been signed, notarized and stapled.

By default Nudge looks for a com.github.macadmins.Nudge.json file located in /Library/Preferences. If you would like to use an alternative path, please read the README or the WIKI

About the LaunchAgent

This is a basic launch agent that opens Nudge twice an hour, every 30 minutes.
If you would like to reduce the amount of times Nudge launches per day, it is recommended to create your own LaunchAgent.

Changelog

Requires macOS 12.0 and higher.

Changed

• Japenese Localization
  • Thanks to enpipi for the changes!
  • 637
• The Debug schema no longer honors randomDelay

Fixed

• The left side of Nudge is no longer cut off when using more "verbose" languages
  • 640
• The left side of Nudge now has proper localization for the values True and False

Changes

• 091b938 - dont use delay on debug schema
• 2c509a7 - allow line limit of 2 for left side text
• d1e78cc - make true and false localized
• 647f81a - fix japanese translations from enpipi
• cc8a9f2 - v2.0.8 changelog and values
• 24a49f9 - Merge pull request #641 from macadmins/development

Nudge 2.0.7.81783

Notes

This is a version of Nudge created by GitHub Actions.
Nudge.app has been signed and notarized. The package has been signed, notarized and stapled.

By default Nudge looks for a com.github.macadmins.Nudge.json file located in /Library/Preferences. If you would like to use an alternative path, please read the README or the WIKI

About the LaunchAgent

This is a basic launch agent that opens Nudge twice an hour, every 30 minutes.
If you would like to reduce the amount of times Nudge launches per day, it is recommended to create your own LaunchAgent.

Changelog

Requires macOS 12.0 and higher.

Added

• If using utilizeSOFAFeed, you can now set the aboutUpdateURL to sofa
  • If a URL is found in the relevant SecurityInfo key for the corresponding update, this value will be used.
  • If no URL is found, the aboutUpdateURL button will not be shown to the user
  • Feature Request 629

Changed

• The SMAppService logic logs have been moved to debug logs
• When an updated Managed Preference is sent for com.github.macadmins.Nudge, if the values are different, Nudge will exit
  • This is a workaround for issue 602
  • The LaunchAgent will ensure the application is successfully restarted at a future time.

Fixed

• The Jamf JSON schema file had an item missing and a key incorrectly set

Changes

• 7ddc361 - remove debug print
• 740d78a - Add 'disableNudgeForStandardInstalls' to Jamf schema
• 56191aa - Update com.github.macadmins.Nudge.json
• b620927 - Update com.github.macadmins.Nudge.json
• e19f199 - add debugging for SMAppService if/when it ever works
• f13a697 - Quit nudge when MDM profile is updated
• a42f3cb - redo SMAppService log method
• 2b43ba4 - v2.0.7
• 0172835 - allow dynamic sofa aboutUpdateURLs
• 9014f1d - Merge pull request #635 from macadmins/development

Nudge 2.0.6.81773

Notes

This is a version of Nudge created by GitHub Actions.
Nudge.app has been signed and notarized. The package has been signed, notarized and stapled.

By default Nudge looks for a com.github.macadmins.Nudge.json file located in /Library/Preferences. If you would like to use an alternative path, please read the README or the WIKI

About the LaunchAgent

This is a basic launch agent that opens Nudge twice an hour, every 30 minutes.
If you would like to reduce the amount of times Nudge launches per day, it is recommended to create your own LaunchAgent.

Changelog

Requires macOS 12.0 and higher.

Added

• Device within the nudgeMinorUpdateEventLaunchDelay now show current and delayed date
  • These logs also now show in the default Nudge logs when use the logger LaunchDaemon
  • Addresses 625

Changed

• Some logs have been changed from info to error, warning or notice to give admins more visibility into Nudge behaviors
• The board-id property has been moved to a debug log event
  • Works around reports like 623

Fixed

• The unsupportedURL key was not being honored when clicking on the Unsupported UI button
  • Addresses 626
• Intel Virtual Machines now have a forced board-id property that complies with Apple's own logic/SOFA.
  • Thanks to Mykola Grymalyuk for the PR
  • Addresses 621
• requiredInstallationDisplayFormat was no longer being honored on Nudge versions 2.0.1 through 2.0.5 due to a regression
  • Addresses 627

Changes

• 88886e0 - fix jamf json schema value
• 34a7e7f - Update README.md to mention 2.0
• 5006e8e - Utils.swift: Add handling for Intel Virtual Machines
• dec3f0f - fix unsupportedURL button action
• 7242bbc - move board-id to a debug log event
• f5327bf - Update changelog with some more info from PRs
• 713dac3 - redo VM logic names
• 5d9cb62 - bump to 14.5 for schema tests
• f5b7a43 - better log updateEventLaunchDelay
• 019650d - change some more logs
• 0ce8087 - go back and add another note about nudge 2.0 change
• bbcbe28 - bump to 2.0.6
• f2b9bfc - do not use locale if set to a different value

Nudge 2.0.5.81760

Notes

This is a version of Nudge created by GitHub Actions.
Nudge.app has been signed and notarized. The package has been signed, notarized and stapled.

By default Nudge looks for a com.github.macadmins.Nudge.json file located in /Library/Preferences. If you would like to use an alternative path, please read the README or the WIKI

About the LaunchAgent

This is a basic launch agent that opens Nudge twice an hour, every 30 minutes.
If you would like to reduce the amount of times Nudge launches per day, it is recommended to create your own LaunchAgent.

Changelog

Requires macOS 12.0 and higher.

Added

• To artificially change the requredInstallationDate to honor a previous macOS minor version, set minorVersionRecalculationThreshold under osVersionRequirement in amount of minor versions.
  • Ex: minorVersionRecalculationThreshold is set to 1 and SOFA feed has macOS 14.5 available
    • macOS device is 14.0: Required OS: 14.5 - Target macOS 14.4.1 requiredInstallationDate of 2024-04-08 00:00:00 +0000
    • macOS device is 14.1: Required OS: 14.5 - Target macOS 14.4.1 requiredInstallationDate of 2024-04-08 00:00:00 +0000
    • macOS device is 14.2: Required OS: 14.5 - Target macOS 14.4.1 requiredInstallationDate of 2024-04-08 00:00:00 +0000
    • macOS device is 14.3: Required OS: 14.5 - Target macOS 14.4.1 requiredInstallationDate of 2024-04-08 00:00:00 +0000
    • macOS device is 14.4: Required OS: 14.5 - Target macOS 14.4.1 requiredInstallationDate of 2024-04-08 00:00:00 +0000
    • macOS device is 14.4.1: Required OS: 14.5 - Target macOS 14.5 requiredInstallationDate of 2024-06-03 00:00:00 +0000
      • This device's requiredInstallationDate is different than the others as there is no active exploit on 14.4.1
    • macOS device is 14.5: Required OS: 14.5 - Fully updated
  • Ex: minorVersionRecalculationThreshold is set to 2 and SOFA feed has macOS 14.5 available
    • macOS device is 14.0: Required OS: 14.5 - Target macOS 14.4 requiredInstallationDate of 2024-03-21 00:00:00 +0000
    • macOS device is 14.1: Required OS: 14.5 - Target macOS 14.4 requiredInstallationDate of 2024-03-21 00:00:00 +0000
    • macOS device is 14.2: Required OS: 14.5 - Target macOS 14.4 requiredInstallationDate of 2024-03-21 00:00:00 +0000
    • macOS device is 14.3: Required OS: 14.5 - Target macOS 14.4 requiredInstallationDate of 2024-03-21 00:00:00 +0000
    • macOS device is 14.4: Required OS: 14.5 - Target macOS 14.4 requiredInstallationDate of 2024-04-08 00:00:00 +0000
    • macOS device is 14.4.1: Required OS: 14.5 - Target macOS 14.4.1 requiredInstallationDate of 2024-06-03 00:00:00 +0000
    • macOS device is 14.5: Required OS: 14.5 - Fully updated
  • Ex: minorVersionRecalculationThreshold is set to 3 and SOFA feed has macOS 14.5 available
    • macOS device is 14.0: Required OS: 14.5 - Target macOS 14.4 requiredInstallationDate of 2024-02-22 00:00:00 +0000
    • macOS device is 14.1: Required OS: 14.5 - Target macOS 14.4 requiredInstallationDate of 2024-02-22 00:00:00 +0000
    • macOS device is 14.2: Required OS: 14.5 - Target macOS 14.4 requiredInstallationDate of 2024-02-22 00:00:00 +0000
    • macOS device is 14.3: Required OS: 14.5 - Target macOS 14.4 requiredInstallationDate of 2024-02-22 00:00:00 +0000
    • macOS device is 14.4: Required OS: 14.5 - Target macOS 14.4 requiredInstallationDate of 2024-04-08 00:00:00 +0000
    • macOS device is 14.4.1: Required OS: 14.5 - Target macOS 14.4.1 requiredInstallationDate of 2024-06-03 00:00:00 +0000
    • macOS device is 14.5: Required OS: 14.5 - Fully updated
  • Addresses 612
• To ease testing, you can now pass -simulate-date as an argument to override the built-in date check.
  • Ex: -simulate-date "2024-07-25T00:00:00Z"

Changed

• The Actively Exploited logic internally within Nudge and the UI on the left sidebar will show True if any previous updates missing on the device had active exploits.
  • WARNING BREAKING CHANGE - This changes the SLA computation and will result in a different requiredInstallationDate than offered in Nudge v2.0 -> v2.01.
  • Ex: Device is on 14.3 and needing to go to 14.5.
    • While 14.4.1 -> 14.5 are not under active exploit, 14.4 contains fixes for 14.3 that were under active exploit.
  • Addresses 610 and 613
• When showRequiredDate is set to True and the admin is using the default values for requiredInstallationDisplayFormat, Nudge will attempt to understand the current locale and display the menu item appropriately.
  • Addresses 615
• Banned shortcut keys - including the ability to quit the application - are now allowed when passing -simulate-os-version or -simulate-hardware-id or -simulate-date

Fixed

• Several components in the Github Actions were triggering deprecation warnings. These have been addressed by updating to the latest version of these components
  • Addresses 616

Changes

• 3ad843d - redo under active exploit logic
• c38d799 - add another note in the changelog
• ccc1d29 - bump to v2.0.5
• 84fb165 - attempt to show locale when using default values for showRequiredDate
• 930681f - address deprecated github actions
• 0d53821 - Add logic for minorVersionRecalculationThreshold
• 07452c3 - re-order logs
• 1fd7e94 - fix some logic issues and add safety
• abfccf7 - fix changelog
• 5d5d6a1 - add an additional note as to why the date is different
• 69421f4 - ensure active exploit logic is properly assessed
• 3d618e9 - add additional logging for computation
• 2f39c0c - fix version comparison
• 500e317 - update changelog with new tests
• c208c8a - Merge pull request #614 from macadmins/development
• 394792c - Update CHANGELOG.md
• 62ba9b7 - Merge pull request #617 from macadmins/erikng-patch-1
• 8294e9d - redo the minorversion calculation a third time
• 06a4476 - allow banned keys when simulating versions
• c17e0db - fix typo
• 7038593 - allow simulated dates
• 4313964 - Merge pull request #618 from macadmins/development

Nudge 2.0.4.81737

Notes

This is a version of Nudge created by GitHub Actions.
Nudge.app has been signed and notarized. The package has been signed, notarized and stapled.

By default Nudge looks for a com.github.macadmins.Nudge.json file located in /Library/Preferences. If you would like to use an alternative path, please read the README or the WIKI

About the LaunchAgent

This is a basic launch agent that opens Nudge twice an hour, every 30 minutes.
If you would like to reduce the amount of times Nudge launches per day, it is recommended to create your own LaunchAgent.

Changelog

Requires macOS 12.0 and higher.

Fixed

• Logic introduced in v2.0.1 for requiredInstallatonDate when using the new gracePeriodInstallDelay was still incorrect and has been rewritten a second time.
  • Unit tests were changed to match the fixed behavior
  • gracePeriodLogic is now computed after the SOFA feed assessment
• Logic introduced in v2.0.2 accidentally forced the randomDelay when using the -demo-mode argument. This is now removed.
• gracePeriodsPath objects that were 0 bytes in size were ignored. This has been modified to allow these files
  • Ex: Ann admin simply runs touch on a file.
• The JAMF JSON schema had an incorrect title value for unsupportedURLs
• PRs sent to the Nudge repo will now have the tag safe-to-test removed after every CI/CD run, regardless of pass/fail status.
• The PR build script has been fixed to re-upload zipped Nudge.app files for user testing

Changes

• c0c12e3 - cleanup nudge pr tag after every run
• 8773366 - fix changelog note
• 16f3276 - correct aboutUpdateURLs to unsupportedURLs (#609)
• 125b537 - re-assess gracePeriod logic with SOFA
• d95e6ac - maybe fix test
• 2671aa3 - always cleanup tag
• 32fa490 - redo build script for PRs
• 057106e - disable randomDelay when using -demo-mode
• 83876e7 - update changlog
• 3c17931 - bump date of 2.0.4

Nudge 2.0.3.81727

Notes

This is a version of Nudge created by GitHub Actions.
Nudge.app has been signed and notarized. The package has been signed, notarized and stapled.

By default Nudge looks for a com.github.macadmins.Nudge.json file located in /Library/Preferences. If you would like to use an alternative path, please read the README or the WIKI

About the LaunchAgent

This is a basic launch agent that opens Nudge twice an hour, every 30 minutes.
If you would like to reduce the amount of times Nudge launches per day, it is recommended to create your own LaunchAgent.

Changelog

Requires macOS 12.0 and higher.

Changed

• The command line argument -disable-randomDelay is now -disable-random-delay

Fixed

• When a user clicked on the updateDevice button, the logs would incorrectly state the user was entering the "Unsupported UI" workflow.
• When running unit tests, Nudge no longer honors the randomDelay key or command line argument

Added

• To ease SOFA testing, you can now pass -custom-sofa-feed-url as an argument to override the built-in preferences and/or custom profile/json.
  • Ex: -custom-sofa-feed-url "file:///Users/Shared/macos_data_feed.json"

Changes

• a77913b - bail on CI/CD if Apple's notary service is down
• 73656af - Better log event on Replace My Device action
• efb9ecc - add option for -custom-sofa-feed-url
• 766246a - fix updateDevice log events
• f9832a3 - v2.0.3 changelog
• e933595 - bump project to v2.0.3
• d9734a0 - ignore random delay for unit tests