sns_endpoint 0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in sns_endpoint.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Piotr Szmielew
+
+MIT License
+
+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,59 @@
+# SnsEndpoint
+
+Simple gem containing Sinatra engine, designed to help you utilize SNS http post service.
+Use inside Rails (as an engine) or outside - as a standalone application.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'sns_endpoint'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install sns_endpoint
+
+## Usage
+
+Configure using SnsEndpoint.setup, providing block, like this:
+```ruby
+SnsEndpoint.setup do |config|
+  config.topics_list = ['first_topic', 'second_topic'] #list of topics that endpoint should respond to subscription request
+  config.subscribe_proc = Proc.new { |message| p message } #proc that should be executed when subscribe request got received and responded to, passed argument is message (json object)
+  config.message_proc = Proc.new { |message| p message } #proc that should be executed when message got send to endpoint
+end
+```
+
+for example in Rails initializer.
+
+Use as Rails engine:
+
+* mount in routes.rb:
+```ruby
+mount SnsEndpoint::Core => "/sns_endpoint"
+```
+
+Use as a standalone app:
+Example script:
+```ruby
+require 'rubygems'
+require 'sns_endpoint'
+SnsEndpoint.setup do |config|
+  config.topics_list = ['first_topic', 'second_topic'] #list of topics that endpoint should respond to subscription request
+  config.subscribe_proc = Proc.new { |message| p message } #proc that should be executed when subscribe request got received and responded to, passed argument is message (json object)
+  config.message_proc = Proc.new { |message| p message } #proc that should be executed when message got send to endpoint
+end
+SnsEndpoint::Core.run!
+```
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/lib/message.rb

@@ -0,0 +1,159 @@
+# Copyright 2011-2012 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+
+#modyfied version of message.rb from Aws-sdk fork by petemounce
+
+require 'base64'
+require 'json'
+require 'openssl'
+require 'httparty'
+
+module SnsEndpoint
+  module AWS
+    class SNS
+      class MessageWasNotAuthenticError < StandardError
+      end
+      class Message
+        attr_accessor :origin, :raw
+
+        def initialize sns
+          if sns.is_a? String
+            @raw = parse_from sns
+          else
+            @raw = sns
+          end
+          @origin = :sns
+        end
+
+        def [] key
+          @raw[key]
+        end
+
+        def authentic?
+          begin
+            decoded_from_base64 = decode signature
+            public_key = get_public_key_from signing_cert_url
+            public_key.verify OpenSSL::Digest::SHA1.new, decoded_from_base64, canonical_string
+          rescue MessageWasNotAuthenticError
+            false
+          end
+        end
+
+        def type
+          case when @raw['Type'] =~ /SubscriptionConfirmation/i
+            then :SubscriptionConfirmation
+          when @raw['Type'] =~ /Notification/i
+            then :Notification
+          when @raw['Type'] =~ /UnsubscribeConfirmation/i
+            then :UnsubscribeConfirmation
+          else
+            :unknown
+          end
+        end
+
+        def message_id
+          @raw['MessageId']
+        end
+
+        def topic_arn
+          @raw['TopicArn']
+        end
+
+        def subject
+          @raw['Subject']
+        end
+
+        def message
+          @raw['Message']
+        end
+
+        def timestamp
+          @raw['Timestamp']
+        end
+
+        def signature
+          @raw['Signature']
+        end
+
+        def signature_version
+          @raw['SignatureVersion']
+        end
+
+        def signing_cert_url
+          @raw['SigningCertURL']
+        end
+
+        def unsubscribe_url
+          @raw['UnsubscribeURL']
+        end
+      
+        def subscribe_url
+          @raw['SubscribeURL']
+        end
+
+        def token
+          @raw['Token']
+        end
+
+        def parse_from json
+          JSON.parse json
+        end
+
+        protected
+        def decode raw
+          Base64.decode64 raw
+        end
+
+        def get_public_key_from(x509_pem_url)
+          cert_pem = download x509_pem_url
+          x509 = OpenSSL::X509::Certificate.new(cert_pem)
+          OpenSSL::PKey::RSA.new(x509.public_key)
+        end
+
+        def canonical_string
+          if type == :SubscriptionConfirmation
+            text = "Message\n#{message}\n"
+            text += "MessageId\n#{message_id}\n"
+            text += "SubscribeURL\n#{subscribe_url}\n"
+            text += "Timestamp\n#{timestamp}\n"
+            text += "Token\n#{token}\n"
+            text += "TopicArn\n#{topic_arn}\n"
+            text += "Type\n#{type}\n"         
+          else
+          text = "Message\n#{message}\n"
+          text += "MessageId\n#{message_id}\n"
+          text += "Subject\n#{subject}\n" unless subject.nil? or subject.empty?
+          text += "Timestamp\n#{timestamp}\n"
+          text += "TopicArn\n#{topic_arn}\n"
+          text += "Type\n#{type}\n"
+        end
+          text
+        end
+
+        def download url
+          raise MessageWasNotAuthenticError, "cert is not hosted at AWS URL (https): #{url}" unless url =~ /^https.*amazonaws\.com\/.*$/i
+          tries = 0
+          begin
+            response = HTTParty.get url
+            response.body
+          rescue => msg
+            tries += 1
+            retry if tries <= 3
+            raise StandardError, "SNS signing cert could not be retrieved after #{tries} tries.\n#{msg}"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/sns_endpoint.rb

@@ -0,0 +1,36 @@
+require "rubygems"
+require 'bundler/setup'
+require "sns_endpoint/version"
+require 'sinatra'
+require 'json'
+require 'message'
+
+module SnsEndpoint
+  
+  class << self
+    attr_accessor :topics_list, :subscribe_proc, :message_proc
+  end
+  
+  def self.setup(&block)
+    yield self
+  end
+  
+  class Core < Sinatra::Base
+    
+      post '/' do
+        json = JSON.parse(request.body.read)
+        sns = SnsEndpoint::AWS::SNS::Message.new json
+        if sns.authentic?
+          if sns.type == :SubscriptionConfirmation
+            if SnsEndpoint.topics_list.include? json['TopicArn']
+              HTTParty.get json['SubscribeURL']
+              SnsEndpoint.subscribe_proc.call(json)
+            end
+          elsif sns.type == :Notification
+            SnsEndpoint.message_proc.call(json)            
+          end
+        end
+      end
+    
+  end
+end

data/lib/sns_endpoint/version.rb

@@ -0,0 +1,3 @@
+module SnsEndpoint
+  VERSION = "0.1"
+end

data/sns_endpoint.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/sns_endpoint/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Piotr Szmielew"]
+  gem.email         = ["p.szmielew@ava.waw.pl"]
+  gem.description   = %q{Gem containing sinatra engine to utilize SNS notifications.}
+  gem.summary       = %q{Gem containing sinatra engine to utilize SNS notifications.}
+  gem.homepage      = "http://github.com/elibri/sns_endpoint"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "sns_endpoint"
+  gem.require_paths = ["lib"]
+  gem.version       = SnsEndpoint::VERSION
+  
+  
+  gem.add_runtime_dependency "httparty"
+  gem.add_runtime_dependency "sinatra"
+  gem.add_runtime_dependency "json"
+end

metadata

@@ -0,0 +1,114 @@
+--- !ruby/object:Gem::Specification 
+name: sns_endpoint
+version: !ruby/object:Gem::Version 
+  hash: 9
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  version: "0.1"
+platform: ruby
+authors: 
+- Piotr Szmielew
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-06-24 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: sinatra
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: json
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+description: Gem containing sinatra engine to utilize SNS notifications.
+email: 
+- p.szmielew@ava.waw.pl
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/message.rb
+- lib/sns_endpoint.rb
+- lib/sns_endpoint/version.rb
+- sns_endpoint.gemspec
+homepage: http://github.com/elibri/sns_endpoint
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.21
+signing_key: 
+specification_version: 3
+summary: Gem containing sinatra engine to utilize SNS notifications.
+test_files: []
+