Class: JSS::OSXConfigurationProfile

Inherits:
APIObject
  • Object
show all
Includes:
Scopable, SelfServable, Updatable
Defined in:
lib/jss-api/api_object/osx_configuration_profile.rb

Overview

An OS X Configuration Profile in the JSS.

Note that the profile payloads and the profile UUID cannot be edited or updated with this via this class. Use the web UI.

See Also:

Constant Summary collapse

RSRC_BASE =

The base for REST resources of this class

"osxconfigurationprofiles"
RSRC_LIST_KEY =

the hash key used for the JSON list output of all objects in the JSS

:os_x_configuration_profiles
RSRC_OBJECT_KEY =

The hash key used for the JSON object output. It’s also used in various error messages

:os_x_configuration_profile
VALID_DATA_KEYS =

these keys, as well as :id and :name, are present in valid API JSON data for this class

[:distribution_method, :scope, :redeploy_on_update]
SCOPE_TARGET_KEY =

Our scopes deal with computers

:computers
SELF_SERVICE_TARGET =

Our SelfService happens on OSX

:osx
SELF_SERVICE_PAYLOAD =

Our SelfService deploys profiles

:profile
DISTRIBUTION_METHODS =

The possible values for the :distribution_method

["Install Automatically", "Make Available in Self Service"]
SELF_SERVICE_DIST_METHOD = 
"Make Available in Self Service"
LEVELS =

The possible values for :level

["user", "computer"]

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(args = {}) ⇒ OSXConfigurationProfile

See JSS::APIObject#initialize



129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
 
# File 'lib/jss-api/api_object/osx_configuration_profile.rb', line 129

def initialize (args = {})
  
  super
  
  @description = @main_subset[:description]
  @distribution_method = @main_subset[:distribution_method]
  @user_removable = @main_subset[:user_removable]
  @level = @main_subset[:level]
  @uuid = @main_subset[:uuid]
  @redeploy_on_update = @main_subset[:redeploy_on_update]
  @payloads = @main_subset[:payloads]
  
  self.parse_scope
  self.parse_self_service
  
end

Instance Attribute Details

#description ⇒ String

Returns the description of this profile.

Returns:

  • (String) —

    the description of this profile



102
103
104
 
# File 'lib/jss-api/api_object/osx_configuration_profile.rb', line 102

def description
  @description
end

#distribution_method ⇒ String

Returns the distribution_method of this profile.

Returns:

  • (String) —

    the distribution_method of this profile



105
106
107
 
# File 'lib/jss-api/api_object/osx_configuration_profile.rb', line 105

def distribution_method
  @distribution_method
end

#level ⇒ String

Returns the level (user/computer) of this profile.

Returns:

  • (String) —

    the level (user/computer) of this profile



111
112
113
 
# File 'lib/jss-api/api_object/osx_configuration_profile.rb', line 111

def level
  @level
end

#need_to_update ⇒ Boolean (readonly) Originally defined in module Updatable

Returns do we have unsaved changes?.

Returns:

  • (Boolean) —

    do we have unsaved changes?

#payloads ⇒ String (readonly)

Returns the plist containing the payloads for this profile. NOT Updatable.

Returns:

  • (String) —

    the plist containing the payloads for this profile. NOT Updatable



120
121
122
 
# File 'lib/jss-api/api_object/osx_configuration_profile.rb', line 120

def payloads
  @payloads
end

#redeploy_on_update ⇒ Boolean (readonly)

Returns Should this profile be redeployed when an inventory update happens?.

Returns:

  • (Boolean) —

    Should this profile be redeployed when an inventory update happens?



117
118
119
 
# File 'lib/jss-api/api_object/osx_configuration_profile.rb', line 117

def redeploy_on_update
  @redeploy_on_update
end

#scope ⇒ Object Originally defined in module Scopable

Attribtues

#self_service_categories ⇒ Array<Hash> (readonly) Originally defined in module SelfServable

Each Hash has these keys about the category

  • :id => [Integer] the JSS id of the category

  • :name => [String] the name of the category

  • :display_in => [Boolean] should the item be displayed in this category in SSvc? (OSX SSvc only)

  • :feature_in => [Boolean] should the item be featured in this category in SSVC? (OSX SSvc only)

NOTE: as of Casper 9.61 there’s a bug in the JSON output from the API, and only the last category is returned, if more than one are set.

Returns:

  • (Array<Hash>) —

    The categories in which this item should appear in SSvc

#self_service_description ⇒ String Originally defined in module SelfServable

Returns The verbage that appears in SelfSvc for this item.

Returns:

  • (String) —

    The verbage that appears in SelfSvc for this item

#self_service_feature_on_main_page ⇒ Boolean Originally defined in module SelfServable

Returns Should this item feature on the main page of SSvc?.

Returns:

  • (Boolean) —

    Should this item feature on the main page of SSvc?

#self_service_force_users_to_view_description ⇒ Boolean Originally defined in module SelfServable

Returns Should an extra window appear before the user can install the item? (OSX SSvc only).

Returns:

  • (Boolean) —

    Should an extra window appear before the user can install the item? (OSX SSvc only)

#self_service_icon ⇒ Hash (readonly) Originally defined in module SelfServable

The Hash contains these keys with info about the icon:

  • :filename => [String] The name of the image file uploaded to the JSS

  • :uri => [String] the URI for retriving the icon

  • :id => [Integer] the JSS id number for the icon (not all SSvc items have this)

  • :data => [String] the icon image encoded as Base64 (not all SSvc items have this)

Returns:

  • (Hash) —

    The icon that appears in SelfSvc for this item

#self_service_install_button_text ⇒ String Originally defined in module SelfServable

Returns The text label on the install button in SSvc (OSX SSvc only).

Returns:

  • (String) —

    The text label on the install button in SSvc (OSX SSvc only)

#self_service_security ⇒ Hash (readonly) Originally defined in module SelfServable

The keys are

  • :removal_disallowed => [String] one of the items in IOS_PROFILE_REMOVAL_OPTIONS

  • :password => [String] if :removal_disallowed is “With Authorization”, this contains the passwd (in plaintext) needed to remove the profile.

NOTE that the key should be called :removal_allowed, since ‘Never’ means it can’t be removed.

Returns:

  • (Hash) —

    The security settings for iOS profiles in SSvc

#user_removable ⇒ Boolean

Returns can the user remove this profile.

Returns:

  • (Boolean) —

    can the user remove this profile



108
109
110
 
# File 'lib/jss-api/api_object/osx_configuration_profile.rb', line 108

def user_removable
  @user_removable
end

#uuid ⇒ String (readonly)

Returns the uuid of this profile. NOT Updatable.

Returns:

  • (String) —

    the uuid of this profile. NOT Updatable



114
115
116
 
# File 'lib/jss-api/api_object/osx_configuration_profile.rb', line 114

def uuid
  @uuid
end

Instance Method Details

#add_self_service_category(new_cat, display_in = true, feature_in = false) ⇒ void Also known as: change_self_service_category Originally defined in module SelfServable

This method returns an undefined value.

Add or change one of the categories for this item in SSvc.

Parameters:

  • new_cat (String) —

    the name of a category for this item in SelfSvc

  • display_in (Boolean) (defaults to: true) —

    should this item appear in the SelfSvc page for the new category?

  • feature_in (Boolean) (defaults to: false) —

    should this item be featured in the SelfSvc page for the new category?

Raises:

#in_self_service? ⇒ Boolean

Returns is this profile available in Self Service?.

Returns:

  • (Boolean) —

    is this profile available in Self Service?



203
204
205
 
# File 'lib/jss-api/api_object/osx_configuration_profile.rb', line 203

def in_self_service?
  @distribution_method == SELF_SERVICE_DIST_METHOD
end

#name=(newname) ⇒ void Originally defined in module Updatable

This method returns an undefined value.

Change the name of this item Remember to #update to push changes to the server.

Parameters:

  • newname (String) —

    the new name

Raises:

#parse_scope ⇒ void Originally defined in module Scopable

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

This method returns an undefined value.

Call this during initialization of objects that have a scope and the scope instance will be created from @init_data

#parse_self_service ⇒ void Originally defined in module SelfServable

This method returns an undefined value.

Call this during initialization of objects that have a self_service subset and the self_service attributes will be populated (as primary attributes) from @init_data

#parsed_payloads ⇒ Hash

Returns The payload plist parsed into a Ruby hash.

Returns:

  • (Hash) —

    The payload plist parsed into a Ruby hash



219
220
221
 
# File 'lib/jss-api/api_object/osx_configuration_profile.rb', line 219

def parsed_payloads
  Plist.parse_xml @payloads
end

#payload_content ⇒ Array<Hash>

Returns the individual payloads from the payload Plist.

Returns:

  • (Array<Hash>) —

    the individual payloads from the payload Plist



226
227
228
 
# File 'lib/jss-api/api_object/osx_configuration_profile.rb', line 226

def payload_content
  parsed_payloads['PayloadContent']
end

#payload_types ⇒ Array<String>

Returns the PayloadType of each payload (e.g. com.apple.caldav.account).

Returns:

  • (Array<String>) —

    the PayloadType of each payload (e.g. com.apple.caldav.account)



233
234
235
 
# File 'lib/jss-api/api_object/osx_configuration_profile.rb', line 233

def payload_types
  payload_content.map{|p| p['PayloadType'] }
end

#profile_can_be_removed(new_val) ⇒ void Originally defined in module SelfServable

This method returns an undefined value.

Set whether or when the user can remove a profile installed with SSvc

Parameters:

  • new_val (String) —

    one of the values in PROFILE_REMOVAL_OPTIONS, or true or false

Raises:

#remove_self_service_category=(cat) ⇒ void Originally defined in module SelfServable

This method returns an undefined value.

Remove a category from those for this item in SSvc

Parameters:

  • cat (String) —

    the name of the category to remove

#self_service_xml ⇒ REXML::Element Originally defined in module SelfServable

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Return a REXML <location> element to be included in the rest_xml of objects that have a Location subset

Returns:

  • (REXML::Element)

#should_update ⇒ void Originally defined in module Scopable

This method returns an undefined value.

When the scope changes, it calls this to tell us that an update is needed.

#update ⇒ Object Originally defined in module Scopable

A wrapper around the update method, to try catching RestClient::Conflict 409 errors when we couldn’t verify all ldap users/groups due to lack of ldap connections

#user_removable? ⇒ Boolean

Returns is this profile removable by the user?.

Returns:

  • (Boolean) —

    is this profile removable by the user?



211
212
213
 
# File 'lib/jss-api/api_object/osx_configuration_profile.rb', line 211

def user_removable?
  @user_removable
end