didww-v3 1.3.0 → 2.0.0

data/lib/didww/encrypt.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+require 'openssl'
+require 'openssl/oaep'
+require 'net/http'
+
+module DIDWW
+  # Allows to encrypt file on Ruby-side before uploading to `/v3/encrypted_files`.
+  # @example
+  #   file_content_1 = File.read('file_to_send_1.jpg', mode: 'rb')
+  #   file_content_2 = File.read('file_to_send_1.pdf', mode: 'rb')
+  #   enc = DIDWW::Encrypt.new
+  #   enc_data_1 = enc.encrypt(file_content_1)
+  #   enc_data_2 = enc.encrypt(file_content_2)
+  #   enc_io_1 = Faraday::UploadIO.new(StringIO.new(enc_data_1), 'application/octet-stream')
+  #   enc_io_2 = Faraday::UploadIO.new(StringIO.new(enc_data_2), 'application/octet-stream')
+  #   DIDWW::Resource::EncryptedFile.upload(
+  #     encryption_fingerprint: enc.encryption_fingerprint,
+  #     items: [
+  #       { file: enc_io_1, description: 'file_to_send_1.jpg' },
+  #       { file: enc_io_2, description: 'file_to_send_2.pdf' }
+  #     ]
+  #   ) # => Array if IDs
+  #
+  class Encrypt
+    AES_ALGO = [256, :CBC]
+    AES_KEY_LEN = 32
+    AES_IV_LEN = 16
+    LABEL = ''
+    SEPARATOR = ':::'
+
+    class << self
+      # @param binary [String]
+      # @return [String]
+      def encrypt(binary)
+        new.encrypt(binary)
+      end
+    end
+
+    attr_reader :public_keys, :encryption_fingerprint
+
+    def initialize
+      reset!
+    end
+
+    # @param binary [String] binary content of a file.
+    # @return [String] binary content of an encrypted file.
+    def encrypt(binary)
+      aes_key, aes_iv, encrypted_aes = encrypt_aes(binary)
+      aes_credentials = aes_key + aes_iv
+      encrypted_rsa_a = encrypt_rsa_oaep(public_keys[0], aes_credentials)
+      encrypted_rsa_b = encrypt_rsa_oaep(public_keys[1], aes_credentials)
+      encrypted_rsa_a + encrypted_rsa_b + encrypted_aes
+    end
+
+    # Resets public keys and fingerprint.
+    def reset!
+      @public_keys = fetch_public_keys
+      @encryption_fingerprint = calculate_fingerprint
+    end
+
+    private
+
+    # @return [Array(String,String)] public keys.
+    def fetch_public_keys
+      DIDWW::Resource::PublicKey.find.map(&:key)
+    end
+
+    def calculate_fingerprint
+      public_keys.map { |pub_key| fingerprint_for(pub_key) }.join(SEPARATOR)
+    end
+
+    # @param public_key [String] PEM public key.
+    # @return [String] hexstring digest SHA1 for public key binary.
+    def fingerprint_for(public_key)
+      public_key += "\n" unless public_key[-1] == "\n"
+      public_key_base64 = public_key.split("\n")[1..-2].join
+      public_key_bin = Base64.decode64(public_key_base64)
+      OpenSSL::Digest::SHA1.hexdigest(public_key_bin)
+    end
+
+    # @param public_key [String]
+    # @param text [String]
+    def encrypt_rsa_oaep(public_key, text)
+      rsa = OpenSSL::PKey::RSA.new(public_key)
+      rsa.public_encrypt_oaep(text, LABEL, OpenSSL::Digest::SHA256)
+    end
+
+    # @param binary [String]
+    # @return [Array(String,String,String)] binaries key, vector, encrypted data.
+    def encrypt_aes(binary)
+      key = SecureRandom.random_bytes(AES_KEY_LEN)
+      iv = SecureRandom.random_bytes(AES_IV_LEN)
+      cipher = OpenSSL::Cipher::AES.new(*AES_ALGO)
+      cipher.encrypt
+      cipher.key = key
+      cipher.iv = iv
+      encrypted = cipher.update(binary) + cipher.final
+      [key, iv, encrypted]
+    end
+  end
+end

data/lib/didww/jsonapi_middleware.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+module DIDWW
+  # :nodoc:
+  class JsonapiMiddleware < Faraday::Middleware
+    def call(request_env)
+      headers = {}
+      headers['Content-Type']        = 'application/vnd.api+json'
+      headers['Api-Key']             = DIDWW::Client.api_key
+      headers['User-Agent']          = "didww-v3 Ruby gem v#{VERSION}"
+      headers['x-didww-api-version'] = DIDWW::Client.api_version unless DIDWW::Client.api_version.blank?
+
+      request_env[:request_headers].merge!(headers)
+      request_env.url.host = URI(DIDWW::Client.api_base_url).host
+
+      @app.call(request_env).on_complete do |response_env|
+        # do something with the response
+        # response_env[:response_headers].merge!(...)
+      end
+    end
+  end
+end

data/lib/didww/resources/address.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+module DIDWW
+  module Resource
+    class Address < Base
+
+      has_one :identity, class_name: 'Identity'
+      has_one :country, class_name: 'Country'
+      has_many :proofs, class_name: 'Proof'
+      has_many :city, class_name: 'City'
+      has_many :area, class_name: 'Area'
+
+      property :city_name, type: :string
+      # Type: String
+      # Description:
+
+      property :postal_code, type: :string
+      # Type: String
+      # Description:
+
+      property :address, type: :string
+      # Type: String
+      # Description:
+
+      property :description, type: :string
+      # Type: String
+      # Description:
+
+      property :created_at, type: :date
+      # Type: Date
+      # Description:
+
+      property :verified, type: :boolean
+      # Type: Boolean
+      # Description:
+    end
+  end
+end

data/lib/didww/resources/address_verification.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+module DIDWW
+  module Resource
+    class AddressVerification < Base
+      STATUS_PENDING = 'Pending'
+      STATUS_APPROVED = 'Approved'
+      STATUS_REJECTED = 'Rejected'
+      STATUSES = [
+        STATUS_PENDING,
+        STATUS_APPROVED,
+        STATUS_REJECTED
+      ].freeze
+
+      has_one :address, class_name: 'Address'
+      has_many :dids, class_name: 'Did'
+      has_many :onetime_files, class_name: 'EncryptedFile'
+
+      property :service_description, type: :string
+      # Type: String
+      # Description:
+
+      property :status, type: :string
+      # Type: String
+      # Description:
+
+      property :reject_reasons, type: :string
+      # Type: String
+      # Description:
+
+      property :created_at, type: :date
+      # Type: Date
+      # Description:
+
+      property :callback_url, type: :string
+      # Type: String
+      # Description: valid URI for callbacks
+
+      property :callback_method, type: :string
+      # Type: String
+      # Description: GET or POST
+
+      def pending?
+        status == STATUS_PENDING
+      end
+
+      def approved?
+        status == STATUS_APPROVED
+      end
+
+      def rejected?
+        status == STATUS_REJECTED
+      end
+
+    end
+  end
+end

data/lib/didww/resources/area.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+module DIDWW
+  module Resource
+    class Area < Base
+      has_one :country, class_name: 'Country'
+
+      property :name, type: :string
+      # Type: String
+      # Description: Regulatory Area name
+    end
+  end
+end

data/lib/didww/resources/available_did.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DIDWW
   module Resource
     class AvailableDid < Base

data/lib/didww/resources/balance.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DIDWW
   module Resource
     class Balance < Base

data/lib/didww/resources/base.rb

@@ -1,4 +1,5 @@
-require 'didww/middleware'
+# frozen_string_literal: true
+require 'didww/jsonapi_middleware'
 require 'didww/complex_objects/base'
 
 module DIDWW

data/lib/didww/resources/capacity_pool.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DIDWW
   module Resource
     class CapacityPool < Base

data/lib/didww/resources/cdr_export.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require 'forwardable'
 require 'didww/complex_objects/cdr_export_filter'
 require 'down/http'
@@ -7,6 +8,8 @@ module DIDWW
     class CdrExport < Base
       extend Forwardable
 
+      STATUS_COMPLETED = 'Completed'
+
       property :filters, type: :cdr_export_filter
       # Type: CDR Export Filters Object
       # Nullable: No
@@ -27,6 +30,14 @@ module DIDWW
       # Nullable: true
       # Description: url of csv file for downloading. available only when status is "Completed"
 
+      property :callback_url, type: :string
+      # Type: String
+      # Description: valid URI for callbacks
+
+      property :callback_method, type: :string
+      # Type: String
+      # Description: GET or POST
+
       def_delegators :filters, :year, :month, :did_number, :year=, :month=, :did_number=
 
       def initialize(params = {})
@@ -39,7 +50,7 @@ module DIDWW
       end
 
       def complete?
-        status == 'Completed'
+        status == STATUS_COMPLETED
       end
       alias_method :completed?, :complete?
     end

data/lib/didww/resources/city.rb

@@ -1,6 +1,11 @@
+# frozen_string_literal: true
 module DIDWW
   module Resource
     class City < Base
+      has_one :country, class_name: 'Country'
+      has_one :region, class_name: 'Region'
+      has_one :area, class_name: 'Area'
+
       property :name, type: :string
       # Type: String
       # Description: City name

data/lib/didww/resources/country.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DIDWW
   module Resource
     class Country < Base

data/lib/didww/resources/did.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DIDWW
   module Resource
     class Did < Base
@@ -5,6 +6,7 @@ module DIDWW
       has_one :trunk_group
       has_one :capacity_pool
       has_one :shared_capacity_group
+      has_one :address_verification
 
       property :blocked, type: :boolean
       # Type: Boolean
@@ -18,7 +20,7 @@ module DIDWW
       # Type: Boolean
       # Description: Identifier for terminated DIDs that will be removed from service at the end of the billing cycle.
 
-      property :pending_removal, type: :boolean
+      property :billing_cycles_count, type: :integer
       # Type: Boolean
       # Description: Identifier for DIDs that are pending removal from your account.
 

data/lib/didww/resources/did_group.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DIDWW
   module Resource
     class DidGroup < Base
@@ -60,10 +61,6 @@ module DIDWW
       # is_available
       # Type: Boolean
       # Description: Defines if numbers in this DID Group are currently in stock.
-      #
-      # restrictions
-      # Type: String
-      # Description: Describes possible restrictions for the DID Group, such as "End User Registration is Required".
 
     end
   end

data/lib/didww/resources/did_group_type.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DIDWW
   module Resource
     class DidGroupType < Base

data/lib/didww/resources/did_reservation.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DIDWW
   module Resource
     class DidReservation < Base

data/lib/didww/resources/encrypted_file.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+module DIDWW
+  module Resource
+    class EncryptedFile < Base
+      class UploadError < StandardError
+      end
+
+      property :description, type: :string
+      # Type: String
+      # Description:
+
+      property :expire_at, type: :date
+      # Type: Date
+      # Description:
+
+      # @return [Faraday::Connection]
+      def self.upload_connection
+        Faraday.new(url: site) do |connection|
+          connection.request :multipart
+          connection.request :url_encoded
+          connection.adapter Faraday.default_adapter
+          connection.use DIDWW::BaseMiddleware
+        end
+      end
+
+      # @param files [Rack::Multipart::UploadedFile,(#tempfile,#content_type,#original_filename)]
+      # @return [Array<String>]
+      # @raise [DIDWW::Resource::EncryptedFile::UploadError]
+      def self.upload_files(files, fingerprint)
+        items = files.map do |file|
+          {
+            file: Faraday::UploadIO.new(file.tempfile, file.content_type),
+            description: file.original_filename
+          }
+        end
+        payload = { encryption_fingerprint: fingerprint, items: items }
+        upload(payload)
+      end
+
+      # @param payload [Hash]
+      #   encryption_fingerprint [String] DIDWW::Encrypt#encryption_fingerprint
+      #   items [Array]
+      #     file [Faraday::UploadIO] upload io
+      #     description [String,nil] optional description
+      # @return [Array<String>]
+      # @raise [DIDWW::Resource::EncryptedFile::UploadError]
+      def self.upload(payload)
+        connection = upload_connection
+        response = connection.post('/v3/encrypted_files', encrypted_files: payload)
+        if response.status == 201
+          JSON.parse(response.body, symbolize_names: true)[:ids]
+        else
+          raise UploadError, "Code: #{response.status} #{response.body}"
+        end
+      end
+    end
+  end
+end

data/lib/didww/resources/identity.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+module DIDWW
+  module Resource
+    class Identity < Base
+      IDENTITY_TYPE_PERSONAL = 'Personal'
+      IDENTITY_TYPE_BUSINESS = 'Business'
+
+      has_one :country, class_name: 'Country'
+      has_many :proofs, class_name: 'Proof'
+      has_many :addresses, class_name: 'Address'
+      has_many :permanent_documents, class_name: 'PermanentSupportingDocument'
+
+      property :first_name, type: :string
+      # Type: String
+      # Description:
+
+      property :last_name, type: :string
+      # Type: String
+      # Description:
+
+      property :phone_number, type: :string
+      # Type: String
+      # Description:
+
+      property :id_number, type: :string
+      # Type: String
+      # Description:
+
+      property :birth_date, type: :date
+      # Type: Date
+      # Description:
+
+      property :company_name, type: :string
+      # Type: String
+      # Description:
+
+      property :company_reg_number, type: :string
+      # Type: String
+      # Description:
+
+      property :vat_id, type: :string
+      # Type: String
+      # Description:
+
+      property :description, type: :string
+      # Type: String
+      # Description:
+
+      property :personal_tax_id, type: :string
+      # Type: String
+      # Description:
+
+      property :identity_type, type: :string
+      # Type: String
+      # Description:
+
+      property :created_at, type: :date
+      # Type: Date
+      # Description:
+
+      property :external_reference_id, type: :string
+      # Type: String
+      # Description:
+
+      property :verified, type: :boolean
+      # Type: Boolean
+      # Description:
+
+      def personal?
+        identity_type == IDENTITY_TYPE_PERSONAL
+      end
+
+      def business?
+        identity_type == IDENTITY_TYPE_BUSINESS
+      end
+    end
+  end
+end

data/lib/didww/resources/order.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require 'didww/complex_objects/did_order_item'
 require 'didww/complex_objects/capacity_order_item'
 
@@ -46,6 +47,14 @@ module DIDWW
       # Type: Boolean
       # Description: Allowing back ordering
 
+      property :callback_url, type: :string
+      # Type: String
+      # Description: valid URI for callbacks
+
+      property :callback_method, type: :string
+      # Type: String
+      # Description: GET or POST
+
       def initialize(*args)
         super
         self.items ||= []

data/lib/didww/resources/permanent_supporting_document.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+module DIDWW
+  module Resource
+    class PermanentSupportingDocument < Base
+
+      has_many :files, class_name: 'EncryptedFile'
+      has_one :template, class_name: 'SupportingDocumentTemplate'
+      has_one :identity, class_name: 'Identity'
+
+      property :created_at, type: :date
+      # Type: Date
+      # Description:
+    end
+  end
+end

data/lib/didww/resources/pop.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DIDWW
   module Resource
     class Pop < Base

data/lib/didww/resources/proof.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+module DIDWW
+  module Resource
+    class Proof < Base
+
+      has_many :files, class_name: 'EncryptedFile'
+      has_one :proof_type, class_name: 'ProofType'
+      has_one :entity, class_name: 'Entity', polymorphic: true
+
+      property :created_at, type: :date
+      # Type: Date
+      # Description:
+
+      property :is_expired, type: :boolean
+      # Type: Boolean
+      # Description:
+    end
+  end
+end

data/lib/didww/resources/proof_type.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+module DIDWW
+  module Resource
+    class ProofType < Base
+      property :name, type: :string
+      # Type: String
+      # Description:
+
+      property :entity_type, type: :string
+      # Type: String
+      # Description:
+    end
+  end
+end

data/lib/didww/resources/public_key.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+module DIDWW
+  module Resource
+    class PublicKey < Base
+
+      property :key, type: :string
+      # Type: String
+      # Description: Public key for encryption.
+
+    end
+  end
+end

data/lib/didww/resources/qty_based_pricing.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DIDWW
   module Resource
     class QtyBasedPricing < Base

data/lib/didww/resources/region.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DIDWW
   module Resource
     class Region < Base

data/lib/didww/resources/requirement.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+module DIDWW
+  module Resource
+    class Requirement < Base
+
+      has_one :country, class_name: 'Country'
+      has_one :did_group_type, class_name: 'DidGroupType', relation_name: :group_type
+      has_one :personal_permanent_document, class_name: 'SupportingDocumentTemplate'
+      has_one :business_permanent_document, class_name: 'SupportingDocumentTemplate'
+      has_one :personal_onetime_document, class_name: 'SupportingDocumentTemplate'
+      has_one :business_onetime_document, class_name: 'SupportingDocumentTemplate'
+      has_many :personal_proof_types, class_name: 'ProofType'
+      has_many :business_proof_types, class_name: 'ProofType'
+      has_many :address_proof_types, class_name: 'ProofType'
+
+      property :identity_type, type: :integer
+      # Type: Integer
+      # Description:
+
+      property :personal_area_level, type: :string
+      # Type: String
+      # Description:
+
+      property :business_area_level, type: :string
+      # Type: String
+      # Description:
+
+      property :address_area_level, type: :string
+      # Type: String
+      # Description:
+
+      property :personal_proof_qty, type: :integer
+      # Type: Integer
+      # Description:
+
+      property :business_proof_qty, type: :integer
+      # Type: Integer
+      # Description:
+
+      property :address_proof_qty, type: :integer
+      # Type: Integer
+      # Description:
+
+      property :personal_mandatory_fields, type: :array
+      # Type: String[]
+      # Description:
+
+      property :business_mandatory_fields, type: :array
+      # Type: String[]
+      # Description:
+
+      property :service_description_required, type: :boolean
+      # Type: Boolean
+      # Description:
+
+      property :restriction_message, type: :string
+      # Type: String
+      # Description:
+    end
+  end
+end

data/lib/didww/resources/requirement_validation.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+module DIDWW
+  module Resource
+    class RequirementValidation < Base
+      has_one :requirement, class_name: 'Requirement'
+      has_one :address, class_name: 'Address'
+      has_one :identity, class_name: 'Identity'
+    end
+  end
+end

data/lib/didww/resources/shared_capacity_group.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module DIDWW
   module Resource
     class SharedCapacityGroup < Base