Viestintäviraston EPP-rajapinta. Sami Salmensuo Erityisasiantuntija

Transkriptio

1 Viestintäviraston EPP-rajapinta Sami Salmensuo Erityisasiantuntija

2 EPP - Extensible Provisioning Protocol EPP on XML- pohjainen protokolla EPP:llä tarkoitetaan RFC-dokumenteissa määriteltyä tapaa liittyä rekisterin (registry) ylläpitäjän järjestelmään. EPP on muodostunut alan standardiksi ja on hyvin yleisessä käytössä. EPP on määritelty RFC-dokumenteissa RFC 3375 ja RFC Määrittelyjä on tarkennettu useissa muissa dokumenteissa. Korvaa Web Service rajapinnan alkaen Sami Salmensuo

3 EPP Web Service <soapenv:envelope xmlns:soapenv=" xmlns:dom=" xmlns:dom1=" xmlns:arr=" ys"> <soapenv:header/> <soapenv:body> <dom:apply> <!--Optional:--> <dom:webdomainrequest> <dom1:name>?</dom1:name> <dom1:valid_applicant_confirmation>?</dom1:valid_applicant_confir mation> <dom1:based_on_person_name>?</dom1:based_on_person_name> <dom1:person_name_registration_id>?</dom1:person_name_registr ation_id> <dom1:person_name_registration_number>?</dom1:person_name_r egistration_number> <dom1:domain_name_holder_company_type>?</dom1:domain_nam e_holder_company_type> <dom1:domain_name_holder_business_id>?</dom1:domain_name_ holder_business_id>... EPP <?xml version="1.0" encoding="utf-8" standalone="no"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:xsi=" <command> <create> <domain:create xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <domain:name>esimerkki.fi</domain:name> <domain:period unit="y">2</domain:period> <domain:ns> <domain:hostobj>ns1.esimerkki.fi</domain:hostobj> <domain:hostobj>ns2.esimerkki.fi</domain:hostobj> </domain:ns> <domain:registrant>haltijantunnus</domain:registrant> <domain:contact type="admin">admin</domain:contact> <domain:contact type="tech">tekninen</domain:contact> <domain:authinfo> <domain:pw>salasana</domain:pw> </domain:authinfo> </domain:create> </create>... Sami Salmensuo

4 EPP Vaikka EPP toteutus on määritelty RFC dokumenteissa, eroavat rekistereiden EPP-toteutukset merkittävästi toisistaan Yksi EPP-client ei toimi kaikilla rekistereillä, vaaditaan rekisterikohtaisia muutoksia Viestintäviraston EPP-toteutus on RFC-dokumenttien mukainen siltä osin kuin mahdollista» Merkittäviä muutoksia contact create toiminnossa Sisältää Viestintäviraston laajennuksia» Check Balance» Auto renew Sami Salmensuo

5 EPP Poikkeamat RFC dokumenteista kuvataan EPP rajapintakuvauksessa Myös RFC:t antavat liikkumavaraa toteutukselle» MAY» SHOULD» RECOMMENDED Sami Salmensuo

6 EPP Turvamekanismit:» EPP Salasana» HTTPS» IP Whitelist» Välittäjäkohtainen palvelinvarmenne Luotetut CA:t (ainakin):» Verisign» Symantec» GeoTrust» GlobalSign» Thawte» CACert» Comodo.pem,.crt,.cer,.key Sami Salmensuo

7 EPP Hyväksytyt CA:t Periaatteessa kaikki CA:t käyvät, kunhan juurivarmenteen julkinen avain on ladattavissa CA:lla on useita varmenteita, joille on omat juurivarmenteet» Kaikkia ei löydy järjestelmästä» Jos varmennetta ladattaessa tulee virheilmoitus Eihyväksyttävästä varmenteesta, viesti osoitteeseen» Viestiin linkki mistä CA:n juurivarmenne on haettavissa» Testiympäristössä käytössä olevat juurivarmenteet kopioidaan myös tuotantoon» Ei Self-signed varmenteita Sami Salmensuo

8 EPP Toteutuksessa käytetyt RFC dokumentit:» RFC Generic Registry-Registrar Protocol Requirements» RFC Guidelines for Extending EPP» RFC Extensible Provisioning Protocol» RFC Extensible Provisioning Protocol (EPP) Domain Name Mapping» RFC Extensible Provisioning Protocol (EPP) Host Mapping» RFC Extensible Provisioning Protocol (EPP) Contact Mapping» RFC Extensible Provisioning Protocol (EPP) Transport over TCP» RFC Domain Name System (DNS) Security Extensions Mapping for the Extensible Provisioning Protocol Sami Salmensuo

9 EPP Vaatimukset Verkkotunnusvälittäjän tulee täyttää määräyksen vaatimukset:» Välittäjällä on Viestintäviraston EPP testaus / kehitysympäristössä toimiva asiakasohjelma» Verkkotunnusvälittäjän on täytettävä Kansallisen turvallisuusauditointikriteeristön (KATAKRI) kulloinkin voimassaolevan version I-osion mukaiset perustason (IV) vaatimukset Tietoliikenneturvallisuus Tietojärjestelmäturvallisuus Sami Salmensuo

10 EPP Testaus & kehitys EPP korvaa Web Service rajapinnan ilman päällekkäistä siirtymäaikaa Viestintävirasto tarjoaa EPP:lle täysin tuotantoversiota vastaavan kehitysympäristön, jossa voi kokeilla muutoksia vapaasti Ympäristö on täysin valmis käytettäväksi Käytettävissä EPP-rajapinta sekä selainkäyttöliittymä Sami Salmensuo

11 EPP Kehitysympäristön käyttöönotto Sami Salmensuo

12 EPP - Ilmoittautumislomake Sami Salmensuo

13 EPP - Ilmoittautumislomake Sami Salmensuo

14 EPP - Vahvistus Sami Salmensuo

15 EPP Salasanan toimittaminen Sami Salmensuo

16 EPP testiweb etusivu Sami Salmensuo

17 EPP tilinhallinta Sami Salmensuo

18 EPP sallitut IP-osoitteet Sami Salmensuo

19 EPP sallitut IP-osoitteet Sallittujen IP-osoitteiden julkaisu on tällä hetkellä manuaalinen prosessi IP-lisäysten tai muutosten jälkeen ilmoitus osoitteeseen Automatisoitu prosessi sallittujen IP-osoitteiden julkaisemiseksi Korkeintaan viisi yksittäistä IP-osoitetta» Ei sallittuja IP-osoitteita ovat IETF:n muuhun käyttöön varaamat IP-osoitteet kuten: /8, /8, /8, /16... Sami Salmensuo

20 EPP Välittäjän loki Sami Salmensuo

21 EPP testaus & kehitysympäristö Kertauksena:» "Ilmoittaudu välittäjäksi" Kehitysympäristöön. Käytännössä rekisteröityy kehitysympäristön käyttäjäksi.» Ilmoita Viestintävirastolle sähköpostitse osoitteeseen että rekisteröidyit käyttäjäksi. [nimi, rekisterinumero].» Lähetämme selainkäyttöliittymän salasanan sähköpostitse» Määritä selainkäyttöliittymässä: EPP-salasana, palvelinvarmenne, sallitut IP-osoitteet Sami Salmensuo

22 EPP - testaus & kehitysympäristö Muutokset ovat mahdollisia Kehitysympäristön käyttäjän ei tarvitse olla välittäjä, ei nykyinen eikä tuleva Palvelun osoite on epptest.ficora.fi, EPP rajapinnalla on sama osoite, mutta portti on TCP 700. Lisätietoja:» innat/epp-rajapinta.html» fi-domain-tech@ficora.fi Kysyttävää? Sami Salmensuo

23 Tulevan verkkotunnuspalvelun merkittäviä muutoksia Sami Salmensuo Erityisasiantuntija

24 2-vaiheinen kirjautuminen Välittäjän käyttäjillä on henkilökohtaiset tunnukset joilla kirjautuvat välittäjän tilille Vähintään 1 pääkäyttäjä, jolla on oikeus lisätä uusia käyttäjiä Käyttäjätunnus, salasana ja kertakäyttösalasana (SMS tai OTP salasanalista) Sami Salmensuo

25 2-vaiheinen kirjautuminen Pääkäyttäjä(t) voivat lisätä uusia käyttäjiä Vähintään 1 pääkäyttäjä, jolla on oikeus lisätä uusia käyttäjiä, muokata käyttäjien rooleja ja puhelinnumeroa Käyttäjät voivat muokata omia tietojaan Ei mahdollista asettaa käyttäjäkohtaisia oikeuksia verkkotunnuspalveluun Sami Salmensuo

26 Yhteystieto Objektit Yksi "Contact object" voidaan linkittää yhteen tai useampaan verkkotunnukseen Nykyjärjestelmässä on jokaisella palveluntarjoajan rekisteröimällä verkkotunnuksella verkkotunnuskohtaiset yhteystiedot. Yhteystietojen muuttuessa pitää uusi yhteystieto päivittää jokaiselle verkkotunnukselle erikseen Uudessa järjestelmässä asiakkaalla voi olla yksi yhteystieto "olio", joka linkitetään kaikkiin asiakkaan verkkotunnuksiin Neljä roolia:» Käyttäjä (Holder) -> pakollinen jokaisella verkkotunnuksella» Billing» Technical» Admin Sami Salmensuo

27 Automaattinen uusiminen Välittäjä voi asettaa verkkotunnukselle automaattisen uusimisen päälle 45 päivää ennen verkkotunnuksen vanhenemista generoidaan Poll ja / tai sähköpostiviesti siitä että verkkotunnuksen voimassaoloaikaa tullaan jatkamaan jos saldo riittää voimassaoloajan jatkamiseen. Tämän ilmoituksen ja uusimisajankohdan välissä voidaan automaattinen voimassaoloajan jatkaminen vielä poistaa käytöstä. 30 päivää ennen verkkotunnuksen vanhenemista verkkotunnuksen voimassaoloaikaa jatketaan, JOS saldo riittää voimassaoloajan jatkamiseen. Jos välittäjän EPP-tilin saldo ei riitä ensimmäisellä uusimiskerralla, yritetään uusimista uudelleen kerran vuorokaudessa kunnes verkkotunnuksen voimassaoloaikaa onnistutaan jatkamaan, tai verkkotunnus vanhenee. Sami Salmensuo

28 Tapahtumaloki Välittäjä näkee lokista kaikki välittäjää koskevat tapahtumat Sami Salmensuo

29 Maksaminen Verkkotunnusmaksujen maksaminen tapahtuu välittäjän ennakkomaksutililtä» EPP:n kautta tapahtuvat maksulliset tapahtumat» Selainkäyttöliittymän maksut» Automaattiset uusimiset Ennakkomaksutilille rahan siirto voi tapahtua kahdella tavalla:» Online maksuna (Verkkopankit, luottokortit)» Tilisiirtona Ennakkomaksutilin saldon hälytysraja on välittäjän itse määriteltävissä Sami Salmensuo