trisulrp 1.5.8 → 1.6.0

data/VERSION

@@ -1 +1 @@
-1.5.8
+1.6.0

data/lib/trisulrp/protocol.rb

@@ -38,6 +38,10 @@ module TrisulRP::Protocol
   # * Trisul is not running in trp mode (see the docs for runmode)
   # * Using the wrong port ( check netstat to verify trisul remote protocol port - typically 12001)
   # * The Access Control List does not permit connections from client IP
+  # * The server certificate expired
+  # * The client certificate expired
+  # * The client does not have permissions to connect with that cert 
+  # * The private key password is wrong 
   #
   def connect(server,port,client_cert_file,client_key_file)
     tcp_sock=TCPSocket.open(server,port)
@@ -50,6 +54,42 @@ module TrisulRP::Protocol
     return ssl_sock
   end
 
+  # Establish a *NONSECURE PLAINTEXT* connection to a Trisul instance 
+  #
+  # We highly recommend  you to use the TLS connect(..) method, but if
+  # you must use plaintext use this version. This is purposely named
+  # connect_nonsecure(..) to drive home the point that there is no
+  # authentication using client certs, or no encryption. 
+  #
+  # You can still use the ACL (Access Control List) to control who connects
+  #
+  #
+  # [server]  IP Address or hostname 
+  # [port]    TRP port, typically 12001 (see trisulConfig.xml)
+  #
+  #
+  # ==== Returns
+  # ==== Yields
+  # a connection object that can be used in subsequent calls 
+  #
+  # ==== On error
+  # If a connection cannot be established, an exception is thrown which can point 
+  # to the actual cause. The most common causes are  
+  #
+  # * Trisul is not running 
+  # * Trisul is not running in trp mode (see the docs for runmode)
+  # * Using the wrong port ( check netstat to verify trisul remote protocol port - typically 12001)
+  # * The Access Control List does not permit connections from client IP
+  #
+  def connect_nonsecure(server,port)
+
+    tcp_sock=TCPSocket.open(server,port)
+    yield tcp_sock if block_given?
+    return tcp_sock
+
+  end
+
+
   # Dispatch request to server & get response 
   # [conn]  TRP connection  previously opened via TrisulRP::Protocol::connect
   # [trp_request]  a TRP request object, created directly or using the mk_request helper 

data/trisulrp.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "trisulrp"
-  s.version = "1.5.8"
+  s.version = "1.6.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["vivek"]
-  s.date = "2013-11-21"
+  s.date = "2013-12-13"
   s.description = "This gem deals about the trisul remote protocol"
   s.email = "vivek_rajagopal@yahoo.com"
   s.extra_rdoc_files = [

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: trisulrp
 version: !ruby/object:Gem::Version
-  version: 1.5.8
+  version: 1.6.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-11-21 00:00:00.000000000 Z
+date: 2013-12-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby-protocol-buffers
@@ -158,7 +158,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -727236621149825974
+      hash: 4500533550725413693
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: