PRODUKTBESKRIVELSE. NRDB Nummerforespørsel

Transkript

1 PRODUKTBESKRIVELSE NRDB Nummerforespørsel Versjon 1.2, juni 2007 Nasjonal referansedatabase AS, c/o Infostrada AS, St Olavs plass 3, N OSLO Side 1 av 6

2 Innholdsfortegnelse 1. INNLEDNING NRDB NUMMERFORESPØRSEL BESKRIVELSE AV TJENESTEN KRAV FOR TILKNYTNING OG BRUK AV TJENESTEN SIKKERHET TEKNISK BESKRIVELSE Systemoversikt Nummerforespørsel API Parameteroversikt TILGJENGELIGHET LEVERANSE BESTILLING FAKTURERING... 6 Side 2 av 6

3 1. Innledning Nasjonal Referansedatabase AS (NRDB) ble etablert i 2000 i forbindelse med innføring av nummerportabilitet (NP) i det norske telemarkedet. NRDB eies av sju teleoperatører og alle teleoperatører som tilbyr nummerportabilitet er kunder. Vi tegner avtaler med de tilbydere som ønsker å ha tilknytning til våre tjenester. NRDB tilbyr et tjenestespekter som er fortløpende utviklet i forhold til markedets ønsker. Vi er selvfinansierende og har kostnadsbaserte tjenester (non-profit). 2. NRDB Nummerforespørsel For tjenesteleverandører av SMS- og MMS-tjenester i det norske markedet er det nødvendig å vite i hvilket fysisk mobilnett en abonnent terminerer for å kunne adressere utsendelse av SMS/MMS til rette SMSC 1 / MMSC 2. Ved å adressere til rett SMSC / MMSC vil tjenesteleverandøren på en effektiv måte kunne overlevere meldingen til mobiloperatøren, som igjen sender meldingen til mottaker (sluttkunde). NRDB Nummerforespørsel er en løsning for tjenesteleverandører av SMS- og MMS-tjenester for oppslag mot en database inneholdende alle mobile nummer med tilhørende identifikasjon av hvilket fysisk mobilnett nummeret hører hjemme i. Ved hjelp av denne tjenesten vil tjenesteleverandøren få informasjon om til hvilken SMSC / MMSC en melding skal sendes uansett opp sluttkundens nummer er portert eller ikke. 3. Beskrivelse av tjenesten 3.1 Krav for tilknytning og bruk av tjenesten NRDB stiller følgende krav til bruk av informasjon utledet fra NRDB Nummerforespørsel tjenesten: - Informasjon om sluttkundes tilbydertilhørighet kan kun brukes til å adressere utsendelse av SMS- og MMS-meldinger i rett fysisk mobilnett (SMSC/MMSC). - NRDB forbeholder seg rettet til å sette en grense for antall oppslag per dag/uke/mnd for å kunne forhindre eventuell misbruk av tjenesten. - Tjenesten vil bare gjøres tilgjengelig for oppslag på mobilnummer. 3.2 Sikkerhet Tjenesten kan kun aksesseres via en på forhånd godkjent IP-adresse. Tilhørende brannmur vil åpnes for denne spesifikke IP adressen. Tilbyder må informere leverandør om hvilken IPadresse som ønskes benyttet. 1 SMSC=Short Message Service Centre 2 MMSC=Multimedia Message Service Centre Side 3 av 6

4 3.3 Teknisk beskrivelse Systemoversikt Figur 1 viser en oversikt over arkitektur og grensesnittene til NRDB oppslag tjenesten. Figur 1 Oversikt arkitektur Kunden kommuniserer med NRDB oppslagsmotor via HTTP eller HTTPS protokollen. Forespørsel fra kunden inneholder MSISDN som parameter og oppslagsmotoren svarer synkront med en XML fil som inneholder MCC, MNC og SPID for dette MSISDN. Oppslagsmotoren håndterer alle forespørsler og utfører søkene mot NRDB noden for å finne porteringsstatus for et gitt MSISDN. Dersom nummeret ikke er portert vil oppslagsmotoren finne nødvendig informasjon fra nasjonal nummerplan Nummerforespørsel API En forespørsel må inneholde MSISDN som parameter. Dette må være et gyldig norsk MSISDN, et ugyldig nummer vil gi feilkode tilbake. Det er kun mulig å forespørre på et MSISDN om gangen. Eksempel: Parameteroversikt Navn Msisdn Serviceid Username Password Forklaring Mobilnummeret som det skal gjøres oppslag for. Identifikator for kundens tjeneste, (1 hvis ikke annet oppgis av NRDB). Brukernavn for kunden på tjenesten, oppgis av NRDB. Passord for kunden på tjenesten, oppgis av NRDB. Innholdet til msisdn valideres på oppslagserveren. Gyldige formater er: Side 4 av 6

5 msisdn uten landskode, for eksempel msisdn med norsk landskode prefikset med +, for eksempel msisdn med norsk landskode prefikset med 00, for eksempel serviceid er et heltall. Tallet 1 brukes hvis ikke annet oppgis av NRDB ved opprettelse av tjenesten. username og password brukes for autentisering mot oppslagserveren. Oppgis av NRDB ved opprettelse av tjenesten. Svaret fra oppslagsmotoren gis i XML. XML filen inneholder feltet errorcode. Dersom denne verdien er 0 var oppslaget vellykket, alle andre verdier indikerer en feil og alle andre felter bortsett fra MSISDN vil få verdien 1. Eksempel på vellykket oppslag (med forbehold om endringer i format): <?xml version="1.0" encoding="utf-8"?> <PORT> <MSISDN> </MSISDN> <ERRORCODE>0</ERRORCODE> <MNC>1</MNC> Eksempel på mislykket oppslag (med forbehold om endringer i format): <?xml version="1.0" encoding="utf-8"?> <PORT> <MSISDN> </MSISDN> <ERRORCODE>1</ERRORCODE> <MNC>-1</MNC> Parameteroversikt Navn MSISDN Errorcode Forklaring Mobilnummeret som det ble gjort oppslag for. Feilkode for oppslaget. Dersom feilkode er lik 0 var oppslaget vellykket. Se tabell nedenfor for oversikt over feilkoder. MNC Identifikator for hvilket nett abonnenten er i. MCC Identifikator for hvilket land abonnenten er i. SPID Operatøren til abonnenten. Side 5 av 6

6 Feilkoder Kode 1 Forklaring Ikke gyldig MSISDN. 2 Nummeret finnes ikke portert eller i aktiv nummerplan. 3 Intern systemfeil 4 Kunden har overskredet grensen for antall forespørsler per døgn. 5 Ingen tilgang, feil i brukernavn eller passord. Eller brukernavn / passord stemmer ikke overens med serviceid. 4. Tilgjengelighet NRDB garanterer en tilgjengelighet til tjenesten på 99,6% målt innenfor tidsperioden mandag fredag 08:00-16:00 over 1 år. Unntatt fra tilgjengelighetsgarantien vil være på forhånd varslede driftsforstyrrelser, samt driftsforstyrrelser forårsaket av leverandør på Internett-tilknytning. 5. Leveranse Tilbyder tildeles brukernavn og passord og Tjenesten tilgjengeliggjøres av NRDB mot spesifiserte IP-adresser. 5.1 Bestilling For bestilling av NRDB Nummerforespørsel, vennligst send en e-post til info@nrdb.no med følgende informasjon om tilbyder: - Firmanavn - Foretaksnummer - Besøksadresse - Postadresse - Kontaktperson (navn, e-post, telefonnr, mobiltelefonnr) Før Tjenesten kan tas i bruk må det oppgis de IP-adresser som Tjenesten skal brukes fra. 6. Fakturering Tilbydere som benytter NRDB Nummerforespørsel vil faktureres á konto hvert kvartal iht. gjeldende prisliste. Etableringsavgiften vil faktureres i forbindelse med første faktura. Bruk av tjenesten deretter faktureres forskuddsvis per kvartal iht. gjeldende prisliste basert på historiske data for antall oppslag som gjennomføres per periode. Side 6 av 6