visa_net_uy 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ad64233849757db1536cd45e307ff682508b665b
+  data.tar.gz: 624d3631474c34e995809dae1c77f9ddf444d7e0
+SHA512:
+  metadata.gz: b89980a6947726cdb0ad86d3c9448095832a65b4fabdca6aff90867b14dd7a800aa5faf6f48b047ba4752e3e346be92c797ba6d1a26e48e26e4822f1f239ab38
+  data.tar.gz: c336e03d91225810cb9aae7d831d6ffe018dd1ae756c7a3ffbe700c46a91230aea3b85cfad27eccf1065d1541f54d36a201bafc92d38a59ff342d2e005db14bb

data/.gitignore

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

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 TODO: Write your name
+
+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,51 @@
+# VisaNetUy
+
+VisaNet PHP PlugIn port for ruby.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'visa_net_uy'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install visa_net_uy
+
+## Usage
+
+Initialize PlugIn
+
+    plugin = VisaNetUy::PlugIn.new do |p|
+      p.cipher_public_key = File.read 'ALIGNET.PHP.CRYPTO.PUBLIC.txt'
+      p.cipher_private_key = File.read 'MILLAVE.CIFRADO.PRIVADA.txt'
+      p.signature_public_key = File.read 'ALIGNET.PHP.SIGNATURE.PUBLIC.txt'
+      p.signature_private_key = File.read 'MILLAVE.TESTING.FIRMA.PRIVADA.txt'
+      p.iv = '0123456789ABCDEF'
+    end
+
+Generate POST request parameters
+
+    plugin.vpos_request_params({
+      'acquirerId' => '11',
+      'commerceId' => '1111',
+      'purchaseOperationNumber' => "111111",
+      'purchaseAmount' => '10099',
+      'purchaseCurrencyCode' => '858',
+      'terminalCode' => 'VBV00111'})
+
+Get response fields from VisaNet callback
+
+    plugin.vpos_response_fields(response)
+
+## Contributing
+
+1. Fork it ( https://github.com/andres99x/visa_net_uy/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,11 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+# Default directory to look in is `/specs`
+# Run with `rake spec`
+RSpec::Core::RakeTask.new(:spec) do |task|
+  task.rspec_opts = ['--color', '--format', 'progress']
+end
+
+task :default => :spec
+task :test => :spec

data/lib/visa_net_uy/cipher.rb

@@ -0,0 +1,90 @@
+require_relative 'encoder'
+require 'openssl'
+
+class VisaNetUy::Cipher
+  include VisaNetUy::Encoder
+
+  CIPHER_ALGORITHM = "DES-EDE3-CBC"
+
+  # Generates a session_key
+  def generate_session_key
+    # Generate random session key with 16 bytes length
+    OpenSSL::Random.random_bytes(16)
+  end
+
+  # Encrypt data using the public_key
+  def urlsafe_base64_asymmetric_encrypt(data, public_key)
+    #  Load key
+    pkey = OpenSSL::PKey::RSA.new(public_key, nil)
+    raise 'Invalid public key.' unless pkey.public?
+
+    # Encrypt data
+    encrypted_data = pkey.public_encrypt(data)
+    # Encode encrypted data with custom Encoder
+    custom_base64_urlsafe_encode(encrypted_data)
+  end
+
+  # Decrypt data using the private_key
+  def urlsafe_base64_asymmetric_decrypt(urlsafe_base64_encrypted_data, private_key)
+    #  Load key
+    pkey = OpenSSL::PKey::RSA.new(private_key, nil)
+    raise 'Invalid private key.' unless pkey.private?
+
+    # Decode encrypted data with custom decoding
+    encrypted_data = custom_base64_urlsafe_decode(urlsafe_base64_encrypted_data)
+    # Decrypt encrypted data
+    pkey.private_decrypt(encrypted_data)
+  end
+
+  # Encrypt data with key
+  def urlsafe_base64_symmetric_encrypt(data, key, iv)
+    raise 'Initialization Vector must have 16 hexadecimal characters.' unless iv.length == 16
+    raise 'Key must have 16 hexadecimal characters.' unless key.length == 16
+
+    bin_iv = [iv].pack('H*')
+    raise 'Initialization Vector is not valid, must contain only hexadecimal characters.' if bin_iv.empty?
+
+    # Appends first 8 Bytes to Key
+    key += key.byteslice(0,8)
+
+    # Create Cipher
+    cipher = OpenSSL::Cipher.new(CIPHER_ALGORITHM)
+    # Initialize cipher mode
+    cipher.encrypt
+    # Set initialization vector
+    cipher.iv = bin_iv
+    # Set key
+    cipher.key = key
+
+    # Encrypt data
+    encrypted_data = cipher.update(data) + cipher.final
+    # Encode data
+    custom_base64_urlsafe_encode(encrypted_data)
+  end
+
+  def urlsafe_base64_symmetric_decrypt(urlsafe_base64_encrypted_data, key, iv)
+    raise 'Initialization Vector must have 16 hexadecimal characters.' unless iv.length == 16
+    raise 'Key must have 16 hexadecimal characters.' unless key.length == 16
+
+    bin_iv = [iv].pack('H*')
+    raise 'Initialization Vector is not valid, must contain only hexadecimal characters.' if bin_iv.empty?
+
+    # Appends first 8 Bytes to Key
+    key += key.byteslice(0,8)
+
+    # Create Cipher
+    cipher = OpenSSL::Cipher.new(CIPHER_ALGORITHM)
+    # Initialize cipher mode
+    cipher.decrypt
+    # Set initialization vector
+    cipher.iv = bin_iv
+    # Set key
+    cipher.key = key
+
+    # Decode data
+    encrypted_data = custom_base64_urlsafe_decode(urlsafe_base64_encrypted_data)
+    # Decrypt data
+    data = cipher.update(encrypted_data) + cipher.final
+  end
+
+end

data/lib/visa_net_uy/encoder.rb

@@ -0,0 +1,15 @@
+require "base64"
+
+module VisaNetUy
+  module Encoder
+    # Encodes to URLSafe Base64 and replaces = with .
+    def custom_base64_urlsafe_encode(data)
+      Base64.urlsafe_encode64(data).gsub('=','.')
+    end
+
+    # Decodes from URLSafe Base64 and replaces . with =
+    def custom_base64_urlsafe_decode(encoded_data)
+      Base64.urlsafe_decode64(encoded_data.gsub('.','='))
+    end
+  end
+end

data/lib/visa_net_uy/plug_in.rb

@@ -0,0 +1,76 @@
+class VisaNetUy::PlugIn
+
+  attr_accessor :cipher_public_key, :cipher_private_key, :signature_public_key, :signature_private_key, :iv
+
+  def initialize(options = {})
+    unless block_given?
+      options.each do |key, value|
+        send(:"#{key}=", value)
+      end
+    else
+      yield(self)
+    end
+  end
+
+  def vpos_request_params(fields)
+    request_params = {}
+
+    # Check for required fields
+    fields.include?('acquirerId') ? (request_params['IDACQUIRER'] = fields['acquirerId']) : (raise "Misssing acquirerId field.")
+    fields.include?('commerceId') ? (request_params['IDCOMMERCE'] = fields['commerceId']) : (raise "Misssing commerceId field.")
+
+    # Generate XML from fields
+    xml = xmler.generate(fields)
+
+    # Generate SessionKey
+    session_key = cipher.generate_session_key
+
+    # Generate digital signature
+    urlsafe_base64_signature = signer.generate_urlsafe_base64_signature(xml, signature_private_key)
+    request_params['DIGITALSIGN'] = urlsafe_base64_signature
+
+    # Cipher XML
+    urlsafe_base64_encrypted_xml = cipher.urlsafe_base64_symmetric_encrypt(xml, session_key, iv)
+    request_params['XMLREQ'] = urlsafe_base64_encrypted_xml
+
+    # Cipher SessionKey
+    urlsafe_base64_encrypted_session_key = cipher.urlsafe_base64_asymmetric_encrypt(session_key, cipher_public_key)
+    request_params['SESSIONKEY'] = urlsafe_base64_encrypted_session_key
+
+    request_params
+  end
+
+  def vpos_response_fields(response)
+    # Check for required fields
+    response.include?('SESSIONKEY') ? (session_key = response['SESSIONKEY']) : (raise "Misssing SESSIONKEY.")
+    response.include?('XMLRES') ? (xmlres = response['XMLRES']) : (raise "Misssing XMLRES.")
+    response.include?('DIGITALSIGN') ? (digital_sing = response['DIGITALSIGN']) : (raise "Misssing DIGITALSIGN.")
+
+    # Decrypt Session Key
+    session_key = cipher.urlsafe_base64_asymmetric_decrypt(session_key, cipher_private_key)
+
+    # Decrypt XML
+    xml = cipher.urlsafe_base64_symmetric_decrypt(xmlres, session_key, iv)
+
+    # Verify Signature
+    raise 'Invalid Signature.' unless signer.verify_urlsafe_base64_signature(xml, digital_sing, signature_public_key)
+
+    # Parse XML
+    xmler.parse(xml)
+  end
+
+  protected
+
+  def xmler
+    @xmler ||= VisaNetUy::Xmler.new
+  end
+
+  def cipher
+    @cipher ||= VisaNetUy::Cipher.new
+  end
+
+  def signer
+    @signer ||= VisaNetUy::Signer.new
+  end
+
+end

data/lib/visa_net_uy/signer.rb

@@ -0,0 +1,42 @@
+require_relative 'encoder'
+require 'openssl'
+
+class VisaNetUy::Signer
+  include VisaNetUy::Encoder
+
+  DIGEST_ALGORITHM = 'SHA1'
+
+  # Generates an urlsafe_base64_signature
+  def generate_urlsafe_base64_signature(data, private_key)
+    # Load Keys
+    pkey = OpenSSL::PKey::RSA.new(private_key, nil)
+    raise 'Invalid private key.' unless pkey.private?
+
+    # Create Digester
+    digest = OpenSSL::Digest.new(DIGEST_ALGORITHM)
+
+    # Generate Signature
+    signature = pkey.sign(digest, data)
+    raise 'RSA signing unsuccessful.' unless signature
+
+    # Encode Signature with custom Encoder
+    custom_base64_urlsafe_encode(signature)
+  end
+
+  # Verifies an urlsafe_base64_signature
+  def verify_urlsafe_base64_signature(data, urlsafe_base64_signature, public_key)
+    # Load Key
+    pkey = OpenSSL::PKey::RSA.new(public_key, nil)
+    raise 'Invalid public key.' unless pkey.public?
+
+    # Decode Signature with custom decoding
+    signature = custom_base64_urlsafe_decode(urlsafe_base64_signature)
+
+    # Create Digester
+    digest = OpenSSL::Digest.new(DIGEST_ALGORITHM)
+
+    # Vefify Signature
+    pkey.public_key.verify(digest, signature, data)
+  end
+
+end

data/lib/visa_net_uy/version.rb

@@ -0,0 +1,3 @@
+module VisaNetUy
+  VERSION = "0.0.1"
+end

data/lib/visa_net_uy/xmler.rb

@@ -0,0 +1,71 @@
+require "rexml/document"
+
+# Monkey Patching
+module REXML
+  class XMLDecl
+
+    private
+      # Force to use double-quotation as attribute delimiter and downcase encoding name for XMLDecl
+      def content(enc)
+        rv = "version=\"#@version\""
+        rv << " encoding=\"#{enc.downcase}\"" if @writeencoding || enc !~ /\Autf-8\z/i
+        rv << " standalone=\"#@standalone\"" if @standalone
+        rv
+      end
+
+  end
+end
+
+class VisaNetUy::Xmler
+  include REXML
+
+  VERSION = '1.0'
+  Encoding = 'ISO-8859-1'
+  ROOT_NAME = 'VPOSTransaction1.2'
+
+  def generate(fields)
+    fields_temp = {}
+
+    dom = Document.new
+    dom << XMLDecl.new(VERSION, Encoding)
+
+    root = Element.new(ROOT_NAME)
+    dom << root
+
+    fields.each_pair do |field, value|
+      if VisaNetUy::VALID_FIELDS.include? field
+        fields_temp[field] = value
+      else
+        raise "#{field} is not a valid field."
+      end
+    end
+
+    fields_temp.each_pair do |field, value|
+      element = Element.new(field)
+      element.text = value
+
+      root << element
+    end
+
+    xml = ''
+    dom.write(xml)
+
+    xml
+  end
+
+  def parse(xml)
+    fields = {}
+
+    dom = Document.new(xml)
+    root = dom.root
+
+    return fields unless root.name == ROOT_NAME
+
+    root.elements.each do |child|
+      fields[child.name] = child.get_text
+    end
+
+    fields
+  end
+
+end

data/lib/visa_net_uy.rb

@@ -0,0 +1,82 @@
+require "visa_net_uy/encoder"
+require "visa_net_uy/cipher"
+require "visa_net_uy/plug_in"
+require "visa_net_uy/signer"
+require "visa_net_uy/version"
+require "visa_net_uy/xmler"
+
+module VisaNetUy
+
+  VALID_FIELDS = [
+    'acquirerId',
+    'commerceId',
+    'purchaseCurrencyCode',
+    'purchaseIPAddress',
+    'purchaseAmount',
+    'purchaseOperationNumber',
+    'billingAddress',
+    'billingCity',
+    'billingState',
+    'billingCountry',
+    'billingZIP',
+    'billingPhone',
+    'billingEMail',
+    'billingFirstName',
+    'billingLastName',
+    'language',
+    'commerceMallId',
+    'terminalCode',
+    'tipAmount',
+    'HTTPSessionId',
+    'shippingAddress',
+    'shippingCity',
+    'shippingState',
+    'shippingCountry',
+    'shippingZIP',
+    'shippingPhone',
+    'shippingEMail',
+    'shippingFirstName',
+    'shippingLastName',
+    'reserved1',
+    'reserved2',
+    'reserved3',
+    'reserved4',
+    'reserved5',
+    'reserved6',
+    'reserved7',
+    'reserved8',
+    'reserved9',
+    'reserved10',
+    'reserved11',
+    'reserved12',
+    'reserved13',
+    'reserved14',
+    'reserved15',
+    'reserved16',
+    'reserved17',
+    'reserved18',
+    'reserved19',
+    'reserved20',
+    'reserved21',
+    'reserved22',
+    'reserved23',
+    'reserved24',
+    'reserved25',
+    'reserved26',
+    'reserved27',
+    'reserved28',
+    'reserved29',
+    'reserved30',
+    'reserved31',
+    'reserved32',
+    'reserved33',
+    'reserved34',
+    'reserved35',
+    'reserved36',
+    'reserved37',
+    'reserved38',
+    'reserved39',
+    'reserved40'
+  ]
+
+end

data/spec/lib/visa_net_uy/plug_in_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+describe 'VisaNetUy::PlugIn' do
+
+  pending 'Testing Pending'
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require 'visa_net_uy'

data/visa_net_uy.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'visa_net_uy/version'
+
+Gem::Specification.new do |spec|
+  spec.name        = 'visa_net_uy'
+  spec.version     = VisaNetUy::VERSION
+  spec.date        = '2010-04-28'
+  spec.summary     = "VisaNet PlugIn for ruby!"
+  spec.description = "VisaNet PHP PlugIn port for ruby."
+  spec.authors     = ["Andres Pache", "TopTierLabs"]
+  spec.email       = 'apache90@gmail.com'
+  spec.homepage    = 'https://github.com/andres99x/visa_net_uy'
+  spec.license     = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+end

metadata

@@ -0,0 +1,103 @@
+--- !ruby/object:Gem::Specification
+name: visa_net_uy
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Andres Pache
+- TopTierLabs
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2010-04-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  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: rspec
+  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'
+description: VisaNet PHP PlugIn port for ruby.
+email: apache90@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/visa_net_uy.rb
+- lib/visa_net_uy/cipher.rb
+- lib/visa_net_uy/encoder.rb
+- lib/visa_net_uy/plug_in.rb
+- lib/visa_net_uy/signer.rb
+- lib/visa_net_uy/version.rb
+- lib/visa_net_uy/xmler.rb
+- spec/lib/visa_net_uy/plug_in_spec.rb
+- spec/spec_helper.rb
+- visa_net_uy.gemspec
+homepage: https://github.com/andres99x/visa_net_uy
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: VisaNet PlugIn for ruby!
+test_files:
+- spec/lib/visa_net_uy/plug_in_spec.rb
+- spec/spec_helper.rb