chef 15.0.300-universal-mingw32 → 15.1.36-universal-mingw32

data/lib/chef/provider/user/aix.rb

@@ -1,131 +1,131 @@
-#
-# Copyright:: Copyright 2012-2018, Chef Software Inc.
-# License:: Apache License, Version 2.0
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-require_relative "../user"
-
-class Chef
-  class Provider
-    class User
-      class Aix < Chef::Provider::User
-        provides :user, os: "aix"
-        provides :aix_user
-
-        def create_user
-          shell_out!("useradd", universal_options, useradd_options, new_resource.username)
-          add_password
-        end
-
-        def manage_user
-          add_password
-          manage_home
-          return if universal_options.empty? && usermod_options.empty?
-          shell_out!("usermod", universal_options, usermod_options, new_resource.username)
-        end
-
-        def remove_user
-          shell_out!("userdel", userdel_options, new_resource.username)
-        end
-
-        # Aix does not support -r like other unix, sytem account is created by adding to 'system' group
-        def useradd_options
-          opts = []
-          opts << "-g" << "system" if new_resource.system
-          if updating_home?
-            if new_resource.manage_home
-              logger.trace("#{new_resource} managing the users home directory")
-              opts << "-m"
-            else
-              logger.trace("#{new_resource} setting home to #{new_resource.home}")
-            end
-          end
-          opts
-        end
-
-        def userdel_options
-          opts = []
-          opts << "-r" if new_resource.manage_home
-          opts << "-f" if new_resource.force
-          opts
-        end
-
-        def usermod_options
-          []
-        end
-
-        def check_lock
-          lock_info = shell_out!("lsuser", "-a", "account_locked", new_resource.username)
-          if whyrun_mode? && passwd_s.stdout.empty? && lock_info.stderr.match(/does not exist/)
-            # if we're in whyrun mode and the user is not yet created we assume it would be
-            return false
-          end
-          raise Chef::Exceptions::User, "Cannot determine if #{new_resource} is locked!" if lock_info.stdout.empty?
-
-          status = /\S+\s+account_locked=(\S+)/.match(lock_info.stdout)
-          @locked =
-            if status && status[1] == "true"
-              true
-            else
-              false
-            end
-
-          @locked
-        end
-
-        def lock_user
-          shell_out!("chuser", "account_locked=true", new_resource.username)
-        end
-
-        def unlock_user
-          shell_out!("chuser", "account_locked=false", new_resource.username)
-        end
-
-        def universal_options
-          opts = []
-          opts << "-c" << new_resource.comment if should_set?(:comment)
-          opts << "-g" << new_resource.gid if should_set?(:gid)
-          opts << "-s" << new_resource.shell if should_set?(:shell)
-          opts << "-u" << new_resource.uid if should_set?(:uid)
-          opts << "-d" << new_resource.home if updating_home?
-          opts << "-o" if new_resource.non_unique
-          opts
-        end
-
-        private
-
-        def add_password
-          return unless current_resource.password != new_resource.password && new_resource.password
-          logger.trace("#{new_resource.username} setting password to #{new_resource.password}")
-          command = "echo '#{new_resource.username}:#{new_resource.password}' | chpasswd -e"
-          shell_out!(command)
-        end
-
-        # Aix specific handling to update users home directory.
-        def manage_home
-          return unless updating_home? && new_resource.manage_home
-          # -m option does not work on aix, so move dir.
-          if ::File.directory?(current_resource.home)
-            logger.trace("Changing users home directory from #{current_resource.home} to #{new_resource.home}")
-            FileUtils.mv current_resource.home, new_resource.home
-          else
-            logger.trace("Creating users home directory #{new_resource.home}")
-            FileUtils.mkdir_p new_resource.home
-          end
-        end
-
-      end
-    end
-  end
-end
+#
+# Copyright:: Copyright 2012-2018, Chef Software Inc.
+# License:: Apache License, Version 2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require_relative "../user"
+
+class Chef
+  class Provider
+    class User
+      class Aix < Chef::Provider::User
+        provides :user, os: "aix"
+        provides :aix_user
+
+        def create_user
+          shell_out!("useradd", universal_options, useradd_options, new_resource.username)
+          add_password
+        end
+
+        def manage_user
+          add_password
+          manage_home
+          return if universal_options.empty? && usermod_options.empty?
+          shell_out!("usermod", universal_options, usermod_options, new_resource.username)
+        end
+
+        def remove_user
+          shell_out!("userdel", userdel_options, new_resource.username)
+        end
+
+        # Aix does not support -r like other unix, sytem account is created by adding to 'system' group
+        def useradd_options
+          opts = []
+          opts << "-g" << "system" if new_resource.system
+          if updating_home?
+            if new_resource.manage_home
+              logger.trace("#{new_resource} managing the users home directory")
+              opts << "-m"
+            else
+              logger.trace("#{new_resource} setting home to #{new_resource.home}")
+            end
+          end
+          opts
+        end
+
+        def userdel_options
+          opts = []
+          opts << "-r" if new_resource.manage_home
+          opts << "-f" if new_resource.force
+          opts
+        end
+
+        def usermod_options
+          []
+        end
+
+        def check_lock
+          lock_info = shell_out!("lsuser", "-a", "account_locked", new_resource.username)
+          if whyrun_mode? && passwd_s.stdout.empty? && lock_info.stderr.match(/does not exist/)
+            # if we're in whyrun mode and the user is not yet created we assume it would be
+            return false
+          end
+          raise Chef::Exceptions::User, "Cannot determine if #{new_resource} is locked!" if lock_info.stdout.empty?
+
+          status = /\S+\s+account_locked=(\S+)/.match(lock_info.stdout)
+          @locked =
+            if status && status[1] == "true"
+              true
+            else
+              false
+            end
+
+          @locked
+        end
+
+        def lock_user
+          shell_out!("chuser", "account_locked=true", new_resource.username)
+        end
+
+        def unlock_user
+          shell_out!("chuser", "account_locked=false", new_resource.username)
+        end
+
+        def universal_options
+          opts = []
+          opts << "-c" << new_resource.comment if should_set?(:comment)
+          opts << "-g" << new_resource.gid if should_set?(:gid)
+          opts << "-s" << new_resource.shell if should_set?(:shell)
+          opts << "-u" << new_resource.uid if should_set?(:uid)
+          opts << "-d" << new_resource.home if updating_home?
+          opts << "-o" if new_resource.non_unique
+          opts
+        end
+
+        private
+
+        def add_password
+          return unless current_resource.password != new_resource.password && new_resource.password
+          logger.trace("#{new_resource.username} setting password to #{new_resource.password}")
+          command = "echo '#{new_resource.username}:#{new_resource.password}' | chpasswd -e"
+          shell_out!(command)
+        end
+
+        # Aix specific handling to update users home directory.
+        def manage_home
+          return unless updating_home? && new_resource.manage_home
+          # -m option does not work on aix, so move dir.
+          if ::File.directory?(current_resource.home)
+            logger.trace("Changing users home directory from #{current_resource.home} to #{new_resource.home}")
+            FileUtils.mv current_resource.home, new_resource.home
+          else
+            logger.trace("Creating users home directory #{new_resource.home}")
+            FileUtils.mkdir_p new_resource.home
+          end
+        end
+
+      end
+    end
+  end
+end

data/lib/chef/provider/user/dscl.rb

@@ -1,632 +1,632 @@
-#
-# Author:: Dreamcat4 (<dreamcat4@gmail.com>)
-# Copyright:: Copyright 2009-2019, Chef Software Inc.
-# License:: Apache License, Version 2.0
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-#
-
-require_relative "../../mixin/shell_out"
-require_relative "../user"
-require_relative "../../resource/user/dscl_user"
-require "openssl"
-require "plist"
-require_relative "../../util/path_helper"
-
-class Chef
-  class Provider
-    class User
-      #
-      # The most tricky bit of this provider is the way it deals with user passwords.
-      # Mac OS X has different password shadow calculations based on the version.
-      # < 10.7  => password shadow calculation format SALTED-SHA1
-      #         => stored in: /var/db/shadow/hash/#{guid}
-      #         => shadow binary length 68 bytes
-      #         => First 4 bytes salt / Next 64 bytes shadow value
-      # = 10.7  => password shadow calculation format SALTED-SHA512
-      #         => stored in: /var/db/dslocal/nodes/Default/users/#{name}.plist
-      #         => shadow binary length 68 bytes
-      #         => First 4 bytes salt / Next 64 bytes shadow value
-      # > 10.7  => password shadow calculation format SALTED-SHA512-PBKDF2
-      #         => stored in: /var/db/dslocal/nodes/Default/users/#{name}.plist
-      #         => shadow binary length 128 bytes
-      #         => Salt / Iterations are stored separately in the same file
-      #
-      # This provider only supports Mac OSX versions 10.7 and above
-      class Dscl < Chef::Provider::User
-
-        attr_accessor :user_info
-        attr_accessor :authentication_authority
-        attr_accessor :password_shadow_conversion_algorithm
-
-        provides :dscl_user
-        provides :user, os: "darwin"
-
-        # Just-in-case a recipe calls the user dscl provider without specifying
-        # a gid property. Avoids chown issues in move_home when the manage_home
-        # property is in use. #5393
-        STAFF_GROUP_ID = 20
-
-        def define_resource_requirements
-          super
-
-          requirements.assert(:all_actions) do |a|
-            a.assertion { ::File.exist?("/usr/bin/dscl") }
-            a.failure_message(Chef::Exceptions::User, "Cannot find binary '/usr/bin/dscl' on the system for #{new_resource}!")
-          end
-
-          requirements.assert(:all_actions) do |a|
-            a.assertion { ::File.exist?("/usr/bin/plutil") }
-            a.failure_message(Chef::Exceptions::User, "Cannot find binary '/usr/bin/plutil' on the system for #{new_resource}!")
-          end
-
-          requirements.assert(:create, :modify, :manage) do |a|
-            a.assertion do
-              if new_resource.password
-                # SALTED-SHA512 password shadow hashes are not supported on 10.8 and above.
-                !salted_sha512?(new_resource.password)
-              else
-                true
-              end
-            end
-            a.failure_message(Chef::Exceptions::User, "SALTED-SHA512 passwords are not supported on Mac 10.8 and above. \
-If you want to set the user password using shadow info make sure you specify a SALTED-SHA512-PBKDF2 shadow hash \
-in 'password', with the associated 'salt' and 'iterations'.")
-          end
-
-          requirements.assert(:create, :modify, :manage) do |a|
-            a.assertion do
-              if new_resource.password && salted_sha512_pbkdf2?(new_resource.password)
-                # salt and iterations should be specified when
-                # SALTED-SHA512-PBKDF2 password shadow hash is given
-                !new_resource.salt.nil? && !new_resource.iterations.nil?
-              else
-                true
-              end
-            end
-            a.failure_message(Chef::Exceptions::User, "SALTED-SHA512-PBKDF2 shadow hash is given without associated \
-'salt' and 'iterations'. Please specify 'salt' and 'iterations' in order to set the user password using shadow hash.")
-          end
-        end
-
-        def load_current_resource
-          @current_resource = Chef::Resource::User::DsclUser.new(new_resource.username)
-          current_resource.username(new_resource.username)
-
-          @user_info = read_user_info
-          if user_info
-            current_resource.uid(dscl_get(user_info, :uid))
-            current_resource.gid(dscl_get(user_info, :gid))
-            current_resource.home(dscl_get(user_info, :home))
-            current_resource.shell(dscl_get(user_info, :shell))
-            current_resource.comment(dscl_get(user_info, :comment))
-            @authentication_authority = dscl_get(user_info, :auth_authority)
-
-            if new_resource.password && dscl_get(user_info, :password) == "********"
-              # A password is set. Let's get the password information from shadow file
-              shadow_hash_binary = dscl_get(user_info, :shadow_hash)
-
-              # Calling shell_out directly since we want to give an input stream
-              shadow_hash_xml = convert_binary_plist_to_xml(shadow_hash_binary.string)
-              shadow_hash = Plist.parse_xml(shadow_hash_xml)
-
-              if shadow_hash["SALTED-SHA512-PBKDF2"] # 10.7+ contains this, but we retain the check in case it goes away in the future
-                @password_shadow_conversion_algorithm = "SALTED-SHA512-PBKDF2"
-                # Convert the entropy from Base64 encoding to hex before consuming them
-                current_resource.password(shadow_hash["SALTED-SHA512-PBKDF2"]["entropy"].string.unpack("H*").first)
-                current_resource.iterations(shadow_hash["SALTED-SHA512-PBKDF2"]["iterations"])
-                # Convert the salt from Base64 encoding to hex before consuming them
-                current_resource.salt(shadow_hash["SALTED-SHA512-PBKDF2"]["salt"].string.unpack("H*").first)
-              else
-                raise(Chef::Exceptions::User, "Unknown shadow_hash format: #{shadow_hash.keys.join(' ')}")
-              end
-            end
-
-            convert_group_name if new_resource.gid
-          else
-            @user_exists = false
-            logger.trace("#{new_resource} user does not exist")
-          end
-
-          current_resource
-        end
-
-        #
-        # Provider Actions
-        #
-
-        def create_user
-          dscl_create_user
-          # set_password modifies the plist file of the user directly. So update
-          # the password first before making any modifications to the user.
-          set_password
-          dscl_create_comment
-          dscl_set_uid
-          dscl_set_gid
-          dscl_set_home
-          dscl_set_shell
-        end
-
-        def manage_user
-          # set_password modifies the plist file of the user directly. So update
-          # the password first before making any modifications to the user.
-          set_password        if diverged_password?
-          dscl_create_user    if diverged?(:username)
-          dscl_create_comment if diverged?(:comment)
-          dscl_set_uid        if diverged?(:uid)
-          dscl_set_gid        if diverged?(:gid)
-          dscl_set_home       if diverged?(:home)
-          dscl_set_shell      if diverged?(:shell)
-        end
-
-        #
-        # Action Helpers
-        #
-
-        #
-        # Create a user using dscl
-        #
-        def dscl_create_user
-          run_dscl("create", "/Users/#{new_resource.username}")
-        end
-
-        #
-        # Saves the specified Chef user `comment` into RealName attribute
-        # of Mac user. If `comment` is not specified, it takes `username` value.
-        #
-        def dscl_create_comment
-          comment = new_resource.comment || new_resource.username
-          run_dscl("create", "/Users/#{new_resource.username}", "RealName", comment)
-        end
-
-        #
-        # Sets the user id for the user using dscl.
-        # If a `uid` is not specified, it finds the next available one starting
-        # from 200 if `system` is set, 501 otherwise.
-        #
-        def dscl_set_uid
-          # XXX: mutates the new resource
-          new_resource.uid(get_free_uid) if new_resource.uid.nil? || new_resource.uid == ""
-
-          if uid_used?(new_resource.uid)
-            raise(Chef::Exceptions::RequestedUIDUnavailable, "uid #{new_resource.uid} is already in use")
-          end
-
-          run_dscl("create", "/Users/#{new_resource.username}", "UniqueID", new_resource.uid)
-        end
-
-        #
-        # Find the next available uid on the system. starting with 200 if `system` is set,
-        # 501 otherwise.
-        #
-        def get_free_uid(search_limit = 1000)
-          uid = nil
-          base_uid = new_resource.system ? 200 : 501
-          next_uid_guess = base_uid
-          users_uids = run_dscl("list", "/Users", "uid")
-          while next_uid_guess < search_limit + base_uid
-            if users_uids =~ Regexp.new("#{Regexp.escape(next_uid_guess.to_s)}\n")
-              next_uid_guess += 1
-            else
-              uid = next_uid_guess
-              break
-            end
-          end
-          uid || raise("uid not found. Exhausted. Searched #{search_limit} times")
-        end
-
-        #
-        # Returns true if uid is in use by a different account, false otherwise.
-        #
-        def uid_used?(uid)
-          return false unless uid
-          users_uids = run_dscl("list", "/Users", "uid").split("\n")
-          uid_map = users_uids.each_with_object({}) do |tuid, tmap|
-            x = tuid.split
-            tmap[x[1]] = x[0]
-            tmap
-          end
-          if uid_map[uid.to_s]
-            unless uid_map[uid.to_s] == new_resource.username
-              return true
-            end
-          end
-          false
-        end
-
-        #
-        # Sets the group id for the user using dscl. Fails if a group doesn't
-        # exist on the system with given group id. If `gid` is not specified, it
-        # sets a default Mac user group "staff", with id 20 using the CONSTANT
-        #
-        def dscl_set_gid
-          if new_resource.gid.nil?
-            # XXX: mutates the new resource
-            new_resource.gid(STAFF_GROUP_ID)
-          elsif !new_resource.gid.to_s.match(/^\d+$/)
-            begin
-              possible_gid = run_dscl("read", "/Groups/#{new_resource.gid}", "PrimaryGroupID").split(" ").last
-            rescue Chef::Exceptions::DsclCommandFailed
-              raise Chef::Exceptions::GroupIDNotFound, "Group not found for #{new_resource.gid} when creating user #{new_resource.username}"
-            end
-            # XXX: mutates the new resource
-            new_resource.gid(possible_gid) if possible_gid && possible_gid.match(/^\d+$/)
-          end
-          run_dscl("create", "/Users/#{new_resource.username}", "PrimaryGroupID", new_resource.gid)
-        end
-
-        #
-        # Sets the home directory for the user. If `:manage_home` is set home
-        # directory is managed (moved / created) for the user.
-        #
-        def dscl_set_home
-          if new_resource.home.nil? || new_resource.home.empty?
-            run_dscl("delete", "/Users/#{new_resource.username}", "NFSHomeDirectory")
-            return
-          end
-
-          if new_resource.manage_home
-            validate_home_dir_specification!
-
-            if (current_resource.home == new_resource.home) && !new_home_exists?
-              ditto_home
-            elsif !current_home_exists? && !new_home_exists?
-              ditto_home
-            elsif current_home_exists?
-              move_home
-            end
-          end
-          run_dscl("create", "/Users/#{new_resource.username}", "NFSHomeDirectory", new_resource.home)
-        end
-
-        def validate_home_dir_specification!
-          unless new_resource.home =~ /^\//
-            raise(Chef::Exceptions::InvalidHomeDirectory, "invalid path spec for User: '#{new_resource.username}', home directory: '#{new_resource.home}'")
-          end
-        end
-
-        def current_home_exists?
-          !!current_resource.home && ::File.exist?(current_resource.home)
-        end
-
-        def new_home_exists?
-          ::File.exist?(new_resource.home)
-        end
-
-        def ditto_home
-          shell_out!("/usr/sbin/createhomedir", "-c", "-u", (new_resource.username).to_s)
-        end
-
-        def move_home
-          logger.trace("#{new_resource} moving #{self} home from #{current_resource.home} to #{new_resource.home}")
-          new_resource.gid(STAFF_GROUP_ID) if new_resource.gid.nil?
-          src = current_resource.home
-          FileUtils.mkdir_p(new_resource.home)
-          files = ::Dir.glob("#{Chef::Util::PathHelper.escape_glob_dir(src)}/*", ::File::FNM_DOTMATCH) - ["#{src}/.", "#{src}/.."]
-          ::FileUtils.mv(files, new_resource.home, force: true)
-          ::FileUtils.rmdir(src)
-          ::FileUtils.chown_R(new_resource.username, new_resource.gid.to_s, new_resource.home)
-        end
-
-        #
-        # Sets the shell for the user using dscl.
-        #
-        def dscl_set_shell
-          if new_resource.shell
-            run_dscl("create", "/Users/#{new_resource.username}", "UserShell", new_resource.shell)
-          else
-            run_dscl("create", "/Users/#{new_resource.username}", "UserShell", "/usr/bin/false")
-          end
-        end
-
-        #
-        # Sets the password for the user based on given password parameters.
-        # Chef supports specifying plain-text passwords and password shadow
-        # hash data.
-        #
-        def set_password
-          # Return if there is no password to set
-          return if new_resource.password.nil?
-
-          shadow_info = prepare_password_shadow_info
-
-          # Shadow info is saved as binary plist. Convert the info to binary plist.
-          shadow_info_binary = StringIO.new
-          shell_out("plutil", "-convert", "binary1", "-o", "-", "-",
-                            input: shadow_info.to_plist, live_stream: shadow_info_binary)
-
-          if user_info.nil?
-            # User is  just created. read_user_info() will read the fresh information
-            # for the user with a cache flush. However with experimentation we've seen
-            # that dscl cache is not immediately updated after the creation of the user
-            # This is odd and needs to be investigated further.
-            sleep 3
-            @user_info = read_user_info
-          end
-
-          # Replace the shadow info in user's plist
-          dscl_set(user_info, :shadow_hash, shadow_info_binary)
-          save_user_info(user_info)
-        end
-
-        #
-        # Prepares the password shadow info based on the platform version.
-        #
-        def prepare_password_shadow_info
-          shadow_info = {}
-          entropy = nil
-          salt = nil
-          iterations = nil
-
-          if salted_sha512_pbkdf2?(new_resource.password)
-            entropy = convert_to_binary(new_resource.password)
-            salt = convert_to_binary(new_resource.salt)
-            iterations = new_resource.iterations
-          else
-            salt = OpenSSL::Random.random_bytes(32)
-            iterations = new_resource.iterations # Use the default if not specified by the user
-
-            entropy = OpenSSL::PKCS5.pbkdf2_hmac(
-              new_resource.password,
-              salt,
-              iterations,
-              128,
-              OpenSSL::Digest::SHA512.new
-            )
-          end
-
-          pbkdf_info = {}
-          pbkdf_info["entropy"] = StringIO.new
-          pbkdf_info["entropy"].string = entropy
-          pbkdf_info["salt"] = StringIO.new
-          pbkdf_info["salt"].string = salt
-          pbkdf_info["iterations"] = iterations
-
-          shadow_info["SALTED-SHA512-PBKDF2"] = pbkdf_info
-          shadow_info
-        end
-
-        #
-        # Removes the user from the system after removing user from his groups
-        # and deleting home directory if needed.
-        #
-        def remove_user
-          if new_resource.manage_home
-            # Remove home directory
-            FileUtils.rm_rf(current_resource.home)
-          end
-
-          # Remove the user from its groups
-          run_dscl("list", "/Groups").each_line do |group|
-            if member_of_group?(group.chomp)
-              run_dscl("delete", "/Groups/#{group.chomp}", "GroupMembership", new_resource.username)
-            end
-          end
-
-          # Remove user account
-          run_dscl("delete", "/Users/#{new_resource.username}")
-        end
-
-        #
-        # Locks the user.
-        #
-        def lock_user
-          run_dscl("append", "/Users/#{new_resource.username}", "AuthenticationAuthority", ";DisabledUser;")
-        end
-
-        #
-        # Unlocks the user
-        #
-        def unlock_user
-          auth_string = authentication_authority.gsub(/AuthenticationAuthority: /, "").gsub(/;DisabledUser;/, "").strip
-          run_dscl("create", "/Users/#{new_resource.username}", "AuthenticationAuthority", auth_string)
-        end
-
-        #
-        # Returns true if the user is locked, false otherwise.
-        #
-        def locked?
-          if authentication_authority
-            !!(authentication_authority =~ /DisabledUser/ )
-          else
-            false
-          end
-        end
-
-        #
-        # This is the interface base User provider requires to provide idempotency.
-        #
-        def check_lock
-          @locked = locked?
-        end
-
-        #
-        # Helper functions
-        #
-
-        #
-        # Returns true if the system state and desired state is different for
-        # given attribute.
-        #
-        def diverged?(parameter)
-          parameter_updated?(parameter) && !new_resource.send(parameter).nil?
-        end
-
-        def parameter_updated?(parameter)
-          !(new_resource.send(parameter) == current_resource.send(parameter))
-        end
-
-        #
-        # We need a special check function for password since we support both
-        # plain text and shadow hash data.
-        #
-        # Checks if password needs update based on platform version and the
-        # type of the password specified.
-        #
-        def diverged_password?
-          return false if new_resource.password.nil?
-
-          # Dscl provider supports both plain text passwords and shadow hashes.
-          #
-          # Some system users don't have salts; this can happen if the system is
-          # upgraded and the user hasn't logged in yet. In this case, we will force
-          # the password to be updated.
-          return true if current_resource.salt.nil?
-
-          if salted_sha512_pbkdf2?(new_resource.password)
-            diverged?(:password) || diverged?(:salt) || diverged?(:iterations)
-          else
-            !salted_sha512_pbkdf2_password_match?
-          end
-        end
-
-        #
-        # Returns true if user is member of the specified group, false otherwise.
-        #
-        def member_of_group?(group_name)
-          membership_info = ""
-          begin
-            membership_info = run_dscl("read", "/Groups/#{group_name}")
-          rescue Chef::Exceptions::DsclCommandFailed
-            # Raised if the group doesn't contain any members
-          end
-          # Output is something like:
-          # GroupMembership: root admin etc
-          members = membership_info.split(" ")
-          members.shift # Get rid of GroupMembership: string
-          members.include?(new_resource.username)
-        end
-
-        #
-        # DSCL Helper functions
-        #
-
-        # A simple map of Chef's terms to DSCL's terms.
-        DSCL_PROPERTY_MAP = {
-          uid: "uid",
-          gid: "gid",
-          home: "home",
-          shell: "shell",
-          comment: "realname",
-          password: "passwd",
-          auth_authority: "authentication_authority",
-          shadow_hash: "ShadowHashData",
-        }.freeze
-
-        # Directory where the user plist files are stored for versions 10.7 and above
-        USER_PLIST_DIRECTORY = "/var/db/dslocal/nodes/Default/users".freeze
-
-        #
-        # Reads the user plist and returns a hash keyed with DSCL properties specified
-        # in DSCL_PROPERTY_MAP. Return nil if the user is not found.
-        #
-        def read_user_info
-          user_info = nil
-
-          # We flush the cache here in order to make sure that we read fresh information
-          # for the user.
-          shell_out("dscacheutil", "-flushcache") # FIXME: this is MacOS version dependent
-
-          begin
-            user_plist_file = "#{USER_PLIST_DIRECTORY}/#{new_resource.username}.plist"
-            user_plist_info = run_plutil("convert", "xml1", "-o", "-", user_plist_file)
-            user_info = Plist.parse_xml(user_plist_info)
-          rescue Chef::Exceptions::PlistUtilCommandFailed
-          end
-
-          user_info
-        end
-
-        #
-        # Saves the given hash keyed with DSCL properties specified
-        # in DSCL_PROPERTY_MAP to the disk.
-        #
-        def save_user_info(user_info)
-          user_plist_file = "#{USER_PLIST_DIRECTORY}/#{new_resource.username}.plist"
-          Plist::Emit.save_plist(user_info, user_plist_file)
-          run_plutil("convert", "binary1", user_plist_file)
-        end
-
-        #
-        # Sets a value in user information hash using Chef attributes as keys.
-        #
-        def dscl_set(user_hash, key, value)
-          raise "Unknown dscl key #{key}" unless DSCL_PROPERTY_MAP.keys.include?(key)
-          user_hash[DSCL_PROPERTY_MAP[key]] = [ value ]
-          user_hash
-        end
-
-        #
-        # Gets a value from user information hash using Chef attributes as keys.
-        #
-        def dscl_get(user_hash, key)
-          raise "Unknown dscl key #{key}" unless DSCL_PROPERTY_MAP.keys.include?(key)
-          # DSCL values are set as arrays
-          value = user_hash[DSCL_PROPERTY_MAP[key]]
-          value.nil? ? value : value.first
-        end
-
-        #
-        # System Helpers
-        #
-
-        def run_dscl(*args)
-          result = shell_out("dscl", ".", "-#{args[0]}", args[1..-1])
-          return "" if ( args.first =~ /^delete/ ) && ( result.exitstatus != 0 )
-          raise(Chef::Exceptions::DsclCommandFailed, "dscl error: #{result.inspect}") unless result.exitstatus == 0
-          raise(Chef::Exceptions::DsclCommandFailed, "dscl error: #{result.inspect}") if result.stdout =~ /No such key: /
-          result.stdout
-        end
-
-        def run_plutil(*args)
-          result = shell_out("plutil", "-#{args[0]}", args[1..-1])
-          raise(Chef::Exceptions::PlistUtilCommandFailed, "plutil error: #{result.inspect}") unless result.exitstatus == 0
-          if result.stdout.encoding == Encoding::ASCII_8BIT
-            result.stdout.encode("utf-8", "binary", undef: :replace, invalid: :replace, replace: "?")
-          else
-            result.stdout
-          end
-        end
-
-        def convert_binary_plist_to_xml(binary_plist_string)
-          shell_out("plutil", "-convert", "xml1", "-o", "-", "-", input: binary_plist_string).stdout
-        end
-
-        def convert_to_binary(string)
-          string.unpack("a2" * (string.size / 2)).collect { |i| i.hex.chr }.join
-        end
-
-        def salted_sha512?(string)
-          !!(string =~ /^[[:xdigit:]]{136}$/)
-        end
-
-        def salted_sha512_pbkdf2?(string)
-          !!(string =~ /^[[:xdigit:]]{256}$/)
-        end
-
-        def salted_sha512_pbkdf2_password_match?
-          salt = convert_to_binary(current_resource.salt)
-
-          OpenSSL::PKCS5.pbkdf2_hmac(
-            new_resource.password,
-            salt,
-            current_resource.iterations,
-            128,
-            OpenSSL::Digest::SHA512.new
-          ).unpack("H*").first == current_resource.password
-        end
-
-      end
-    end
-  end
-end
+#
+# Author:: Dreamcat4 (<dreamcat4@gmail.com>)
+# Copyright:: Copyright 2009-2019, Chef Software Inc.
+# License:: Apache License, Version 2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+require_relative "../../mixin/shell_out"
+require_relative "../user"
+require_relative "../../resource/user/dscl_user"
+require "openssl" unless defined?(OpenSSL)
+require "plist"
+require_relative "../../util/path_helper"
+
+class Chef
+  class Provider
+    class User
+      #
+      # The most tricky bit of this provider is the way it deals with user passwords.
+      # Mac OS X has different password shadow calculations based on the version.
+      # < 10.7  => password shadow calculation format SALTED-SHA1
+      #         => stored in: /var/db/shadow/hash/#{guid}
+      #         => shadow binary length 68 bytes
+      #         => First 4 bytes salt / Next 64 bytes shadow value
+      # = 10.7  => password shadow calculation format SALTED-SHA512
+      #         => stored in: /var/db/dslocal/nodes/Default/users/#{name}.plist
+      #         => shadow binary length 68 bytes
+      #         => First 4 bytes salt / Next 64 bytes shadow value
+      # > 10.7  => password shadow calculation format SALTED-SHA512-PBKDF2
+      #         => stored in: /var/db/dslocal/nodes/Default/users/#{name}.plist
+      #         => shadow binary length 128 bytes
+      #         => Salt / Iterations are stored separately in the same file
+      #
+      # This provider only supports Mac OSX versions 10.7 and above
+      class Dscl < Chef::Provider::User
+
+        attr_accessor :user_info
+        attr_accessor :authentication_authority
+        attr_accessor :password_shadow_conversion_algorithm
+
+        provides :dscl_user
+        provides :user, os: "darwin"
+
+        # Just-in-case a recipe calls the user dscl provider without specifying
+        # a gid property. Avoids chown issues in move_home when the manage_home
+        # property is in use. #5393
+        STAFF_GROUP_ID = 20
+
+        def define_resource_requirements
+          super
+
+          requirements.assert(:all_actions) do |a|
+            a.assertion { ::File.exist?("/usr/bin/dscl") }
+            a.failure_message(Chef::Exceptions::User, "Cannot find binary '/usr/bin/dscl' on the system for #{new_resource}!")
+          end
+
+          requirements.assert(:all_actions) do |a|
+            a.assertion { ::File.exist?("/usr/bin/plutil") }
+            a.failure_message(Chef::Exceptions::User, "Cannot find binary '/usr/bin/plutil' on the system for #{new_resource}!")
+          end
+
+          requirements.assert(:create, :modify, :manage) do |a|
+            a.assertion do
+              if new_resource.password
+                # SALTED-SHA512 password shadow hashes are not supported on 10.8 and above.
+                !salted_sha512?(new_resource.password)
+              else
+                true
+              end
+            end
+            a.failure_message(Chef::Exceptions::User, "SALTED-SHA512 passwords are not supported on Mac 10.8 and above. \
+If you want to set the user password using shadow info make sure you specify a SALTED-SHA512-PBKDF2 shadow hash \
+in 'password', with the associated 'salt' and 'iterations'.")
+          end
+
+          requirements.assert(:create, :modify, :manage) do |a|
+            a.assertion do
+              if new_resource.password && salted_sha512_pbkdf2?(new_resource.password)
+                # salt and iterations should be specified when
+                # SALTED-SHA512-PBKDF2 password shadow hash is given
+                !new_resource.salt.nil? && !new_resource.iterations.nil?
+              else
+                true
+              end
+            end
+            a.failure_message(Chef::Exceptions::User, "SALTED-SHA512-PBKDF2 shadow hash is given without associated \
+'salt' and 'iterations'. Please specify 'salt' and 'iterations' in order to set the user password using shadow hash.")
+          end
+        end
+
+        def load_current_resource
+          @current_resource = Chef::Resource::User::DsclUser.new(new_resource.username)
+          current_resource.username(new_resource.username)
+
+          @user_info = read_user_info
+          if user_info
+            current_resource.uid(dscl_get(user_info, :uid))
+            current_resource.gid(dscl_get(user_info, :gid))
+            current_resource.home(dscl_get(user_info, :home))
+            current_resource.shell(dscl_get(user_info, :shell))
+            current_resource.comment(dscl_get(user_info, :comment))
+            @authentication_authority = dscl_get(user_info, :auth_authority)
+
+            if new_resource.password && dscl_get(user_info, :password) == "********"
+              # A password is set. Let's get the password information from shadow file
+              shadow_hash_binary = dscl_get(user_info, :shadow_hash)
+
+              # Calling shell_out directly since we want to give an input stream
+              shadow_hash_xml = convert_binary_plist_to_xml(shadow_hash_binary.string)
+              shadow_hash = Plist.parse_xml(shadow_hash_xml)
+
+              if shadow_hash["SALTED-SHA512-PBKDF2"] # 10.7+ contains this, but we retain the check in case it goes away in the future
+                @password_shadow_conversion_algorithm = "SALTED-SHA512-PBKDF2"
+                # Convert the entropy from Base64 encoding to hex before consuming them
+                current_resource.password(shadow_hash["SALTED-SHA512-PBKDF2"]["entropy"].string.unpack("H*").first)
+                current_resource.iterations(shadow_hash["SALTED-SHA512-PBKDF2"]["iterations"])
+                # Convert the salt from Base64 encoding to hex before consuming them
+                current_resource.salt(shadow_hash["SALTED-SHA512-PBKDF2"]["salt"].string.unpack("H*").first)
+              else
+                raise(Chef::Exceptions::User, "Unknown shadow_hash format: #{shadow_hash.keys.join(' ')}")
+              end
+            end
+
+            convert_group_name if new_resource.gid
+          else
+            @user_exists = false
+            logger.trace("#{new_resource} user does not exist")
+          end
+
+          current_resource
+        end
+
+        #
+        # Provider Actions
+        #
+
+        def create_user
+          dscl_create_user
+          # set_password modifies the plist file of the user directly. So update
+          # the password first before making any modifications to the user.
+          set_password
+          dscl_create_comment
+          dscl_set_uid
+          dscl_set_gid
+          dscl_set_home
+          dscl_set_shell
+        end
+
+        def manage_user
+          # set_password modifies the plist file of the user directly. So update
+          # the password first before making any modifications to the user.
+          set_password        if diverged_password?
+          dscl_create_user    if diverged?(:username)
+          dscl_create_comment if diverged?(:comment)
+          dscl_set_uid        if diverged?(:uid)
+          dscl_set_gid        if diverged?(:gid)
+          dscl_set_home       if diverged?(:home)
+          dscl_set_shell      if diverged?(:shell)
+        end
+
+        #
+        # Action Helpers
+        #
+
+        #
+        # Create a user using dscl
+        #
+        def dscl_create_user
+          run_dscl("create", "/Users/#{new_resource.username}")
+        end
+
+        #
+        # Saves the specified Chef user `comment` into RealName attribute
+        # of Mac user. If `comment` is not specified, it takes `username` value.
+        #
+        def dscl_create_comment
+          comment = new_resource.comment || new_resource.username
+          run_dscl("create", "/Users/#{new_resource.username}", "RealName", comment)
+        end
+
+        #
+        # Sets the user id for the user using dscl.
+        # If a `uid` is not specified, it finds the next available one starting
+        # from 200 if `system` is set, 501 otherwise.
+        #
+        def dscl_set_uid
+          # XXX: mutates the new resource
+          new_resource.uid(get_free_uid) if new_resource.uid.nil? || new_resource.uid == ""
+
+          if uid_used?(new_resource.uid)
+            raise(Chef::Exceptions::RequestedUIDUnavailable, "uid #{new_resource.uid} is already in use")
+          end
+
+          run_dscl("create", "/Users/#{new_resource.username}", "UniqueID", new_resource.uid)
+        end
+
+        #
+        # Find the next available uid on the system. starting with 200 if `system` is set,
+        # 501 otherwise.
+        #
+        def get_free_uid(search_limit = 1000)
+          uid = nil
+          base_uid = new_resource.system ? 200 : 501
+          next_uid_guess = base_uid
+          users_uids = run_dscl("list", "/Users", "uid")
+          while next_uid_guess < search_limit + base_uid
+            if users_uids =~ Regexp.new("#{Regexp.escape(next_uid_guess.to_s)}\n")
+              next_uid_guess += 1
+            else
+              uid = next_uid_guess
+              break
+            end
+          end
+          uid || raise("uid not found. Exhausted. Searched #{search_limit} times")
+        end
+
+        #
+        # Returns true if uid is in use by a different account, false otherwise.
+        #
+        def uid_used?(uid)
+          return false unless uid
+          users_uids = run_dscl("list", "/Users", "uid").split("\n")
+          uid_map = users_uids.each_with_object({}) do |tuid, tmap|
+            x = tuid.split
+            tmap[x[1]] = x[0]
+            tmap
+          end
+          if uid_map[uid.to_s]
+            unless uid_map[uid.to_s] == new_resource.username
+              return true
+            end
+          end
+          false
+        end
+
+        #
+        # Sets the group id for the user using dscl. Fails if a group doesn't
+        # exist on the system with given group id. If `gid` is not specified, it
+        # sets a default Mac user group "staff", with id 20 using the CONSTANT
+        #
+        def dscl_set_gid
+          if new_resource.gid.nil?
+            # XXX: mutates the new resource
+            new_resource.gid(STAFF_GROUP_ID)
+          elsif !new_resource.gid.to_s.match(/^\d+$/)
+            begin
+              possible_gid = run_dscl("read", "/Groups/#{new_resource.gid}", "PrimaryGroupID").split(" ").last
+            rescue Chef::Exceptions::DsclCommandFailed
+              raise Chef::Exceptions::GroupIDNotFound, "Group not found for #{new_resource.gid} when creating user #{new_resource.username}"
+            end
+            # XXX: mutates the new resource
+            new_resource.gid(possible_gid) if possible_gid && possible_gid.match(/^\d+$/)
+          end
+          run_dscl("create", "/Users/#{new_resource.username}", "PrimaryGroupID", new_resource.gid)
+        end
+
+        #
+        # Sets the home directory for the user. If `:manage_home` is set home
+        # directory is managed (moved / created) for the user.
+        #
+        def dscl_set_home
+          if new_resource.home.nil? || new_resource.home.empty?
+            run_dscl("delete", "/Users/#{new_resource.username}", "NFSHomeDirectory")
+            return
+          end
+
+          if new_resource.manage_home
+            validate_home_dir_specification!
+
+            if (current_resource.home == new_resource.home) && !new_home_exists?
+              ditto_home
+            elsif !current_home_exists? && !new_home_exists?
+              ditto_home
+            elsif current_home_exists?
+              move_home
+            end
+          end
+          run_dscl("create", "/Users/#{new_resource.username}", "NFSHomeDirectory", new_resource.home)
+        end
+
+        def validate_home_dir_specification!
+          unless new_resource.home =~ /^\//
+            raise(Chef::Exceptions::InvalidHomeDirectory, "invalid path spec for User: '#{new_resource.username}', home directory: '#{new_resource.home}'")
+          end
+        end
+
+        def current_home_exists?
+          !!current_resource.home && ::File.exist?(current_resource.home)
+        end
+
+        def new_home_exists?
+          ::File.exist?(new_resource.home)
+        end
+
+        def ditto_home
+          shell_out!("/usr/sbin/createhomedir", "-c", "-u", (new_resource.username).to_s)
+        end
+
+        def move_home
+          logger.trace("#{new_resource} moving #{self} home from #{current_resource.home} to #{new_resource.home}")
+          new_resource.gid(STAFF_GROUP_ID) if new_resource.gid.nil?
+          src = current_resource.home
+          FileUtils.mkdir_p(new_resource.home)
+          files = ::Dir.glob("#{Chef::Util::PathHelper.escape_glob_dir(src)}/*", ::File::FNM_DOTMATCH) - ["#{src}/.", "#{src}/.."]
+          ::FileUtils.mv(files, new_resource.home, force: true)
+          ::FileUtils.rmdir(src)
+          ::FileUtils.chown_R(new_resource.username, new_resource.gid.to_s, new_resource.home)
+        end
+
+        #
+        # Sets the shell for the user using dscl.
+        #
+        def dscl_set_shell
+          if new_resource.shell
+            run_dscl("create", "/Users/#{new_resource.username}", "UserShell", new_resource.shell)
+          else
+            run_dscl("create", "/Users/#{new_resource.username}", "UserShell", "/usr/bin/false")
+          end
+        end
+
+        #
+        # Sets the password for the user based on given password parameters.
+        # Chef supports specifying plain-text passwords and password shadow
+        # hash data.
+        #
+        def set_password
+          # Return if there is no password to set
+          return if new_resource.password.nil?
+
+          shadow_info = prepare_password_shadow_info
+
+          # Shadow info is saved as binary plist. Convert the info to binary plist.
+          shadow_info_binary = StringIO.new
+          shell_out("plutil", "-convert", "binary1", "-o", "-", "-",
+                            input: shadow_info.to_plist, live_stream: shadow_info_binary)
+
+          if user_info.nil?
+            # User is  just created. read_user_info() will read the fresh information
+            # for the user with a cache flush. However with experimentation we've seen
+            # that dscl cache is not immediately updated after the creation of the user
+            # This is odd and needs to be investigated further.
+            sleep 3
+            @user_info = read_user_info
+          end
+
+          # Replace the shadow info in user's plist
+          dscl_set(user_info, :shadow_hash, shadow_info_binary)
+          save_user_info(user_info)
+        end
+
+        #
+        # Prepares the password shadow info based on the platform version.
+        #
+        def prepare_password_shadow_info
+          shadow_info = {}
+          entropy = nil
+          salt = nil
+          iterations = nil
+
+          if salted_sha512_pbkdf2?(new_resource.password)
+            entropy = convert_to_binary(new_resource.password)
+            salt = convert_to_binary(new_resource.salt)
+            iterations = new_resource.iterations
+          else
+            salt = OpenSSL::Random.random_bytes(32)
+            iterations = new_resource.iterations # Use the default if not specified by the user
+
+            entropy = OpenSSL::PKCS5.pbkdf2_hmac(
+              new_resource.password,
+              salt,
+              iterations,
+              128,
+              OpenSSL::Digest::SHA512.new
+            )
+          end
+
+          pbkdf_info = {}
+          pbkdf_info["entropy"] = StringIO.new
+          pbkdf_info["entropy"].string = entropy
+          pbkdf_info["salt"] = StringIO.new
+          pbkdf_info["salt"].string = salt
+          pbkdf_info["iterations"] = iterations
+
+          shadow_info["SALTED-SHA512-PBKDF2"] = pbkdf_info
+          shadow_info
+        end
+
+        #
+        # Removes the user from the system after removing user from his groups
+        # and deleting home directory if needed.
+        #
+        def remove_user
+          if new_resource.manage_home
+            # Remove home directory
+            FileUtils.rm_rf(current_resource.home)
+          end
+
+          # Remove the user from its groups
+          run_dscl("list", "/Groups").each_line do |group|
+            if member_of_group?(group.chomp)
+              run_dscl("delete", "/Groups/#{group.chomp}", "GroupMembership", new_resource.username)
+            end
+          end
+
+          # Remove user account
+          run_dscl("delete", "/Users/#{new_resource.username}")
+        end
+
+        #
+        # Locks the user.
+        #
+        def lock_user
+          run_dscl("append", "/Users/#{new_resource.username}", "AuthenticationAuthority", ";DisabledUser;")
+        end
+
+        #
+        # Unlocks the user
+        #
+        def unlock_user
+          auth_string = authentication_authority.gsub(/AuthenticationAuthority: /, "").gsub(/;DisabledUser;/, "").strip
+          run_dscl("create", "/Users/#{new_resource.username}", "AuthenticationAuthority", auth_string)
+        end
+
+        #
+        # Returns true if the user is locked, false otherwise.
+        #
+        def locked?
+          if authentication_authority
+            !!(authentication_authority =~ /DisabledUser/ )
+          else
+            false
+          end
+        end
+
+        #
+        # This is the interface base User provider requires to provide idempotency.
+        #
+        def check_lock
+          @locked = locked?
+        end
+
+        #
+        # Helper functions
+        #
+
+        #
+        # Returns true if the system state and desired state is different for
+        # given attribute.
+        #
+        def diverged?(parameter)
+          parameter_updated?(parameter) && !new_resource.send(parameter).nil?
+        end
+
+        def parameter_updated?(parameter)
+          !(new_resource.send(parameter) == current_resource.send(parameter))
+        end
+
+        #
+        # We need a special check function for password since we support both
+        # plain text and shadow hash data.
+        #
+        # Checks if password needs update based on platform version and the
+        # type of the password specified.
+        #
+        def diverged_password?
+          return false if new_resource.password.nil?
+
+          # Dscl provider supports both plain text passwords and shadow hashes.
+          #
+          # Some system users don't have salts; this can happen if the system is
+          # upgraded and the user hasn't logged in yet. In this case, we will force
+          # the password to be updated.
+          return true if current_resource.salt.nil?
+
+          if salted_sha512_pbkdf2?(new_resource.password)
+            diverged?(:password) || diverged?(:salt) || diverged?(:iterations)
+          else
+            !salted_sha512_pbkdf2_password_match?
+          end
+        end
+
+        #
+        # Returns true if user is member of the specified group, false otherwise.
+        #
+        def member_of_group?(group_name)
+          membership_info = ""
+          begin
+            membership_info = run_dscl("read", "/Groups/#{group_name}")
+          rescue Chef::Exceptions::DsclCommandFailed
+            # Raised if the group doesn't contain any members
+          end
+          # Output is something like:
+          # GroupMembership: root admin etc
+          members = membership_info.split(" ")
+          members.shift # Get rid of GroupMembership: string
+          members.include?(new_resource.username)
+        end
+
+        #
+        # DSCL Helper functions
+        #
+
+        # A simple map of Chef's terms to DSCL's terms.
+        DSCL_PROPERTY_MAP = {
+          uid: "uid",
+          gid: "gid",
+          home: "home",
+          shell: "shell",
+          comment: "realname",
+          password: "passwd",
+          auth_authority: "authentication_authority",
+          shadow_hash: "ShadowHashData",
+        }.freeze
+
+        # Directory where the user plist files are stored for versions 10.7 and above
+        USER_PLIST_DIRECTORY = "/var/db/dslocal/nodes/Default/users".freeze
+
+        #
+        # Reads the user plist and returns a hash keyed with DSCL properties specified
+        # in DSCL_PROPERTY_MAP. Return nil if the user is not found.
+        #
+        def read_user_info
+          user_info = nil
+
+          # We flush the cache here in order to make sure that we read fresh information
+          # for the user.
+          shell_out("dscacheutil", "-flushcache") # FIXME: this is MacOS version dependent
+
+          begin
+            user_plist_file = "#{USER_PLIST_DIRECTORY}/#{new_resource.username}.plist"
+            user_plist_info = run_plutil("convert", "xml1", "-o", "-", user_plist_file)
+            user_info = Plist.parse_xml(user_plist_info)
+          rescue Chef::Exceptions::PlistUtilCommandFailed
+          end
+
+          user_info
+        end
+
+        #
+        # Saves the given hash keyed with DSCL properties specified
+        # in DSCL_PROPERTY_MAP to the disk.
+        #
+        def save_user_info(user_info)
+          user_plist_file = "#{USER_PLIST_DIRECTORY}/#{new_resource.username}.plist"
+          Plist::Emit.save_plist(user_info, user_plist_file)
+          run_plutil("convert", "binary1", user_plist_file)
+        end
+
+        #
+        # Sets a value in user information hash using Chef attributes as keys.
+        #
+        def dscl_set(user_hash, key, value)
+          raise "Unknown dscl key #{key}" unless DSCL_PROPERTY_MAP.keys.include?(key)
+          user_hash[DSCL_PROPERTY_MAP[key]] = [ value ]
+          user_hash
+        end
+
+        #
+        # Gets a value from user information hash using Chef attributes as keys.
+        #
+        def dscl_get(user_hash, key)
+          raise "Unknown dscl key #{key}" unless DSCL_PROPERTY_MAP.keys.include?(key)
+          # DSCL values are set as arrays
+          value = user_hash[DSCL_PROPERTY_MAP[key]]
+          value.nil? ? value : value.first
+        end
+
+        #
+        # System Helpers
+        #
+
+        def run_dscl(*args)
+          result = shell_out("dscl", ".", "-#{args[0]}", args[1..-1])
+          return "" if ( args.first =~ /^delete/ ) && ( result.exitstatus != 0 )
+          raise(Chef::Exceptions::DsclCommandFailed, "dscl error: #{result.inspect}") unless result.exitstatus == 0
+          raise(Chef::Exceptions::DsclCommandFailed, "dscl error: #{result.inspect}") if result.stdout =~ /No such key: /
+          result.stdout
+        end
+
+        def run_plutil(*args)
+          result = shell_out("plutil", "-#{args[0]}", args[1..-1])
+          raise(Chef::Exceptions::PlistUtilCommandFailed, "plutil error: #{result.inspect}") unless result.exitstatus == 0
+          if result.stdout.encoding == Encoding::ASCII_8BIT
+            result.stdout.encode("utf-8", "binary", undef: :replace, invalid: :replace, replace: "?")
+          else
+            result.stdout
+          end
+        end
+
+        def convert_binary_plist_to_xml(binary_plist_string)
+          shell_out("plutil", "-convert", "xml1", "-o", "-", "-", input: binary_plist_string).stdout
+        end
+
+        def convert_to_binary(string)
+          string.unpack("a2" * (string.size / 2)).collect { |i| i.hex.chr }.join
+        end
+
+        def salted_sha512?(string)
+          !!(string =~ /^[[:xdigit:]]{136}$/)
+        end
+
+        def salted_sha512_pbkdf2?(string)
+          !!(string =~ /^[[:xdigit:]]{256}$/)
+        end
+
+        def salted_sha512_pbkdf2_password_match?
+          salt = convert_to_binary(current_resource.salt)
+
+          OpenSSL::PKCS5.pbkdf2_hmac(
+            new_resource.password,
+            salt,
+            current_resource.iterations,
+            128,
+            OpenSSL::Digest::SHA512.new
+          ).unpack("H*").first == current_resource.password
+        end
+
+      end
+    end
+  end
+end