mobile-subscriber 1.0.0.alpha4 → 1.0.0.alpha5

data/lib/mobile_subscriber/http/known_imsi_headers.rb

@@ -0,0 +1,22 @@
+module MobileSubscriber::HTTP
+
+  # Known IMSI Header and MCC/MNC Tuples:
+  KNOWN_IMSI_HEADER_MCC_MNC = {
+
+    'X-Imsi' => [
+      ['714', '03'], # Claro Panamá
+    ],
+
+    'X-Nokia-Imsi' => [
+      ['704', '01' ], # Claro Guatemala
+      ['716', '10' ], # Claro Perú
+      ['722', '310'], # Claro Argentina
+      ['722', '320'], # Claro Argentina
+      ['722', '330'], # Claro Argentina
+    ],
+
+    'X-Cisco-Imsi' => [
+      ['330', '110'], # Claro Puerto Rico
+    ]
+  }
+end

data/lib/mobile_subscriber/http/known_msisdn_headers.rb

@@ -0,0 +1,68 @@
+module MobileSubscriber::HTTP
+
+  KNOWN_MSISDN_HEADER_MCC_MNC = {
+
+    'Msisdn' => [
+      ['370', '02'], # Claro República Dominicana
+      ['714', '03'], # Claro Paraguay
+      ['724', '05'], # Claro Brasil A
+      ['724', '38'], # Claro Brasil B
+      ['740', '01'], # Claro Ecuador
+    ],
+
+    'X-Cisco-Msisdn' => [
+      ['330', '110'], # Claro Puerto Rico
+    ],
+
+    'X-Nokia-Msisdn' => [
+      ['334', '020'], # Telcel México
+      ['704', '01' ], # Claro Guatemala
+      ['706', '01' ], # Claro El Salvador
+      ['708', '001'], # Claro Honduras
+      ['710', '21' ], # Claro Nicaragua
+      ['712', '03' ], # Claro Costa Rica
+      ['722', '310'], # Claro Argentina A
+      ['722', '320'], # Claro Argentina B
+      ['722', '330'], # Claro Argentina C
+    ],
+
+    'X-Up-Calling-Line-Id' => [
+      ['334', '030'], # Movistar México
+      ['716', '06' ], # Movistar Perú
+      ['716', '10' ], # Claro Perú
+      ['722', '010'], # Movistar Argentina
+      ['722', '070'], # Movistar Argentina
+      ['724', '02' ], # TIM (Telecom Italia Mobile) Brasil A
+      ['724', '03' ], # TIM (Telecom Italia Mobile) Brasil B
+      ['724', '04' ], # TIM (Telecom Italia Mobile) Brasil C
+      ['724', '30' ], # OI Brasil
+      ['724', '31' ], # OI Brasil
+    ],
+
+    'X-Up-Ch-Msisdn' => [
+      ['724', '06'], # Vivo Brasil
+      ['724', '10'], # Vivo Brasil
+      ['724', '11'], # Vivo Brasil
+      ['724', '23'], # Vivo Brasil
+    ],
+
+    'X-Up-Subno' => [
+      ['732', '101'], # Claro Colombia and former Comcel Colombia
+      ['714', '03' ], # Claro Panamá
+    ],
+
+    'X-Wap-Msisdn' => [
+      ['730', '03' ], # Claro Chile
+    ],
+
+    'X-Wap-Sesiones3g-Mdn' => [
+      ['334', '040'], # Iusacell México
+      ['334', '050'], # Iusacell México
+    ],
+
+    'X-Ztgo-Beareraddress' => [
+      ['740', '00'], # Movistar Ecuador
+    ],
+  }
+
+end

data/lib/mobile_subscriber/http/request_info.rb

@@ -0,0 +1,166 @@
+require 'mobile_subscriber/http/known_imsi_headers'
+require 'mobile_subscriber/http/known_msisdn_headers'
+
+module MobileSubscriber::HTTP
+
+  class RequestInfo
+
+    attr_reader :remote_ip, :headers,
+                :imsi,   :detected_imsi_header_name,
+                :msisdn, :detected_msisdn_header_name,
+                :mcc, :mnc
+
+    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-Cisco-Msisdn',
+        'X-Cisco-Imsi',
+        'X-Fh-Msisdn',
+        "X-H3-G-Msisdn",
+        'X-Hts-Clid',
+        'X-Imsi',
+        '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.split('-').map(&:upcase).join('_')}"
+
+        if env.has_key? header_env_key
+          collected_headers[header_name] = env[header_env_key].strip
+        end
+
+        collected_headers
+      end
+
+      # IMSI Extraction:
+      # Extract the first IMSI Header Value:
+      @imsi, @detected_imsi_header_name = MobileSubscriber::HTTP::KNOWN_IMSI_HEADER_MCC_MNC.inject([nil,nil]) do |result, keyval|
+        header_name = keyval[0]
+        if result.compact.blank? and current_imsi = headers[header_name]
+          result = [current_imsi, header_name] if current_imsi.length >= 14
+        end
+        result
+      end
+
+      # MSISDN Extraction:
+      # Extract the first MSISDN Header Value:
+      @msisdn, @detected_msisdn_header_name = MobileSubscriber::HTTP::KNOWN_MSISDN_HEADER_MCC_MNC.inject([nil,nil]) do |result, keyval|
+        header_name = keyval[0]
+        if result.compact.blank? and current_msisdn = headers[header_name]
+          result = [current_msisdn, header_name] if current_msisdn.length >= 8
+        end
+        result
+      end
+
+      # Mobile Operator Info Extraction:
+      extract_mobile_operator_info!
+
+    end
+
+    def has_imsi?
+      imsi.present?
+    end
+
+    def has_msisdn?
+      msisdn.present?
+    end
+
+    private
+
+      def extract_mobile_operator_info!
+
+        tuples_by_imsi = if has_imsi?
+          MobileSubscriber::HTTP::KNOWN_IMSI_HEADER_MCC_MNC[detected_imsi_header_name]
+        end
+
+        tuples_by_msisdn = if has_msisdn?
+          MobileSubscriber::HTTP::KNOWN_MSISDN_HEADER_MCC_MNC[detected_msisdn_header_name]
+        end
+
+        tuples_to_check = if tuples_by_imsi.present? && tuples_by_msisdn.present?
+          # Intersect known data from request - less tuples to check later
+          tuples_by_imsi & tuples_by_msisdn
+        elsif tuples_by_imsi.present?
+          tuples_by_imsi
+        elsif tuples_by_msisdn.present?
+          tuples_by_msisdn
+        end
+
+        detected_mobile_operator_info = if tuples_to_check.present? && tuples_to_check.any?
+          if has_imsi?
+            tuples_to_check.detect { |tuple| imsi.start_with?(tuple.join) }
+          elsif has_msisdn?
+
+            msisdn_country_code = (1..4).to_a.reverse.inject(nil) do |code, prefix_length|
+              current_prefix = msisdn[0,prefix_length]
+              if code.nil?
+                code = MobileSubscriber::DIALING_COUNTRY_CODES[current_prefix]
+              end
+              code
+            end
+
+            msisdn_mcc = MobileSubscriber::MCC_ISO_COUNTRY_CODES.detect { |key, val| val == msisdn_country_code }.first
+
+            # TODO Check for duplicates!
+            tuples_to_check.detect { |tuple| tuple.first == msisdn_mcc }
+
+          end
+        end
+
+        @mcc, @mnc = detected_mobile_operator_info if detected_mobile_operator_info.present?
+
+      end
+
+  end
+end

data/lib/mobile_subscriber/identity.rb

@@ -1 +1,97 @@
-# Placeholder for the new Mobile User class
+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
+
+  # Identity class
+  class Identity
+
+    attr_reader :mcc, :mnc, :msisdn, :imsi, :http_request_info
+
+    alias_method :mobile_country_code, :mcc
+    alias_method :mobile_network_code, :mnc
+    alias_method :international_mobile_subscriber_identity, :imsi
+    alias_method :mobile_station_international_subscriber_directory_number, :msisdn
+
+    def initialize(attributes={})
+      @msisdn = attributes.delete :msisdn
+      @imsi   = attributes.delete :imsi
+      @mcc    = attributes.delete :mcc
+      @mnc    = attributes.delete :mnc
+      @http_request_info    = attributes.delete :http_request_info
+    end
+
+    def id
+      if imsi.present?
+        "imsi:#{imsi}"
+      else
+        "msisdn:#{msisdn}"
+      end
+    end
+    alias_method :to_s, :id
+
+    def dialing_code
+      if mcc.present?
+        dialing_codes = MobileSubscriber::DIALING_COUNTRY_CODES.select do |k,v|
+          v == iso_3166_country_code
+        end.keys
+
+        if msisdn.present?
+          max_length = dialing_codes.map(&:length).max
+          msisdn[0,max_length]
+        else
+          dialing_codes.first
+        end
+      end
+    end
+    alias_method :country_dialing_code, :dialing_code
+
+    def iso_3166_country_code
+      MobileSubscriber::MCC_ISO_COUNTRY_CODES[mcc] if mcc.present?
+    end
+
+    def mobile_network_brand
+      MobileSubscriber::OPERATOR_DATA[[mcc, mnc]][:brand] if mcc.present? && mnc.present?
+    end
+
+    def mobile_network_operator
+      MobileSubscriber::OPERATOR_DATA[[mcc, mnc]][:operator] if mcc.present? && mnc.present?
+    end
+
+    def inspect
+      "<MobileSubscriber::Identity #{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 = MobileSubscriber::HTTP::RequestInfo.new request.env
+
+      # TODO: Validate request for forged data HERE
+
+      if http_request_info.has_imsi? || http_request_info.has_msisdn?
+        validated_identity = new(
+          msisdn: http_request_info.msisdn,
+          imsi: http_request_info.imsi,
+          mcc: http_request_info.mcc,
+          mnc: http_request_info.mnc,
+          http_request_info: http_request_info
+        )
+        validated_identity.send :http_validated!
+        validated_identity
+      end
+    end
+
+    protected
+
+      def http_validated!
+        @http_validated = true
+      end
+
+  end
+
+end

data/lib/mobile_subscriber/version.rb

@@ -1,3 +1,3 @@
 module MobileSubscriber
-  VERSION = "1.0.0.alpha4"
+  VERSION = "1.0.0.alpha5"
 end

data/mobile_subscriber.thor

@@ -96,4 +96,45 @@ class MobileSubscriber < Thor
 
   end
 
+  # Scrapes the Wikipedia entry of 'Mobile country code' to generate the dictionaries.
+  desc "update_country_dialing_codes", "Update the country dialing codes dictionary from countrycode.org"
+  def update_country_dialing_codes()
+
+    # Get the Wikipedia HTML and parse HTML with nokogiri:
+    page = Nokogiri::HTML(open "http://countrycode.org/")
+
+    funky_stripper = -> (str, pttrn) { str.chars.select { |c| c =~ pttrn }.join }
+
+    # Iterate over the main table > tbody > tr:
+    @country_code_data = page.css('table#main_table_blue > tbody > tr').inject([]) do |list, t_row|
+      t_cells = t_row.css('td')
+
+      # Capture the country name:
+      name = t_cells[0].text.strip
+
+      # Capture the iso codes:
+      # WTF strip does not work here to clear spaces!
+      alpha_2, alpha_3 = t_cells[1].text.split('/').map { |str| funky_stripper.call(str, /[A-Z]/) }
+
+      # Capture the dialing code:
+      dialing = funky_stripper.call(t_cells[2].text, /\d/)
+
+      # Add to list if alpha_2 and dialing code are both present:
+      if alpha_2.present? && dialing.present?
+        list << {
+          country_name: name,
+          iso_code_2:   alpha_2,
+          iso_code_3:   alpha_3,
+          dialing_code: dialing
+        }
+      end
+
+      # Return updated list:
+      list
+    end
+
+    template 'templates/dialing_and_country_codes.rb.erb', 'lib/mobile_subscriber/dictionaries/dialing_and_country_codes.rb'
+
+  end
+
 end

data/spec/factories/mobile_requests.rb

@@ -0,0 +1,28 @@
+# Read about factories at https://github.com/thoughtbot/factory_girl
+
+FactoryGirl.define do
+
+  factory :common_mobile_request_env, class: Hash do
+    initialize_with do
+      {
+        "HTTP_HOST"             =>  "www.example.com",
+        "HTTP_CONNECTION"       =>  "close",
+        "HTTP_CACHE_CONTROL"    =>  "no-cache, max-age=0",
+        "HTTP_ACCEPT"           =>  "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8",
+        "HTTP_USER_AGENT"       =>  "Mozilla/5.0 (iPhone; CPU iPhone OS 7_0 like Mac OS X; en-us) AppleWebKit/537.51.1 (KHTML, like Gecko) Version/7.0 Mobile/11A465 Safari/9537.53",
+        "HTTP_ACCEPT_ENCODING"  =>  "gzip, deflate, sdch",
+        "HTTP_ACCEPT_LANGUAGE"  =>  "en-US,en;q=0.8,es;q=0.6",
+        "HTTP_VERSION"          =>  "HTTP/1.1"
+      }
+    end
+  end
+
+  factory :mobile_request, class: Rack::Request do
+    initialize_with do
+      new build(:common_mobile_request_env).merge(
+        "REMOTE_ADDR"           =>  "201.144.162.4"
+      )
+    end
+  end
+
+end

data/spec/factories/mobile_requests_from_claro.rb

@@ -0,0 +1,257 @@
+# Read about factories at https://github.com/thoughtbot/factory_girl
+
+FactoryGirl.define do
+
+  # Real request captured on claroapps.com at 2015-03-13
+  factory :mobile_request_from_claro_argentina, parent: :mobile_request do
+    initialize_with do
+      new build(:common_mobile_request_env).merge(
+        "REMOTE_ADDR"           =>  "23.15.7.188",
+        "HTTP_ACCEPT" => "multipart/mixed, application/vnd.wap.multipart.mixed, application/vnd.wap.xhtml+xml, application/xhtml+xml, text/vnd.wap.wml, */*",
+        "HTTP_ACCEPT_CHARSET"=> "utf-8,utf-16,iso-8859-1,iso-10646-ucs-2,Shift_JIS,Big5",
+        "HTTP_ACCEPT_ENCODING"=>"gzip",
+        "HTTP_ACCEPT_LANGUAGE"=>"es",
+        "HTTP_AKAMAI_ORIGIN_HOP"=>"1",
+        "HTTP_CACHE_CONTROL"=>"no-cache, max-age=0",
+        "HTTP_CONNECTION"=>"close",
+        "HTTP_CONNECT_TIME"=>"4",
+        "HTTP_COOKIE" => "request_method=GET; HttpOnly=; ",
+        "HTTP_COOKIE2"=>"$Version=1",
+        "HTTP_HOST"=>"www.claroapps.com",
+        "HTTP_PRAGMA"=>"no-cache",
+        "HTTP_TOTAL_ROUTE_TIME"=>"0",
+        "HTTP_USER_AGENT"=> "SonyEricssonW580i/R8BE Browser/NetFront/3.3 Profile/MIDP-2.0 Configuration/CLDC-1.1",
+        "HTTP_VERSION"=>"HTTP/1.1",
+        "HTTP_VIA"=>"1.1 akamai.net(ghost) (AkamaiGHost), 1.1 vegur",
+        "HTTP_X_AKAMAI_CONFIG_LOG_DETAIL"=>"true",
+        "HTTP_X_FORWARDED_FOR"=>"172.65.159.141, 170.51.255.15, 23.15.7.188",
+        "HTTP_X_FORWARDED_PORT"=>"80",
+        "HTTP_X_FORWARDED_PROTO"=>"http",
+        "HTTP_X_NOKIA_BEARER"=>"CSD or GPRS or 3G",
+        "HTTP_X_NOKIA_CHARGINGID"=>"-335177295",
+        "HTTP_X_NOKIA_GATEWAY"=>"NBG/4.0/1",
+        "HTTP_X_NOKIA_GGSNIPADDRESS"=>"170.51.252.245",
+        "HTTP_X_NOKIA_IMSI"=>"722310115238848",
+        "HTTP_X_NOKIA_IPADDRESS"=>"172.65.159.141",
+        "HTTP_X_NOKIA_LOCALSOCKET"=>"192.168.16.239:8080",
+        "HTTP_X_NOKIA_MAXDOWNLINKBITRATE"=>"0",
+        "HTTP_X_NOKIA_MAXUPLINKBITRATE"=>"0",
+        "HTTP_X_NOKIA_MSISDN"=>"5491126368595",
+        "HTTP_X_NOKIA_PREPAIDID"=>"4",
+        "HTTP_X_NOKIA_REMOTESOCKET"=>"172.65.159.141:16513",
+        "HTTP_X_NOKIA_ROAMINGID"=>"1",
+        "HTTP_X_NOKIA_SGSNIPADDRESS"=>"186.158.128.49",
+        "HTTP_X_REQUEST"=>"3e0f82f8-b086-4ad2-8793-c60e6a94c443",
+        "HTTP_X_REQUEST_START"=>"1426256922162",
+        "HTTP_X_WAP_PROFILE"=>"\"http://wap.sonyericsson.com/UAprof/W580iR201.xml\""
+      )
+    end
+  end
+
+  factory :mobile_request_from_claro_brasil, parent: :mobile_request do
+    initialize_with do
+      new build(:common_mobile_request_env).merge(
+        "REMOTE_ADDR" =>  "201.23.176.202",
+        "HTTP_MSISDN" =>  "5500000000000"
+      )
+    end
+  end
+
+  # TODO: Replace with a real example:
+  factory :mobile_request_from_claro_dominican_republic, parent: :mobile_request do
+    initialize_with do
+      new build(:common_mobile_request_env).merge(
+        "REMOTE_ADDR" =>  "181.37.104.3",
+        "HTTP_MSISDN" =>  "18098591800"
+      )
+    end
+  end
+
+  # http://ns.myip.ms/view/ip_owners/181034/Claro_Chile_S_a.html
+  factory :mobile_request_from_claro_chile, parent: :mobile_request do
+    initialize_with do
+      new build(:common_mobile_request_env).merge(
+        "REMOTE_ADDR" =>  "191.116.39.114",
+        "HTTP_X_WAP_MSISDN" =>  "56024440000"
+      )
+    end
+  end
+
+  factory :mobile_request_from_claro_colombia, parent: :mobile_request do
+    initialize_with do
+      new build(:common_mobile_request_env).merge(
+        "REMOTE_ADDR" =>  "200.26.137.100",
+        "HTTP_X_UP_SUBNO" =>  "57000000000"
+      )
+    end
+  end
+
+  # TODO: Replace with a real example request:
+  factory :mobile_request_from_claro_costa_rica, parent: :mobile_request do
+    initialize_with do
+      new build(:common_mobile_request_env).merge(
+        "REMOTE_ADDR" =>  "186.26.126.37",
+        "HTTP_X_NOKIA_MSISDN" =>  "50600000000"
+      )
+    end
+  end
+
+  # Real request taken on 2015-04-09 16:07:05
+  factory :mobile_request_from_claro_puerto_rico, parent: :mobile_request do
+    initialize_with do
+      new build(:common_mobile_request_env).merge(
+        "REMOTE_ADDR" =>  "63.235.37.23",
+        "HTTP_ACCEPT" =>  "application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5",
+        "HTTP_ACCEPT_CHARSET" =>"utf-8, iso-8859-1, utf-16, *;q=0.7",
+        "HTTP_ACCEPT_ENCODING" =>"gzip",
+        "HTTP_ACCEPT_LANGUAGE" =>"en-US",
+        "HTTP_AKAMAI_ORIGIN_HOP" =>"1",
+        "HTTP_CACHE_CONTROL"  =>"no-cache, max-age=0",
+        "HTTP_CONNECT_TIME"   =>"0",
+        "HTTP_CONNECTION"     =>"close",
+        "HTTP_HOST"           =>"api.claroapps.com",
+        "HTTP_PRAGMA"         =>"no-cache",
+        "HTTP_TOTAL_ROUTE_TIME" =>"0",
+        "HTTP_USER_AGENT"   => "Mozilla/5.0 (Linux; U; Android 2.3.6; en-us; GT-I9070 Build/GINGERBREAD) AppleWebKit/533.1 (KHTML, like Gecko) Version/4.0 Mobile Safari/533.1",
+        "HTTP_VERSION"      =>"HTTP/1.1",
+        "HTTP_VIA"          =>"1.1 akamai.net(ghost) (AkamaiGHost), 1.1 vegur",
+
+        "HTTP_X_AKAMAI_CONFIG_LOG_DETAIL" =>"true",
+
+        "HTTP_X_CISCO_IMSI"   =>"330110010202360",
+        "HTTP_X_CISCO_MSISDN" =>"17873131471",
+
+        "HTTP_X_FORWARDED_FOR"   =>"63.135.255.59, 63.235.37.23",
+        "HTTP_X_FORWARDED_PORT"  =>"80",
+        "HTTP_X_FORWARDED_PROTO" =>"http",
+
+        "HTTP_X_REQUEST_ID"    =>"4b67a488-619e-4366-9437-f5e5e746f971",
+        "HTTP_X_REQUEST_START" =>"1428595625229",
+        "HTTP_X_WAP_PROFILE"   =>"http://wap.samsungmobile.com/uaprof/GT-I9070.xml"
+      )
+    end
+  end
+
+  # http://myip.ms/view/ip_owners/80612/Conecel.html
+  factory :mobile_request_from_claro_ecuador, parent: :mobile_request do
+    initialize_with do
+      new build(:common_mobile_request_env).merge(
+        "REMOTE_ADDR" =>  "190.63.1.10",
+        "HTTP_MSISDN" =>  "59342690000"
+      )
+    end
+  end
+
+  # Request from a client through Claro Guatemala network:
+  # (Built from an actual ATP test)
+  factory :mobile_request_from_claro_guatemala, parent: :mobile_request do
+    initialize_with do
+      new build(:common_mobile_request_env).merge(
+        "REMOTE_ADDR" =>  "216.230.152.158",
+        "HTTP_X_NOKIA_MSISDN" => "50241865146",
+        "HTTP_X_NOKIA_IMSI" => "704012013128442",
+        "HTTP_X_FORWARDED_FOR" => "190.212.233.218, 204.0.3.199"
+      )
+    end
+  end
+
+  # TODO: Replace with a real example:
+  factory :mobile_request_from_claro_honduras, parent: :mobile_request do
+    initialize_with do
+      new build(:common_mobile_request_env).merge(
+        "REMOTE_ADDR" =>  "190.107.157.31",
+        "HTTP_X_NOKIA_MSISDN" => "50430000000"
+      )
+    end
+  end
+
+  # TODO: Replace with a real example request:
+  factory :mobile_request_from_claro_nicaragua, parent: :mobile_request do
+    initialize_with do
+      new build(:common_mobile_request_env).merge(
+        "REMOTE_ADDR" =>  "190.212.88.8",
+        "HTTP_X_NOKIA_MSISDN" =>  "50500000000"
+      )
+    end
+  end
+
+  # TODO: Replace with a real example request:
+  factory :mobile_request_from_claro_el_salvador, parent: :mobile_request do
+    initialize_with do
+      new build(:common_mobile_request_env).merge(
+        "REMOTE_ADDR" =>  "190.86.139.225",
+        "HTTP_X_NOKIA_MSISDN" =>  "50300000000"
+      )
+    end
+  end
+
+  # Real request recorded at claroapps.com at 2015-03-24
+  factory :mobile_request_from_claro_peru, parent: :mobile_request do
+    initialize_with do
+      new build(:common_mobile_request_env).merge(
+        "REMOTE_ADDR"             => "216.246.75.208", # This IP belongs to a U.S. datacenter which acts as proxy for the real user...
+
+        "HTTP_ACCEPT_LANGUAGE"    => "es-PE,es-419;q=0.8,es;q=0.6",
+        "HTTP_AKAMAI_ORIGIN_HOP"  => "1",
+        "HTTP_CONNECT_TIME"       => "3",
+        "HTTP_PRAGMA"             => "no-cache",
+        "HTTP_TOTAL_ROUTE_TIME"   => "5",
+        "HTTP_VERSION"            => "HTTP/1.1",
+        "HTTP_VIA"                => "1.1 akamai.net(ghost) (AkamaiGHost), 1.1 vegur",
+
+        # X Headers:
+        "HTTP_X_AKAMAI_CONFIG_LOG_DETAIL" => "true",
+
+        # The leftmost IP is the:
+        # - Closer to the User (or the actual user IP)
+        # - Less trustable
+        "HTTP_X_FORWARDED_FOR"      => "190.113.210.147, 216.246.75.208",
+        "HTTP_X_NOKIA_IMSI"         => "716100316259449",
+        "HTTP_X_REQUEST"            => "272aa345-55cc-45b2-b879-79678957817f",
+
+        "HTTP_X_REQUEST_START"      => "1427225820026",
+        "HTTP_X_FORWARDED_PORT"     => "80",
+        "HTTP_X_FORWARDED_PROTO"    => "http",
+        "HTTP_X_UP_CALLING_LINE_ID" => "51941037249"
+      )
+    end
+  end
+
+  # Real request sample captured at claroapps.com on 2015-03-13
+  factory :mobile_request_from_claro_panama, parent: :mobile_request do
+    initialize_with do
+      new build(:common_mobile_request_env).merge(
+        "REMOTE_ADDR" => "216.246.75.196",
+
+        # Client generated headers:
+        "HTTP_ACCEPT"          => "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+        "HTTP_ACCEPT_ENCODING" => "gzip",
+        "HTTP_ACCEPT_LANGUAGE" => "es-es",
+        "HTTP_CONNECTION"      => "close",
+        "HTTP_HOST"            => "api.claroapps.com",
+        "HTTP_PRAGMA"          => "no-cache",
+        "HTTP_USER_AGENT"      => "Mozilla/5.0 (iPhone; CPU iPhone OS 8_1_3 like Mac OS X) AppleWebKit/600.1.4 (KHTML, like Gecko) Version/8.0 Mobile/12B466 Safari/600.1.4",
+        "HTTP_VERSION"         => "HTTP/1.1",
+
+        # Mobile Network generated headers:
+        "HTTP_X_APN"      => "web.claro.com.pa",
+        "HTTP_X_IMSI"     => "714030003647380",
+        "HTTP_X_UP_SUBNO" => "50762526353",
+
+        # Akamai generated/modified headers:
+        "HTTP_AKAMAI_ORIGIN_HOP"          => "1",
+        "HTTP_CONNECT_TIME"               => "1",
+        "HTTP_CACHE_CONTROL"              => "no-cache, max-age=0",
+        "HTTP_X_AKAMAI_CONFIG_LOG_DETAIL" => "true",
+        "HTTP_TOTAL_ROUTE_TIME"           => "0",
+        "HTTP_VIA"                        => "1.1 akamai.net(ghost) (AkamaiGHost), 1.1 vegur",
+        "HTTP_X_FORWARDED_FOR"            => "181.179.0.28, 216.246.75.196",
+        "HTTP_X_FORWARDED_PORT"           => "80",
+        "HTTP_X_FORWARDED_PROTO"          => "http",
+        "HTTP_X_REQUEST"                  => "d141e3e0-0282-4f44-9e45-470a834976a1",
+        "HTTP_X_REQUEST_START"            => "1426248962827"
+      )
+    end
+  end
+
+end