win32-security 0.3.1 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: eb48272d87182c9d2f834a8756446177ce280d24
-  data.tar.gz: 272c29b8ba86646bd85e4fd00e5300ee52dcdba2
+  metadata.gz: 33ce1c2dc5905f666656e1e91ccccf4c68895071
+  data.tar.gz: 59d8f0ea5c8bed6db0ab4474ea6b8cf3bbdeaccf
 SHA512:
-  metadata.gz: 2158ce7793c2e4261c6664235451905ed0f74720588d48dbe8c34316d4c4b8dbbfc45b65648f7b38975c94faff89c59b84ecbb8cb3c47b6d30485d8d18c97dcf
-  data.tar.gz: ef88d6ee47441bced718e6c981acbeb663739d2b6427511418dcd1b0b8d359e2fa1862f5a58bb2fdabe08cc09b6d793e6efa3df3606c335a663a2ee0df093b57
+  metadata.gz: 9f1644cbd1d6bf1072e8d9bb3844b55d200cb21a13876ffcae54ef46acdfe6046ca1e1bc19de33ef2fa12830ea6ac49ad1ca50d0cf6f8310bd84b514da01d576
+  data.tar.gz: 1e2ee6736e1f24390985c03b176f49da020128dc60846bb7f4eed91ab87f7b7e0c97ccf29f1e704f8a7714c8c72cfd00eaff4ed4cdb20108537c97c731d1f8f5

data/CHANGES

@@ -1,57 +1,63 @@
-== 0.3.1 - 8-Dec-2014
-* Work around a bug in 64-bit JRuby, which doesn't handle uintptr_t properly.
-
-== 0.3.0 - 31-Oct-2014
-* Implemented an ACL class that lets you create and inspect acccess
-  control lists.
-* Implemented a basic ACE class that encapsulates an ACE object.
-* Removed Windows XP support.
-* Some minor updates to the Rakefile and gemspec.
-
-== 0.2.5 - 24-Feb-2014
-* Fixed a bug in the SID#string_to_sid method. Thanks go to Rob Reynolds
-  for the spot.
-
-== 0.2.4 - 8-Nov-2013
-* Added rake as a development dependency.
-* Attempted to make FFI related constants and structs more private.
-* Updated the gem:create task for Rubygems 2.
-
-== 0.2.3 - 27-Jun-2013
-* Fixed a bug where a sid could be inappropriately stripped. Thanks
-  go to Josh Cooper for the spot.
-
-== 0.2.2 - 8-Apr-2013
-* Fixed HANDLE prototypes in the underlying FFI code. This affected
-  64 bit versions of Ruby.
-
-== 0.2.1 - 19-Feb-2013
-* Removed a trailing comma that was causing problems.
-
-== 0.2.0 - 11-Jan-2013
-* Converted the code to FFI.
-* Refactored some of the tests.
-
-= 0.1.4 - 4-Oct-2012
-* Updated the SID.string_to_sid method so that it completes a string/sid
-  round trip successfully now. Thanks go to Josh Cooper for the patch.
-
-= 0.1.3 - 12-Jul-2012
-* The SID.new method now defaults to the owner of the current thread if
-  no account name is provided.
-* Updates to the gemspec, Rakefile, and SID tests, including updates to
-  some of the gemspec dependencies.
-
-= 0.1.2 - 2-Aug-2009
-* Now compatible with Ruby 1.9.x.
-* Switched test-unit and sys-admin from standard dependencies to development
-  dependencies.
-
-= 0.1.1 - 14-Jul-2009
-* Added some well known SID's as constants to the Win32::Security::SID class
-  for convenience, e.g. SID::World, SID::Everyone.
-* Fixes for the gemspec.
-* Changed license to Artistic 2.0.
-
-= 0.1.0 - 17-Dec-2008
-* Initial release
+== 0.3.2 - 4-Dec-2015
+* This gem is now signed.
+* Added a win32-security.rb file for convenience.
+* The gem related tasks in the Rakefile now assume Rubygems 2.x.
+* Fixed a function and struct prototype.
+
+== 0.3.1 - 8-Dec-2014
+* Work around a bug in 64-bit JRuby, which doesn't handle uintptr_t properly.
+
+== 0.3.0 - 31-Oct-2014
+* Implemented an ACL class that lets you create and inspect acccess
+  control lists.
+* Implemented a basic ACE class that encapsulates an ACE object.
+* Removed Windows XP support.
+* Some minor updates to the Rakefile and gemspec.
+
+== 0.2.5 - 24-Feb-2014
+* Fixed a bug in the SID#string_to_sid method. Thanks go to Rob Reynolds
+  for the spot.
+
+== 0.2.4 - 8-Nov-2013
+* Added rake as a development dependency.
+* Attempted to make FFI related constants and structs more private.
+* Updated the gem:create task for Rubygems 2.
+
+== 0.2.3 - 27-Jun-2013
+* Fixed a bug where a sid could be inappropriately stripped. Thanks
+  go to Josh Cooper for the spot.
+
+== 0.2.2 - 8-Apr-2013
+* Fixed HANDLE prototypes in the underlying FFI code. This affected
+  64 bit versions of Ruby.
+
+== 0.2.1 - 19-Feb-2013
+* Removed a trailing comma that was causing problems.
+
+== 0.2.0 - 11-Jan-2013
+* Converted the code to FFI.
+* Refactored some of the tests.
+
+= 0.1.4 - 4-Oct-2012
+* Updated the SID.string_to_sid method so that it completes a string/sid
+  round trip successfully now. Thanks go to Josh Cooper for the patch.
+
+= 0.1.3 - 12-Jul-2012
+* The SID.new method now defaults to the owner of the current thread if
+  no account name is provided.
+* Updates to the gemspec, Rakefile, and SID tests, including updates to
+  some of the gemspec dependencies.
+
+= 0.1.2 - 2-Aug-2009
+* Now compatible with Ruby 1.9.x.
+* Switched test-unit and sys-admin from standard dependencies to development
+  dependencies.
+
+= 0.1.1 - 14-Jul-2009
+* Added some well known SID's as constants to the Win32::Security::SID class
+  for convenience, e.g. SID::World, SID::Everyone.
+* Fixes for the gemspec.
+* Changed license to Artistic 2.0.
+
+= 0.1.0 - 17-Dec-2008
+* Initial release

data/MANIFEST

@@ -1,9 +1,11 @@
-* CHANGES
-* MANIFEST
-* README
-* Rakefile
-* win32-security.gemspec
-* lib/win32/security.rb
-* lib/win32/security/sid.rb
-* test/test_security.rb
-* test/test_sid.rb
+* CHANGES
+* MANIFEST
+* README
+* Rakefile
+* win32-security.gemspec
+* certs/djberg96_pub.pem
+* lib/win32-security.rb
+* lib/win32/security.rb
+* lib/win32/security/sid.rb
+* test/test_security.rb
+* test/test_sid.rb

data/README

@@ -1,53 +1,53 @@
-= Description
-  A security library for MS Windows that allows you to open existing or
-  create new security identifiers (SID's), as well as create access
-  control lists (ACL's) and access control entries (ACE's).
-
-= Synopsis
-  require 'win32/security'
-  include Win32
-   
-  sid = Security::SID.open('some_user')
-   
-  sid.valid? # => true
-  sid.to_s   # => "S-1-5-21-3733855671-1102023144-2002619019-1000"
-  sid.length # => 28
-  sid.sid    # => "\001\005\000\000\000\000\000\005\025\000\000\000..."
-
-  acl = Security::ACL.new
-  mask = Security::ACL::GENERIC_READ | Security::ACL::GENERIC_WRITE
-
-  acl.add_access_allowed_ace('some_user', mask)
-  acl.add_access_denied_ace('some_user', Security::ACL::GENERIC_EXECUTE)
-
-  acl.acl_count # => 2
-  acl.valid?    # => true
-   
-== Future Plans
-  None at the moment. Suggestions welcome.
-   
-== Known Issues
-  There appears to be an issue with 64-bit versions of JRuby. I believe this
-  is related to this issue: https://github.com/jruby/jruby/issues/1315. There
-  is nothing I can do about it here.
-
-  Please file any other bug reports on the project page at:
-
-  https://github.com/djberg96/win32-security
-
-== Contributions
-  Although this library is free, please consider having your company
-  setup a gittip if used by your company professionally.
-
-  http://www.gittip.com/djberg96/
-
-== License
-  Artistic 2.0
-    
-== Copyright
-  (C) 2003-2014 Daniel J. Berger
-  All Rights Reserved
-    
-== Authors
-  Daniel J. Berger
-  Park Heesob
+= Description
+  A security library for MS Windows that allows you to open existing or
+  create new security identifiers (SID's), as well as create access
+  control lists (ACL's) and access control entries (ACE's).
+
+= Synopsis
+  require 'win32/security'
+  include Win32
+   
+  sid = Security::SID.open('some_user')
+   
+  sid.valid? # => true
+  sid.to_s   # => "S-1-5-21-3733855671-1102023144-2002619019-1000"
+  sid.length # => 28
+  sid.sid    # => "\001\005\000\000\000\000\000\005\025\000\000\000..."
+
+  acl = Security::ACL.new
+  mask = Security::ACL::GENERIC_READ | Security::ACL::GENERIC_WRITE
+
+  acl.add_access_allowed_ace('some_user', mask)
+  acl.add_access_denied_ace('some_user', Security::ACL::GENERIC_EXECUTE)
+
+  acl.acl_count # => 2
+  acl.valid?    # => true
+   
+== Future Plans
+  None at the moment. Suggestions welcome.
+   
+== Known Issues
+  There appears to be an issue with 64-bit versions of JRuby. I believe this
+  is related to this issue: https://github.com/jruby/jruby/issues/1315. There
+  is nothing I can do about it here.
+
+  Please file any other bug reports on the project page at:
+
+  https://github.com/djberg96/win32-security
+
+== Contributions
+  Although this library is free, please consider having your company
+  setup a gittip if used by your company professionally.
+
+  http://www.gittip.com/djberg96/
+
+== License
+  Artistic 2.0
+    
+== Copyright
+  (C) 2003-2015 Daniel J. Berger
+  All Rights Reserved
+    
+== Authors
+  Daniel J. Berger
+  Park Heesob

data/Rakefile

@@ -1,61 +1,58 @@
-require 'rake'
-require 'rake/clean'
-require 'rake/testtask'
-require 'rbconfig'
-
-CLEAN.include('**/*.gem', '**/*.rbc')
-
-namespace :gem do
-  desc "Create the win32-security gem"
-  task :create => [:clean] do
-    spec = eval(IO.read('win32-security.gemspec'))
-    if Gem::VERSION < "2.0"
-      Gem::Builder.new(spec).build
-    else
-      require 'rubygems/package'
-      Gem::Package.build(spec)
-    end
-  end
-
-  desc "Install the win32-security gem"
-  task :install => [:create] do
-    ruby 'win32-security.gemspec'
-    file = Dir["*.gem"].first
-    sh "gem install -l #{file}"
-  end
-end
-
-namespace :test do
-  Rake::TestTask.new(:security) do |t|
-    t.verbose = true
-    t.warning = true
-    t.test_files = Dir['test/test_security.rb']
-  end
-
-  Rake::TestTask.new(:acl) do |t|
-    t.verbose = true
-    t.warning = true
-    t.test_files = Dir['test/test_acl.rb']
-  end
-
-  Rake::TestTask.new(:ace) do |t|
-    t.verbose = true
-    t.warning = true
-    t.test_files = Dir['test/test_ace.rb']
-  end
-
-  Rake::TestTask.new(:sid) do |t|
-    t.verbose = true
-    t.warning = true
-    t.test_files = Dir['test/test_sid.rb']
-  end
-
-  # ACL class isn't ready yet
-  Rake::TestTask.new(:all) do |t|
-    t.verbose = true
-    t.warning = true
-    t.test_files = Dir['test/test_sid.rb', 'test/test_security.rb']
-  end
-end
-
-task :default => 'test:all'
+require 'rake'
+require 'rake/clean'
+require 'rake/testtask'
+require 'rbconfig'
+
+CLEAN.include('**/*.gem', '**/*.rbc')
+
+namespace :gem do
+  desc "Create the win32-security gem"
+  task :create => [:clean] do
+    require 'rubygems/package'
+    spec = eval(IO.read('win32-security.gemspec'))
+    spec.signing_key = File.join(Dir.home, '.ssh', 'gem-private_key.pem')
+    Gem::Package.build(spec, true)
+  end
+
+  desc "Install the win32-security gem"
+  task :install => [:create] do
+    ruby 'win32-security.gemspec'
+    file = Dir["*.gem"].first
+    sh "gem install -l #{file}"
+  end
+end
+
+namespace :test do
+  Rake::TestTask.new(:security) do |t|
+    t.verbose = true
+    t.warning = true
+    t.test_files = Dir['test/test_security.rb']
+  end
+
+  Rake::TestTask.new(:acl) do |t|
+    t.verbose = true
+    t.warning = true
+    t.test_files = Dir['test/test_acl.rb']
+  end
+
+  Rake::TestTask.new(:ace) do |t|
+    t.verbose = true
+    t.warning = true
+    t.test_files = Dir['test/test_ace.rb']
+  end
+
+  Rake::TestTask.new(:sid) do |t|
+    t.verbose = true
+    t.warning = true
+    t.test_files = Dir['test/test_sid.rb']
+  end
+
+  # ACL class isn't ready yet
+  Rake::TestTask.new(:all) do |t|
+    t.verbose = true
+    t.warning = true
+    t.test_files = Dir['test/test_sid.rb', 'test/test_security.rb']
+  end
+end
+
+task :default => 'test:all'

data/certs/djberg96_pub.pem

@@ -0,0 +1,21 @@
+-----BEGIN CERTIFICATE-----
+MIIDcDCCAligAwIBAgIBATANBgkqhkiG9w0BAQUFADA/MREwDwYDVQQDDAhkamJl
+cmc5NjEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPyLGQBGRYDY29t
+MB4XDTE1MDkwMjIwNDkxOFoXDTE2MDkwMTIwNDkxOFowPzERMA8GA1UEAwwIZGpi
+ZXJnOTYxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixkARkWA2Nv
+bTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMyTkvXqRp6hLs9eoJOS
+Hmi8kRYbq9Vkf15/hMxJpotYMgJVHHWrmDcC5Dye2PbnXjTkKf266Zw0PtT9h+lI
+S3ts9HO+vaCFSMwFFZmnWJSpQ3CNw2RcHxjWkk9yF7imEM8Kz9ojhiDXzBetdV6M
+gr0lV/alUr7TNVBDngbXEfTWscyXh1qd7xZ4EcOdsDktCe5G45N/o3662tPQvJsi
+FOF0CM/KuBsa/HL1/eoEmF4B3EKIRfTHrQ3hu20Kv3RJ88QM4ec2+0dd97uX693O
+zv6981fyEg+aXLkxrkViM/tz2qR2ZE0jPhHTREPYeMEgptRkTmWSKAuLVWrJEfgl
+DtkCAwEAAaN3MHUwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0OBBYEFEwe
+nn6bfJADmuIDiMSOzedOrL+xMB0GA1UdEQQWMBSBEmRqYmVyZzk2QGdtYWlsLmNv
+bTAdBgNVHRIEFjAUgRJkamJlcmc5NkBnbWFpbC5jb20wDQYJKoZIhvcNAQEFBQAD
+ggEBAHmNOCWoDVD75zHFueY0viwGDVP1BNGFC+yXcb7u2GlK+nEMCORqzURbYPf7
+tL+/hzmePIRz7i30UM//64GI1NLv9jl7nIwjhPpXpf7/lu2I9hOTsvwSumb5UiKC
+/sqBxI3sfj9pr79Wpv4MuikX1XPik7Ncb7NPsJPw06Lvyc3Hkg5X2XpPtLtS+Gr2
+wKJnmzb5rIPS1cmsqv0M9LPWflzfwoZ/SpnmhagP+g05p8bRNKjZSA2iImM/GyYZ
+EJYzxdPOrx2n6NYR3Hk+vHP0U7UBSveI6+qx+ndQYaeyCn+GRX2PKS9h66YF/Q1V
+tGSHgAmcLlkdGgan182qsE/4kKM=
+-----END CERTIFICATE-----

data/lib/win32-security.rb

@@ -0,0 +1 @@
+require_relative 'win32/security'

data/lib/win32/security.rb

@@ -1,91 +1,91 @@
-# This file allows users to require all security related classes from
-# a single file, instead of having to require individual files.
-
-require_relative 'security/windows/constants'
-require_relative 'security/windows/structs'
-require_relative 'security/windows/functions'
-
-# The Win32 module serves as a namespace only.
-module Win32
-
-  # The Security class encapsulates security aspects of MS Windows.
-  class Security
-
-    # Base error class for all Win32::Security errors.
-    class Error < StandardError; end
-
-    include Windows::Security::Functions
-    include Windows::Security::Constants
-    include Windows::Security::Structs
-    extend Windows::Security::Functions
-
-    # The version of the win32-security library
-    VERSION = '0.3.1'
-
-    # Used by OpenProcessToken
-    TOKEN_QUERY = 8
-
-    # Returns whether or not the owner of the current process is running
-    # with elevated security privileges.
-    #
-    def self.elevated_security?
-      result = false
-
-      # Work around a 64-bit JRuby bug
-      if RUBY_PLATFORM == 'java' && ENV_JAVA['sun.arch.data.model'] == '64'
-        ptr_type = :ulong_long
-      else
-        ptr_type = :uintptr_t
-      end
-
-      FFI::MemoryPointer.new(ptr_type) do |token|
-        unless OpenProcessToken(GetCurrentProcess(), TOKEN_QUERY, token)
-          raise SystemCallError.new("OpenProcessToken", FFI.errno)
-        end
-
-        begin
-          token = token.read_pointer.to_i
-
-          # Since the TokenElevation struct only has 1 member, we use a pointer.
-          te = FFI::MemoryPointer.new(:ulong)
-          rl = FFI::MemoryPointer.new(:ulong)
-
-          bool = GetTokenInformation(
-            token,
-            :TokenElevation,
-            te,
-            te.size,
-            rl
-          )
-
-          raise SystemCallError.new("GetTokenInformation", FFI.errno) unless bool
-
-          result = te.read_ulong != 0
-        ensure
-          CloseHandle(token)
-          te.free
-          rl.free
-        end
-      end
-
-      result
-    end
-
-    private
-
-    def self.windows_version
-      ver = OSVERSIONINFO.new
-      ver[:dwOSVersionInfoSize] = ver.size
-
-      unless GetVersionExA(ver)
-        raise SystemCallError.new("GetVersionEx", FFI.errno)
-      end
-
-      ver[:dwMajorVersion]
-    end
-  end
-end
-
-require 'win32/security/sid'
-require 'win32/security/acl'
-require 'win32/security/ace'
+# This file allows users to require all security related classes from
+# a single file, instead of having to require individual files.
+
+require_relative 'security/windows/constants'
+require_relative 'security/windows/structs'
+require_relative 'security/windows/functions'
+
+# The Win32 module serves as a namespace only.
+module Win32
+
+  # The Security class encapsulates security aspects of MS Windows.
+  class Security
+
+    # Base error class for all Win32::Security errors.
+    class Error < StandardError; end
+
+    include Windows::Security::Functions
+    include Windows::Security::Constants
+    include Windows::Security::Structs
+    extend Windows::Security::Functions
+
+    # The version of the win32-security library
+    VERSION = '0.3.2'
+
+    # Used by OpenProcessToken
+    TOKEN_QUERY = 8
+
+    # Returns whether or not the owner of the current process is running
+    # with elevated security privileges.
+    #
+    def self.elevated_security?
+      result = false
+
+      # Work around a 64-bit JRuby bug
+      if RUBY_PLATFORM == 'java' && ENV_JAVA['sun.arch.data.model'] == '64'
+        ptr_type = :ulong_long
+      else
+        ptr_type = :uintptr_t
+      end
+
+      FFI::MemoryPointer.new(ptr_type) do |token|
+        unless OpenProcessToken(GetCurrentProcess(), TOKEN_QUERY, token)
+          raise SystemCallError.new("OpenProcessToken", FFI.errno)
+        end
+
+        begin
+          token = token.read_pointer.to_i
+
+          # Since the TokenElevation struct only has 1 member, we use a pointer.
+          te = FFI::MemoryPointer.new(:ulong)
+          rl = FFI::MemoryPointer.new(:ulong)
+
+          bool = GetTokenInformation(
+            token,
+            :TokenElevation,
+            te,
+            te.size,
+            rl
+          )
+
+          raise SystemCallError.new("GetTokenInformation", FFI.errno) unless bool
+
+          result = te.read_ulong != 0
+        ensure
+          CloseHandle(token)
+          te.free
+          rl.free
+        end
+      end
+
+      result
+    end
+
+    private
+
+    def self.windows_version
+      ver = OSVERSIONINFO.new
+      ver[:dwOSVersionInfoSize] = ver.size
+
+      unless GetVersionExA(ver)
+        raise SystemCallError.new("GetVersionEx", FFI.errno)
+      end
+
+      ver[:dwMajorVersion]
+    end
+  end
+end
+
+require 'win32/security/sid'
+require 'win32/security/acl'
+require 'win32/security/ace'