mobile-subscriber 1.0.0.alpha4 → 1.0.0.alpha5

data/lib/mobile_subscriber/detection/from_x_nokia_msisdn_http_request_header.rb

@@ -1,58 +0,0 @@
-require 'mobile_subscriber/dictionaries/dialing_and_country_codes'
-
-module MobileSubscriber::Detection
-
-  # Módulo que provee métodos de deteccion y validacion para MSISDN's de:
-  # - Telcel México
-  # - Claro Argentina
-  # - Claro Costa Rica
-  # - Claro Puerto Rico
-  # - Claro Guatemala
-  # - Claro Honduras
-  # - Claro Nicaragua
-  # - Claro El Salvador
-  module FromXNokiaMsisdnHttpRequestHeader
-
-    def extract_from_x_nokia_msisdn_http_request_header(http_request_info)
-      if msisdn = http_request_info.headers['X-Nokia-Msisdn'] and msisdn.length >= 8
-
-        country_code = (
-          MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,2]] ||
-          MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,3]] || # Dominican 3-digit needed
-          MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,1]]    # Puerto Rico 1-digit country code of "1"
-        )
-
-        # Determine the Network Operator tuple (MCC + MNC):
-        # TODO: Validate IP ranges, additional headers, etc.
-        network_id_tuple = case country_code
-        when 'PR' # Claro Puerto Rico:
-          { mcc: "330", mnc: "110" }
-        when 'MX' # Telcel México:
-          { mcc: "334", mnc: "020" }
-        when 'GT' # Claro Guatemala:
-          { mcc: "704", mnc: "01"  }
-        when 'SV' # Claro El Salvador:
-          { mcc: "706", mnc: "01"  }
-        when 'HN' # Claro Honduras:
-          { mcc: "708", mnc: "001" }
-        when 'NI' # Claro Nicaragua:
-          { mcc: "710", mnc: "21"  }
-        when 'CR' # Claro Costa Rica
-          { mcc: "712", mnc: "03"  }
-        when 'AR' # Claro Argentina:
-          { mcc: "722", mnc: "330" }
-        end
-
-        # Return only if we identified the network:
-        if network_id_tuple.present?
-          {
-            id:                   msisdn,
-            mobile_country_code:  network_id_tuple[:mcc],
-            mobile_network_code:  network_id_tuple[:mnc],
-            http_request_info:    http_request_info
-          }
-        end
-      end
-    end
-  end
-end

data/lib/mobile_subscriber/detection/from_x_up_calling_line_id_http_request_header.rb

@@ -1,65 +0,0 @@
-require 'mobile_subscriber/dictionaries/dialing_and_country_codes'
-
-module MobileSubscriber::Detection
-
-  # Módulo que provee métodos de deteccion y validacion para MSISDN por el
-  # header de HTTP 'X-Up-Calling-Line-Id':
-  # - Claro Perú
-  # - TIM (Telecom Italia Mobile) Brasil
-  # - OI Brasil
-  # - Movistar México
-  # - Movistar Argentina
-  # - Movistar Perú
-  module FromXUpCallingLineIdHttpRequestHeader
-
-    def extract_from_x_up_calling_line_id_http_request_header(http_request_info)
-      if msisdn = http_request_info.headers['X-Up-Calling-Line-Id'] and msisdn.length >= 8
-
-        country_code = (
-          MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,2]] ||
-          MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,3]]
-        )
-
-        # Determine the Network Operator tuple (MCC + MNC):
-        # TODO: Validate IP ranges, additional headers, etc.
-        network_id_tuple = case country_code
-        when 'PE'
-          # Claro Perú includes the "X-Nokia-Imsi" header...
-          imsi = http_request_info.headers['X-Nokia-Imsi']
-          if imsi.present?
-            # Claro Peru: (IP's 190.113.x)
-            { mcc: "716", mnc: "10" } if imsi.start_with?('71610')
-          else
-            # Movistar Peru: (IP's 190.238.x)
-            { mcc: "716", mnc: "06" }
-          end
-        when 'BR'
-          if x_msp_apn_header = request.env["X-Msp-Apn"] and x_msp_apn_header.present?
-            if http_request_x_msp_apn_header =~ /OI/i
-              # Oi Brazil:
-              { mcc: "724", mnc: "30" }
-            else
-              # TIM Brazil:
-              { mcc: "724", mnc: "02" }
-            end
-          end
-        when 'MX' # Movistar Mexico:
-          { mcc: "334", mnc: "030" }
-        when 'AR' # Movistar Argentina:
-          # TODO: Determine (if possible) the MNC (010 or 070)
-          { mcc: "722", mnc: "010" }
-        end
-
-        # Return only if we identified the network:
-        if network_id_tuple.present?
-          {
-            id:                   msisdn,
-            mobile_country_code:  network_id_tuple[:mcc],
-            mobile_network_code:  network_id_tuple[:mnc],
-            http_request_info:    http_request_info
-          }
-        end
-      end
-    end
-  end
-end

data/lib/mobile_subscriber/detection/from_x_up_ch_msisdn_http_request_header.rb

@@ -1,35 +0,0 @@
-require 'mobile_subscriber/dictionaries/dialing_and_country_codes'
-module MobileSubscriber::Detection
-  # Módulo que provee métodos de deteccion y validacion para MSISDN's de:
-  # - Vivo Brasil
-  module FromXUpChMsisdnHttpRequestHeader
-
-    def extract_from_x_up_ch_msisdn_http_request_header(http_request_info)
-      if msisdn = http_request_info.headers['X-Up-Ch-Msisdn'] and msisdn.length >= 8
-
-        country_code = (
-          MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,2]] ||
-          MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,3]]
-        )
-
-        # Determine the Network Operator tuple (MCC + MNC):
-        # TODO: Validate IP ranges, additional headers, etc.
-        network_id_tuple = case country_code
-        when 'BR' # Vivo Brazil:
-          # TODO: Determine (if possible) the MNC (06, 10, 11, 23)
-          { mcc: "724", mnc: "06" }
-        end
-
-        # Return only if we identified the network:
-        if network_id_tuple.present?
-          {
-            id:                   msisdn,
-            mobile_country_code:  network_id_tuple[:mcc],
-            mobile_network_code:  network_id_tuple[:mnc],
-            http_request_info:    http_request_info
-          }
-        end
-      end
-    end
-  end
-end

data/lib/mobile_subscriber/detection/from_x_up_subno_http_request_header.rb

@@ -1,44 +0,0 @@
-require 'mobile_subscriber/dictionaries/dialing_and_country_codes'
-
-module MobileSubscriber::Detection
-  # Módulo que provee métodos de deteccion y validacion para MSISDN por el
-  # header de HTTP 'X-Up-Subno':
-  # - Claro Colombia
-  # - Claro Panamá
-  # - Comcel Colombia
-  module FromXUpSubnoHttpRequestHeader
-
-    def extract_from_x_up_subno_http_request_header(http_request_info)
-      if msisdn = http_request_info.headers['X-Up-Subno'] and msisdn.length >= 8
-
-        country_code = (
-          MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,2]] ||
-          MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,3]]
-        )
-
-        # Determine the Network Operator tuple (MCC + MNC):
-        # TODO: Validate IP ranges, additional headers, etc.
-        network_id_tuple = case country_code
-        when 'CO'
-          # TODO: Discernir por ip/hostname
-          #{ mcc: "732", mnc: "101" } # Comcel Colombia
-
-          # Claro Colombia
-          { mcc: "732", mnc: "101" }
-        when 'PA' # Claro Panamá:
-          { mcc: "714", mnc: "03"  }
-        end
-
-        # Return only if we identified the network:
-        if network_id_tuple.present?
-          {
-            id:                   msisdn,
-            mobile_country_code:  network_id_tuple[:mcc],
-            mobile_network_code:  network_id_tuple[:mnc],
-            http_request_info:    http_request_info
-          }
-        end
-      end
-    end
-  end
-end

data/lib/mobile_subscriber/detection/from_x_wap_msisdn_http_request_header.rb

@@ -1,37 +0,0 @@
-require 'mobile_subscriber/dictionaries/dialing_and_country_codes'
-
-module MobileSubscriber::Detection
-
-  # Módulo que provee métodos de detección y validacion para MSISDN por el
-  # header de HTTP 'X-Wap-Msisdn':
-  # - Claro Chile
-  module FromXWapMsisdnHttpRequestHeader
-
-    def extract_from_x_wap_msisdn_http_request_header(http_request_info)
-      if msisdn = http_request_info.headers['X-Wap-Msisdn'] and msisdn.length >= 8
-
-        country_code = (
-          MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,2]] ||
-          MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,3]]
-        )
-
-        # Determine the Network Operator tuple (MCC + MNC):
-        # TODO: Validate IP ranges, additional headers, etc.
-        network_id_tuple = case country_code
-        when 'CL' # Claro Chile
-          { mcc: "730", mnc: "03"  }
-        end
-
-        # Return only if we identified the network:
-        if network_id_tuple.present?
-          {
-            id:                   msisdn,
-            mobile_country_code:  network_id_tuple[:mcc],
-            mobile_network_code:  network_id_tuple[:mnc],
-            http_request_info:    http_request_info
-          }
-        end
-      end
-    end
-  end
-end

data/lib/mobile_subscriber/detection/from_x_wap_sesiones3g_mdn_http_request_header.rb

@@ -1,39 +0,0 @@
-require 'mobile_subscriber/dictionaries/dialing_and_country_codes'
-
-module MobileSubscriber::Detection
-  # Módulo que provee métodos de detección y validacion para MSISDN por el
-  # header de HTTP 'X-Wap-Sesiones3g-Mdn':
-  # - Iusacell
-  module FromXWapSesiones3gMdnHttpRequestHeader
-
-    def extract_from_x_wap_sesiones3g_mdn_http_request_header(http_request_info)
-      if msisdn = http_request_info.headers['X-Wap-Sesiones3g-Mdn'] and msisdn.length >= 8
-
-        country_code = (
-          MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,2]] ||
-          MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,3]]
-        )
-
-        # Determine the Network Operator tuple (MCC + MNC):
-        # TODO: Validate IP ranges, additional headers, etc.
-        network_id_tuple = case country_code
-        when 'MX' # Iusacell Mexico:
-          # TODO: Determine (if possible) the MNC:
-          # - MNC "040": Iusacell/Unefon
-          # - MNC "050": Iusacell
-          { mcc: "334", mnc: "040" }
-        end
-
-        # Return only if we identified the network:
-        if network_id_tuple.present?
-          {
-            id:                   msisdn,
-            mobile_country_code:  network_id_tuple[:mcc],
-            mobile_network_code:  network_id_tuple[:mnc],
-            http_request_info:    http_request_info
-          }
-        end
-      end
-    end
-  end
-end

data/lib/mobile_subscriber/detection/from_x_ztgo_beareraddress_http_request_header.rb

@@ -1,36 +0,0 @@
-require 'mobile_subscriber/dictionaries/dialing_and_country_codes'
-
-module MobileSubscriber::Detection
-  # Módulo que provee métodos de detección y validacion para MSISDN por el
-  # header de HTTP 'X-Ztgo-Beareraddress':
-  # - Movistar Ecuador
-  module FromXZtgoBeareraddressHttpRequestHeader
-
-    def extract_from_x_ztgo_beareraddress_http_request_header(http_request_info)
-      if msisdn = http_request_info.headers['X-Ztgo-Beareraddress'] and msisdn.length >= 8
-
-        country_code = (
-          MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,2]] ||
-          MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,3]]
-        )
-
-        # Determine the Network Operator tuple (MCC + MNC):
-        # TODO: Validate IP ranges, additional headers, etc.
-        network_id_tuple = case country_code
-        when 'EC' # Movistar Ecuador:
-          { mcc: "740", mnc: "00" }
-        end
-
-        # Return only if we identified the network:
-        if network_id_tuple.present?
-          {
-            id:                   msisdn,
-            mobile_country_code:  network_id_tuple[:mcc],
-            mobile_network_code:  network_id_tuple[:mnc],
-            http_request_info:    http_request_info
-          }
-        end
-      end
-    end
-  end
-end

data/lib/mobile_subscriber/detection/http_request_info.rb

@@ -1,77 +0,0 @@
-module MobileSubscriber::Detection
-  class HttpRequestInfo
-    attr_reader :remote_ip, :headers
-
-    def initialize(env)
-
-      @remote_ip = env['REMOTE_ADDR']
-
-      # Reference Links:
-      # - http://www.slideshare.net/DefCamp/mobile-networks-exploiting-http-headers-and-data-traffic
-      # - http://www.mulliner.org/collin/academic/publications/mobile_web_privacy_icin10_mulliner.pdf
-      @headers = [
-        # HTTP Headers that contain important request details for validation
-        'Max-Forwards',   # Para validar el número de forwards que el cliente permite... muy pobre..
-        'Via',
-        'X-Forwarded-For', # lista de IP's que originaron la petición, en caso de pasar por proxies:
-
-        # HTTP headers that contain the MSISDN:
-        # http://www.mulliner.org/collin/academic/publications/mobile_web_privacy_icin10_mulliner.pdf
-        'Cookie',
-        'Igcli',
-        'Msisdn',
-        'Rapmin',
-        'X-Fh-Msisdn',
-        "X-H3-G-Msisdn",
-        'X-Hts-Clid',
-        'X-Jinny-Cid',
-        'X-Msisdn',
-        'X-Msp-Clid',
-        'X-Msp-Msisdn',
-        'X-Network-Info',
-        'X-Nokia-Imsi',             # This is a VERY useful one... if you have it!
-        'X-Nokia-Msisdn',
-        'X-Nx-Clid',
-        'X-Orange-Cli',
-        'X-Up-Calling-Line',
-        'X-Up-Calling-Line-Id',     # Not in referenced literature
-        'X-Up-Ch-Msisdn',           # Not in referenced literature
-        'X-Up-Lsid',
-        'X-Up-Subno',               # Not in referenced literature
-        'X-Wap-Fh-Subscriber-Info',
-        'X-Wap-Msisdn',
-        'X-Wap-Sesiones3g-Mdn',     # Not in referenced literature
-        'X-Wsb-Cli',
-        'X-Ztgo-Beareraddress',     # Not in referenced literature
-
-        # Headers that contain bearer information:
-        # http://www.mulliner.org/collin/academic/publications/mobile_web_privacy_icin10_mulliner.pdf
-        'Bearer',
-        'Bearer-Indication',
-        'New-Bearer-Header',
-        'Nokia-Bearer',
-        'X-Nokia-Bearer',
-        'X-Nokia-Musicshop-Bearer',
-        'X-Up-Bear-Type',           # NOT A TYPO
-        'X-Up-Bearer-Type',
-        'X-Bearer-Type',
-
-        # Headers that contain roaming information:
-        # http://www.mulliner.org/collin/academic/publications/mobile_web_privacy_icin10_mulliner.pdf
-        'X-Orange-Roaming',
-        'X-Nokia-Roaming',
-        'X-Roaming',
-        'X-Sdp-Roaming'
-      ].inject({}.with_indifferent_access) do |collected_headers, header_name|
-        header_env_key = "HTTP_#{header_name.gsub('-','_').upcase}"
-
-        if env.has_key? header_env_key
-          collected_headers[header_name] = env[header_env_key].strip
-        end
-
-        collected_headers
-      end
-
-    end
-  end
-end

data/lib/mobile_subscriber/isdn.rb

@@ -1,89 +0,0 @@
-require 'mobile_subscriber/dictionaries/mobile_and_iso_country_codes'
-require 'mobile_subscriber/dictionaries/dialing_and_country_codes'
-require 'mobile_subscriber/dictionaries/operator_data'
-
-module MobileSubscriber
-
-  class ISDN
-
-    attr_reader :id, :mobile_country_code, :mobile_network_code, :http_request_info
-    alias_method :to_s, :id
-
-    extend MobileSubscriber::Detection::FromMsisdnHttpRequestHeader
-    extend MobileSubscriber::Detection::FromXNokiaMsisdnHttpRequestHeader
-    extend MobileSubscriber::Detection::FromXUpCallingLineIdHttpRequestHeader
-    extend MobileSubscriber::Detection::FromXUpChMsisdnHttpRequestHeader
-    extend MobileSubscriber::Detection::FromXUpSubnoHttpRequestHeader
-    extend MobileSubscriber::Detection::FromXWapMsisdnHttpRequestHeader
-    extend MobileSubscriber::Detection::FromXWapSesiones3gMdnHttpRequestHeader
-    extend MobileSubscriber::Detection::FromXZtgoBeareraddressHttpRequestHeader
-
-    def initialize(attributes={})
-      @id                   = attributes.delete :id
-      @mobile_country_code  = attributes.delete :mobile_country_code
-      @mobile_network_code  = attributes.delete :mobile_network_code
-      @http_request_info    = attributes.delete :http_request_info
-    end
-
-    def dialing_code
-      self.id[0,2]
-    end
-    alias_method :country_dialing_code, :dialing_code
-
-    def iso_3166_country_code
-      if self.mobile_country_code.present?
-        MobileSubscriber::MCC_ISO_COUNTRY_CODES[self.mobile_country_code]
-      end
-    end
-
-    def mobile_network_brand
-      if self.mobile_country_code.present? && self.mobile_network_code.present?
-        key = [self.mobile_country_code, self.mobile_network_code]
-        MobileSubscriber::OPERATOR_DATA[key][:brand]
-      end
-    end
-
-    def mobile_network_operator
-      if self.mobile_country_code.present? && self.mobile_network_code.present?
-        key = [self.mobile_country_code, self.mobile_network_code]
-        MobileSubscriber::OPERATOR_DATA[key][:operator]
-      end
-    end
-
-    def inspect
-      "<MobileSubscriber::ISDN #{self.id} (#{self.http_validated? ? '' : 'not '}validated by HTTP)>"
-    end
-
-    def http_validated?
-      @http_validated ||= false
-    end
-
-    # Creates a new MobileSubscriber::ISDN from a Rack::Request object
-    def self.new_from_request(request)
-      http_request_info = Detection::HttpRequestInfo.new request.env
-
-      detection_results = self.methods.select do |x|
-        x.to_s =~ /\Aextract_from_(\w+)_http_request_header\z/i
-      end.map do |detection_method|
-        self.send detection_method, http_request_info
-      end.compact
-
-      # TODO: Select first from a preference order:
-      detection = detection_results.first if detection_results.any?
-
-      if detection.present?
-        validated_isdn = new(detection)
-        validated_isdn.send :http_validated!
-        validated_isdn
-      end
-    end
-
-    protected
-
-      def http_validated!
-        @http_validated = true
-      end
-
-  end
-
-end