RubyGems - mobile-subscriber - Versions diffs - 0.0.1.alpha5 → 0.0.1.beta1 - Mend

mobile-subscriber 0.0.1.alpha5 → 0.0.1.beta1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (19) hide show

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0f3d86284c8cd6a42a0fdab25eba82cb6c1ba05b
-  data.tar.gz: fbcf9b5f54072d1a6f9580da21bc6afbd4314d51
+  metadata.gz: b57bb989e630712c7b4a06d051a7038006b426c1
+  data.tar.gz: 00d70b45ea77d7e0ebeae56c47c3fb19960c5ebc
 SHA512:
-  metadata.gz: 0acdb66c244b26c2360958eeaf0a392b3786d59e73946348e5abfc1f249ea47e978576711b76e3a2f4a960c60e1ad4ca546e879c085a2821be8223c8ad2317ab
-  data.tar.gz: d7f91b0655d285b3f9ce75993ee7702088b35e17887590c77cd54df922703fd421000a49e08ddf6d1dc45b9e6c3d630039c8b0652048d4f0a60a527e60b98a7c
+  metadata.gz: df5e3a68907f3c6a33350a16be66e20ed2d385d133ee2547e1848613ae179a5231c8a145ccf4ed46ae1a2f41c785c2c816c612c4c62a50381ba4140a8b4fface
+  data.tar.gz: 2e4a5f0151692218c8cf90d20de3288f31aa91ebaba3533dbb67607176272acc940caee34ca243c617af9697c70168aeccd5f0438cd8eb5a54e267d0ae392989

data/README.md CHANGED Viewed

@@ -1,6 +1,16 @@
 # MobileSubscriber Gem
-TODO: Write a gem description
+It's a fact that the Mobile network providers (carriers, operators & such) share
+subscriber identity data to approved 3rd parties when users navigate via Web to
+the 3rd parties' websites.
+The problem is that generally the algorythms used by these 3rd parties offer
+no security against forged HTTP requests.
+The goals of this project are basically to detect the user's identity for the
+3rd parties, in the most secure and reliably as possible:
+- Validate the mobile user's identity by checking the originating IP address
+- Validate the request hopping between relaying proxies
 ## Installation
@@ -34,3 +44,5 @@ TODO: Write usage instructions here
 ## References
 - [MSISDN - Wikipedia, the free encyclopedia](http://en.wikipedia.org/wiki/MSISDN)
 - [Mobile country code - Wikipedia, the free encyclopedia](http://en.wikipedia.org/wiki/Mobile_country_code)
+- [Mobile networks: exploiting HTTP headers and data traffic - DefCamp 2012](http://www.slideshare.net/DefCamp/mobile-networks-exploiting-http-headers-and-data-traffic)
+- [Privacy Leaks in Mobile Phone Internet Access - Collin Mulliner](http://www.mulliner.org/collin/academic/publications/mobile_web_privacy_icin10_mulliner.pdf)

data/lib/mobile-subscriber.rb CHANGED Viewed

@@ -13,5 +13,7 @@ module MobileSubscriber
     autoload :FromXUpCallingLineIdHttpRequestHeader
     autoload :FromXUpChMsisdnHttpRequestHeader
     autoload :FromXUpSubnoHttpRequestHeader
+    autoload :FromXWapSesiones3gMdnHttpRequestHeader
+    autoload :HttpRequestInfo
   end
 end

data/lib/mobile_subscriber/detection/from_msisdn_http_request_header.rb CHANGED Viewed

@@ -1,137 +1,70 @@
 require 'mobile_subscriber/dictionaries/dialing_and_country_codes'
-module MobileSubscriber
-  module Detection
+module MobileSubscriber::Detection
-    # Módulo que provee métodos de detección y validacion para MSISDN por el
-    # header de HTTP 'Msisdn':
-    # - Claro Brasil
-    # - Claro Chile
-    # - Claro Colombia
-    # - Claro Costa Rica
-    # - Claro República Dominicana
-    # - Claro Ecuador
-    # - Claro El Salvador
-    # - Claro Guatemala
-    # - Claro Nicaragua
-    # - Claro Panamá
-    # - Claro Paraguay
-    module FromMsisdnHttpRequestHeader
+  # Módulo que provee métodos de detección y validacion para MSISDN por el
+  # header de HTTP 'Msisdn':
+  # - Claro Brasil
+  # - Claro Chile
+  # - Claro Colombia
+  # - Claro Costa Rica
+  # - Claro República Dominicana
+  # - Claro Ecuador
+  # - Claro El Salvador
+  # - Claro Guatemala
+  # - Claro Nicaragua
+  # - Claro Panamá
+  # - Claro Paraguay
+  module FromMsisdnHttpRequestHeader
-      extend ActiveSupport::Concern
+    def extract_from_msisdn_http_request_header(http_request_info)
+      if msisdn = http_request_info.headers['Msisdn'] and msisdn.length >= 8
-      module ClassMethods
-        def extract_from_msisdn_http_request_header(request)
-          header_name = 'Msisdn'
-          header_env_key = "HTTP_#{header_name.gsub('-','_').upcase}"
+        country_code = (
+          MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,2]] ||
+          MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,3]]
+        )
-          isdn_attributes = nil
-          isdn_attributes = if msisdn = request.env[header_env_key] and msisdn.strip.length >= 8
-            msisdn.strip!
-            detection_cues = {
-              remote_ip: request.env["REMOTE_ADDR"],
-              http_request_headers: { 'Msisdn' => msisdn }
-            }
-            country_code = MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,2]] || MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,3]]
-            # Determinar la procedencia del MSISDN
-            # TODO: Validar por IP, etc.
-            case country_code
-            when 'BR'
-              # Claro Brasil
-              # TODO: Determinar correctamente el MNC (05, 38)
-              {
-                id: msisdn,
-                mobile_country_code: "724",
-                mobile_network_code: "05"
-              }.merge(detection_cues: detection_cues)
-            when 'CL'
-              # Claro Chile
-              {
-                id: msisdn,
-                mobile_country_code: "730",
-                mobile_network_code: "03"
-              }.merge(detection_cues: detection_cues)
-            when 'CO'
-              # Claro Colombia
-              {
-                id: msisdn,
-                mobile_country_code: "732",
-                mobile_network_code: "101"
-              }.merge(detection_cues: detection_cues)
-            when 'CR'
-              # Claro Costa Rica
-              {
-                id: msisdn,
-                mobile_country_code: "712",
-                mobile_network_code: "03"
-              }.merge(detection_cues: detection_cues)
-            when 'DO'
-              # Claro Dominicana:
-              {
-                id: msisdn,
-                mobile_country_code: "370",
-                mobile_network_code: "02"
-              }.merge(detection_cues: detection_cues)
-            when 'EC'
-              # Claro Ecuador:
-              {
-                id: msisdn,
-                mobile_country_code: "740",
-                mobile_network_code: "01"
-              }.merge(detection_cues: detection_cues)
-            when 'SV'
-              # Claro El Salvador:
-              {
-                id: msisdn,
-                mobile_country_code: "706",
-                mobile_network_code: "01"
-              }.merge(detection_cues: detection_cues)
-            when 'GT'
-              # Claro Guatemala:
-              {
-                id: msisdn,
-                mobile_country_code: "704",
-                mobile_network_code: "01"
-              }.merge(detection_cues: detection_cues)
-            when 'HN'
-              # Claro Honduras:
-              {
-                id: msisdn,
-                mobile_country_code: "708",
-                mobile_network_code: "001"
-              }.merge(detection_cues: detection_cues)
-            when 'NI'
-              # Claro Nicaragua:
-              {
-                id: msisdn,
-                mobile_country_code: "710",
-                mobile_network_code: "21"
-              }.merge(detection_cues: detection_cues)
-            when 'PA'
-              # Claro Panamá:
-              {
-                id: msisdn,
-                mobile_country_code: "714",
-                mobile_network_code: "03"
-              }.merge(detection_cues: detection_cues)
-            when 'PY'
-              # Claro Paraguay:
-              {
-                id: msisdn,
-                mobile_country_code: "744",
-                mobile_network_code: "02"
-              }.merge(detection_cues: detection_cues)
-            end
-          end
+        # Determine the Network Operator (MCC + MNC tuple):
+        # TODO: Validate IP ranges, additional headers, etc.
+        network_id_tuple = case country_code
+        when 'BR' # Claro Brasil
+          # TODO: Determine (if possible) the MNC (05, 38)
+          { mcc: "724", mnc: "05"   }
+        when 'CL' # Claro Chile
+          { mcc: "730", mnc: "03"   }
+        when 'CO' # Claro Colombia
+          { mcc: "732", mnc: "101"  }
+        when 'CR' # Claro Costa Rica
+          { mcc: "712", mnc: "03"   }
+        when 'DO' # Claro Dominicana:
+          { mcc: "370", mnc: "02"   }
+        when 'EC' # Claro Ecuador:
+          { mcc: "740", mnc: "01"   }
+        when 'SV' # Claro El Salvador:
+          { mcc: "706", mnc: "01"   }
+        when 'GT' # Claro Guatemala:
+          { mcc: "704", mnc: "01"   }
+        when 'HN' # Claro Honduras:
+          { mcc: "708", mnc: "001"  }
+        when 'NI' # Claro Nicaragua:
+          { mcc: "710", mnc: "21"   }
+        when 'PA' # Claro Panamá:
+          { mcc: "714", mnc: "03"   }
+        when 'PY' # Claro Paraguay:
+          { mcc: "744", mnc: "02"   }
+        end
-          isdn_attributes
+        # 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_nokia_msisdn_http_request_header.rb CHANGED Viewed

@@ -1,53 +1,38 @@
 require 'mobile_subscriber/dictionaries/dialing_and_country_codes'
-module MobileSubscriber
-  module Detection
+module MobileSubscriber::Detection
-    # Módulo que provee métodos de deteccion y validacion para MSISDN's de:
-    # - Telcel México
-    # - Claro Argentina
-    module FromXNokiaMsisdnHttpRequestHeader
+  # Módulo que provee métodos de deteccion y validacion para MSISDN's de:
+  # - Telcel México
+  # - Claro Argentina
+  module FromXNokiaMsisdnHttpRequestHeader
-      extend ActiveSupport::Concern
+    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
-      module ClassMethods
-        def extract_from_x_nokia_msisdn_http_request_header(request)
+        country_code = (
+          MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,2]] ||
+          MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,3]]
+        )
-          header_name = 'X-Nokia-Msisdn'
-          header_env_key = "HTTP_#{header_name.gsub('-','_').upcase}"
+        # Determine the Network Operator tuple (MCC + MNC):
+        # TODO: Validate IP ranges, additional headers, etc.
+        network_id_tuple = case country_code
+        when 'MX' # Telcel México:
+          { mcc: "334", mnc: "020"  }
-          isdn_attributes = if msisdn = request.env[header_env_key] and msisdn.strip.length >= 8
-            msisdn.strip!
-            detection_cues = {
-              remote_ip: request.env["REMOTE_ADDR"],
-              http_request_headers: { 'X-Nokia-Msisdn' => msisdn }
-            }
-            country_code = MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,2]] || MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,3]]
-            # Determinar la procedencia del MSISDN
-            # TODO: Validar por IP, etc.
-            case country_code
-            when 'MX'
-              # Telcel México:
-              {
-                id: msisdn,
-                mobile_country_code: "334",
-                mobile_network_code: "020"
-              }.merge(detection_cues: detection_cues)
-            # Claro Argentina:
-            when 'AR'
-              {
-                id: msisdn,
-                mobile_country_code: "722",
-                mobile_network_code: "330"
-              }.merge(detection_cues: detection_cues)
-            end
-          end
-          isdn_attributes
+        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

data/lib/mobile_subscriber/detection/from_x_up_calling_line_id_http_request_header.rb CHANGED Viewed

@@ -1,100 +1,65 @@
 require 'mobile_subscriber/dictionaries/dialing_and_country_codes'
-module MobileSubscriber
-  module Detection
+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 Ecuador
-    # - Movistar Perú
-    module FromXUpCallingLineIdHttpRequestHeader
+  # 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 Ecuador
+  # - Movistar Perú
+  module FromXUpCallingLineIdHttpRequestHeader
-      extend ActiveSupport::Concern
+    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
-      module ClassMethods
-        def extract_from_x_up_calling_line_id_http_request_header(request)
-          header_name = 'X-Up-Calling-Line-Id'
-          header_env_key = "HTTP_#{header_name.gsub('-','_').upcase}"
+        country_code = (
+          MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,2]] ||
+          MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,3]]
+        )
-          isdn_attributes = if msisdn = request.env[header_env_key] and msisdn.strip.length >= 8
-            msisdn.strip!
-            detection_cues = {
-              remote_ip: request.env["REMOTE_ADDR"],
-              http_request_headers: { header_name => msisdn }
-            }
-            country_code = MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,2]] || MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,3]]
-            case country_code
-            when 'PE'
-              if (http_request_via_header = request.env["HTTP_VIA"]).present? and http_request_via_header =~ /Comverse/i
-                # Is Claro Peru subscriber:
-                detection_cues[:http_request_headers]['Via'] = http_request_via_header
-                {
-                  id: msisdn,
-                  mobile_country_code: "716",
-                  mobile_network_code: "10"
-                }.merge(detection_cues: detection_cues)
-              else
-                # Is a Movistar Peru subscriber:
-                {
-                  id: msisdn,
-                  mobile_country_code: "716",
-                  mobile_network_code: "06"
-                }.merge(detection_cues: detection_cues)
-              end
-            when 'BR'
-              if http_request_x_msp_apn_header = request.env["HTTP_X_MSP_APN"] and http_request_x_msp_apn_header.present?
-                detection_cues[:http_request_headers]['X-Msp-Apn'] = http_request_x_msp_apn_header
-                if http_request_x_msp_apn_header =~ /OI/i
-                  # Is a Oi Brazil subscriber:
-                  {
-                    id: msisdn,
-                    mobile_country_code: "724",
-                    mobile_network_code: "30"
-                  }.merge(detection_cues: detection_cues)
-                else
-                  # Is a TIM Brasil subscriber:
-                  {
-                    id: msisdn,
-                    mobile_country_code: "724",
-                    mobile_network_code: "02"
-                  }.merge(detection_cues: detection_cues)
-                end
-              end
-            when 'MX'
-              # Is a Movistar Mexico subscriber:
-              {
-                id: msisdn,
-                mobile_country_code: "334",
-                mobile_network_code: "030"
-              }.merge(detection_cues: detection_cues)
-            when 'AR'
-              # Is a Movistar Argentina subscriber:
-              # TODO: Detect if MNC is 010 or 070 (Different MHz Bands)
-              {
-                id: msisdn,
-                mobile_country_code: "722",
-                mobile_network_code: "010"
-              }.merge(detection_cues: detection_cues)
-            when 'EC'
-              # Is a Movistar Ecuador subscriber:
-              {
-                id: msisdn,
-                mobile_country_code: "740",
-                mobile_network_code: "00"
-              }.merge(detection_cues: detection_cues)
+        # Determine the Network Operator tuple (MCC + MNC):
+        # TODO: Validate IP ranges, additional headers, etc.
+        network_id_tuple = case country_code
+        when 'PE'
+          if (via_header = http_request_info.headers['Via']).present? and via_header =~ /Comverse/i
+            # Claro Peru:
+            { mcc: "716", mnc: "10" }
+          else
+            # Movistar Peru:
+            { 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" }
+        when 'EC' # Movistar Ecuador:
+          { mcc: "740", mnc: "00" }
+        end
-          isdn_attributes
+        # 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 CHANGED Viewed

@@ -1,46 +1,35 @@
 require 'mobile_subscriber/dictionaries/dialing_and_country_codes'
-module MobileSubscriber
-  module Detection
-    # Módulo que provee métodos de deteccion y validacion para MSISDN's de:
-    # - Vivo Brasil
-    module FromXUpChMsisdnHttpRequestHeader
-      extend ActiveSupport::Concern
-      module ClassMethods
-        def extract_from_x_up_ch_msisdn_http_request_header(request)
-          header_name = 'X-Up-Ch-Msisdn'
-          header_env_key = "HTTP_#{header_name.gsub('-','_').upcase}"
-          isdn_attributes = if msisdn = request.env[header_env_key] and msisdn.strip.length >= 8
-            msisdn.strip!
-            detection_cues = {
-              remote_ip: request.env["REMOTE_ADDR"],
-              http_request_headers: { 'X-Up-Ch-Msisdn' => msisdn }
-            }
-            country_code = MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,2]] || MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,3]]
-            # Determinar la procedencia del MSISDN
-            # TODO: Validar por IP, etc.
-            case country_code
-            when 'BR'
-              # Vivo:
-              # TODO: Determinar el MNC correcto (06, 10, 11, 23)
-              {
-                id: msisdn,
-                mobile_country_code: "724",
-                mobile_network_code: "06"
-              }.merge(detection_cues: detection_cues)
-            end
-          end
-          isdn_attributes
+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 CHANGED Viewed

@@ -1,48 +1,35 @@
 require 'mobile_subscriber/dictionaries/dialing_and_country_codes'
-module MobileSubscriber
-  module Detection
-    # Módulo que provee métodos de deteccion y validacion para MSISDN por el
-    # header de HTTP 'Msisdn':
-    #  - Comcel Colombia
-    module FromXUpSubnoHttpRequestHeader
-      extend ActiveSupport::Concern
-      module ClassMethods
-        def extract_from_x_up_subno_http_request_header(request)
-          header_name = 'X-Up-Subno'
-          header_env_key = "HTTP_#{header_name.gsub('-','_').upcase}"
-          isdn_attributes = nil
-          isdn_attributes = if msisdn = request.env[header_env_key] and msisdn.strip.length >= 8
-            msisdn.strip!
-            detection_cues = {
-              remote_ip: request.env["REMOTE_ADDR"],
-              http_request_headers: { header_name => msisdn }
-            }
-            country_code = MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,2]] || MobileSubscriber::DIALING_COUNTRY_CODES[msisdn[0,3]]
-            # Determinar la procedencia del MSISDN
-            # TODO: Validar por IP, etc.
-            case country_code
-            when 'CO'
-              # Comcel Colombia
-              {
-                id: msisdn,
-                mobile_country_code: "732",
-                mobile_network_code: "101"
-              }.merge(detection_cues: detection_cues)
-            end
-          end
+module MobileSubscriber::Detection
+  # Módulo que provee métodos de deteccion y validacion para MSISDN por el
+  # header de HTTP 'Msisdn':
+  #  - 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' # Comcel Colombia
+          { mcc: "732", mnc: "101" }
+        end
-          isdn_attributes
+        # 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 ADDED Viewed

@@ -0,0 +1,39 @@
+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/http_request_info.rb ADDED Viewed

@@ -0,0 +1,75 @@
+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-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',
+        # 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 CHANGED Viewed

@@ -6,20 +6,20 @@ module MobileSubscriber
   class ISDN
-    attr_reader :id, :mobile_country_code, :mobile_network_code, :detection_cues
+    attr_reader :id, :mobile_country_code, :mobile_network_code, :http_request_info
     alias_method :to_s, :id
-    include MobileSubscriber::Detection::FromMsisdnHttpRequestHeader
-    include MobileSubscriber::Detection::FromXNokiaMsisdnHttpRequestHeader
-    include MobileSubscriber::Detection::FromXUpCallingLineIdHttpRequestHeader
-    include MobileSubscriber::Detection::FromXUpChMsisdnHttpRequestHeader
-    include MobileSubscriber::Detection::FromXUpSubnoHttpRequestHeader
+    extend MobileSubscriber::Detection::FromMsisdnHttpRequestHeader
+    extend MobileSubscriber::Detection::FromXNokiaMsisdnHttpRequestHeader
+    extend MobileSubscriber::Detection::FromXUpCallingLineIdHttpRequestHeader
+    extend MobileSubscriber::Detection::FromXUpChMsisdnHttpRequestHeader
+    extend MobileSubscriber::Detection::FromXUpSubnoHttpRequestHeader
     def initialize(attributes={})
       @id                   = attributes.delete :id
       @mobile_country_code  = attributes.delete :mobile_country_code
       @mobile_network_code  = attributes.delete :mobile_network_code
-      @detection_cues       = attributes.delete :detection_cues
+      @http_request_info    = attributes.delete :http_request_info
     end
     def dialing_code
@@ -47,8 +47,6 @@ module MobileSubscriber
       end
     end
     def inspect
       "<MobileSubscriber::ISDN #{self.id} (#{self.http_validated? ? '' : 'not '}validated by HTTP)>"
     end
@@ -59,15 +57,19 @@ module MobileSubscriber
     # Creates a new MobileSubscriber::ISDN from a Rack::Request object
     def self.new_from_request(request)
-      detected_attributes = self.methods.select do |x|
+      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.sort.reduce(nil) do |attrs, detection_method|
-        attrs = self.send detection_method, request unless attrs.present?
-        attrs
-      end
+      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 detected_attributes.present?
-        validated_isdn = new(detected_attributes)
+      if detection.present?
+        validated_isdn = new(detection)
         validated_isdn.send :http_validated!
         validated_isdn
       end

data/lib/mobile_subscriber/version.rb CHANGED Viewed

@@ -1,3 +1,3 @@
 module MobileSubscriber
-  VERSION = "0.0.1.alpha5"
+  VERSION = "0.0.1.beta1"
 end

data/spec/detection/from_msisdn_http_request_header_spec.rb CHANGED Viewed

@@ -2,16 +2,20 @@ require "spec_helper"
 describe MobileSubscriber::Detection::FromMsisdnHttpRequestHeader do
-  include described_class::ClassMethods
+  include described_class
   let :test_request do
     build :mobile_request_from_claro_brasil
   end
+  let :test_request_info do
+    MobileSubscriber::Detection::HttpRequestInfo.new test_request.env
+  end
   describe "the returned object of self.extract_from_msisdn_http_request_header" do
     subject do
-      extract_from_msisdn_http_request_header test_request
+      extract_from_msisdn_http_request_header test_request_info
     end
     context "when given a request made from Claro Brasil" do
@@ -53,7 +57,7 @@ describe MobileSubscriber::Detection::FromMsisdnHttpRequestHeader do
         expect(subject[:mobile_network_code]).to eq '01'
       end
     end
   end
 end

data/spec/detection/from_x_nokia_msisdn_http_request_header_spec.rb CHANGED Viewed

@@ -2,12 +2,16 @@ require "spec_helper"
 describe MobileSubscriber::Detection::FromXNokiaMsisdnHttpRequestHeader do
-  include described_class::ClassMethods
+  include described_class
+  let :test_request_info do
+    MobileSubscriber::Detection::HttpRequestInfo.new test_request.env
+  end
   describe "the returned object of self.extract_from_msisdn_http_request_header" do
     subject do
-      extract_from_x_nokia_msisdn_http_request_header test_request
+      extract_from_x_nokia_msisdn_http_request_header test_request_info
     end
     context "when given a request made from Telcel México" do

data/spec/detection/from_x_up_calling_line_id_http_request_header_spec.rb CHANGED Viewed

@@ -2,12 +2,16 @@ require "spec_helper"
 describe MobileSubscriber::Detection::FromXUpCallingLineIdHttpRequestHeader do
-  include described_class::ClassMethods
+  include described_class
+  let :test_request_info do
+    MobileSubscriber::Detection::HttpRequestInfo.new test_request.env
+  end
   describe "the returned object of self.extract_from_msisdn_http_request_header" do
     subject do
-      extract_from_x_up_calling_line_id_http_request_header test_request
+      extract_from_x_up_calling_line_id_http_request_header test_request_info
     end
     context "when given a request made from Claro Perú" do

data/spec/detection/from_x_wap_sesiones3g_mdn_http_request_header_spec.rb ADDED Viewed

@@ -0,0 +1,29 @@
+require "spec_helper"
+describe MobileSubscriber::Detection::FromXWapSesiones3gMdnHttpRequestHeader, focus: true do
+  include described_class
+  let :test_request_info do
+    MobileSubscriber::Detection::HttpRequestInfo.new test_request.env
+  end
+  describe "the returned object of self.extract_from_msisdn_http_request_header" do
+    subject do
+      extract_from_x_wap_sesiones3g_mdn_http_request_header test_request_info
+    end
+    context "when given a request made from Iusacell Mexico" do
+      let(:test_request) { build :mobile_request_from_iusacell_mexico }
+      include_examples "of detection of msisdn from a valid mexican mobile network http request"
+      it "has a :mobile_network_code value of '040' or '050'" do
+        expect(subject[:mobile_network_code]).to match /040|050/i
+      end
+    end
+  end
+end

data/spec/factories/requests.rb CHANGED Viewed

@@ -25,6 +25,15 @@ FactoryGirl.define do
       )
     end
+    factory :mobile_request_from_iusacell_mexico do
+      initialize_with do
+        new build(:common_mobile_request_env).merge(
+          "REMOTE_ADDR"               =>  "201.144.162.4",
+          "HTTP_X_WAP_SESIONES3G_MDN" =>  "528110000000"
+        )
+      end
+    end
     factory :mobile_request_from_telcel_mexico do
       initialize_with do
         new build(:common_mobile_request_env).merge(

data/spec/models/isdn_spec.rb CHANGED Viewed

@@ -38,6 +38,10 @@ describe MobileSubscriber::ISDN do
     expect(subject).to respond_to :http_validated?
   end
+  it "responds to #http_request_info" do
+    expect(subject).to respond_to :http_request_info
+  end
   describe "detection from request headers" do
     shared_examples "of detection from a valid request" do

metadata CHANGED Viewed

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mobile-subscriber
 version: !ruby/object:Gem::Version
-  version: 0.0.1.alpha5
+  version: 0.0.1.beta1
 platform: ruby
 authors:
 - Roberto Quintanilla
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2015-01-07 00:00:00.000000000 Z
+date: 2015-01-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -118,6 +118,8 @@ files:
 - lib/mobile_subscriber/detection/from_x_up_calling_line_id_http_request_header.rb
 - lib/mobile_subscriber/detection/from_x_up_ch_msisdn_http_request_header.rb
 - lib/mobile_subscriber/detection/from_x_up_subno_http_request_header.rb
+- lib/mobile_subscriber/detection/from_x_wap_sesiones3g_mdn_http_request_header.rb
+- lib/mobile_subscriber/detection/http_request_info.rb
 - lib/mobile_subscriber/dictionaries/dialing_and_country_codes.rb
 - lib/mobile_subscriber/dictionaries/mobile_and_iso_country_codes.rb
 - lib/mobile_subscriber/dictionaries/operator_data.rb
@@ -128,6 +130,7 @@ files:
 - spec/detection/from_msisdn_http_request_header_spec.rb
 - spec/detection/from_x_nokia_msisdn_http_request_header_spec.rb
 - spec/detection/from_x_up_calling_line_id_http_request_header_spec.rb
+- spec/detection/from_x_wap_sesiones3g_mdn_http_request_header_spec.rb
 - spec/factories/requests.rb
 - spec/mobile_subscriber_spec.rb
 - spec/models/isdn_spec.rb
@@ -163,6 +166,7 @@ test_files:
 - spec/detection/from_msisdn_http_request_header_spec.rb
 - spec/detection/from_x_nokia_msisdn_http_request_header_spec.rb
 - spec/detection/from_x_up_calling_line_id_http_request_header_spec.rb
+- spec/detection/from_x_wap_sesiones3g_mdn_http_request_header_spec.rb
 - spec/factories/requests.rb
 - spec/mobile_subscriber_spec.rb
 - spec/models/isdn_spec.rb