ruby-jss 4.2.4 → 5.0.0b1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0907c7aa66d97c4af670851a3864dda26c577a8276b81bfa1ff2e0c226a8fcdf'
-  data.tar.gz: 69cab90152dc3e537b4c9d05333f7ce0009962ebb7f29b16f2f050d0deedb579
+  metadata.gz: fe2a1fd9beba704e48499993ccfbc030e07eb9a7f008d695d652f5b906dca691
+  data.tar.gz: 58ba3c159e925c3f86eb65b9d2c3583921810ec7ed18daa0f230219f8c8e5b1c
 SHA512:
-  metadata.gz: 767582cc94c273ad2777488e93c659f15f2e90bfb6bcd344427a569169307f83a6581a7b964be264c815cfbf0ae260a6b6fdfdc5a85d5dedb63d2bc6854771f0
-  data.tar.gz: 6292bdaa50bdbdd98718c1ffd9f87a3c855c8ae2783dc72a24671ef832ec771820fe3195d95a09178cf600422b21542de3ae95b03d099407dd074690f784647f
+  metadata.gz: e6ab10f5930e059100ce9783714a8495b33719bd3d2445b2aae2b6f5ab4980ba76cd4dfa07b0a9a0e272be8a38913aa7fd2afee609aefc873043e906fa9cb394
+  data.tar.gz: 19dda1b6bec99106e64e02b04c56d2f3e8387afb6e64bf40d6a61b0dafdab720c9094184eee551c02ec0bf0226c58a462bb97ae42970205fb483d2a460bcd5c8

data/CHANGES.md

@@ -14,6 +14,31 @@ __Please update all installations of ruby-jss to at least v1.6.0.__
 
 Many many thanks to actae0n of Blacksun Hackers Club for reporting this issue and providing examples of how it could be exploited.
 
+--------
+## \[5.0.0] Unreleased
+
+### Added
+
+  - A new dependency on the [pixar-ruby-extensions gem](https://rubygems.org/gems/pixar-ruby-extensions), which are similar to those found in the JamfRubyExtensions module built into ruby-jss. Once all use of JamfRubyExtensions has been replaced by the new gem, JamfRubyExtensions will be removed. Staying DRY is a good thing.
+
+  - Jamf::Computer and Jamf::MobileDevice now have a class method `.management_id(ident, cnx: Jamf.cnx)` and a matching instance method `#management_id`.  Even though the classes are based on the Classic API endpoints for Computers and MobileDevices, the 'managementId' value (a UUID used by Apples MDM/DDM) is not available in the Classic API data. These methods reach out to the Jamf Pro API to find the id for the instance, or the identified object.
+
+### Changed
+
+  - The Jamf Pro API is now used for sending MDM commands.
+
+    The Jamf::MDM mixin module has been updated to use the Jamf Pro API for nearly all defined methods. As of Jamf Pro 11.21, most of the Classic API endpoints have been deprecated for a while and are now removed. We now mostly uses the `/v2/mdm/commands` endpoint for POSTing commands.
+
+    This module is mixed in to the Computer, ComputerGroup, MobileDevice, and MobileDeviceGroup classes, which are still based on the Classic API. Those classes will be ported to the Jamf Pro API (as JComputer, JMobileDevice, etc..) in the coming months, but until then, the existing classes can now continue to send MDM commands. 
+    
+    Also at that time, newer MDM commands supported by the Jamf Pro API, but not yet by ruby-jss, will be implemented.
+
+    NOTE: The 'update_inventory' MDM command for mobile devices is no longer a thing and calling #update_inventory will raise an exception. Some of the MDM-based subcommands now in the JP API, such as CERTIFICATE_LIST, DEVICE_INFORMATION, INSTALLED_APPLICATION_LIST, etc, will be implemented in the future.
+
+    This fixes [GitHub Issue 107](https://github.com/PixarAnimationStudios/ruby-jss/issues/107) - many thanks to @csfjeff for reporting the problem!
+
+  
+
 --------
 ## \[4.2.4] 2025-10-31
 

data/lib/jamf/api/classic/api_objects/computer.rb

@@ -596,6 +596,20 @@ module Jamf
     end
     private_class_method :management_data_subset
 
+    # Get the MDM Management ID for a computer by identifer
+    # @param ident [Integer,String] An identifier (id, name, serialnumber, macaddr)
+    #   of the computer for which to retrieve the Management ID
+    # @param cnx [Jamf::Connection] an API connection to use for the query.
+    #
+    # @return [String, nil] the management ID, or nil if the computer is not MDM managed
+    ##########################################
+    def self.management_id(ident, cnx: Jamf.cnx)
+      jid = valid_id ident
+      raise Jamf::NoSuchItemError, "No Computer with identifier '#{ident}'" unless jid
+
+      cnx.jp_get("v2/computers-inventory/#{jid}").dig :general, :managementId
+    end
+
     # Attributes
     #####################################
 
@@ -1073,6 +1087,12 @@ module Jamf
       Jamf::Computer.application_usage @id, start_date, end_date, cnx: @cnx
     end # app usage
 
+    # The management id for this computer
+    # @return [String, nil] the management ID, or nil if the computer is not MDM managed
+    def management_id
+      @management_id ||= self.class.management_id @id, cnx: @cnx
+    end
+
     # The 'computer management' data for this computer
     #
     # NOTE: the data isn't cached locally, and the API is queried every time