certificate-transparency-client 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d688032d7f32de9399ffac2339ae54897650bfd5
-  data.tar.gz: a2127485b2aa9657dc4534ed4c147de6ca25d565
+  metadata.gz: 6d6a56b3273a0429713b312948b1d4d6aa6fcf58
+  data.tar.gz: 7ea05b65e5b80d272f358d8e6b54220838df10fc
 SHA512:
-  metadata.gz: 353cbf08a26d3d9e9a9adaaf355fa1c33bf7192fafb45fb1e6cc2696fb3453d5094a1fa01e61f58071e4874c513e260ef02cf4bb9e3c63fc1e912922ebb9d678
-  data.tar.gz: b12f6515e8aa005bd3199c814544da926f3a4f2b669e11d9784f19ace14d02ed065366ffba81186c5077ecccd8a0bd44ff84c61a7d9caaa80557341b0f7b96dc
+  metadata.gz: a73f1d0a7f17adb86d52a3f300ec67b254521622fd14fba920803748ee613e6fa3c297e21d240042ad870981827c8000483e75069078c08ed888e2090904f076
+  data.tar.gz: 619c902a80cc5253b862840e80a36531c52f58ad39d5d2926a96d251c488081feaead33021d5f7cfa27ffe33d1527779031d079872be2a24ee99f2667f77c95d

data/certificate-transparency-client.gemspec

@@ -22,7 +22,7 @@ Gem::Specification.new do |s|
 
 	s.required_ruby_version = ">= 1.9.3"
 
-	s.add_runtime_dependency 'certificate-transparency', '~> 0.0'
+	s.add_runtime_dependency 'certificate-transparency', '~> 0.4'
 
 	s.add_development_dependency 'bundler'
 	s.add_development_dependency 'github-release'
@@ -33,5 +33,6 @@ Gem::Specification.new do |s|
 	s.add_development_dependency 'rb-inotify', '~> 0.9'
 	s.add_development_dependency 'redcarpet'
 	s.add_development_dependency 'rspec'
+	s.add_development_dependency 'webmock'
 	s.add_development_dependency 'yard'
 end

data/lib/certificate-transparency/client.rb

@@ -1,9 +1,36 @@
 require 'certificate-transparency'
 require 'openssl'
+require 'uri'
 
 # Interact with a Certificate Transparency server.
 #
 class CertificateTransparency::Client
+	# Base class for all errors from CT::Client.
+	#
+	class Error < StandardError; end
+
+	# Indicates an error in making a HTTP request.
+	#
+	class HTTPError < Error; end
+
+	# The public key of the log, as specified in the constructor.
+	#
+	# @return [OpenSSL::PKey]
+	#
+	attr_reader :public_key
+
+	# Create thyself a new CT::Client.
+	#
+	# @param url [String] the "base" URL to the CT log, without any
+	#   `/ct/v1` bits in it.
+	#
+	# @param opts [Hash] any options you'd like to pass.
+	#
+	# @option public_key [String] either the "raw" bytes of a log's public
+	#   key, or the base64-encoded form of same.
+	#
+	# @return [CT::Client]
+	#
 	def initialize(url, opts = {})
 		unless opts.is_a? Hash
 			raise ArgumentError,
@@ -12,7 +39,7 @@ class CertificateTransparency::Client
 
 		if opts[:public_key]
 			begin
-				@pubkey = if opts[:public_key].valid_encoding? && opts[:public_key] =~ /^[A-Za-z0-9+\/]+=*$/
+				@public_key = if opts[:public_key].valid_encoding? && opts[:public_key] =~ /^[A-Za-z0-9+\/]+=*$/
 					OpenSSL::PKey::EC.new(opts[:public_key].unpack("m").first)
 				else
 					OpenSSL::PKey::EC.new(opts[:public_key])
@@ -25,4 +52,84 @@ class CertificateTransparency::Client
 
 		@url = URI(url)
 	end
+
+	# Retrieve the current Signed Tree Head from the log.
+	#
+	# @return [CT::SignedTreeHead]
+	#
+	# @raise [CT::Client::HTTPError] if something goes wrong with the HTTP
+	#   request.
+	#
+	def get_sth
+		CT::SignedTreeHead.from_json(make_request("get-sth"))
+	end
+
+	# Retrieve one or more entries from the log.
+	#
+	# @param first [Integer] the 0-based index of the first entry in the log
+	#   that you wish to retrieve.
+	#
+	# @param last [Integer] the 0-base indexd of the last entry in the log
+	#   that you wish to retrieve.  Note that you may not get as many entries
+	#   as you requested, due to limits in the response size that are imposed
+	#   by many log servers.
+	#
+	#   If `last` is not specified, this method will attempt to retrieve as
+	#   many entries as the log is willing and able to hand over.
+	#
+	# @return [Array<CT::LogEntry>]
+	#
+	# @raise [CT::Client::HTTPError] if something goes wrong with the HTTP
+	#   request.
+	#
+	def get_entries(first, last = nil)
+		last ||= get_sth.tree_size - 1
+
+		entries_json = make_request("get-entries", :start => first, :end => last)
+		JSON.parse(entries_json)["entries"].map do |entry|
+			CT::LogEntry.from_json(entry.to_json)
+		end
+	end
+
+	private
+
+	# Make a request to the log server.
+	#
+	# @param op [String] the bit after `/ct/v1/` in the URL path.
+	#
+	# @param params [Hash<#to_s, #to_s>] any query params you wish to send
+	#   off with the request.
+	#
+	# @return [String]
+	#
+	# @raise [CT:Client::HTTPError] if anything goes spectacularly wrong.
+	#
+	def make_request(op, params = nil)
+		resp = Net::HTTP.get_response(url(op, params))
+
+		if resp.code != "200"
+			raise CT::Client::HTTPError,
+			      "Failed to #{op}: got HTTP #{resp.code}"
+		end
+
+		if resp["Content-Type"] != "application/json"
+			raise CT::Client::HTTPError,
+			      "Failed to #{op}: received incorrect Content-Type (#{resp["Content-Type"]})"
+		end
+
+		resp.body
+	end
+
+	# Generate a URL for the given `op` and `params`.
+	#
+	# @see {#make_request}.
+	#
+	def url(op, params = nil)
+		@url.dup.tap do |url|
+			url.path += "/ct/v1/#{op}"
+			if params
+				url.query = params.map { |k,v| "#{k}=#{v}" }.join("&")
+			end
+		end
+	end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: certificate-transparency-client
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Matt Palmer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-05-30 00:00:00.000000000 Z
+date: 2015-06-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: certificate-transparency
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.0'
+        version: '0.4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.0'
+        version: '0.4'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -142,6 +142,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement