ruby-jss 5.0.0b1 → 5.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fe2a1fd9beba704e48499993ccfbc030e07eb9a7f008d695d652f5b906dca691
-  data.tar.gz: 58ba3c159e925c3f86eb65b9d2c3583921810ec7ed18daa0f230219f8c8e5b1c
+  metadata.gz: fb8e45fa884fdb03111f19962b52cc59e9d9a959b56139c0494682d1796be369
+  data.tar.gz: 51f1c69302671c63da44b535b437ed92741f925741ab27348def5d9bb51ac0c9
 SHA512:
-  metadata.gz: e6ab10f5930e059100ce9783714a8495b33719bd3d2445b2aae2b6f5ab4980ba76cd4dfa07b0a9a0e272be8a38913aa7fd2afee609aefc873043e906fa9cb394
-  data.tar.gz: 19dda1b6bec99106e64e02b04c56d2f3e8387afb6e64bf40d6a61b0dafdab720c9094184eee551c02ec0bf0226c58a462bb97ae42970205fb483d2a460bcd5c8
+  metadata.gz: 0f3220a26d97723f97624dedf79abef52ed800aac589f2a485b7d9e37cb14499cce810093ce666209c3355f64b3a5585f901d05c070098bf88bdc48c36cb386a
+  data.tar.gz: f9b4b1fba7f67e8cef0a883d7ec92f229f6241a33a48d16c6e45772d9789bc03a0361ab189b35018ddc45c2748e31cf494bde2e2cb1c9fcbae7fe49a2f1468f5

data/CHANGES.md

@@ -15,13 +15,20 @@ __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
+## \[5.0.1] 2026-01-09
+
+### Fixed
+
+  - The `Jamf::Connection::JamfProAPI` methods for basic HTTP interaction with the server (`#jp_get`, `#jp_post`, `#jp_put`, `#jp_patch`, & `#jp_delete`) can all now optionally take a second parameter as the request body, or omit such a parameter. Omission is needed for some endpoints, such as POSTing to `/v2/mobile-devices/{id}/unmanage`, which takes no body,  and occasionally there have been GET or DELETE endpoints that require a body also (which is allowed in the HTTP spec.) Previously, `#jp_post` required such a body, so the unmanage was failing.
+
+--------
+## \[5.0.0] 2026-01-06
 
 ### 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.
+  - 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 Apple's 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. The upcoming JComputer and JMobileDevice classes will embody the Jamf Pro API endpoints directly.
 
 ### Changed
 
@@ -37,25 +44,27 @@ Many many thanks to actae0n of Blacksun Hackers Club for reporting this issue an
 
     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
 
 ### Added 
+
   - Set request User-Agent header to indicate ruby-jss version
 
 ### Changed
+
   - Use the 'TOMORROW OPEN SOURCE TECHNOLOGY LICENSE 1.0' (TOST) License 
     - The terms are unchanged, but it now has an offical name.
 
 ### Fixed
+
   - Resolved [GitHub Issue 106](https://github.com/PixarAnimationStudios/ruby-jss/issues/106). REXML v3.4.3 or higher doesn't allow the creation of REXML::Document instances without a root element. Many thanks to @hiboma for the bug report and a suggested fix!
 
 --------
 ## \[4.2.3] 2025-09-23
 
 ### Fixed
+
   - Fixed bug were `#save` was not returning the object's Jamf ID when updating scopable objects.
   - Fixed bug where `Jamf::Policy#retry_event=` raised error when no retry_attempts are defined.
 
@@ -63,6 +72,7 @@ Many many thanks to actae0n of Blacksun Hackers Club for reporting this issue an
 ## \[4.2.2] 2025-09-06
 
 ### Fixed
+
   - Class `Jamf::JPackage` no longer raises `Errno::EINVAL Invalid argument @ io_fread` when generating manifest checksums for very large package files.
 
 

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

@@ -355,11 +355,7 @@ module Jamf
           commandData: command_data
         }
 
-        if JSS.devmode?
-          puts "Sending XML:\n"
-          REXML::Document.new(cmd_xml).write STDOUT, 2
-          puts "\n\nTo rsrc: #{rsrc}"
-        end
+        puts "Sending data:\n#{data}" if JSS.devmode?
 
         cnx.jp_post MDM_COMMAND_RSRC, data
       end
@@ -378,7 +374,7 @@ module Jamf
       #
       # @param cnx [Jamf::Connection] an API connection to use.
       #
-      # @return [Array<Integer>] The ids of the target devices for a command
+      # @return [Array<String,Integer>] The ids of the target devices for a command
       #
       def raw_targets_to_mgmt_ids(targets, expand_groups: true, unmanaged_ok: false, jamf_ids: false, api: nil, cnx: Jamf.cnx)
         cnx = api if api
@@ -593,7 +589,7 @@ module Jamf
         }
         cmd_data[:message] = message if message
         cmd_data[:phoneNumber] = phoneNumber if phoneNumber
-        cmd_data[:pin] = passcode if passcode
+        cmd_data[:pin] = passcode unless passcode.pix_empty?
 
         send_mdm_command(targets, cmd_data, cnx: cnx)
       end
@@ -722,8 +718,8 @@ module Jamf
         data = {
           commandType: DELETE_USER,
           userName: user,
-          force: force,
-          all: all
+          forceDeletion: force,
+          deleteAllUsers: all
         }
         send_mdm_command targets, data, cnx: cnx
       end
@@ -915,7 +911,7 @@ module Jamf
       alias set_name device_name
       alias set_device_name device_name
 
-      # TODO: Re-enable this when the wallpaper MDM commands are migrated to JPAPI
+      # TODO: Update/migrate this when the wallpaper MDM command is migrated to JPAPI
       #
       # Send a wallpaper command to one or more targets
       #
@@ -955,9 +951,15 @@ module Jamf
         end
 
         targets = raw_targets_to_mgmt_ids targets, jamf_ids: true, cnx: cnx
-        cmd_xml = mdm_command_xml(command, opts, targets)
+        cmd_xml = mdm_command_xml(:Wallpaper, opts, targets)
         rsrc = 'mobiledevicecommands/command/Wallpaper'
 
+        if JSS.devmode?
+          puts "Sending XML:\n"
+          REXML::Document.new(cmd_xml).write STDOUT, 2
+          puts "\n\nTo rsrc: #{rsrc}"
+        end
+
         xml_resp = cnx.c_post rsrc, cmd_xml
 
         hash = {}
@@ -1449,11 +1451,10 @@ module Jamf
     #
     # @return (see .send_mdm_command)
     #
-    def device_name(name)
+    def set_device_name(name)
       self.class.device_name @id, name, cnx: @cnx
     end
-    alias set_name device_name
-    alias set_device_name device_name
+    alias set_name set_device_name
 
     # Send a wallpaper command to this object
     #

data/lib/jamf/api/connection/jamf_pro_api.rb

@@ -44,15 +44,17 @@ module Jamf
 
       # @return [Hash] the result of the get
       #######################################################
-      def jp_get(rsrc)
+      def jp_get(rsrc, data = nil)
         validate_connected
+
         rsrc = rsrc.delete_prefix Jamf::Connection::SLASH
         resp = @jp_cnx.get(rsrc) do |req|
           # Modify the request here if needed.
           # puts "JPAPI Cookie is: #{req.headers['Cookie']}"
+          req.body = data if data
         end
-        @last_http_response = resp
 
+        @last_http_response = resp
         return resp.body if resp.success?
 
         raise Jamf::Connection::JamfProAPIError, resp
@@ -69,12 +71,14 @@ module Jamf
       #
       # @return [String] the response body
       #######################################################
-      def jp_post(rsrc, data)
+      def jp_post(rsrc, data = nil)
         validate_connected
+
         rsrc = rsrc.delete_prefix Jamf::Connection::SLASH
         resp = @jp_cnx.post(rsrc) do |req|
-          req.body = data
+          req.body = data if data
         end
+
         @last_http_response = resp
         return resp.body if resp.success?
 
@@ -92,12 +96,14 @@ module Jamf
       # @return [String] the response from the server.
       #
       #######################################################
-      def jp_put(rsrc, data)
+      def jp_put(rsrc, data = nil)
         validate_connected
+
         rsrc = rsrc.delete_prefix Jamf::Connection::SLASH
         resp = @jp_cnx.put(rsrc) do |req|
-          req.body = data
+          req.body = data if data
         end
+
         @last_http_response = resp
         return resp.body if resp.success?
 
@@ -115,14 +121,16 @@ module Jamf
       # @return [String] the response from the server.
       #
       #######################################################
-      def jp_patch(rsrc, data)
+      def jp_patch(rsrc, data = nil)
         validate_connected
+
         rsrc = rsrc.delete_prefix Jamf::Connection::SLASH
         resp = @jp_cnx.patch(rsrc) do |req|
           # Patch requests must use this content type!
           req.headers['Content-Type'] = 'application/merge-patch+json'
-          req.body = data
+          req.body = data if data
         end
+
         @last_http_response = resp
         return resp.body if resp.success?
 
@@ -138,10 +146,14 @@ module Jamf
       # @return [String] the response from the server.
       #
       #######################################################
-      def jp_delete(rsrc)
+      def jp_delete(rsrc, data = nil)
         validate_connected
         rsrc = rsrc.delete_prefix Jamf::Connection::SLASH
-        resp = @jp_cnx.delete rsrc
+
+        resp = @jp_cnx.delete(rsrc) do |req|
+          req.body = data if data
+        end
+
         @last_http_response = resp
         return resp.body if resp.success?
 
@@ -164,7 +176,7 @@ module Jamf
       end
 
       # @param rsrc[String] the API resource being uploadad-to,
-      #   the URL part after 'JSSResource/'
+      #   the URL part after 'api/'
       #
       # @param local_file[String, Pathname] the local file to upload
       #

data/lib/jamf/version.rb

@@ -9,6 +9,6 @@
 module Jamf
 
   ### The version of ruby-jss
-  VERSION = '5.0.0b1'.freeze
+  VERSION = '5.0.1'.freeze
 
 end # module

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby-jss
 version: !ruby/object:Gem::Version
-  version: 5.0.0b1
+  version: 5.0.1
 platform: ruby
 authors:
 - Chris Lasell
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-12-03 00:00:00.000000000 Z
+date: 2026-01-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pixar-ruby-extensions
@@ -544,9 +544,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 2.6.3
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubygems_version: 3.0.3.1
 signing_key: