dot_net_services 0.3.0 → 0.4.0

data/lib/acs/token_validator.rb

@@ -0,0 +1,114 @@
+# Copyright (c) 2009, Persistent Systems Limited
+#
+# Redistribution and use, with or without modification, are permitted
+#  provided that the following  conditions are met:
+#   - Redistributions of source code must retain the above copyright notice,
+#     this list of conditions and the following disclaimer.
+#   - Neither the name of Persistent Systems Limited nor the names of its contributors
+#     may be used to endorse or promote products derived from this software
+#     without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE, DATA, OR PROFITS
+# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+# EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+require "cgi"
+require "base64"
+require 'rubygems'
+require 'hmac-sha2'
+require "#{__FILE__}/../../service_bus/requests"
+
+class TokenValidator
+  
+  attr_reader :claims, :trusted_token_issuer, :trusted_audience, :trusted_signing_key, :token
+  
+  # service_name: Defined in the contants file
+  # solution_name: Name of the service created
+  # truste_audience: Applies_to url
+  # trusted_signing_key: Management key provided when the service was created
+  # token: service_name + " " + token received
+  def initialize(service_name, solution_name, trusted_audience, trusted_signing_key, token)
+    token_separator = ' '
+    @issuer_label = "Issuer"
+    @expires_label = "ExpiresOn"
+    @audience_label = "Audience"
+    @hmacSHA256_label = "HMACSHA256"
+     
+    @trusted_token_issuer = "https://" + solution_name + "." + DotNetServicesEnvironment.acm_host_name +
+      "/" + service_name
+    @trusted_audience = trusted_audience
+    @trusted_signing_key = trusted_signing_key
+    
+    @token = CGI::unescape(token.split(token_separator).last)
+    populate_claims(@token)
+  end
+  
+  # Validates the token based on hmac key, expiry, issuer and audience.
+  def validate
+    return false if(@token[0..7] == "WRAPv0.8")
+    return false unless hmac_valid?
+    self.populate_claims(@token)
+    return false if expired?
+    return false unless issuer_trusted?
+    return false unless audience_trusted?
+    return true
+  end
+    
+  # Checks the token against hmac key
+	def hmac_valid?
+    @token_signature = @token.split('&' + @hmacSHA256_label + '=')
+    return false if(@token_signature.size != 2)
+    @computed_signature = Base64.encode64(HMAC::SHA256.digest(Base64.decode64(@trusted_signing_key), @token_signature.first))
+    @computed_signature = @computed_signature.gsub("\n", "")
+    return (@computed_signature == (CGI::unescape(@token_signature.last)))
+  end
+
+  # Validates claims received in the tokens with the expected claims
+  # * expected_claims: Hask containing key-value pairs of claims
+  def validate_claims(expected_claims)
+     expected_claim_keys = expected_claims.keys
+     expected_claim_keys.each do |key|
+       return false unless @claims[key]
+       return false unless (expected_claims[key] == @claims[key])
+     end
+   end
+
+  # Extracts the claims from token
+  # * token_value: Token returned by the .NET services
+	def populate_claims(token_value)
+    token_value.extend DotNetServices::HTTPRequests::ToHash
+    @claims = token_value.to_hash
+  end
+  
+  # Checks if the token is expired or not
+	def expired?
+    raise StandardError.new("Claims not defined in the token.") if(@claims.empty?)
+    expires_on_seconds =  @claims[@expires_label]
+    expiry_time = Time.at(expires_on_seconds.to_i)
+    current_time = Time.new
+    # Current timestamp must be less than expiration time stamp
+    return (current_time > expiry_time)
+  end
+  
+  # Checks if the issuer in the token is the same as the trusted token issuer
+	def issuer_trusted?
+    raise StandardError.new("Claims not defined in the token.") if(@claims.empty?)
+    @issuer = @claims[@issuer_label]
+    return ((@issuer.empty?) || (@issuer.casecmp(@trusted_token_issuer)  != 0))
+  end
+  
+  # Checks if the audience (applies to) in the token is the same as the trusted token issuer
+	def audience_trusted?
+    raise StandardError.new("Claims not defined in the token.") if(@claims.empty?)
+    audience = @claims[@audience_label]
+    return ((!audience.empty?) || (audience == @trusted_audience))
+  end
+end

data/lib/common/dot_net_services_environment.rb

@@ -0,0 +1,61 @@
+# Copyright (c) 2009, Persistent Systems Limited
+#
+# Redistribution and use, with or without modification, are permitted
+#  provided that the following  conditions are met:
+#   - Redistributions of source code must retain the above copyright notice,
+#     this list of conditions and the following disclaimer.
+#   - Neither the name of Persistent Systems Limited nor the names of its contributors
+#     may be used to endorse or promote products derived from this software
+#     without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE, DATA, OR PROFITS
+# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+# EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+require 'yaml'
+# Class that holds Service bus and ACS host names for bvt, int, ppe and prod environment.
+# The environment can be set in environment.properties file
+class DotNetServicesEnvironment
+
+  ENV_FILE = File.join(File.dirname(__FILE__), "environment.yml")
+  HOST_NAME_CONFIG_FILE = File.join(File.dirname(__FILE__), "host_name_config.yml")
+  ENCODING = "UTF-8"
+  # Default env is set to bvt during development,
+  # will be changed to prod at the time of release
+  HOST_NAMES = YAML.load(File.open(HOST_NAME_CONFIG_FILE))["environments"]
+
+  class << self
+    # Returns the environment from the environment.yml file
+    def environment
+      environment = YAML.load(File.open(ENV_FILE))
+      (environment && environment['Environment'])
+    end
+
+    def acm_host_name(env = nil)
+      HOST_NAMES[valid_env(env)]['acm']
+    end
+
+    def sts_host_name(env = nil)
+      HOST_NAMES[valid_env(env)]['sts']
+    end
+
+    def service_bus_host_name(env = nil)
+      HOST_NAMES[valid_env(env)]['service_bus']
+    end
+
+    def valid_env(env)
+      env ||= environment
+      HOST_NAMES.keys.include?(env) ? env : 'default'
+    end
+
+  end
+
+end

data/lib/common/environment.yml

@@ -0,0 +1,23 @@
+# Copyright (c) 2009, Persistent Systems Limited
+#
+# Redistribution and use, with or without modification, are permitted
+#  provided that the following  conditions are met:
+#   - Redistributions of source code must retain the above copyright notice,
+#     this list of conditions and the following disclaimer.
+#   - Neither the name of Persistent Systems Limited nor the names of its contributors
+#     may be used to endorse or promote products derived from this software
+#     without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE, DATA, OR PROFITS
+# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+# EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+Environment: prod

data/lib/common/host_name_config.yml

@@ -0,0 +1,45 @@
+# Copyright (c) 2009, Persistent Systems Limited
+#
+# Redistribution and use, with or without modification, are permitted
+#  provided that the following  conditions are met:
+#   - Redistributions of source code must retain the above copyright notice,
+#     this list of conditions and the following disclaimer.
+#   - Neither the name of Persistent Systems Limited nor the names of its contributors
+#     may be used to endorse or promote products derived from this software
+#     without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE, DATA, OR PROFITS
+# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+# EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+environments:
+  bvt: &bvt
+    service_bus: servicebus.windows-bvt.net
+    acm: accesscontrol.windows-bvt.net
+    sts: accesscontrol.windows-bvt.net
+
+  int: &int
+    service_bus: servicebus.int2.windows-int.net
+    acm: accesscontrol.int2.windows-int.net
+    sts: accesscontrol.int2.windows-int.net
+
+  ppe: &ppe
+    service_bus: servicebus.windows-ppe.net
+    acm: accesscontrol.windows-ppe.net
+    sts: accesscontrol.windows-ppe.net
+
+  prod: &prod
+    service_bus: servicebus.windows.net
+    acm: accesscontrol.windows.net
+    sts: accesscontrol.windows.net
+
+  default:
+    <<: *prod

data/lib/dot_net_services.rb

@@ -1,145 +1,32 @@
-require 'dot_net_services/session'
-require 'dot_net_services/authentication'
-require 'dot_net_services/error'
-require 'dot_net_services/message_buffer'
-require 'net/http/create_mb'
-require 'net/http/retrieve'
-require 'net/http/subscribe'
+# Copyright (c) 2009, Persistent Systems Limited
+#
+# Redistribution and use, with or without modification, are permitted
+#  provided that the following  conditions are met:
+#   - Redistributions of source code must retain the above copyright notice,
+#     this list of conditions and the following disclaimer.
+#   - Neither the name of Persistent Systems Limited nor the names of its contributors
+#     may be used to endorse or promote products derived from this software
+#     without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE, DATA, OR PROFITS
+# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+# EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+require "#{__FILE__}/../acs/shared_secret_token_provider"
+require "#{__FILE__}/../acs/simple_api_auth_token_provider"
+require "#{__FILE__}/../acs/simple_web_token_provider"
+require "#{__FILE__}/../acs/saml_token_provider"
+require "#{__FILE__}/../acs/token_constants"
+require "#{__FILE__}/../acs/token_info"
+require "#{__FILE__}/../acs/token_provider"
+require "#{__FILE__}/../acs/token_validator"
+require "#{__FILE__}/../service_bus/message_buffer"
 
-# DotNetServices is the top-level namespace of <b>.NET Services for Ruby</b>, Ruby interoperability layer for
-# .NET Services plain HTTP (REST) API.
-#
-# == .NET Services
-#
-# Since you are reading this, you probably already know that .NET Services is a Microsoft product, described as the
-# "Internet Services Bus", a messaging bus in the cloud. Like any other messaging bus, it helps services and consumers
-# to communicate with each other. Further information on .NET Services can be found on MSDN:
-# http://go.microsoft.com/fwlink/?LinkID=129428.
-#
-# While .NET Services primarily target .NET platform, non-Microsoft software is also catered for,
-# by providing open protocols for most of the bus functionality, in both SOAP/WS-* and plain HTTP style. The latter
-# is structured in a way that makes it easy to implement REST interactions over the bus, including both
-# synchronous and asynchronous semantics. .NET Services bus doesn't force an application to use REST, any
-# other kind of plain HTTP protocol can be routed through it, too.
-#
-#
-# == Functionality
-#
-# This library is a simple Ruby wrapper for .NET Services plain HTPP (REST) APIs. Current version allows Ruby
-# developers to build consumers of synchronous RESTful services (implemented as .NET WCF services, using
-# webHttpRelayBinding, provided by the .NET Services SDK). You can also exchange messages between Ruby processes via
-# Volatile Message Buffers (VMBs), which are .NET Services mechanism for asynchronous communications.
-#
-# .NET Services for Ruby looks like Net::HTTP API from the standard library, but deals with authentication,
-# VMB management and message retrieval.
-#
-# Since this is a 0.1.0 version of an interoperability layer for a PDC version of a bus, a few things are missing.
-#
-# Most notably, with this version you still can not:
-# * communicate with WCF services bound by anything other than webHttpRelayBinding.
-# * communicate with the bus via WS-* protocols.
-# * communicate with a WCF-based service via a VMB. At least, not until .NET Services SDK adds a WCF binding for
-# REST via VMB. Once it's available, we should be able to work with it.
-# * use VMB pub-sub and multicast functionality
-# * use Workflow Services
-# * use Identity Service as a dfederated identity provider for end-users
-#
-# == Usage examples
-#
-# Say, you are a cellphone dealer. You have a Point of Sale web application, written in Rails. It sells cellphones.
-# The phones you sell are operated by a phone company, which offers a .NET Services solution (group of services in
-# the .NET Services world), called Dealership. It includes two services, Customer and Provisioning.
-#
-# Customer service is a RESTful service endpoint, implemented by WCF service with a webHttpRelayBinding. It's listening
-# on /Customer URL, and provides the usual CRUD functionality for managing customers.
-#
-# Provisioning service endpoint is a VMB. Coincidentally, it's also written in Ruby! :) When a customer buys a new phone,
-# provisioning application should activate the phohe on the network, so that the customer can actually make calls with it.
-# Activation can take several minutes, even hours, and we don't want the point of sale terminal to hang until it's over.
-# Hence the use of a VMB as an asynchronous communication device.
-#
-# To create a customer, point of sale app needs to post a URL-encoded form to a webHttpRelayBinding endpoint. That's
-# where you need to use a DotNetServices::Session class:
-#
-#   require 'dotnetservices'
-#   session = DotNetServices::Session.open("/Dealership/Customer", :username => 'Dealership', :password => '_password')
-#   session.post :first_name => 'John', :last_name => 'Doe'
-#
-# Posting a message to a Provisioning endpoint would actually look the same:
-#
-#   session = DotNetServices::Session.open("/Dealership/Provisioning", :username => 'Dealership', :password => '_password')
-#   session.post :phone_number => '555 888-8888'
-#
-# DotNetServices::MessageBuffer is needed by the Provisioning *service* (and not the client), to register the VMB and
-# retrieve messages from it. Usage typically looks like this:
-#
-#   buffer = DotNetServices::MessageBuffer.new("/Dealership/Provisioning",
-#                                              :username => 'Dealership', :password => '_password')
-#   buffer.open_and_poll do |message|
-#     ... process incoming messages ...
-#   end
-#
-# This code will check that the VMB exists, create one if necessary, and continuously poll it for new messages. Whenever
-# a new message is sent to VMB, MessageBuffer#open_and_poll retrieves it and invokesthe block, passing it a
-# Net::HTTP::Request instance that looks exactly like what the sender originally sent to the VMB. Nice and easy.
-#
-# To understand and use .NET Services for Ruby, you should probably also read the documentation for the two classes
-# mentioned above: DotNetServices::Session and DotNetServices::MessageBuffer.
-#
-# Happy bussing!
-module DotNetServices
-
-  class << self
-
-    # The name of the host providing DotNetServices relay services.
-    def relay_host
-      "servicebus.windows.net"
-    end
-
-    # The name of the host providing DotNetServices identity services.
-    def identity_host
-      'accesscontrol.windows.net'
-    end
-
-    # The root URL used for exposing services.
-    def root_url
-      # Modified as per changes in enpoint URL naming conventions in
-      # .Net Services March 09 CTP release (M5)
-      "#{relay_host}/"
-    end
-
-    # Host and port of the bus endpoint.
-    def host_port
-      return @host_port if @host_port
-      uri = URI.parse(root_url) 
-      @host_port = [uri.host, uri.port]
-      @host_port
-    end
-
-    # Use an HTTP proxy to connect to .NET Services
-    #
-    # If you call this method, all subsequent communications with .NET Services will use an HTTP proxy.
-    # You must given hostname and password #use proxy 
-    #   DotNetServices.use_proxy()
-    def use_proxy(proxy_host, proxy_port, proxy_user = nil, proxy_password = nil)
-      @proxy = Net::HTTP::Proxy(proxy_host, proxy_port, proxy_user, proxy_password)
-    end
-
-    # An HTTP proxy to connect through.
-    #
-    # Defaults to Net::HTTP (direct connection without proxy). To set a proxy, see #use_proxy.
-    def proxy
-      @proxy || Net::HTTP
-    end
-
-    # TODO implement!
-    def logger
-      if RAILS_ENV
-        nil
-      else
-        @logger ||= nil
-      end
-    end
-
-  end
-end

data/lib/service_bus/http_proxy.rb

@@ -0,0 +1,34 @@
+# Copyright (c) 2009, Persistent Systems Limited
+#
+# Redistribution and use, with or without modification, are permitted
+#  provided that the following  conditions are met:
+#   - Redistributions of source code must retain the above copyright notice,
+#     this list of conditions and the following disclaimer.
+#   - Neither the name of Persistent Systems Limited nor the names of its contributors
+#     may be used to endorse or promote products derived from this software
+#     without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE, DATA, OR PROFITS
+# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+# EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+require 'net/http'
+
+module HTTPProxy # :nodoc:
+
+  def set_http_web_proxy(proxy)
+    if proxy['http_web_proxy_server'] && proxy['http_web_proxy_port']
+      @http_web_proxy = Net::HTTP::Proxy(proxy['http_web_proxy_server'], proxy['http_web_proxy_port'], proxy['http_web_proxy_username'], proxy['http_web_proxy_password'])
+    end
+  end
+end
+
+

data/lib/service_bus/locked_message_info.rb

@@ -0,0 +1,34 @@
+# Copyright (c) 2009, Persistent Systems Limited
+#
+# Redistribution and use, with or without modification, are permitted
+#  provided that the following  conditions are met:
+#   - Redistributions of source code must retain the above copyright notice,
+#     this list of conditions and the following disclaimer.
+#   - Neither the name of Persistent Systems Limited nor the names of its contributors
+#     may be used to endorse or promote products derived from this software
+#     without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE, DATA, OR PROFITS
+# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+# EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+class LockedMessageInfo # :nodoc:
+  
+  attr_accessor :lock_id, :lock_uri, :message_uri
+
+  def initialize(lock_id, lock_uri, message_uri)
+    @lock_id = lock_id
+    @lock_uri = lock_uri
+    @message_uri = message_uri
+  end
+
+end
+