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