casual 0.1.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Zach Holman
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.markdown

@@ -0,0 +1,39 @@
+# Casual
+### Casual is a tiny [CAS](http://en.wikipedia.org/wiki/Central_Authentication_Service) client
+
+There's a [few](http://github.com/gunark/rubycas-client) [CAS](http://github.com/p8/casablanca) [clients](http://github.com/jamesarosen/casrack_the_authenticator) in [the Ruby world](http://github.com/search?langOverride=&language=rb&q=cas&repo=&start_value=1&type=Repositories&x=25&y=13). Go check them out; there's a very good chance they'll fit your needs. I'll wait.
+
+Cool. What I didn't like from existing solutions was that they assumed you were using Rails, they assumed you would use CAS in a particular fashion, and CAS seemed too straightforward to muddy it up with a ten-thousand line client library.
+
+Casual is a übertiny client that doesn't hook into a Rails `before_filter` or deep into Rack middleware. It'll work in irb, it'll work in a simple controller, it'll work underwater. It's based off of another tiny client from [Texas A&M](http://http.tamu.edu/auth/caslibraries/ruby/), except generalized for use outside the school and to avoid REXML (ew).
+
+Casual will work for casual use, like simple and straightforward authentication requirements or as a way to programmatically play around with and understand CAS itself.
+
+## Codes
+
+### Fake end-to-end CAS authentication
+This bypasses the intermediary CAS single sign-on point, which is frowned upon in the CAS docs since the client gains access to usernames + passwords. But it's also a-nice-to-have if you're building an internal app that is entirely in your control.
+
+    require 'casual'
+    casual = Casual::Client.new(:server_path => 'local-cas-server'
+                                :port => 443, # defaults to 443 (SSL)
+                                :callback_url => 'http://your.example.com')
+    casual.authenticate('holman','super_secret_password')
+      # => returns 'holman' if I'm logged in, or nil if not
+
+### Simulate traditional CAS authentication
+This is closer to the normal CAS authentication process. It requires that you send the user off to your CAS login page to transfer tickets between your app and the CAS server, so you can't just do it all in one request.
+
+    require 'casual'
+    casual = Casual::Client.new(:server_path => 'local-cas-server'
+                                :port => 443, # defaults to 443 (SSL)
+                                :callback_url => 'http://your.example.com')
+    casual.authentication_url
+      # returns URL your user should be redirected to
+      # after CAS login, redirects you to +callback_url+ with ticket as param
+    casual.user_login(ticket)
+      # returns username if valid, nil if invalid
+      
+## Casual.
+
+by [@holman](http://twitter.com/holman).

data/Rakefile

@@ -0,0 +1,53 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "casual"
+    gem.summary = "A tiny CAS client for Ruby"
+    gem.description = "A tiny CAS client for Ruby"
+    gem.email = "github.com@zachholman.com"
+    gem.homepage = "http://github.com/holman/casual"
+    gem.authors = ["Zach Holman"]
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+    gem.add_dependency 'nokogiri'
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "casual #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/casual.gemspec

@@ -0,0 +1,54 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{casual}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Zach Holman"]
+  s.date = %q{2010-03-31}
+  s.description = %q{A tiny CAS client for Ruby}
+  s.email = %q{github.com@zachholman.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.markdown"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.markdown",
+     "Rakefile",
+     "VERSION",
+     "casual.gemspec",
+     "lib/casual.rb",
+     "test/helper.rb",
+     "test/test_casual.rb"
+  ]
+  s.homepage = %q{http://github.com/holman/casual}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{A tiny CAS client for Ruby}
+  s.test_files = [
+    "test/helper.rb",
+     "test/test_casual.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<nokogiri>, [">= 0"])
+    else
+      s.add_dependency(%q<nokogiri>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<nokogiri>, [">= 0"])
+  end
+end
+

data/lib/casual.rb

@@ -0,0 +1,50 @@
+require 'net/https'
+require 'nokogiri'
+
+module Casual
+  class Client
+    attr_accessor :server_path, :callback_url, :port
+    
+    def initialize(config)
+      @server_path = config[:server_path]
+      @callback_url = config[:callback_url]
+      @port = config[:port] || 443
+    end
+
+    def authorization_url
+      "#{server_url}/login?service=#{callback_url}"
+    end
+
+    def authenticate(username,password)
+      ticket = acquire_ticket
+      params = "username=#{username}&password=#{password}&lt=#{ticket}"
+      status,response = connection.post('/login', params)#.last
+      (status.code == '200') ? username : nil
+    end
+    
+    def acquire_ticket
+      login_page = connection.get('/login')
+      Nokogiri::HTML(login_page.body).css('input#lt').first['value']
+    end
+
+    def connection
+      http = Net::HTTP.new(server_path, port)
+      http.use_ssl = true
+      http
+    end
+    
+    def authenticate_ticket(ticket)
+      connection.get("/serviceValidate?service=#{callback_url}&ticket=#{ticket}").body
+    end
+    
+    def user_login(ticket)
+      user = Nokogiri::XML(authenticate_ticket(ticket)).xpath('//cas:authenticationSuccess //cas:user').text
+      user.strip != '' ? user : nil
+    end
+    
+    def server_url
+      "https://#{server_path}:#{port}"
+    end
+    
+  end
+end

data/test/helper.rb

@@ -0,0 +1,12 @@
+require 'rubygems'
+require 'test/unit'
+require 'redgreen'
+require 'rr'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'casual'
+
+class Test::Unit::TestCase
+  include RR::Adapters::TestUnit
+end

data/test/test_casual.rb

@@ -0,0 +1,42 @@
+require 'helper'
+
+class TestCasual < Test::Unit::TestCase
+  
+  def setup
+    @client = Casual::Client.new(:server_path => 'localhost', 
+                                 :port => 443, 
+                                 :callback_url => 'http://localhost')
+  end
+  
+  def test_authorization_url
+    assert_equal @client.authorization_url, 
+      "https://localhost:443/login?service=http://localhost"
+  end
+  
+  def test_user_login_success
+    mock(@client).authenticate_ticket.with('GOLDEN_TICKET_LOL') {
+      '<cas:serviceResponse xmlns:cas="http://www.yale.edu/tp/cas">'+
+      '<cas:authenticationSuccess><cas:user>holman</cas:user></cas:authenticationSuccess>'+
+      '</cas:serviceResponse>'
+    }
+    assert_equal @client.user_login('GOLDEN_TICKET_LOL'), 'holman'
+  end
+  
+  def test_user_login_fail
+    mock(@client).authenticate_ticket.with('GOLDEN_TICKET_FAIL') {
+      '<cas:serviceResponse xmlns:cas="http://www.yale.edu/tp/cas">'+
+      '<cas:authenticationFailure code="INVALID_TICKET">Ticket \'GOLDEN_TICKET_FAIL\' not recognized.'+
+      '</cas:authenticationFailure></cas:serviceResponse>'
+    }
+    assert_equal @client.user_login('GOLDEN_TICKET_FAIL'), nil
+  end
+  
+  def test_authenticate_success
+    connection_mock = mock('').post.with_any_args { 
+      [Net::HTTPSuccess.new('','200',''), '<div class="messagebox confirmation">You have successfully logged in.</div>']
+    }
+    mock(@client).connection { connection_mock }
+    mock(@client).acquire_ticket { 'a_ticket' }
+    assert_equal @client.authenticate('holman','lolsecret'), 'holman'
+  end
+end

metadata

@@ -0,0 +1,84 @@
+--- !ruby/object:Gem::Specification 
+name: casual
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Zach Holman
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-03-31 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+description: A tiny CAS client for Ruby
+email: github.com@zachholman.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.markdown
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.markdown
+- Rakefile
+- VERSION
+- casual.gemspec
+- lib/casual.rb
+- test/helper.rb
+- test/test_casual.rb
+has_rdoc: true
+homepage: http://github.com/holman/casual
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: A tiny CAS client for Ruby
+test_files: 
+- test/helper.rb
+- test/test_casual.rb