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.