autodiscover 0.1.0

data/CHANGELOG

@@ -0,0 +1,3 @@
+*0.1.0*
+
+* First public release

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010-2011 WIMM Labs, Inc.
+
+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.md

@@ -0,0 +1,81 @@
+Autodiscover
+============
+
+Ruby client for Microsoft's Autodiscover Service.
+
+The Autodiscover Service is a component of the Exchange 2007 and Exchange 2010 architecture. Autoservice clients can access the URLs and settings needed to communicate with Exchange servers, such as the URL of the endpoint to use with the Exchange Web Services (EWS) API.
+
+This library implements Microsoft's "Autodiscover HTTP Service Protocol Specification" to discover the endpoint for an Autodiscover server that supports a specified e-mail address and Microsoft's "Autodiscover Publishing and Lookup Protocol Specification" to get URLs and settings that are required to access Web services available from Exchange servers.
+
+Dependencies
+------------
+
+This library requires the following Gems:
+
+* HTTPClient
+* Nokogiri
+
+The HTTPClient Gem in turn requires the rubyntlm Gem for Negotiate/NTLM authentication.
+
+For unit testing the webmock Gem is also used.
+
+How to Use
+----------
+
+    require 'autodiscover'
+    
+    credentials = Autodiscover::Credentials.new('<e-mail address>', '<password>')
+    client = Autodiscover::Client.new
+    services = client.get_services(credentials)
+    ews_url = services.ews_url
+    ttl = services.ttl
+
+Options
+-------
+
+### Debugging
+
+For debugging, we extend the use of the debug_dev option in the HTTPClient library.
+
+    debug_file = File.open('<filename path>', 'w')
+    credentials = Autodiscover::Credentials.new('<e-mail address>', '<password>')
+    client = Autodiscover::Client.new(:debug_dev => debug_file)
+    services = client.get_services(credentials)
+    debug_file.close
+
+### Connection Timeouts
+
+To adjust the connection timeout values used when searching for Autodiscover server endpoints:
+
+    client = Autodiscover::Client.new(:connect_timeout => 5)
+
+The units are seconds.
+
+Installation
+------------
+
+### Configuring a Rails App to use the latest GitHub master version
+
+	  gem 'autodiscover', :git => 'git://github.com/wimm/autodiscover.git'
+
+### To install the latest development version from the GitHub master
+
+	  git clone http://github.com/wimm/autodiscover.git
+	  cd autodiscover
+	  gem build autodiscover.gemspec
+	  sudo gem install autodiscover-<version>.gem
+
+Bugs and Issues
+---------------
+
+Limitations:
+
+* Doesn't support querying the DNS for SRV Records
+* Only returns the TTL and EWS_Url values from the EXPR Protocol response
+
+Please submit additional bugs and issues here [http://github.com/wimm/autodiscover/issues](http://github.com/wimm/autodiscover/issues)
+
+Copyright
+---------
+
+Copyright (c) 2010-2011 WIMM Labs, Inc. See MIT-LICENSE for details.

data/lib/autodiscover.rb

@@ -0,0 +1,26 @@
+#--
+# Copyright (c) 2010-2011 WIMM Labs, Inc.
+#
+# 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.
+#++
+
+require 'autodiscover/client'
+require 'autodiscover/credentials'
+require 'autodiscover/services'

data/lib/autodiscover/client.rb

@@ -0,0 +1,226 @@
+#--
+# Copyright (c) 2010-2011 WIMM Labs, Inc.
+#
+# 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.
+#++
+
+require 'httpclient'
+require 'nokogiri'
+
+module Autodiscover
+  REDIRECT_LIMIT = 10  # attempts
+  CONNECT_TIMEOUT_DEFAULT = 10  # seconds
+
+  # Client objects are used to make queries to the autodiscover server, to
+  # specify configuration values, and to maintain state between requests.
+  class Client
+    # Creates a Client object.
+    #
+    # The following options can be specified:
+    #
+    # <tt>:connect_timeout</tt>::  Number of seconds to wait when trying to establish
+    #                              a connection. The default value is 10 seconds.
+    # <tt>:debug_dev</tt>::        Device that debug messages and all HTTP
+    #                              requests and responses are dumped to. The debug
+    #                              device must respond to <tt><<</tt> for dump. 
+    def initialize(options={})
+      @debug_dev = options[:debug_dev]
+
+      @http = HTTPClient.new
+      @http.connect_timeout = options[:connect_timeout] || CONNECT_TIMEOUT_DEFAULT
+      @http.debug_dev = @debug_dev if @debug_dev
+
+      @redirect_count = 0
+    end
+
+    # Get a Services object from an \Autodiscover server that is
+    # available on an authenticated endpoint determined by the
+    # specified Credentials object.
+    def get_services(credentials, reset_redirect_count=true)
+      @redirect_count = 0 if reset_redirect_count
+
+      req_body = build_request_body credentials.email
+
+      try_standard_secure_urls(credentials, req_body) ||
+      try_standard_redirection_url(credentials, req_body) ||
+      try_dns_serv_record
+    end
+
+    private
+
+    def try_standard_secure_urls(credentials, req_body)
+      response = nil
+      [ "https://#{credentials.smtp_domain}/autodiscover/autodiscover.xml",
+        "https://autodiscover.#{credentials.smtp_domain}/autodiscover/autodiscover.xml"
+      ].each do |url|
+        @debug_dev << "AUTODISCOVER: trying #{url}\n" if @debug_dev
+        response = try_secure_url(url, credentials, req_body)
+        break if response
+      end
+      response
+    end
+
+    def try_standard_redirection_url(credentials, req_body)
+      url = "http://autodiscover.#{credentials.smtp_domain}/autodiscover/autodiscover.xml"
+      @debug_dev << "AUTODISCOVER: looking for redirect from #{url}\n" if @debug_dev
+      response = @http.get(url) rescue nil
+      return nil unless response
+
+      if response.status_code == 302
+        try_redirect_url(response.header['Location'].first, credentials, req_body)
+      else
+        nil
+      end
+    end
+
+    def try_secure_url(url, credentials, req_body)
+      @http.set_auth(url, credentials.email, credentials.password)
+
+      response = @http.post(url, req_body, {'Content-Type' => 'text/xml; charset=utf-8'}) rescue nil
+      return nil unless response
+
+      if response.status_code == 302
+        try_redirect_url(response.header['Location'].first, credentials, req_body)
+      elsif HTTP::Status.successful?(response.status_code)
+        result = parse_response(response.content)
+        case result
+          when Autodiscover::Services
+            return result
+          when Autodiscover::RedirectUrl
+            try_redirect_url(result.url, credentials, req_body)
+          when Autodiscover::RedirectAddress
+            begin
+              credentials.email = result.address
+            rescue ArgumentError
+              # An invalid email address was returned
+              return nil
+            end
+            
+            try_redirect_addr(credentials)
+        end
+      else
+        nil
+      end
+    end
+
+    def try_redirect_url(url, credentials, req_body)
+      @redirect_count += 1
+      return nil if @redirect_count > REDIRECT_LIMIT
+
+      # Only permit redirects to secure addresses
+      return nil unless url =~ /^https:/i
+      try_secure_url(url, credentials, req_body)
+    end
+
+    def try_redirect_addr(credentials)
+      @redirect_count += 1
+      return nil if @redirect_count > REDIRECT_LIMIT
+
+      get_services(credentials, false)
+    end
+
+    def try_dns_serv_record
+      nil
+    end
+
+    def build_request_body(email)
+      Nokogiri::XML::Builder.new do |xml| 
+        xml.Autodiscover('xmlns' => 'http://schemas.microsoft.com/exchange/autodiscover/outlook/requestschema/2006') {
+          xml.Request {
+            xml.EMailAddress email
+            xml.AcceptableResponseSchema 'http://schemas.microsoft.com/exchange/autodiscover/outlook/responseschema/2006a'
+          }
+        }
+      end.to_xml
+    end
+
+    NAMESPACES = {
+      'a' => 'http://schemas.microsoft.com/exchange/autodiscover/responseschema/2006',
+      'o' => 'http://schemas.microsoft.com/exchange/autodiscover/outlook/responseschema/2006a'        
+    }  #:nodoc:
+
+    def parse_response(body)
+      doc = parse_xml body
+      return nil unless doc
+
+      # The response must include an Account element. Return an error if not found.
+      account_e = doc.at_xpath('a:Autodiscover/o:Response/o:Account', NAMESPACES)
+      return nil unless account_e
+
+      # The response must include an Action element. Return an error if not found.
+      action_e = account_e.at_xpath('o:Action', NAMESPACES)
+      return nil unless action_e
+
+      case action_e.content
+        when /^settings$/i
+          # Response contains configuration settings in <Protocol> elements
+          # Only care about about "EXPR" type protocol configuration values
+          # for accessing Exchange services outside of the firewall
+          settings = {}
+          if protocol_e = account_e.at_xpath('o:Protocol[o:Type="EXPR"]', NAMESPACES)
+            # URL for the Web services virtual directory.
+            ews_url_e = protocol_e.at_xpath('o:EwsUrl', NAMESPACES)
+            settings['ews_url'] = ews_url_e.content if ews_url_e
+            # Time to Live (TTL) in hours. Default is 1 hour if no element is
+            # returned.
+            ttl_e = protocol_e.at_xpath('o:TTL', NAMESPACES)
+            settings['ttl'] = ttl_e ? ttl_e.content : 1
+          end
+          Autodiscover::Services.new(settings)
+        when /^redirectAddr$/i
+          # Response contains a new address that must be used to re-­Autodiscover
+          redirect_addr_e = account_e.at_xpath('o:RedirectAddr', NAMESPACES)
+          address = redirect_addr_e ? redirect_addr_e.content : nil
+          return nil unless address
+          Autodiscover::RedirectAddress.new(address)
+        when /^redirectUrl$/i
+          # Response contains a new URL that must be used to re-Autodiscover
+          redirect_url_e = account_e.at_xpath('o:RedirectUrl', NAMESPACES)
+          url = redirect_url_e ? redirect_url_e.content : nil
+          return nil unless url
+          Autodiscover::RedirectUrl.new(url)          
+        else
+          nil
+      end
+    end
+
+    def parse_xml(doc)
+      Nokogiri::XML(doc) { |c| c.options = Nokogiri::XML::ParseOptions::STRICT }
+    rescue Nokogiri::XML::SyntaxError
+      nil
+    end
+  end
+
+  class RedirectUrl  #:nodoc: all
+    attr_reader :url
+
+    def initialize(url)
+      @url = url
+    end
+  end
+
+  class RedirectAddress  #:nodoc: all
+    attr_reader :address
+
+    def initialize(address)
+      @address = address
+    end
+  end
+end

data/lib/autodiscover/credentials.rb

@@ -0,0 +1,51 @@
+#--
+# Copyright (c) 2010-2011 WIMM Labs, Inc.
+#
+# 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.
+#++
+
+module Autodiscover
+  # A Credentials object is used to determine the autodiscover service
+  # endpoint and to authenticate to it.
+  class Credentials
+    # E-mail address for the user.
+    attr_reader :email
+
+    # Password for the account.
+    attr_reader :password
+
+    # SMTP domain determined by the e-mail address.
+    attr_reader :smtp_domain  #:nodoc:
+
+    def initialize(address, password)
+      self.email = address
+      @password = password
+    end
+
+    def email=(address)  #:nodoc:
+      raise ArgumentError, "No email address specified" unless address
+      @smtp_domain = address[/^.+@(.*)$/, 1]
+      unless @smtp_domain =~ /.+\..+/
+        raise ArgumentError, "Invalid email address: #{address}"
+      end
+      @email = address
+    end
+  end
+end

data/lib/autodiscover/services.rb

@@ -0,0 +1,40 @@
+#--
+# Copyright (c) 2010-2011 WIMM Labs, Inc.
+#
+# 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.
+#++
+
+module Autodiscover
+  # A Services object contains the endpoint URLs and settings returned
+  # from an \Autodiscover server.
+  class Services
+    # URL for Exchange Web Services API endpoint.
+    attr_reader :ews_url
+
+    # Time to Live (TTL), in hours, during which the settings remain valid.
+    # A value of zero indicates that rediscovery is not required.
+    attr_reader :ttl
+
+    def initialize(settings)  #:nodoc:
+      @ews_url = settings['ews_url']
+      @ttl = settings['ttl']
+    end
+  end
+end

data/test/unit_test.rb

@@ -0,0 +1,195 @@
+# Prefix LOAD_PATH with lib sub-directory to ensure we're
+# testing the intended version.
+$:.unshift File.join(File.dirname(__FILE__), "..", "lib")
+
+# Load HTTPClient before webmock so the HTTPClient adapter will be used.
+require 'httpclient'
+require 'webmock/test_unit'
+require 'test/unit'
+require 'autodiscover'
+
+SETTINGS_AUTODISCOVER_RESPONSE = <<END
+<?xml version="1.0" encoding="utf-8"?>
+<Autodiscover xmlns="http://schemas.microsoft.com/exchange/autodiscover/responseschema/2006">
+  <Response xmlns="http://schemas.microsoft.com/exchange/autodiscover/outlook/responseschema/2006a">
+    <User>
+      <DisplayName>spiff</DisplayName>
+      <LegacyDN>/o=outlook/ou=Exchange Administrative Group (spacecommand)/cn=Recipients/cn=spiff</LegacyDN>
+      <DeploymentId>11111111-2222-3333-4444-555555555555</DeploymentId>
+    </User>
+    <Account>
+      <AccountType>email</AccountType>
+      <Action>settings</Action>
+      <Protocol>
+        <Type>EXPR</Type>
+        <Server>outlook.spacecommand.sol</Server>
+        <SSL>On</SSL>
+        <AuthPackage>Basic</AuthPackage>
+        <EwsUrl>https://ews.spacecommand.sol/EWS/Exchange.asmx</EwsUrl>
+      </Protocol>
+    </Account>
+  </Response>
+</Autodiscover>
+END
+
+REDIRECTURL_AUTODISCOVER_RESPONSE = <<END
+<?xml version="1.0" encoding="utf-8"?>
+  <Autodiscover xmlns="http://schemas.microsoft.com/exchange/autodiscover/responseschema/2006">
+  <Response xmlns="http://schemas.microsoft.com/exchange/autodiscover/outlook/responseschema/2006a">
+    <Account>
+      <Action>redirectUrl</Action>
+      <RedirectUrl>https://earthcommand.org/autodiscover/autodiscover.xml</RedirectUrl>
+    </Account>
+  </Response>
+</Autodiscover>
+END
+
+REDIRECTADDR_AUTODISCOVER_RESPONSE = <<END
+<?xml version="1.0" encoding="utf-8"?>
+  <Autodiscover xmlns="http://schemas.microsoft.com/exchange/autodiscover/responseschema/2006">
+  <Response xmlns="http://schemas.microsoft.com/exchange/autodiscover/outlook/responseschema/2006a">
+    <Account>
+      <Action>redirectAddr</Action>
+      <RedirectAddr>calvin@spacecommand.sol</RedirectAddr>
+    </Account>
+  </Response>
+</Autodiscover>
+END
+
+class AutodiscoverResponseTest < Test::Unit::TestCase
+  def setup
+    @credentials = Autodiscover::Credentials.new('spiff@spacecommand.sol', 'hobbes')
+    @client = Autodiscover::Client.new
+    WebMock::stub_request(:any, /spacecommand.sol/).to_timeout
+  end
+
+  # Test the cases where the Autodiscover service is configured to listen on
+  # the standard secure endpoint addresses.
+  [ "https://spiff%40spacecommand.sol:hobbes@spacecommand.sol/autodiscover/autodiscover.xml",
+    "https://spiff%40spacecommand.sol:hobbes@autodiscover.spacecommand.sol/autodiscover/autodiscover.xml"
+  ].each_with_index do |url, i|
+    define_method "test_standard_secure_urls_#{i}" do
+      WebMock::stub_request(:post, url).to_return(
+        :body => SETTINGS_AUTODISCOVER_RESPONSE,
+        :status => 200, 
+        :headers => { 'Content-Length' => SETTINGS_AUTODISCOVER_RESPONSE.size }
+      )
+      response = @client.get_services(@credentials)
+      assert_not_nil response
+      assert_equal 'https://ews.spacecommand.sol/EWS/Exchange.asmx', response.ews_url
+    end
+  end
+
+  # Test the cases where a standard secure address is used to redirect
+  # to a secure endpoint that the Autodiscover service is available upon.
+  def test_redirect_from_standard_secure_url
+    WebMock::stub_request(:post, /spacecommand.sol/).to_return(
+      :status => 302,
+      :headers => { 'Location' => 'https://earthcommand.org/autodiscover/autodiscover.xml' }
+    )
+    WebMock::stub_request(:post, 'https://spiff%40spacecommand.sol:hobbes@earthcommand.org/autodiscover/autodiscover.xml').to_return(
+      :body => SETTINGS_AUTODISCOVER_RESPONSE,
+      :status => 200, 
+      :headers => { 'Content-Length' => SETTINGS_AUTODISCOVER_RESPONSE.size }
+    )
+    response = @client.get_services(@credentials)
+    assert_not_nil response
+    assert_equal 'https://ews.spacecommand.sol/EWS/Exchange.asmx', response.ews_url
+  end
+
+  # Test the cases where the standard insecure redirect address is used to redirect
+  # to a secure endpoint that the Autodiscover service is available upon.
+  def test_standard_redirection_url
+    WebMock::stub_request(:get, "http://autodiscover.spacecommand.sol/autodiscover/autodiscover.xml").to_return(
+      :status => 302,
+      :headers => { 'Location' => 'https://earthcommand.org/autodiscover/autodiscover.xml' }
+    )
+    WebMock::stub_request(:post, 'https://spiff%40spacecommand.sol:hobbes@earthcommand.org/autodiscover/autodiscover.xml').to_return(
+      :body => SETTINGS_AUTODISCOVER_RESPONSE,
+      :status => 200, 
+      :headers => { 'Content-Length' => SETTINGS_AUTODISCOVER_RESPONSE.size }
+    )
+    response = @client.get_services(@credentials)
+    assert_not_nil response
+    assert_equal 'https://ews.spacecommand.sol/EWS/Exchange.asmx', response.ews_url
+  end
+
+  # Test the case where a post to a standard secure address returns a redirectUrl response that
+  # redirects to a secure endpoint that returns a valid settings response.
+  def test_redirect_url_response
+    WebMock::stub_request(:post, "https://spiff%40spacecommand.sol:hobbes@spacecommand.sol/autodiscover/autodiscover.xml").to_return(
+      :body => REDIRECTURL_AUTODISCOVER_RESPONSE,
+      :status => 200, 
+      :headers => { 'Content-Length' => REDIRECTURL_AUTODISCOVER_RESPONSE.size }
+    )
+    WebMock::stub_request(:post, 'https://spiff%40spacecommand.sol:hobbes@earthcommand.org/autodiscover/autodiscover.xml').to_return(
+      :body => SETTINGS_AUTODISCOVER_RESPONSE,
+      :status => 200, 
+      :headers => { 'Content-Length' => SETTINGS_AUTODISCOVER_RESPONSE.size }
+    )
+    response = @client.get_services(@credentials)
+    assert_not_nil response
+    assert_equal 'https://ews.spacecommand.sol/EWS/Exchange.asmx', response.ews_url
+  end
+
+  # Test the case where a post to a standard secure address returns a redirectAddr response that
+  # includes a new email address to use.
+  def test_redirect_addr_response
+    WebMock::stub_request(:post, "https://spiff%40spacecommand.sol:hobbes@autodiscover.spacecommand.sol/autodiscover/autodiscover.xml").to_return(
+      :body => REDIRECTADDR_AUTODISCOVER_RESPONSE,
+      :status => 200, 
+      :headers => { 'Content-Length' => REDIRECTURL_AUTODISCOVER_RESPONSE.size }
+    )
+    WebMock::stub_request(:post, 'https://calvin%40spacecommand.sol:hobbes@spacecommand.sol/autodiscover/autodiscover.xml').to_return(
+      :body => SETTINGS_AUTODISCOVER_RESPONSE,
+      :status => 200, 
+      :headers => { 'Content-Length' => SETTINGS_AUTODISCOVER_RESPONSE.size }
+    )
+    response = @client.get_services(@credentials)
+    assert_not_nil response
+    assert_equal 'https://ews.spacecommand.sol/EWS/Exchange.asmx', response.ews_url
+  end
+
+  # Test the case where there is an infinite loop of HTTP redirects. A limit should be hit
+  # and a nil result should be returned.
+  def test_http_redirect_limit
+    WebMock::stub_request(:post, /spacecommand.sol/).to_return(
+      :status => 302,
+      :headers => { 'Location' => 'https://spacecommand.sol/autodiscover/autodiscover.xml' }
+    )
+    response = @client.get_services(@credentials)
+    assert_nil response
+  end
+
+  # Test the case where there is an infinite loop created by circular redirectUrl responses.
+  # The redirect limit should be reached and a nil result should be returned.
+  def test_redirect_url_response_limit
+    WebMock::stub_request(:post, "https://spiff%40spacecommand.sol:hobbes@spacecommand.sol/autodiscover/autodiscover.xml").to_return(
+      :body => REDIRECTURL_AUTODISCOVER_RESPONSE,
+      :status => 200, 
+      :headers => { 'Content-Length' => REDIRECTURL_AUTODISCOVER_RESPONSE.size }
+    )
+    WebMock::stub_request(:post, 'https://spiff%40spacecommand.sol:hobbes@earthcommand.org/autodiscover/autodiscover.xml').to_return(
+      :body => REDIRECTURL_AUTODISCOVER_RESPONSE,
+      :status => 200, 
+      :headers => { 'Content-Length' => SETTINGS_AUTODISCOVER_RESPONSE.size }
+    )
+    response = @client.get_services(@credentials)
+    assert_nil response
+  end
+
+  def test_redirect_addr_response_limit
+    WebMock::stub_request(:post, "https://spiff%40spacecommand.sol:hobbes@spacecommand.sol/autodiscover/autodiscover.xml").to_return(
+      :body => REDIRECTADDR_AUTODISCOVER_RESPONSE,
+      :status => 200, 
+      :headers => { 'Content-Length' => REDIRECTURL_AUTODISCOVER_RESPONSE.size }
+    )
+    WebMock::stub_request(:post, 'https://calvin%40spacecommand.sol:hobbes@spacecommand.sol/autodiscover/autodiscover.xml').to_return(
+      :body => REDIRECTADDR_AUTODISCOVER_RESPONSE,
+      :status => 200, 
+      :headers => { 'Content-Length' => SETTINGS_AUTODISCOVER_RESPONSE.size }
+    )
+    response = @client.get_services(@credentials)
+    assert_nil response
+  end
+end

metadata

@@ -0,0 +1,112 @@
+--- !ruby/object:Gem::Specification 
+name: autodiscover
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- David King
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-01-02 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: httpclient
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: webmock
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id003
+description: Library to find the Autodiscover server and to get from it the URLs and settings needed to access Web services available from Exchange servers.
+email: dking@bestinclass.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- MIT-LICENSE
+- README.md
+files: 
+- CHANGELOG
+- README.md
+- MIT-LICENSE
+- lib/autodiscover/client.rb
+- lib/autodiscover/credentials.rb
+- lib/autodiscover/services.rb
+- lib/autodiscover.rb
+- test/unit_test.rb
+has_rdoc: true
+homepage: http://github.com/wimm/autodiscover
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 1
+      - 8
+      - 7
+      version: 1.8.7
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Ruby client for Microsoft's Autodiscover Service
+test_files: 
+- test/unit_test.rb