ruby-jss 1.4.1 → 1.5.1

data/lib/jamf/api/abstract_classes/prestage_skip_setup_items.rb

@@ -30,6 +30,27 @@ module Jamf
   # various Setup options in a DEP prestage
   # The object model here includes the attributes common
   # to both Computer and MobileDevice prestages
+  #
+  # To see the current list of settings that are common
+  # to both Computers and MobileDevices, run this in irb:
+  #
+  # Jamf::ComputerPrestage.all.sample[:skipSetupItems].keys & Jamf::MobileDevicePrestage.all.sample[:skipSetupItems].keys
+  #
+  #   => [
+  # :Appearance,
+  # :AppleID,
+  # :Biometric,
+  # :Diagnostics,
+  # :DisplayTone,
+  # :Location,
+  # :Payment,
+  # :Privacy,
+  # :Restore,
+  # :ScreenTime,
+  # :Siri,
+  # :TOS
+  #     ]
+  #
   class PrestageSkipSetupItems < Jamf::JSONObject
 
     extend Jamf::Abstract

data/lib/jamf/api/abstract_classes/resource.rb

@@ -186,7 +186,7 @@ module Jamf
     #####################################
 
     # These methods are allowed to call .new
-    NEW_CALLERS = ['fetch', 'create', 'all', 'block in all'].freeze
+    NEW_CALLERS = ['fetch', 'create', 'all', 'cached_all', 'block in all', 'block in cached_all'].freeze
 
     # The resource version for previewing new features
     RSRC_PREVIEW_VERSION = 'preview'.freeze
@@ -197,7 +197,7 @@ module Jamf
     # the resource path for this resource
     # @return [String]
     def self.rsrc_path
-      "#{self::RSRC_VERSION}/#{self::RSRC_PATH}"
+      @rsrc_path ||= "#{self::RSRC_VERSION}/#{self::RSRC_PATH}"
     end
 
     def self.preview_path
@@ -205,11 +205,11 @@ module Jamf
     end
 
     # Disallow direct use of ruby's .new class method for creating instances.
-    # Require use of .fetch or .create.
+    # Require use of .fetch or .create, or 'all'
     #
     def self.new(data, cnx: Jamf.cnx)
       calling_method = caller_locations(1..1).first.label
-      raise Jamf::UnsupportedError, "Use .fetch or .create to instantiate Jamf::Resource's" unless NEW_CALLERS.include? calling_method
+      raise Jamf::UnsupportedError, "Use .fetch, .create, or .all(instantiate:true) to instantiate Jamf::Resources" unless NEW_CALLERS.include? calling_method
 
       super
     end

data/lib/jamf/api/abstract_classes/singleton_resource.rb

@@ -60,7 +60,7 @@ module Jamf
       cached = cnx.singleton_cache[self]
       return cached if cached
 
-      data = cnx.get "#{self::RSRC_VERSION}/#{self::RSRC_PATH}"
+      data = cnx.get rsrc_path
       cnx.singleton_cache[self] = new data, cnx: cnx
     end # fetch
 

data/lib/jamf/api/connection.rb

@@ -24,9 +24,6 @@
 require 'faraday' # >= 0.17.0
 require 'faraday_middleware' # >= 0.13.0
 
-require 'jamf/api/connection/token'
-require 'jamf/api/connection/api_error'
-
 # The module
 module Jamf
 
@@ -45,10 +42,10 @@ module Jamf
     #####################################
 
     # The start of the path for API resources
-    RSRC_BASE = 'uapi'.freeze
+    RSRC_BASE = 'api'.freeze
 
-    # The API version must be this or higher
-    MIN_JAMF_VERSION = Gem::Version.new('10.23.0')
+    # The JamfPro version must be this or higher
+    MIN_JAMF_VERSION = Gem::Version.new('10.25.0')
 
     HTTPS_SCHEME = 'https'.freeze
 
@@ -85,6 +82,7 @@ module Jamf
     TOKEN_REUSE_MIN_LIFE = 60
 
     HTTP_ACCEPT_HEADER = 'Accept'.freeze
+
     HTTP_CONTENT_TYPE_HEADER = 'Content-Type'.freeze
 
     MIME_JSON = 'application/json'.freeze
@@ -161,7 +159,6 @@ module Jamf
     #
     # SingletonResource.fetch will return the instance from here, if it exists,
     # unless the first parameter is truthy.
-
     attr_reader :singleton_cache
 
     # @return [Hash]
@@ -704,7 +701,11 @@ module Jamf
 
       @timeout = params[:timeout]
       @open_timeout = params[:open_timeout]
-      @base_url = URI.parse "https://#{@host}:#{@port}/#{RSRC_BASE}"
+
+      # TEMPORARY ? the tryitout host still uses `uapi` rather than the
+      # new `api` for regular servers
+      rsrc_base = @host == Token::JAMF_TRYITOUT_HOST ? 'uapi' : RSRC_BASE
+      @base_url = URI.parse "https://#{@host}:#{@port}/#{rsrc_base}"
 
       # ssl opts for faraday
       # TODO: implement all of faraday's options
@@ -766,7 +767,7 @@ module Jamf
         cnx.response :json, parser_options: { symbolize_names: true } if parse_json
         cnx.options[:timeout] = @timeout
         cnx.options[:open_timeout] = @open_timeout
-        cnx.use Faraday::Adapter::NetHttp
+        cnx.adapter Faraday::Adapter::NetHttp
       end
     end
 
@@ -861,3 +862,6 @@ module Jamf
   end
 
 end # module Jamf
+
+require 'jamf/api/connection/token'
+require 'jamf/api/connection/api_error'

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

@@ -83,18 +83,18 @@ module Jamf
       def initialize(http_response)
         @http_response = http_response
         @httpStatus = http_response.status
-
         @errors =
-          if @http_response.body.dig :errors
-            @http_response.body[:errors].map { |e| ErrorInfo.new e }
-          else
-            []
+          if @http_response.body.is_a? String
+            JSON.parse(@http_response.body)[:errors]
+          elsif @http_response.body.is_a?(Hash)
+            @http_response.body[:errors]
           end
+        @errors &&= @errors.map { |e| ErrorInfo.new e }
 
-        if @errors.empty?
+        unless @errors
           code = @httpStatus
-          desc = @httpStatus == 404 ? RSRC_NOT_FOUND : @http_response.reason_phrase
-          @errors << ErrorInfo.new(code: code, field: nil, description: desc, id: nil)
+          desc = code == 404 ? RSRC_NOT_FOUND : @http_response.reason_phrase
+          @errors = [ErrorInfo.new(code: code, field: nil, description: desc, id: nil)]
         end
 
         super

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

@@ -32,13 +32,15 @@ module Jamf
 
       JAMF_VERSION_RSRC = 'v1/jamf-pro-version'.freeze
 
+      AUTH_RSRC_VERSION = 'v1'.freeze
+
       AUTH_RSRC = 'auth'.freeze
 
-      NEW_TOKEN_RSRC = "#{AUTH_RSRC}/tokens".freeze
+      NEW_TOKEN_RSRC = "#{AUTH_RSRC_VERSION}/#{AUTH_RSRC}/token".freeze
 
-      KEEP_ALIVE_RSRC = "#{AUTH_RSRC}/keepAlive".freeze
+      KEEP_ALIVE_RSRC = "#{AUTH_RSRC_VERSION}/#{AUTH_RSRC}/keep-alive".freeze
 
-      INVALIDATE_RSRC = "#{AUTH_RSRC}/invalidateToken".freeze
+      INVALIDATE_RSRC = "#{AUTH_RSRC_VERSION}/#{AUTH_RSRC}/invalidate-token".freeze
 
       # this string is prepended to the token data when used for
       # transaction authorization.
@@ -50,7 +52,7 @@ module Jamf
 
       JAMF_TRYITOUT_TOKEN_BODY = {
         token: 'This is a fake token, tryitout.jamfcloud.com uses internal tokens',
-        expires: 2000000000000
+        expires: 2_000_000_000_000
       }.freeze
 
       # @return [String] The user who generated this token
@@ -154,12 +156,14 @@ module Jamf
 
       # @return [String]
       def jamf_version
-        raw_jamf_version.split('-').first
+        fetch_jamf_version unless @jamf_version
+        @jamf_version
       end
 
       # @return [String]
       def jamf_build
-        raw_jamf_version.split('-').last
+        fetch_jamf_version unless @jamf_build
+        @jamf_build
       end
 
       # @return [Boolean]
@@ -264,15 +268,12 @@ module Jamf
       end
 
       # @return [String]
-      def raw_jamf_version
-        # TODO: Remove this once we require Jamf Pro 10.19 and up
-        # the rsrc for getting the version used to be nothing (the
-        # base url itself returnedit) but now its JAMF_VERSION_RSRC
-        resp = token_connection(Jamf::BLANK, token: @auth_token).get # .body # [:version]
-        return resp.body[:version] if resp.success?
-
+      def fetch_jamf_version
         resp = token_connection(JAMF_VERSION_RSRC, token: @auth_token).get
-        return resp.body[:version] if resp.success?
+        if resp.success?
+          @jamf_version, @jamf_build = resp.body[:version].split('-')
+          return
+        end
 
         raise Jamf::InvalidConnectionError, 'Unable to read Jamf version from the API'
       end
@@ -291,7 +292,7 @@ module Jamf
           else
             con.basic_auth @user, pw
           end
-          con.use Faraday::Adapter::NetHttp
+          con.adapter Faraday::Adapter::NetHttp
         end # Faraday.new
       end # token_connection
 

data/lib/jamf/api/json_objects/computer_prestage_skip_setup_items.rb

@@ -26,7 +26,13 @@
 # The module
 module Jamf
 
-  # A 'location' for a computer prestage in Jamf Pro
+  # The 'skip Setup Items' for a computer prestage in Jamf Pro
+  # The ones in common with Mobile Devices are in the superclass
+  # To see the ones that should be here, remove anything that's in
+  # mobile device's list from the computer ones, thus:
+  #
+  # > Jamf::ComputerPrestage.all.sample[:skipSetupItems].keys - Jamf::MobileDevicePrestage.all.sample[:skipSetupItems].keys
+  #  => [:FileVault, :iCloudDiagnostics, :Accessibility, :Registration, :iCloudStorage]
   class ComputerPrestageSkipSetupItems < Jamf::PrestageSkipSetupItems
 
     OBJECT_MODEL = superclass::OBJECT_MODEL.merge(
@@ -57,6 +63,13 @@ module Jamf
       Registration: {
         class: :boolean,
         aliases: %i[registration]
+      },
+
+      # @!attribute Registration
+      #   @return [Boolean]
+      Accessibility: {
+        class: :boolean,
+        aliases: %i[accessibility]
       }
     ).freeze
 

data/lib/jamf/api/json_objects/device_enrollment_device.rb

@@ -68,25 +68,25 @@ module Jamf
     OBJECT_MODEL = {
 
       # @!attribute id
-      #   @return [Integer]
+      #   @return [String]
       id: {
-        class: :integer,
+        class: :j_id,
         identifier: true
       },
 
       # @!attribute deviceEnrollmentProgramInstanceId
-      #   @return [Integer]
+      #   @return [String]
       deviceEnrollmentProgramInstanceId: {
-        class: :integer,
+        class: :j_id,
         aliases: %i[instanceId]
       },
 
       # @!attribute prestageId
       #   The most recent prestage this device was assigned to, even if
       #   currently unassigned to any prestage.
-      #   @return [Integer]
+      #   @return [String]
       prestageId: {
-        class: :integer
+        class: :j_id
       },
 
       # @!attribute serialNumber
@@ -122,7 +122,14 @@ module Jamf
       # @!attribute profileStatus
       #   @return [String]
       profileStatus: {
-        class: :string
+        class: :string,
+        enum: PROFILE_STATUSES
+      },
+
+      # @!attribute syncState
+      #   @return [DeviceEnrollmentDeviceSyncState]
+      syncState: {
+        class: Jamf::DeviceEnrollmentDeviceSyncState
       },
 
       # @!attribute profileAssignTime

data/lib/jamf/api/json_objects/device_enrollment_device_sync_state.rb

@@ -0,0 +1,81 @@
+# Copyright 2020 Pixar
+
+#
+#    Licensed under the Apache License, Version 2.0 (the "Apache License")
+#    with the following modification; you may not use this file except in
+#    compliance with the Apache License and the following modification to it:
+#    Section 6. Trademarks. is deleted and replaced with:
+#
+#    6. Trademarks. This License does not grant permission to use the trade
+#       names, trademarks, service marks, or product names of the Licensor
+#       and its affiliates, except as required to comply with Section 4(c) of
+#       the License and to reproduce the content of the NOTICE file.
+#
+#    You may obtain a copy of the Apache License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the Apache License with the above modification is
+#    distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#    KIND, either express or implied. See the Apache License for the specific
+#    language governing permissions and limitations under the Apache License.
+#
+#
+
+# The module
+module Jamf
+
+  # The status of a device from Apple's POV, regarding its
+  # assignment or removal from ADE. Such assignment is done via
+  # a profile from apple, this data is the state of that profile.
+  class DeviceEnrollmentDeviceSyncState < Jamf::JSONObject
+
+    extend Jamf::Immutable
+
+    OBJECT_MODEL = {
+
+      # @!attribute id
+      #   NOTE: this is not a jamf object id, it comes from Apple, therefore
+      #   it is an Integer, not a :j_id
+      #   @return [Integer]
+      id: {
+        class: :integer
+      },
+
+      # @!attribute serialNumber
+      #   @return [String]
+      serialNumber: {
+        class: :string
+      },
+
+      # @!attribute profileUUID
+      #   @return [String]
+      profileUUID: {
+        class: :string
+      },
+
+      # @!attribute syncStatus
+      #   @return [String]
+      syncStatus: {
+        class: :string
+      },
+
+      # @!attribute failureCount
+      #   @return [Integer]
+      failureCount: {
+        class: :integer
+      },
+
+      # @!attribute timestamp
+      #   @return [Jamf::Timestamp]
+      timestamp: {
+        class: Jamf::Timestamp
+      }
+    }.freeze
+
+    parse_object_model
+
+  end # class Country
+
+end # module

data/lib/jamf/api/json_objects/locale.rb

@@ -0,0 +1,59 @@
+# Copyright 2020 Pixar
+
+#
+#    Licensed under the Apache License, Version 2.0 (the "Apache License")
+#    with the following modification; you may not use this file except in
+#    compliance with the Apache License and the following modification to it:
+#    Section 6. Trademarks. is deleted and replaced with:
+#
+#    6. Trademarks. This License does not grant permission to use the trade
+#       names, trademarks, service marks, or product names of the Licensor
+#       and its affiliates, except as required to comply with Section 4(c) of
+#       the License and to reproduce the content of the NOTICE file.
+#
+#    You may obtain a copy of the Apache License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the Apache License with the above modification is
+#    distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#    KIND, either express or implied. See the Apache License for the specific
+#    language governing permissions and limitations under the Apache License.
+#
+#
+
+# The module
+module Jamf
+
+  # A Time Zone known to Jamf Pro
+  class Locale < Jamf::JSONObject
+
+    # Object Model / Attributes
+    # See APIObject class documentation for details
+    # of how the OBJECT_MODEL hash works.
+    #####################################
+    OBJECT_MODEL = {
+
+      # @!attribute [r] zoneId
+      #   @return [String]
+      identifier: {
+        class: :string,
+        identifier: :primary,
+        read_only: true,
+        aliases: [:id]
+      },
+
+      # @!attribute displayName
+      #   @return [String]
+      description: {
+        class: :string,
+        read_only: true,
+        aliases: %i[name desc]
+      }
+    }.freeze
+    parse_object_model
+
+  end # class Locale
+
+end # module