Käyttöönotto- ja laskutusohje. Content Gateway Versio 4.0 Versio 1.1 12.05.2011 TeliaSonera Finland Oyj

Käyttöönotto- ja laskutusohje Content Gateway Versio 4.0 Versio 1.1 12.05.2011 TeliaSonera Finland Oyj

2 (44) Sisällysluettelo 1 Content Gateway -ohjelmiston käyttöoikeusehdot... 4 2 Johdanto... 5 3 CGW 4.0 version muutokset... 5 3.1 Windows Remote Control on korvattu Web käyttöliittymällä.... 5 3.2 Palvelutyypit:... 6 3.3 Kaikki palvelutyypit tukevat SMS ja MMS -viestejä... 6 3.4 Query/Reply -palvelujen timeout aika on aina kymmenen minuuttia... 6 3.5 Query/Reply palvelun vastausta ei tarvitse lähettää saman yhteyden kautta... 6 3.6 Palvelujen loppukäyttäjähinnat asetetaan Provider Admin käyttöliittymässä... 6 3.7 Konfiguroitua Palvelun loppukäyttäjähintaa voi muuttaa paluuviestillä... 7 3.8 Push palvelussa palvelun loppukäyttäjähintaa voi muuttaa... 7 3.9 Push palvelut toimivat kuten muutkin palvelut... 7 3.10 Push palvelujen tilauslogiikka... 7 3.11 Viivästyneet toimituskuittaukset toimivat... 7 4 Content Gateway järjestelmän käyttöönotto... 7 4.1 Lataa ohjelmiston uusin versio Soneran www- sivuilta... 7 4.2 Asenna ohjelmisto... 8 4.3 Ota yhteys CGW4:ään WWW-selaimella... 12 4.4 Asenna lisenssi... 12 4.5 Konfiguroi ylläpitokäyttöliittymän käyttäjät, käyttäjäryhmät ja salasanat... 13 4.6 Testaa järjestelmän ja yhteyksien toiminta... 14 5 Palomuuri ja yhteysasetukset... 17 6 Porttinumerot... 17 7 Käsin tehtävät konfiguroinnit (HTTP, OTP, Java API)... 18 8 Multimediaviesti tuen käyttöönotto... 18 8.1 MMS tuen vaatimat asetukset... 19 8.2 MMS rajoituksia... 19 8.3 MMS -päätelaitteen asetukset... 19 9 Loppukäyttäjän laskuttaminen... 19 9.1 Soneran ohjeet Loppukäyttäjien laskuttamiseen... 19 9.2 Yleistä laskutusmahdollisuuksista... 20 9.3 Miksi laskutus epäonnistuu?... 20 9.4 Push palvelut (loppukäyttäjää laskutetaan hänen vastaanottamistaan viesteistä)... 21 9.5 Query/Reply ja Receive Only palvelu HTTP protokollalla... 22 9.6 SMS ja MMS Push palvelu HTTP protokollalla... 23 9.7 Query/Reply ja Receive Only palvelu OTP protokollalla... 24

3 (44) 9.8 Push palvelu OTP protokollalla... 26 9.9 Query/Reply ja Receive Only palvelu Java -kirjastolla... 29 9.10 Push palvelu Java -kirjastolla... 31 9.11 Query/Reply ja Receive Only palvelu C++ -kirjastolla... 32 9.12 Push palvelu C++ -kirjastolla... 33 9.13 Laskutus UCP/EMI protokollalla... 34 9.14 Query/Reply palvelun toteuttaminen kun vastaus lähetetään eri protokollaa tai eri yhteyttä käyttäen kuin tilaus... 35 10 Useampi kuin yksi Provider Server ja lisenssi samalla koneella... 35 10.1 Linux/Unix asennus... 36 10.2 Windows NT/Windows 2000 asennus... 36 11 Teknisiä Ohjeita... 37 11.1 CGW4 version protokollarajapinnan tärkeimmät tekniset epäyhteensopivuudet CGW3 versioon verrattuna... 37 11.2 Toimituskuittaukset... 38 11.3 Push palvelun tilaajien statuksen kysely... 42 11.4 Push palvelun tilaajan poisto... 43 11.5 Liittymän operaattorin kysely... 44

4 (44) 1 CONTENT GATEWAY -OHJELMISTON KÄYTTÖOIKEUSEHDOT Content Gateway -ohjelmiston (jäljempänä Ohjelmisto ) ja siihen liittyvän muun aineiston kuten asiakirjojen, ohjelmistokirjastojen ja esimerkkisovellusten (jäljempänä Aineisto ) käyttämistä edellyttää, että käyttäjä hyväksyy nämä käyttöoikeusehdot kokonaisuudessaan. Jos ehtoja ei hyväksytä, ohjelman käyttöoikeutta ei ole. Käyttöoikeus Sonera myöntää näiden käyttöoikeusehtojen mukaisen rajoitetun käyttöoikeuden Ohjelmistoon ja Aineistoon. Ohjelmistoa ja Aineistoa voidaan käyttää ilman käyttöoikeusmaksua palvelukuvauksessa kuvattujen sovellusten rakentamiseksi ja testaamiseksi. Ohjelmiston käyttö sovellusten kytkemiseen matkaviestinverkon sanomanvälityskeskukseen tai Ohjelmiston käyttö teksti- tai multimediaviestien lähettämiseen tai vastaanottamiseen edellyttää erillisen sopimuksen tekemistä Soneran kanssa. Ohjelmiston käyttö muuhun kuin edellä kuvattuun tarkoitukseen ilman erillistä kirjallista sopimusta Soneran kanssa on kielletty. Aineistoa saa käyttää vain Ohjelmiston käytön yhteydessä. Oikeudet Ohjelmisto ja Aineisto ovat tekijänoikeuslain ja kansainvälisten sopimusten mukaan suojattuja. Tekijänoikeudet omistaa Sonera tai sen päämies, eivätkä nämä oikeudet siirry käyttäjälle. Ohjelmiston ja Aineiston tai niiden käyttöoikeuden luovuttaminen kolmannelle taholle ei ole sallittua. Käyttöoikeuden edellytyksenä on, että Ohjelmisto ja Aineisto joko ladataan suoraan Soneran palvelimelta tai että Sonera toimittaa Ohjelmiston ja Aineiston asiakkaalle tietolevykkeillä. Ohjelmistosta tai Aineistosta ei saa poistaa tuotemerkkejä, tekijänoikeusilmoituksia tai muita vastaavia käyttörajoituksia osoittavia merkintöjä. Vastuunrajoitus Ohjelmisto ja Aineisto toimitetaan sellaisena kuin ne ovat. Sonera on pyrkinyt varmistamaan niiden virheettömyyden, mutta virheettömyyttä tai muuta soveltuvuutta tai sopivuutta mihinkään tiettyyn käyttötarkoitukseen ei taata. Sonera ei vastaa vahingoista, joita käyttäjälle voi aiheutua Ohjelmiston tai Aineiston käytöstä, virheistä tai toimimattomuudesta riippumatta siitä, mihin tai keneen vahinko kohdistuu tai mistä vahinko aiheutuu.

5 (44) 2 JOHDANTO Content Gateway on järjestelmä, joka mahdollistaa teksti- ja multimediaviestien lähettämisen yrityksen järjestelmistä matkapuhelimiin sekä viestien vastaanottamisen yrityksen järjestelmiin. Yritys voi käyttää valmiita sovelluksia kuten viestien lähetystä tai rakentaa API kirjastoja ja protokollarajapintoja käyttäen omia sovelluksia. Content Gateway järjestelmässä on kaksi osaa: yrityksen omalle palvelimelle asennettava Provider Server -ohjelmisto ja Soneran hallitsema Operator Server. Viestit kulkevat yrityksen ja Soneran välillä salattuina Internetin kautta. Sonera ja Asiakas sopivat yhteyden avaamisesta Soneran Operator Serverille ja sanomanvälitysjärjestelmään: Mobiiliviesti-palvelu on tarkoitettu ainoastaan yrityksen sisäiseen viestintään. Viestirajapintasopimuksella on mahdollista tarjota kuluttajaasiakkaille maksuttomia ja maksullisia Palveluja. Apua asennusongelmiin ja muihin kysymyksiin saat sähköpostilla Content Gateway tuesta osoitteesta content.provider@sonera.com. Lähetä kaikki laskutukseen, sopimukseen ja konfiguraatiomuutoksiin liittyvät kysymykset ja pyynnöt osoitteeseen content.provider@sonera.com. TeliaSonera Finland Oyj/Customer Service content.provider@sonera.com 3 CGW 4.0 VERSION MUUTOKSET Kun tässä dokumentissa myöhemmin viitataan CGW3 versioon, tarkoitetaan kaikkia CGW 4.0 versiota edeltäviä versiota jos ei muuta erikseen mainita. Protokollarajapinnat ja kirjastot on pyritty pitämään mahdollisimman pitkälle taaksepäin yhteensopivina. Luvussa 11.1 on kuvattu poikkeukset yhteensopivuuteen. Myös laskutuksen ohjaus sovellusrajapinnassa on pyritty pitämään mahdollisimman yhteensopivana. Katso luvusta 9. uudet mahdollisuudet. HUOMAA: TeliaSoneran CGW 4.0 installaatiossa on joitakin eroja CCC Groupin CGW 4.0 -tuotteeseen. Jos CCC Group:in dokumentaation ja tämän dokumentin välillä on eroja, käytä ensisijaisesti tätä dokumenttia palveluiden toteuttamiseen. TeliaSoneran CGW 4.0 installaatiossa ei ole käytössä kaikkia CCC Groupin CGW 4.0 tuotteen ominaisuuksia. Esimerkiksi: o SMPP tunnelointi ei ole tuettu. o Windows TestPhone sovellus ei ole tuettu. TeliaSoneran installaatiossa on ominaisuuksia joita CCC Groupin tuotteessa ei ole. o Web TestPhone sovellus. o Raportit ovat erilaisia. Admin näyttöjen ulkonäkö ja osittain myös palveluiden konfigurointiin liittyvät parametrit saattavat poiketa perustuotteesta. 3.1 Windows Remote Control on korvattu Web käyttöliittymällä. Palvelujen hallintaan, Provider Serverin konfigurointiin ja järjestelmän tilan seurantaan käytetään web-käyttöliittymää.

6 (44) 3.2 Palvelutyypit: Kaikki palvelumuutokset aktivoituvat heti. Remote Control web-käyttöliittymä vaatii tiukempaa käyttäjätunnusten ja käyttäjätasojen hallintaa kuin vanha Windows ohjelma. Tutustu huolella asennusohjeeseen. Remote Control ohjelman vanhaa versiota voi käyttää logien seurantaan ja vastaanottajaryhmien luontiin. Se ei kuitenkaan ole enää tuettu eikä sitä koskeviin kysymyksiin enää vastata. Content Gateway järjestelmässä käytetään neljää palvelutyyppiä: 1) Send Only palvelu vain lähettää viestejä tietojärjestelmästä puhelimeen. 2) Receive Only palvelu vain vastaanottaa puhelimesta saapuvia viestejä. 3) Query/Reply palvelu vastaanottaa viestin puhelimesta ja palauttaa vastauksen puhelimeen. 4) Push palvelu, jota käytetään vastaanottajalle maksullisten palveluiden toteuttamisessa. 3.3 Kaikki palvelutyypit tukevat SMS ja MMS -viestejä Kaikki palvelutyypit Send Only, Receive Only, Query/Reply ja Push tukevat sekä teksti- että multimediaviestejä. Query/Reply palvelutyypissä tilaus voidaan vastaanottaa tekstiviestillä ja vastaus lähettää multimediaviestinä. HUOMAA: Receive Only- ja Query/Reply- palveluissa hakusanatunnistusta ei voi käyttää MMS viesteille. 3.4 Query/Reply -palvelujen timeout aika on aina kymmenen minuuttia CGW 4.0 versiossa palvelujen timeout -aika on kaikille Query/Reply tyyppisille palveluille kymmenen minuuttia. Palvelun timeout tarkoittaa aikaa, jonka sisällä palvelulta on tultava vastaus puhelimesta lähetettyyn viestiin, jotta tapahtuma veloitetaan Loppukäyttäjältä. HUOMAA:. Viestiliikenne laskutetaan myös timeout ajan ylittyessä vaikka Loppukäyttäjälaskutus perutaan. HUOMAA: Tapahtuman Loppukäyttäjälaskutus peruuntuu myös jos palvelu ei kuittaa viestiä vastaanotetuksi tai viestin välityksessä tapahtuu virhe. 3.5 Query/Reply palvelun vastausta ei tarvitse lähettää saman yhteyden kautta Query/Reply palvelun vastausta ei tarvitse lähettää saman yhteyden kautta. Riittää että tapahtuman session-id on mukana vastauksessa. On suositeltavaa käyttää samaa palvelutunnistetta kuin alkuperäisessä puhelimesta tulleessa viestissä. Vastaus voidaan lähettää myös eri protokollalla ja eri viestityypillä kuin alkuperäinen tilausviesti. Esimerkiksi Java kirjastolla vastaanotettuun SMS viestiin voidaan lähettää vastauksena MMS viesti HTTP protokollalla. 3.6 Palvelujen loppukäyttäjähinnat asetetaan Provider Admin käyttöliittymässä Palveluntarjoaja asettaa Palvelujen loppukäyttäjähinnat Remote Control web-käyttöliittymässä.

7 (44) Palvelujen loppukäyttäjähinnoittelu on mahdollista, kun Palveluntarjoaja ja Sonera ovat tehneet Palvelutuotannon ratkaisun Viestirajapintasopimuksen, johon on liitetty laskutuspalvelu. 3.7 Konfiguroitua Palvelun loppukäyttäjähintaa voi muuttaa paluuviestillä Kun sovellus vastaa puhelimesta tulleeseen viestiin, voidaan tapahtuman loppukäyttäjähintaa muuttaa. Rajoituksena kuitenkin on, että hinnan pitää olla alempi kuin palvelulle käyttöliittymässä konfiguroitu loppukäyttäjähinta. Loppukäyttäjähinnan muuttaminen toimii vain Query/Reply- ja push palvelutyypeissä. 3.8 Push palvelussa palvelun loppukäyttäjähintaa voi muuttaa Push palvelussa kunkin lähetetyn viestin loppukäyttäjähintaa voi muuttaa Palvelulle konfiguroidusta hinnasta. Rajoituksena on, että hinnan on oltava alempi kuin palvelulle käyttöliittymässä konfiguroitu hinta. 3.9 Push palvelut toimivat kuten muutkin palvelut Push palvelu voidaan toteuttaa käyttäen mitä tahansa tuettua protokollaa. Lähtevässä viestissä on oltava Push palvelun palvelutunniste asetettuna. 3.10 Push palvelujen tilauslogiikka Push palvelu tilataan lähettämällä viesti, jossa on palvelulle konfiguroitu hakusana palvelulle konfiguroituun lyhytnumeroon. Palvelun tilannut loppukäyttäjä saa välittömästi viestin lähetyksen jälkeen kuittauksen tilauksesta tekstiviestinä Soneran lähettämänä. Soneran asiakaspalvelu voi pyydettäessä poistaa push-palvelusta Soneran automaattisesti lähettämät viestit. HUOMAA: Push palvelu aktivoituu vasta 1 minuutti tilauksen jälkeen. Tilaaja voi milloin tahansa sulkea palvelun tekstiviestillä. 3.11 Viivästyneet toimituskuittaukset toimivat CGW4 toimittaa tarvittaessa myös viivästyneet toimituskuittaukset. Katso luku 10.2. 4 CONTENT GATEWAY JÄRJESTELMÄN KÄYTTÖÖNOTTO 4.1 Lataa ohjelmiston uusin versio Soneran www- sivuilta Ohjelmiston ja ohjelmointirajapinnan uusin versio on saatavilla Soneran Internet sivulta osoitteesta: http://www.sonera.fi/contentgateway. Sivulta saat ladattua versiot seuraaville käyttöjärjestelmille: - Windows NT/2000/XP - HP-UX - Linux - Solaris

8 (44) 4.2 Asenna ohjelmisto 4.2.1 Windows asennus Serveriasennusta varten tarvitaan Windows NT, Windows 2000, Windows XP työasema tai serveri, jossa on n. 10 MB vapaata levytilaa. Windows asennusohjelma on cgwsetup.exe. 1. Jos valitsit asennustavan 1) poista vanha CGW -versio ennen uuden version asennusta. Tee varmuuskopio konfiguraatiotiedostoista ja lisenssitiedostosta (*.cnf, *.lic) ennen päivitystä. 2. Käynnistä asennusohjelma cgwsetup.exe. 2. Hyväksy lisenssiehdot. 3. Valitse hakemisto johon ohjelmisto asennetaan.

9 (44) 4. Valitse asennustyyppi. - Typical -asennus asentaa kaikki ohjelmistot. Käytä tätä jos erityistä syytä muiden asennuksien käyttöön ei ole. - Compact asennus asentaa vain Provider Server ohjelman. - Custom asennuksessa voit valita mitä ohjelmistoja asennetaan. 4a. Jos valitsit Custom -asennuksen, valitse asennettavat komponentit. - Test Installation for Server Components and Applications asentaa Provider Server ohjelmiston ja esimerkkisovellukset normaalisti. Valitse tämä jos haluat testata CGW4.0 versiota vanhan version rinnalla samassa koneessa. Huomaa että asennus vaikuttaa järjestelmän käyttämiin porttinumeroihin. Esimerkiksi Admin portti on 50081. Tarkista porttinumerot asennushakemiston provider.cnf tiedostosta.

10 (44) - Server Components and Applications asentaa Provider Server ohjelmiston ja esimerkkisovellukset normaalisti. - Send applications asentaa SMS-lähetysohjelmat. Käytä tätä asennusta kun asennat ohjelmiston koneelle, josta vain lähetetään SMS-viestejä Provider Server koneen kautta. - Documents asentaa dokumentaation Adobe Acrobat muodossa. - cpp asentaa C++ -kirjastot ja esimerkkiohjelmat. - java asentaa Java kirjastot ja esimerkkiohjelmat. - activex asentaa ActiveX komponentin. 5. Asennus on valmis. Jos ohjelmisto ei käynnisty välittömästi, käynnistä kone uudelleen. Content Gateway Windows Service (eli ProviderServer.exe ohjelma) käynnistyy oletusarvoisesti automaattisesti, kun kone käynnistetään.

11 (44) Jos Content Gateway ei asennu Windows Serviceksi (eli sitä ei löydy Control Panelin Services hallintatyökalulla) tee näin: - Avaa komentorivitulkki - Siirry CGW 4.0 asennushakemistoon - Kirjoita komennot: o providerserver install o net start providerserver 6. Siirry lukuun 4.3. 4.2.2 HP-UX/Linux/SunOS -asennus Serveriasennusta varten tarvitaan Linux, HP-UX tai SunOS -kone, jossa on n. 10 MB vapaata levytilaa. HP-UX/Linux/Sun -versioita varten ei ole asennusohjelmaa. Ohjelmat ovat gzip pakatuissa tar tiedostoissa (cgw40_hpux1020.tar.gz, cgw40_hpux1100.tar.gz, cgw40_sunos.tar.gz, cgw40_linux.tar.gz). Tämä ohje kuvaa Linux asennuksen, mutta muut asennukset tapahtuvat samalla tavalla: Suunnittele asennus luvun 4.2 ohjeiden mukaan. 1. Tee asennushakemisto ja mahdollisesti oma käyttäjätunnus cgw:lle. Esimerkiksi: mkdir /home/cgw40 cd /home/cgw40 2. Pura tiedostot tar -arkistosta. Huomaa että jos olet päivittämässä ohjelmistoa, kaikki konfiguraatiotiedostot (.lic,.cnf) kannattaa kopioida talteen ennen päivitystä ja palauttaa päivityksen jälkeen alkuperäiseen hakemistoon. gunzip cgw40_linux.tar.gz tar xvf cgw40_linux.tar 3. Jos asennat CGW 4.0:n vanhan CGW version rinnalle muistaa muuttaa provider.cnf tiedostoon porttinumerot sellaisiksi että ne eivät ole käytössä vanhalla CGW:llä. Muista testin jälkeen poistaa vanhan CGW.n käynnistys ja asettaa uuden version crypted-port samaan arvoon joka oli käytössä vanhalla CGW:llä. 4. Käynnistä Provider Server ProviderServer provider.cnf & 5. Lisää Provider Server ohjelman käynnistys koneen käynnistysskripteihin. Tämä vaihe ei ole välttämätön, mutta ilman tätä Provider Server ei käynnisty automaattisesti kun kone käynnistyy. Oikea skripti riippuu käyttöjärjestelmästä. Katsoa manuaalisivulta esimerkiksi man rc, man rc.config. Esimerkiksi Linuxissa voit tehdä automaattikäynnistyksen näin: - Tee /home/cgw hakemistoon skripti start, jonka sisältö on seuraava: nohup ProviderServer provider.cnf & - Lisää /etc/rc.d/rc.local tiedostoon rivi (tässä oletetaan että ProviderServeriä ajetaan cgw käyttäjätunnuksella): 6. Siirry lukuun 4.3. su cgw -c /home/cgw/start

12 (44) 4.3 Ota yhteys CGW4:ään WWW-selaimella Kun uusi Provider Server ohjelma on käynnissä, ota yhteys ylläpitokäyttöliittymään WWW selaimella. Oletusarvoisesti ylläpitokäyttöliittymä on porttinumerossa 8081. Esimerkiksi jos Provider Server koneen osoite on sms.company.com, URL admin käyttöliittymään on oletusasetuksilla http://sms.company.com:8081. Jos olet samalla koneella kuin Provider Server, myös URL http://localhost:8081 toimii. HUOMAA: Jos valitsit ohjelmiston Windows asennuksessa testiasennuksen niin porttinumero on 50081. Eli URL on silloin esimerkiksi http://localhost:50081. Jos annoit URL:in oikein selain kysyy CGW Provider Serverin käyttäjätunnusta ja salasanaa: 4.4 Asenna lisenssi Ensimmäisellä sisäänkirjautumiskerralla voit antaa minkä tahansa käyttäjätunnuksen ja salasanan. Muuta ne luvun 4.6 ohjeiden mukaan. HUOMAA: Ensimmäisellä kerralla sisäänkirjautumisessa antamasi salasana tallentuu järjestelmän käyttäjärekisteriin vain siksi aikaa kuin Provider Server ohjelmisto on käynnissä. Talleta se luvun 4.7 ohjeiden mukaisesti. Sinun pitää myöhemmin käyttää täsmälleen samaa salasanaa kuin ensimmäisessä sisäkirjautumisessa ennen kuin muutat sen. Jos oikea sivu ei tule näkyviin, testaa CGW yhteyden toiminta (kts. luvut 5 ja 4.9). VINKKI: Jos portti 8081 on varattu muuta admin portin porttinumero provider.cnf tiedostosta ja käynnistä Provider Server ohjelma uudelleen: http-admin-port 8081 VINKKI: Jos unohdat käyttäjätunnuksen/salasanan, sammuta Provider Server ja editoi auth.cnf tiedostoa siten että kirjoitat siihen salasanan selkokielisenä. Esimerkiksi jos rivi auth.cnf tiedostossa on: peter =nxffxgffghi5pyfxxubxrx== admin ja haluat asettaa salasanaksi abc123 muuta rivi seuraavasti: peter abc123 admin Käynnistä muutoksen jälkeen Provider Server uudelleen. Lisenssitiedosto toimitetaan sähköpostilla, kun palvelusopimus Soneran kanssa on tehty. Lisenssitiedosto on asennettava, ennen kuin viestejä pystyy lähettämään puhelimeen tai vastaanottamaan puhelimesta. Jos olet päivittämässä CGW:n vanhaa versiota CGW4-versioon, et tarvitse uutta lisenssiä vaan voit käyttää vanhaa lisenssiä. Kun sisäänkirjautuminen on onnistunut järjestelmä pyytää lisenssiä jos sitä ei ole sille vielä konfiguroitu:

13 (44) Avaa lisenssitiedosto mihin tahansa tekstieditoriin ja kopioi lisenssin koko teksti leikekirjaan. Liitä sitten kopioitu teksti tyhjään kenttään ja talleta lisenssi: Paina sitten Connect painiketta. Jos Connect:in painamisen jälkeen yhteys ei muodostu tarkista yhteydet luvun 5. ja 4.9 ohjeiden mukaisesti. 4.5 Konfiguroi ylläpitokäyttöliittymän käyttäjät, käyttäjäryhmät ja salasanat Käyttäjien konfigurointisivun saa näkyviin admin sivujen linkin User Authentication kautta. Tämän voit tehdä myös ennen palveluiden siirtoa. CGW 4.0:ssa jokaisella käyttäjällä on erittäin suositeltavaa olla henkilökohtainen käyttäjätunnus ja salasana. Käyttäjät kuuluvat kahteen ryhmään: 1) admin ryhmään kuuluvalla käyttäjällä on täydet oikeudet Provider Serverin asetusten ja palvelujen tietojen muokkaamiseen. 2) user ryhmään kuuluvat voivat muokata palvelujen konfiguraatiota ja Loppukäyttäjähintoja.

14 (44) 4.6 Testaa järjestelmän ja yhteyksien toiminta Sen varmistamiseksi että yhteyskonfiguraatiot ovat varmasti oikein kannattaa tehdä tässä luvussa kuvatut testit. Yhteysongelmat ovat järjestelmähäiriöiden tyypillisin syy. Nämä testit kannattaa tehdä vasta lopullisella tuotantojärjestelmällä. 4.6.1 Testaa viestin lähetys matkapuhelimeen Lähetä Wsend tai send ohjelmalla viesti omaan liittymääsi. Send ohjelmalla seuraavasti: kirjoita> send s12345 r0401234567 hlocalhost m Testiviesti SENT: 0401234567 Delivered to the SMSC tai Wsend ohjelmalla: Muista ennen lähetystä asettaa Wsend ohjelman Setup näytöllä lähettäjän numero ja Provider Server koneen osoite. Lähetys toimii oikein, jos viesti tulee puhelimeesi. Send ohjelma löytyy CGWohjelmiston asennushakemistosta. Jos kokeilet lähetystä jollain muulla koneella kuin sillä missä Provider Server ohjelmisto on, korvaa localhost Provider Server koneen osoitteella. 4.6.2 Testaa viestin vastaanotto puhelimesta Kytkeydy ProviderServer koneeseen Web selaimella (kts. 4.4). Voit vaihtoehtoisesti tarkastaa testin tuloksen myös suoraan logitiedostoista. Käynnistä myös sovellus jolla haluat toimintaa testata. Huomaa että ennen testejä sinun pitää määritellä Admin -sivustolla palvelu joka vastaanottaa viestit. Yksinkertaisinta on luoda Receive Only -palvelu joka tallettaa vastaanotetut viestit tekstitiedostoon. Esimerkiksi seuraavat asetukset riittävät viestien vastaanottoon: Name Test

15 (44) Short number Service keyword Application URI <testattava lyhytnumero> <jätä tyhjäksi> file://received.txt 4.6.3 Testipuhelin Ota Web Admin käyttöliittymästä näkyviin logit. Huomaa että logisivu ei päivity automaattisesti, vaan sinun pitää klikata uudelleen Log linkkiä kunnes tapahtuma näkyy logisivulla. Lähetä sen jälkeen viesti, jossa on palvelulle konfiguroitu hakusana palvelun lyhytnumeroon ja odota vastausta palvelulta. Jos puhelimeen tulee virheviesti Palvelu on tilapäisesti pois käytöstä. Yritä myöhemmin uudelleen. ja Web Admin ohjelman Log -näytöllä ei näy mitään, on yhteydessä ongelmia. Todennäköisesti yrityksesi palomuuri estää yhteyden. Katso luku 5 (Palomuuri ja yhteysasetukset). Jos taas Log -näytöllä näkyy viestiliikenne, on yhteys operaattoriin kunnossa, mutta joko palvelussa tai viestin reitityskonfiguraatiossa on ongelmia. Jos puhelimeen tulee virheviesti Palvelua ei tunnistettu. Tarkista että lyhytnumero ja hakusana ovat oikein, ei palvelujen konfiguraatio ole oikein tai lähetit väärän hakusanan. Tarkista molemmat tapaukset. Palveluiden testaamiseen voit käyttää Testipuhelin sovellusta. Vanhasta versiosta poiketen Testipuhelin toimii Admin web sivujen kautta. Testipuhelin on tarkoitettu helpottamaan testi SMS viestien lähettämistä. Vastausviestit lähetetään oikeaan puhelimeen. Testipuhelimesta lähetettyä SMS viestiä ei voi erottaa mitenkään oikeasta puhelimesta lähetetystä viestistä. Sen vuoksi ennen kuin voit käyttää testipuhelin sovellusta siinä käytettävä liittymänumero varmennetaan oikeaan puhelimeen lähetettävällä PIN koodilla. 4.6.4 Current Messages raportti Current Messages raportilta näet viimeisen viidentoista minuutin aikana käsitellyt viestit, niiden statuksen ja loppuasiakasveloituksen. Kenttien merkitys on kerrottu raporttisivulle. HUOMAA: Sivulla näytetään enintään 200 viimeistä tapahtumaa.

16 (44) HUOMAA: Current messages raportti antaa vain viitteellisen tiedon laskutuksen onnistumisesta, jonka voi faktisesti tarkistaa vain Soneran laskutusjärjestelmästä tai loppukäyttäjän laskulta. 4.6.5 Testaa palomuurit ja yhteyskonfiguraatiot Jos palomuuri estää yhteyden Soneralta yrityksesi Provider Serveriin, todennäköisesti palvelut eivät toimi yhteyskatkojen jälkeen oikein eikä puhelimesta lähetettyjä viestejä voida toimittaa. Ensimmäiseksi: sammuta Provider Server ohjelma ja käynnistä se uudelleen (Windows ympäristössä vaikka komennoilla net stop providerserver ja net start providerserver, nix ympäristöissä tapa ohjelma kill komennolla ja käynnistä se uudelleen). Toista sitten kohdan 4.9.2 testi, mutta älä ota yhteyttä Provider Serveriin ennen kuin lähetät testiviestin. Jos Web Admin sivuilla näkyy virhe, tarkista että edes yhteys Soneralle toimii: A) Varmista että Provider Server koneen nimipalvelu toimii oikein. kirjoita> nslookup cgw.mobile.sonera.net Name: cgw.mobile.sonera.net Address: 195.156.25.22 Jos nimipalvelu ei ole kunnossa, on kolme vaihtoehtoa korjaamiseen: 1) Korjaa nimipalvelu. 2) Lisää koneen hosts tiedostoon rivi 195.156.25.22 cgw.mobile.sonera.net 3) Tai editoi lisenssitiedostoa provider.lic siten että korvaat rivin: operator-server cgw.mobile.sonera.net rivillä: operator-server 195.156.25.22 Käynnistä tämän jälkeen Provider Server uudelleen.

17 (44) B) Varmista että yhteys Soneralle toimii oikein. Tyypillisesti yrityksen palomuuri on auki niin, että yhteys toimii oikein. Joissakin tapauksissa yhteydet ulospäin on estetty. Testaa yhteys esimerkiksi telnet -ohjelmalla seuraavasti: kirjoita> telnet cgw.mobile.sonera.net 31779 Jos kaikki toimii oikein, niin yhteys muodostuu, mutta se katkeaa heti kun kirjoitat jotain telnet ikkunaan. Jos yhteys telnetillä ei muodostu, niin ongelma korjataan avaamalla yrityksen palomuuri. Jos käytössä on Datanet, varmista että yhdysliikenneavaus on tehty oikein. Soneran palomuuri osoitteessa cgw.mobile.sonera.net, portti 31779 on auki. 5 PALOMUURI JA YHTEYSASETUKSET Soneran ja yrityksen verkon välille on sallittava seuraavat yhteydet: Provider Server kytkeytyy Operator Serveriin (Soneran palvelin) osoitteeseen cgw.mobile.sonera.net (195.156.25.22), portti 31779. Soneran palomuuri on valmiiksi auki kaikille. Operator Server kytkeytyy Provider Serveriin (Yrityksen palvelin) yrityksen antamaan osoitteeseen porttiin 31779. Eli Provider Server koneen porttiin 31779 pitää sallia pääsy yrityksen verkon ulkopuolelta osoitteesta cgw.mobile.sonera.net (195.156.25.22). Provider Serverin muihin portteihin tai muista koneista ei pidä sallia yhteyttä yrityksen verkon ulkopuolelta. Huomaa että Windows version testimoodiasennus käyttää porttinumeron 31779 sijasta porttia 50079. Avaa yhteys aina ennen testejä Provider Serveriltä päin ja kun testit ovat valmiit joko vaihda porttinumero 50079 normaliksi konfiguraatiotiedostoon provider.cnf tai sitten poista testiasennus ja tee normaaliasennus. Huomaa että jos olet muuttanut crypted-port asetusta pitää muutos ilmoittaa myös operaattorille ja tehdä palomuuriavaus siten että operaattori voi avata yhteyden konfiguroimaasi porttiin. Palomuurista kannattaa poistaa connection timeout asetus CGW yhteyden osalta. Yhteys Soneran Operator Serveriltä Provider Serveriin on tarpeen avata vain, jos halutaan vastaanottaa viestejä matkapuhelimelta (MO-liikenne). Viestin lähettämiseen riittää yhteys Soneran palvelimeen (MT-liikenne). 6 PORTTINUMEROT Porttinumerokonfiguraation näkee helpoimmin Web Admin käyttöliittymästä Connections linkin takaa. Provider Server ohjelman käyttämät porttinumerot ovat oletusasennuksella seuraavat: http-admin-port 8081 # Admin käyttöliittymä crypted-port 31779 # Operaattori ottaa yhteyden tähän porttiin salatulla yhteydellä app-port 31771 # Windows ohjelmien ja C++ -ohjelmien käyttämä portti http-port 8080 # HTTP protokollan portti text-port 21772 # Java API:n ja OTP protokollan portti

18 (44) Windowsin testimoodiasennuksessa ne ovat (ota huomioon sovelluksissa): http-admin-port 50081 # Admin käyttöliittymä crypted-port 50079 # Operaattori ottaa yhteyden tähän porttiin salatulla yhteydellä app-port 50071 # Windows ohjelmien ja C++ -ohjelmien käyttämä portti http-port 50080 # HTTP protokollan portti text-port 50072 # Java API:n ja OTP protokollan portti 7 KÄSIN TEHTÄVÄT KONFIGUROINNIT (HTTP, OTP, JAVA API) CGW 4.0 versiossa voit editoida konfiguraatiotiedostoa Web Admin käyttöliittymän linkin Configuration kautta. Huomaa että asetusten talletus katkaisee kaikki yhteydet ja käynnistää serverin uudelleen. Web Admin sivujen oletusporttinumero on 8081. Jos haluat muuttaa sen, editoi konfiguraation riviä: http-admin-port 8081 Jos haluat käyttää HTTP protokollaa viestien lähettämiseen matkapuhelimeen, on konfiguraatioon lisättävä http-port rivi. Esimerkiksi: http-port 7080 Lähetys tapahtuu esimerkiksi näin: http://localhost:7080/send?from=12345&to=0401234567&msg=tämä+on+testi Jos käytät Java API:a tai tekstiprotokollaa (OTP) lisää konfiguraatioon rivi: text-port 21772 Jos haluat käyttää UCP/EMI protokollaa viestien lähettämiseen, lisää konfiguraatioon rivi: emi-port 5123 8 MULTIMEDIAVIESTI TUEN KÄYTTÖÖNOTTO Sonera käyttää Nokian valmistamaa multimediaviestikeskusta (MMSC). Content Gateway tarjoaa saman EAIF rajapinnan kuin suora yhteys MMSC:lle (EAIF = External Applications Interface). Nokian tarjoama Java kirjasto toimii sellaisenaan Content Gateway:n läpi. MMS Sovelluskehitykseen tarvittavat ohjeet ja kirjastot on saatavilla Nokian Internet-sivuilta osoitteesta www.forum.nokia.com. Content Gateway:n MMS tuki vaatii toimiakseen seuraavat ohjelmistot ja kirjastot 1) Content Gateway versio 4.0 tai uudempi. 2) Sovelluskehitystä varten Nokian MMS Java API kirjasto tai muu ohjelmisto joka muodostaa viestit Nokian MMSC:n ymmärtämässä muodossa.

19 (44) 8.1 MMS tuen vaatimat asetukset 8.2 MMS rajoituksia 1) Varmista mitä HTTP porttia Provider Server kuuntelee. Tämän näkee Web Admin käyttöliittymästä Connections linkin takaa. Oletusarvoisesti porttinumero on 8080. Lähetä viestit ko. porttinumeron kautta. Älä käytä http-admin porttia viestien lähettämiseen. 2) Jos ainoastaan lähetät viestejä puhelimeen, riittää että yksi Send Only tyyppinen palvelu on olemassa. Käytännössä näin on aina koska id:llä 1 olevaa Send Only palvelua ei pysty poistamaan. 3) Jos haluat vastaanottaa viestejä puhelimesta, konfiguroi yksi Receive Only tyyppinen palvelu, jolla ei ole hakusanaa ja salli sille MMS viestien vastaanotto. Hakusanatunnistus ei toimi. Kun konfiguroit palvelun jolle haluat vastaanottaa puhelimesta lähetettyjä viestejä, älä aseta palvelulle hakusanaa. MMS palvelut toimivat vain HTTP protokollalla. Asynkroniset sovellukset eivät ole tuettuja. Filtering tyyppiset sovellukset eivät ole tuettuja. Puhelimien rajoituksista johtuen ensimmäiset testit kannattaa tehdä pelkällä tekstisisällöllä. Palveluntarjoajille varattu kapasiteetti on rajoitettu noin yhteen multimediaviestiin sekunnissa. Älä lähetä viestejä samanaikaisesti rinnakkaisilla yhteyksillä. Jos lähetät saman viestin usealle vastaanottajalle, älä lähetä viestejä erikseen vaan aseta yhdelle viestille monta vastaanottajaa. MT suunnassa viestin koko on rajattu 300 Kilotavuun. 8.3 MMS -päätelaitteen asetukset MMS asetukset päätelaitteeseen saa lähettämällä viestin asetukset puhelinmalli numeroon 15400. Esimerkiksi asetukset nokia 3120. 9 LOPPUKÄYTTÄJÄN LASKUTTAMINEN Tämä kappale koskee vain Soneran Palvelutuotannon ratkaisun Viestirajapintasopimuksen solmineita. Tässä kappaleessa kuvataan, miten Sonera edellyttää loppukäyttäjälaskutuksen tapahtuvan, kuinka se toimii teknisesti ja miten sitä ohjataan sovellus-/protokollatasolla. 9.1 Soneran ohjeet Loppukäyttäjien laskuttamiseen 1. Loppukäyttäjille tarjottavan Palvelun tulee olla Soneran ohjeiden mukaisesti toteutettu. 2. Loppukäyttäjää saa laskuttaa Palvelun ilmoitetulla täydellä hinnalla ainoastaan hänelle onnistuneesti lähetetystä palvelusta. 3. Loppukäyttäjää ei saa laskuttaa hänen tekemästään inhimillisestä virheestä Palvelun tilauksessa enempää kuin Soneran kulloinkin voimassaolevan niinsanotun yleisen SMS tariffin verran.

20 (44) 4. Soneran yleinen SMS tariffi virheelliselle Palvelun tilaukselle on 1.7.2010 lähtien 0,11 (0,14) euroa. 23 % arvonlisäverollinen hinta sulkeissa (). 5. Loppukäyttäjän inhimilliseksi virheeksi katsotaan sellainen viesti ja/tai tilauspyyntö, joka on lähetetty esimerkiksi väärään numeroon tai väärällä tai virheellisellä tilauskoodilla/hakusanalla. 6. Palveluntarjoaja on velvollinen hyvittämään Loppukäyttäjälle virheellisesti toteutuneen laskutuksen. 7. Jos Loppukäyttäjä reklamoi Palvelun laskutuksesta Palveluntarjoajalle, Palveluntarjoaja on velvollinen ilmoittamaan asiasta Soneralle. 8. Loppukäyttäjän reklamoidessa Palvelusta Soneralle, Palveluntarjoajan on Soneran vaatiessa esitettävä selvitys Loppukäyttäjälle toimitetusta Palvelusta ja Loppukäyttäjän laskutuksesta. 9. Jos Palveluntarjoaja havaitsee, että Loppukäyttäjää on laskutettu virheellisesti tai väärin perustein, Palveluntarjoaja on velvollinen ilmoittamaan asiasta Soneralle niin pian kuin mahdollista ja toimittamaan Soneralle tarpeelliset tiedot virheellisen laskutuksen korjaamiseksi. Jos Palveluntarjoaja ei muistutuksesta huolimatta noudata edellä kuvattuja ohjeita tai Palvelutuotannon Ratkaisun sopimusehtoja, Soneralla on oikeus sulkea Palvelu tai Palvelutuotannon Ratkaisu. 9.2 Yleistä laskutusmahdollisuuksista Laskutus perustuu siihen että, Sonera tunnistaa puhelimesta lähetetyn viestin ja laskuttaa viestin lähettänyttä loppukäyttäjää Palvelulle määritellyn Loppukäyttäjähinnan mukaisesti. Myös vastaanottajalle maksullisten palveluiden laskutus ( Push ) on mahdollista. Palvelu tunnistetaan lyhytnumeron ja mahdollisesti hakusanan perusteella. Laskutettavat palvelut voivat olla Query/Reply, Receive Only tai Push - tyyppisiä. Query/Reply tyyppiseksi määritellyn palvelun pitää toimia niin, että Loppukäyttäjän lähettämään viestiin vastataan saman tapahtumakohtaisen tunnisteen (Session id) sisältävällä viestillä 10 minuutin sisällä viestin vastaanottamisesta. Jos vastausviesti puuttuu, viestin lähettänyttä loppukäyttäjää ei laskuteta. Palveluntarjoajaa laskutetaan tässäkin tapauksessa lähetetyistä ja vastaanotetuista viesteistä. Receive Only tyyppinen palvelu vain vastaanottaa viestin eikä lähetä vastausta asiakkaalle. Loppukäyttäjälaskutus tapahtuu pelkästään puhelimesta saapuneen viestin perusteella. Jos palvelu lähettää vastauksen on käytettävä palvelutyyppinä Query/Reply. Vain silloin varmistetaan, että loppukäyttäjä maksaa saamastaan palvelusta. Push palvelun laskutus toimii siten että loppukäyttäjää veloitetaan puhelimeen lähetetystä viestistä. Vastaanottaja maksaa -laskutus toimii vain silloin kun loppukäyttäjä on tilannut palvelun, saldoraja ei ole täyttynyt eikä loppukäyttäjällä ole palveluestoja. Loppukäyttäjä tilaa Push palvelun lähettämällä hakusanan sisältävän viestin palvelun lyhytnumeroon. Tilauksen jälkeen CGW järjestelmä lähettää automaattisesti tilausvahvistuksen loppukäyttäjälle. Tilausvahvistuksessa kerrotaan palvelun nimi, palvelun Viestikohtainen hinta, palveluntarjoajan nimi ja ohjeet palvelun sulkemiselle. 9.3 Miksi laskutus epäonnistuu? Yleisimmät syyt tapahtuman Loppukäyttäjälaskutuksen peruuttamiseen ovat seuraavat: