Webbtjänstgränssnittet av fi-domännamnsservicen

Web service är ett gränssnitt som använder maskinspråk och möjliggör registrering, förnyelse och förändring av domännamn utan att man behöver ett webbläsarbaserat användargränssnitt. Gränssnittet är avsett endast för tjänsteleverantörer för att bl.a. försnabba registrering av domännamn.

Tjänstegränssnittet uppfyller kraven i WS-I Basic Profile 1.1 standard. Servicebeskrivningen kan laddas här:

Servicebeskrivning [PDF, 158 KB]

Web service demo client (.NET) [ZIP, 121 KB]

Web service demo client (JAVA) [ZIP, 448 KB]

Web service demo client (PHP) [ZIP, 5 KB]

Tjänstens wsdl-beskrivning

Web Services Description Language (wsdl) beskriver webbtjänstgränssnittet ur applikationsutvecklarens synvinkel. Wsdl-beskrivningen kan laddas här:

https://domainws.ficora.fi/fidomain/DomainNameWS_FicoraDomainNameWS.svc?wsdl

Möjligheter som ws-gränssnittet ger

Genom webbtjänstgränssnittet kan tjänsteleverantörerna utföra följande åtgärder på fi-domännamn:

• Ansöka om nytt domännamn
• Förnya ett domännamns giltighetstid
• Ändra namnserver för ett domännamn
• Ta bort tjänsteleverantörens namnservrar från ett domännamn

Användarbehörigheter

Användning av webbtjänstgränssnittet förutsätter kontakt med kundservicen för domännamnssystemet. Kundservicen öppnar åt tjänsteleverantören ett s.k. webbtjänstkonto, genom vilket tjänsteleverantören kan vidta webbtjänstgränssnittets avgiftsbelagda åtgärder. Dessutom postar kundtjänsten till tjänsteleverantören en krypteringsnyckel som behövs för att gränssnittet skall kunna användas.

Betalning av domännamn via web service tjänsten

På grund av web service -gränssnittet introduceras ett nytt betalningssätt, "förhandsbetalning". Användningen av gränssnittets avgiftsbelagda funktioner förutsätter att tjänsteleverantören i förväg har överfört ett visst belopp på sitt användarkonto. Beloppet kan sedan användas för registrering av domännamn mm. Förhandsbetalningen sker i domännamnsservicen. Förhandsbetalningen kan endast användas för att registrera och förnya domännamn i ws-tjänsten, men inte i domännamnsservicen.

Förhandsbetalningen kan inte i det första skedet användas för att betala i domännamnsservicen.

Autentisering

Varje XML-meddelande som ska sändas innehåller en s.k. meddelandekontext, som innehåller en användaridentitet, en tidsstämpel och en MAC-kontrollsträng. Dessa fält används när servicen autentiserar en inkommande tjänstebegäran.

Användaridentitet

Användaridentiteten som läggs till i XML-meddelandet är densamma som tjänsteleverantören använder när denne ska logga in i domännamnssystemet.

Krypteringsnyckel (delad nyckel)

Krypteringsnyckeln är en teckensträng med 24 tecken, som skickas till tjänsteleverantören per post av kundservicen för domännamnssystemet.

Förutsättningarna för tjänsten

• Kundprogram som stöder WS-I Basic Profile 1.1 standard och överensstämmer med service beskrivningen
• Tjänsteleverantören har registrerat sig som tjänsteleverantör i fi-domännamnsservicen på adressen https://domain.ficora.fi/
• Aktivering av ws-konto
• Krypteringsnyckel - är en teckensträng som består av 24 tecken och kundservicen skickar den per brev.

Testning av Web Service

Web Service har en testtjänst som fungerar identiskt i förhållande till den egentliga produktionsversionen utom att ändringarna och tilläggen uppdateras inte. Dessutom debiteras tjänsteleverantörens egentliga webbtjänstkonto ingenting.

Web Service testsystemet finns på adressen:
https://domainws.ficora.fi/fidomaintest/DomainNameWS_FicoraDomainNameWS.svc

Alla tjänsteleverantörer har samma krypteringsnyckel som består av 24 tecken:
1111 1111 1111 1111 1111 1111 (radera mellanrummen).
Användaridentiteten som läggs till i XML-meddelandet är densamma som tjänsteleverantören använder när denne ska logga in i domännamnssystemet samt i Web Service produktionstjänsten.

Hundratusen (100 000) euro har satts in på tjänsteleverantörens webbtjänstkonto i testsystemet. Det är möjligt att höja värdet. I problemsituationer vänligen sänd e-post till fi-domain-tech@ficora.fi. Sänd gärna med det sända och mottagna XML-meddelandet. Det kan hjälpa till att utreda problemet.

Tjänsteleverantörer som inte har anmält att de vill ta Web Servicen i sitt bruk, har inte heller ett Web Service testkonto. I dessa fall får man ett webbtjänstkonto i sitt bruk genom att anmäla om det till ovan stående e-postadress.