viestintäviraston epp-rajapinta...epp - extensible provisioning protocol epp on xml- pohjainen...

Viestintäviraston EPP-rajapinta

Sami Salmensuo

Erityisasiantuntija

|

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 3735. Määrittelyjä on tarkennettu useissa muissa dokumenteissa.

Korvaa Web Service rajapinnan 5.9.2016 alkaen

27.10.2015 2 Sami Salmensuo

|

EPP Web Service

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dom="http://domainws.ficora.fi.operations" xmlns:dom1="http://domainws.ficora.fi.schemas" xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <soapenv:Header/> <soapenv:Body> <dom:Apply>  <dom:webDomainRequest> <dom1:name>?</dom1:name> <dom1:valid_applicant_confirmation>?</dom1:valid_applicant_confirmation> <dom1:based_on_person_name>?</dom1:based_on_person_name> <dom1:person_name_registration_id>?</dom1:person_name_registration_id> <dom1:person_name_registration_number>?</dom1:person_name_registration_number> <dom1:domain_name_holder_company_type>?</dom1:domain_name_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="http://www.w3.org/2001/XMLSchema-instance"> <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> ...

27.10.2015 Sami Salmensuo 3

|

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


|

EPP

Poikkeamat RFC dokumenteista kuvataan EPP rajapintakuvauksessa

Myös RFC:t antavat liikkumavaraa toteutukselle

» MAY

» SHOULD

» RECOMMENDED


|

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


|

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 Ei-hyväksyttävästä varmenteesta, viesti [email protected] 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


mailto:[email protected]





|

EPP

Toteutuksessa käytetyt RFC dokumentit:

» RFC 3375 - Generic Registry-Registrar Protocol Requirements

» RFC 3735 - Guidelines for Extending EPP

» RFC 5730 - Extensible Provisioning Protocol

» RFC 5731 - Extensible Provisioning Protocol (EPP) Domain Name Mapping

» RFC 5732 - Extensible Provisioning Protocol (EPP) Host Mapping

» RFC 5733 - Extensible Provisioning Protocol (EPP) Contact Mapping

» RFC 5734 - Extensible Provisioning Protocol (EPP) Transport over TCP

» RFC 5910 - Domain Name System (DNS) Security Extensions Mapping for the Extensible Provisioning Protocol


|

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


|

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ä


|

EPP – Kehitysympäristön käyttöönotto


|

EPP - Ilmoittautumislomake


|

EPP - Vahvistus


|

EPP – Salasanan toimittaminen


|

EPP testiweb etusivu


|

EPP tilinhallinta


|

EPP sallitut IP-osoitteet


|

EPP sallitut IP-osoitteet


Sallittujen IP-osoitteiden julkaisu on tällä hetkellä manuaalinen prosessi

IP-lisäysten tai muutosten jälkeen ilmoitus [email protected] 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:

0.0.0.0/8, 10.0.0.0/8, 127.0.0.0/8, 169.254.0.0/16 ...






|

EPP – Välittäjän loki


|

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 [email protected] 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







|

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: » https://domain.fi/info/index/fi_uudistuu/valittajalle/teknisetrajap

innat/epp-rajapinta.html

» [email protected]

Kysyttävää?


https://domain.fi/info/index/fi_uudistuu/valittajalle/teknisetrajapinnat/epp-rajapinta.html






Tulevan verkkotunnuspalvelun merkittäviä muutoksia

Sami Salmensuo

Erityisasiantuntija

|

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)


|

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


|

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


|

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.


|

Tapahtumaloki

Välittäjä näkee lokista kaikki välittäjää koskevat tapahtumat


|

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ä


viestintäviraston epp-rajapinta...epp - extensible provisioning protocol epp on xml- pohjainen...

Documents