mobile-subscriber 0.0.1.alpha5 → 0.0.1.beta1

checksums.yaml

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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