ruby-jss 1.2.3 → 1.2.4a1

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

@@ -0,0 +1,77 @@
+# Copyright 2019 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.
+
+module Jamf
+
+  # A single entry in a resource's change history.
+  # This class is read-only
+  #
+  class ChangeLogEntry < Jamf::JSONObject
+
+    extend Jamf::Immutable
+
+    OBJECT_MODEL = {
+
+      # @!attribute [r] id
+      #  @return [String] The Jamf Pro user who made the change or note.
+      id: {
+        class: :integer,
+        readonly: true
+      },
+
+      # @!attribute [r] username
+      #  @return [String] The Jamf Pro user who made the change or note.
+      username: {
+        class: :string,
+        readonly: true
+      },
+
+      # @!attribute [r] date
+      #  @return [Jamf::Timestamp] When the change was made
+      date: {
+        class: Jamf::Timestamp,
+        readonly: true
+      },
+
+      # @!attribute [r] notes
+      #  @return [String] Notes entered manually or via the API.
+      note: {
+        class: :string,
+        readonly: true
+      },
+
+      # @!attribute [r] details
+      #  @return [String] Details of the change
+      details: {
+        class: :string,
+        readonly: true
+      }
+    }.freeze
+
+    # Must call parse_object_model to turn the OBJECT_MODEL into
+    # attributes
+    parse_object_model
+
+  end # class
+
+end # module

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

@@ -0,0 +1,67 @@
+# Copyright 2019 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 'location' for a computer prestage in Jamf Pro
+  class ComputerPrestageSkipSetupItems < Jamf::PrestageSkipSetupItems
+
+    OBJECT_MODEL = superclass::OBJECT_MODEL.merge(
+
+      # @!attribute FileVault
+      #   @return [Boolean]
+      FileVault: {
+        class: :boolean,
+        aliases: %i[filevault]
+      },
+
+      # @!attribute iCloudDiagnostics
+      #   @return [Boolean]
+      iCloudDiagnostics: {
+        class: :boolean,
+        aliases: %i[iclouddiagnostics icloud_diagnostics]
+      },
+
+      # @!attribute iCloudStorage
+      #   @return [Boolean]
+      iCloudStorage: {
+        class: :boolean,
+        aliases: %i[icloudstorage icloud_storage]
+      },
+
+      # @!attribute Registration
+      #   @return [Boolean]
+      Registration: {
+        class: :boolean,
+        aliases: %i[registration]
+      }
+    ).freeze
+
+    parse_object_model
+
+  end # class location
+
+end # module

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

@@ -0,0 +1,51 @@
+# Copyright 2019 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 'location' for a managed object in Jamf Pro
+  class Country < Jamf::JSONObject
+
+    OBJECT_MODEL = {
+
+      # @!attribute code [r]
+      #   @return [String] the country code
+      code: {
+        class: :string
+      },
+
+      # @!attribute name [r]
+      #   @return [String] the country name
+      name: {
+        class: :string
+      }
+    }.freeze
+
+    parse_object_model
+
+  end # class Country
+
+end # module

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

@@ -0,0 +1,128 @@
+# Copyright 2019 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
+
+  # An extension attribute in Jamf Pro
+  class ExtensionAttributeValue < Jamf::JSONObject
+
+    OBJECT_MODEL = {
+
+      # @!attribute [r] id
+      #   The id of the attribute defining this value
+      #   @return [Integer]
+      id: {
+        class: :integer,
+        readonly: true
+      },
+
+      # @!attribute [r] name
+      #   The name of the attribute defining this value
+      #   @return [String]
+      name: {
+        class: :string,
+        readonly: true
+      },
+
+      # @!attribute [r] type
+      #   The value_type of this value
+      #   @return [String]
+      type: {
+        class: :string,
+        enum: Jamf::ExtensionAttribute::VALUE_TYPES,
+        readonly: true
+      },
+
+      # @!attribute [r] value
+      #   The value stored for this managed object for this ext attr
+      #   Settable via #new_value=
+      #   @return [String]
+      value: {
+        class: :string,
+        readonly: true # settable via Extendable#set_ext_attr
+      }
+
+    }.freeze
+    parse_object_model
+
+    # TODO: The WebApp doesn't seem to support enforcement of Data types..
+    #  I can enter any string as a DATE ea, an that string comes through as the
+    #  value.
+    #
+
+    def initialize(data, cnx: Jamf.cnx)
+      super
+      return if @value.nil?
+      @value =
+        case @type
+        when :integer
+          @value.j_integer? ? @value.to_i : "INVALID INTEGER: #{@value}"
+        when :date
+          Jamf::TimeStamp.new @value, cnx: cnx
+        else
+          @value
+        end # case
+    end # init
+
+    # setter for values. Usually called by
+    # Extendable#set_ext_attr
+    def new_value=(new_val)
+
+      # nil unsets the value
+      unless new_val.nil?
+        new_val =
+          case @type
+          when :integer
+            Jamf::Validate.integer new_val, "Value for ext. attr. #{@name} must be an integer"
+          when :date
+            validate_date new_val
+          else
+            new_val.to_s
+          end # case
+      end # unless nil
+
+      old_val = @value
+      return if old_val == new_val
+      @value = new_val
+      note_unsaved_change(:value, old_val)
+    end
+
+    # the to_jamf in JSONObject would skip all these
+    # cuz they are read-only
+    # but we need them here.
+    def to_jamf
+      return unless unsaved_changes?
+
+      new_val = @type == :date ? @value.to_jamf : @value.to_s
+      {
+        id: @id,
+        value: new_val
+      }
+    end
+
+  end # class ext attr
+
+end # module

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

@@ -0,0 +1,59 @@
+# Copyright 2019 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
+
+  # An installed application on a device
+  class InstalledApplication < Jamf::JSONObject
+
+    OBJECT_MODEL = {
+
+      # @!attribute [r] identifier
+      #   @return [String]
+      identifier: {
+        class: :string,
+        readonly: true
+      },
+
+      # @!attribute [r] name
+      #   @return [String]
+      name: {
+        class: :string,
+        readonly: true
+      },
+
+      # @!attribute [r] version
+      #   @return [String]
+      version: {
+        class: :string,
+        readonly: true
+      }
+    }.freeze
+    parse_object_model
+
+  end # class Mobile Device security
+
+end # module

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

@@ -0,0 +1,53 @@
+# Copyright 2019 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 certificate installed on a device
+  class InstalledCertificate < Jamf::JSONObject
+
+    OBJECT_MODEL = {
+
+      # @!attribute [r] commonName
+      #   @return [String]
+      commonName: {
+        class: :string,
+        readonly: true
+      },
+
+      # @!attribute [r] isIdentity
+      #   @return [Boolean]
+      isIdentity: {
+        class: :boolean,
+        readonly: true
+      }
+
+    }.freeze
+    parse_object_model
+
+  end # class Mobile Device security
+
+end # module

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

@@ -0,0 +1,67 @@
+# Copyright 2019 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 config profile installed on a device
+  class InstalledConfigurationProfile < Jamf::JSONObject
+
+    OBJECT_MODEL = {
+
+      # @!attribute [r] displayName
+      #   @return [String]
+      displayName: {
+        class: :string,
+        readonly: true
+      },
+
+      # @!attribute [r] version
+      #   @return [String]
+      version: {
+        class: :string,
+        readonly: true
+      },
+
+      # @!attribute [r] uuid
+      #   @return [String]
+      uuid: {
+        class: :string,
+        readonly: true
+      },
+
+      # @!attribute [r] identifier
+      #   @return [String]
+      identifier: {
+        class: :string,
+        readonly: true
+      }
+
+    }.freeze
+    parse_object_model
+
+  end # class Mobile Device security
+
+end # module