win32-security 0.1.0

data/CHANGES

@@ -0,0 +1,2 @@
+= 0.1.0 - 17-Dec-2008
+* Initial release

data/MANIFEST

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

data/README

@@ -0,0 +1,35 @@
+= Description
+   A security library for MS Windows that allows you to open existing or
+   create new security identifiers (SID's).
+
+= Synopsis
+   require 'win32/security'
+   include Win32
+   
+   sid = Security::SID.open('djberge')
+   
+   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..."
+   
+== Future Plans
+   Create classes that encapsulate ACL's, ACE's, Token's, etc.
+   
+   There are some unfinished versions of the ACL and ACE classes in CVS
+   if you're interested in taking a look.
+   
+== Known Issues
+   None that I'm aware of. Please file any bug reports on the project page
+   at http://www.rubyforge.org/projects/win32utils.
+    
+== License
+   Ruby's
+    
+== Copyright
+   (C) 2003-2008 Daniel J. Berger
+   All Rights Reserved
+    
+== Authors
+   Daniel J. Berger
+   Park Heesob

data/Rakefile

@@ -0,0 +1,37 @@
+require 'rake'
+require 'rake/testtask'
+require 'rbconfig'
+include Config
+
+desc 'Cleanup any temp files left over by Test::Unit'
+task :clean do
+   Dir['*'].each{ |file|
+      file = File.expand_path(file)
+      next unless File.directory?(file)
+      next if file =~ /CVS/
+      Dir.chdir(file) do
+         rm_rf '.test-result' if File.exists?('.test-result')
+      end
+   }
+
+desc 'Install the win32-security package (non-gem)'
+task :install do
+   install_dir = File.join(CONFIG["sitelibdir"], 'win32', 'security')
+   mkdir_p(install_dir) unless File.exists?(install_dir)
+   cp 'lib/win32/security.rb', File.dirname(install_dir), :verbose => true
+   cp 'lib/win32/security/acl.rb', install_dir, :verbose => true
+   cp 'lib/win32/security/sid.rb', install_dir, :verbose => true
+end
+
+task :install_gem do
+   ruby 'win32-security.gemspec'
+   file = Dir["*.gem"].first
+   sh "gem install #{file}"
+end
+
+# TODO: Add more test files as more classes are added.
+Rake::TestTask.new do |t|
+   t.verbose = true
+   t.warning = true
+   t.test_files = Dir['test/test_sid.rb', 'test/test_security.rb']
+end

data/lib/win32/security.rb

@@ -0,0 +1,66 @@
+# This file allows users to require all security related classes from
+# a single file, instead of having to require individual files.
+
+require 'windows/process'
+require 'windows/security'
+require 'windows/handle'
+require 'windows/error'
+
+$LOAD_PATH.unshift(File.dirname(File.dirname(File.expand_path(__FILE__))))
+
+# 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
+      
+      extend Windows::Process
+      extend Windows::Security
+      extend Windows::Handle
+      extend Windows::Error
+      
+      # The version of the win32-security library
+      VERSION = '0.1.0'
+      
+      # Returns whether or not the owner of the current process is running
+      # with elevated security privileges.
+      #
+      def self.elevated_security?
+         token = 0.chr * 4
+              
+         unless OpenProcessToken(GetCurrentProcess(), TOKEN_QUERY, token)
+            raise Error, get_last_error
+         end
+         
+         begin    
+            token = token.unpack('V')[0]
+            
+            te = 0.chr * 4 # TOKEN_ELEVATION
+            rl = 0.chr * 4 # Return length
+            
+            bool = GetTokenInformation(
+               token,
+               TokenElevation,
+               te,
+               te.size,
+               rl
+            )
+            
+            raise Error, get_last_error unless bool
+         ensure
+            CloseHandle(token)
+         end
+         
+         te.unpack('L')[0] != 0
+      end
+   end
+end
+
+require 'win32/security/sid'
+#require 'win32/security/acl'
+#require 'win32/security/ace'

data/test/test_security.rb

@@ -0,0 +1,22 @@
+########################################################################
+# test_security.rb
+#
+# Test suite for the Win32::Security base class. You should run these
+# tests via the 'rake test' task.
+########################################################################
+require 'rubygems'
+gem 'test-unit'
+
+require 'test/unit'
+require 'win32/security'
+
+class TC_Win32_Security < Test::Unit::TestCase
+   def test_version
+      assert_equal('0.1.0', Win32::Security::VERSION)
+   end
+
+   def test_elevated_security
+      assert_respond_to(Win32::Security, :elevated_security?)
+      assert_boolean(Win32::Security.elevated_security?)
+   end
+end

data/test/test_sid.rb

@@ -0,0 +1,119 @@
+########################################################################
+# test_sid.rb
+#
+# Test suite for the Win32::Security::SID class. You should run these
+# tests via the 'rake test' task.
+########################################################################
+require 'rubygems'
+gem 'test-unit'
+
+require 'test/unit'
+require 'win32/security'
+require 'sys/admin'
+include Win32
+
+class TC_Win32_Security_Sid < Test::Unit::TestCase
+   def self.startup
+      @@host = Socket.gethostname
+      @@name = Sys::Admin.users[0].name
+   end
+
+   def setup
+      @sid = Security::SID.new(@@name)
+   end
+
+   def test_version
+      assert_equal('0.1.0', Security::SID::VERSION)
+   end
+
+   def test_sid
+      assert_respond_to(@sid, :sid)
+      assert_kind_of(String, @sid.sid)
+   end
+
+   def test_account
+      assert_respond_to(@sid, :account)
+      assert_kind_of(String, @sid.account)
+   end
+
+   def test_account_type
+      assert_respond_to(@sid, :account_type)
+      assert_kind_of(String, @sid.account_type)
+   end
+
+   def test_domain
+      assert_respond_to(@sid, :domain)
+      assert_kind_of(String, @sid.domain)
+   end
+
+   def test_host
+      assert_respond_to(@sid, :host)
+      assert_kind_of(String, @sid.host)
+   end
+
+   def test_sid_to_string
+      assert_respond_to(Security::SID, :sid_to_string)
+      assert_kind_of(String, Security::SID.sid_to_string(@sid.sid))
+      assert_not_nil(Security::SID.sid_to_string(@sid.sid) =~ /\w+\-\w+/)
+   end
+
+   def test_string_to_sid
+      assert_respond_to(Security::SID, :string_to_sid)
+      assert_kind_of(String, Security::SID.string_to_sid(@sid.to_s))
+   end
+
+   def test_to_s
+      assert_respond_to(@sid, :to_s)
+      assert_kind_of(String, @sid.to_s)
+      assert_equal(true, @sid.to_s.include?('-'))
+   end
+
+   def test_to_str_alias
+      assert_respond_to(@sid, :to_str)
+      assert_equal(true, @sid.method(:to_s) == @sid.method(:to_str))
+   end
+
+   def test_equal
+      assert_respond_to(@sid, :==)
+      assert_equal(true, @sid == @sid)
+   end
+
+   def test_valid
+      assert_respond_to(@sid, :valid?)
+      assert_equal(true, @sid.valid?)
+   end
+
+   def test_length
+      assert_respond_to(@sid, :length)
+      assert_equal(true, @sid.length > 0)
+   end
+
+   def test_create
+      assert_respond_to(Security::SID, :create)
+      assert_nothing_raised{
+         Security::SID.create(
+            Security::SID::SECURITY_WORLD_SID_AUTHORITY,
+            Security::SID::SECURITY_WORLD_RID
+         )
+      }
+   end
+
+   def test_new_with_host
+      assert_nothing_raised{ Security::SID.new(@@name, @@host) }
+   end
+
+   def test_new_expected_errors
+      assert_raise(ArgumentError){ Security::SID.new }
+      assert_raise(ArgumentError){ Security::SID.new(@@name, @@host, @@host) }
+      assert_raise(Security::SID::Error){ Security::SID.new('bogus') }
+   end
+
+   def teardown
+      @sid = nil
+   end
+
+   def self.shutdown
+      @@host = nil
+      @@name = nil
+   end
+end

data/win32-security.gemspec

@@ -0,0 +1,32 @@
+require "rubygems"
+
+spec = Gem::Specification.new do |gem|
+   gem.name        = "win32-security"
+   gem.version     = "0.1.0"
+   gem.authors     = ["Daniel J. Berger", "Park Heesob"]
+   gem.email       = "djberg96@gmail.com"
+   gem.homepage    = "http://www.rubyforge.org/projects/win32utils"
+   gem.platform    = Gem::Platform::RUBY
+   gem.summary     = "A library for dealing with aspects of Windows security."
+   gem.test_files  = Dir["test/*.rb"]
+   gem.has_rdoc    = true
+   gem.files       = Dir["lib/win32/*.rb"] + Dir["test/*"] + Dir["[A-Z]*"]
+   gem.files.reject! { |fn| fn.include? "CVS" }
+   gem.extra_rdoc_files = ["README", "CHANGES", "MANIFEST"]
+   gem.rubyforge_project = 'Win32Utils'
+   
+   gem.add_dependency("windows-pr", ">= 0.9.8")
+   gem.add_dependency("test-unit", ">= 2.0.1")
+   gem.add_dependency("sys-admin", ">= 1.4.4")
+   
+   description = "The win32-security library provides an interface for dealing"
+   description << " with security aspects of MS Windows. It includes classes"
+   description << " for SID's, ACL's and ACE's."
+   
+   gem.description = description
+end
+
+if $0 == __FILE__
+   Gem.manage_gems if Gem::RubyGemsVersion.to_f < 1.0
+   Gem::Builder.new(spec).build
+end

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification 
+name: win32-security
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Daniel J. Berger
+- Park Heesob
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-12-17 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: windows-pr
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.9.8
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: test-unit
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.0.1
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: sys-admin
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.4.4
+    version: 
+description: The win32-security library provides an interface for dealing with security aspects of MS Windows. It includes classes for SID's, ACL's and ACE's.
+email: djberg96@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+- CHANGES
+- MANIFEST
+files: 
+- lib/win32/security.rb
+- test/test_security.rb
+- test/test_sid.rb
+- CHANGES
+- lib
+- MANIFEST
+- Rakefile
+- README
+- test
+- win32-security.gemspec
+has_rdoc: true
+homepage: http://www.rubyforge.org/projects/win32utils
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: Win32Utils
+rubygems_version: 1.3.1
+signing_key: 
+specification_version: 2
+summary: A library for dealing with aspects of Windows security.
+test_files: 
+- test/test_security.rb
+- test/test_sid.rb