Manual
Transcription
Manual
Manual Date Coverage Service Provider’s Software Developers Approved on Valid from 2013-04-23 2013-04-23 Expiry MSISDN Enrichment Description TS1209243890 1.0 This document describes the technical details of http header enrichment i.e. MSISDN forwarding and how to test the service. Company information TeliaSonera Finland Oyj Teollisuuskatu 15, 00510 HELSINKI, FI Registered office: Helsinki Business ID 1475607-9, VAT No. FI14756079 Page 2014-04-15 1 (4) Identifier Version TS1209282625 1.2 Relation Sonera Service Provision Solution Approved Manual Page Date Coverage Service Provider’s Software Developers Approved on Valid from 2013-04-23 2013-04-23 Expiry 2014-04-15 2 (4) Identifier Version TS1209282625 1.2 Approved Relation Sonera Service Provision Solution Version history Versions Status Date Modified by Comments 0.1. 1.1 1.2 Draft Approved Approved 2012-10-12 2013-06-06 2014-04-15 Text. Sonera Sonera Text. x-up-calling-line-id format and ip range changed Updated the IP and added some testing hints Table of contents 1 HTTP header enrichment (MSISDN forwarding) ............................................................................ 3 1.1 DNS Configurations and Header format ............................................................................... 3 1.2 IP Configurations.................................................................................................................. 3 2 Testing the HTTP header enrichment (MSISDN forwarding) .......................................................... 4 Manual Date Coverage Service Provider’s Software Developers Approved on Valid from 2013-04-23 2013-04-23 Expiry Page 2014-04-15 3 (4) Identifier Version TS1209282625 1.2 Approved Relation Sonera Service Provision Solution 1 HTTP header enrichment (MSISDN forwarding) 1.1 DNS Configurations and Header format TeliaSonera Finland Oyj’s (later Sonera) system adds and transfers the end user’s MSISDN to service application in “X-UP-CALLING-LINE-ID” HTTP header field. The MSISDN in header is shown in international format e.g. “X-UP-CALLING-LINE-ID: 358401234567” For transmitting the parameter, the Service Provider needs to indicate the DNS name where the Service is situated. For example: m.servicedomain.fi, www.servicedomain.fi payment.servicedomain.fi Note! The service TCP port must be 80 (default). Note! Sonera adds the MSISDN to the header first in the header row. Service Provider shall start the parsing from the first header and only take into account the first one. Example of the header: Host: m.servicedomain.fi Connection: Close User agent: Vendor X/1.0 (3,02) . . . x-up-calling-line-id: 358401234567\r\n 1.2 IP Configurations Sonera’s header enriched traffic is coming from the following IP-ranges/IP-addresses which need to be allowed in the Service Provider’s firewall: IP-address range: [188.238.0.0/16 ] and [109.240.0.0/16] Note! Service works on following APN: SONERA, TELE FINLAND (or “internet”, if APN manually configured). Header Enrichments service does no longer support WAP APN. Note! Do not allow or take into account “x-up-calling-line-id” –headers which are coming from other IP-addresses than described above! Note! If for some reason the x-up-calling-line-id contains more than one MSISDN, accept only the first number and displace all the others after the first ‘,’ mark Manual Date Coverage Service Provider’s Software Developers Approved on Valid from 2013-04-23 2013-04-23 Expiry Page 2014-04-15 4 (4) Identifier Version TS1209282625 1.2 Approved Relation Sonera Service Provision Solution 2 Testing the HTTP header enrichment (MSISDN forwarding) After Service Provider has informed Sonera about service domain(s) and Sonera has informed Service Provider that it is ok to test. Service Provider: Test the service with several terminals and check if the “x-up-calling-line-id” header is shown. If the header is shown ‘HTTP header enrichment test is concluded and please continue to Mobile Charger tests for end user charging. If the header is not shown: Check that the domain (and port 80) is valid and same as informed to Sonera. Check that traffic is coming from the Sonera’s IP-addresses mentioned previously on the document. Browse to http://m.tele.fi/mtelefi/layout/checker/whatis.php with the mobile phones browser you’re using for testing. You should see a page displaying your MSISDN and the source IP. To use this test site the test phone must have a Sonera or Telefinland SIM. If the MSISDN is not shown, check your phone APN settings - the active access point should be SONERA, TELE FINLAND (or “internet”) Inform Sonera that header is not shown. Sonera checks its configuration and informs again when ready to test. Repeat the test until the header is shown.