Resurssin rekisteröinti

Tässä luvussa selitetään, kuinka uusi palveluntarjoajan (SP) palvelu lisätään Virtu-luottamusverkkoon Resource Registerin avulla. Menettely on sama sekä testi- että tuotantopalvelimille. Erona on, että tuotantopalveluiden osalta operaattori hakee Valtorin hyväksynnän palvelun lisäämiseksi Virtu-metatietoihin.

HUOM! Tämä ohje sisältää esimerkkikuvia. Käytä rekisteröinnissä oman yrityksesi tietoja.

1. Siirry osoitteeseen https://virtus.csc.fi ja valitse linkki Add a new Service Provider
   
   
   
2. Valitse oikea organisaatio pudotusvalikosta ja ota muutokset käyttöön ja palaa takaisin.
   
   
   
3. Valitse SP Basic Information ja täytä tiedot. (Muista, että Entity Id täytyy toimittaa Efectelle ESA:n määritystä varten). Entity Id:n on oltava URI, joko URL tai URN, esimerkiksi https://domain.com/service. Ota muutokset käyttöön ja palaa takaisin.
   
   
4. Valitse SP SAML Endpoints ja täytä tiedot. Ota muutokset käyttöön ja palaa takaisin.
   
   
   
5. Valitse Certificates ja täytä tiedot. Ota muutokset käyttöön ja palaa takaisin.
   
   
   
6. Valitse Required attributes ja täytä tiedot. Ota muutokset käyttöön ja palaa takaisin.
   
   
   
7. Valitse Contact information ja täytä tiedot. Ota muutokset käyttöön ja palaa takaisin.
   
8. Valitse Submit SP Description -painike. Tiedot siirtyvät sen jälkeen luottamusverkon operaattorille ja Valtorille tarkastettavaksi. Saat sähköpostin, kun rekisteröinti on tarkastettu.

Varmennevaatimukset

Testi

Itse allekirjoitettujen varmenteiden käyttö on sallittua Virtu-testiympäristössä.

Tuotanto

Tuotannon Virtuun liittyvien palveluiden varmenteiden on oltava Digi- ja väestötietoviraston (DVV) allekirjoittamia. Vaatimus koskee SAML2-varmenteita, ei TLS-varmenteita.

https://dvv.fi/en/service-certificates-for-organisations

Suosittelemme valitsemaan "system signature certificate" -vaihtoehdon "normal server certificate" -vaihtoehdon sijaan, koska ensimmäinen on voimassa kaksi vuotta, kun jälkimmäinen on voimassa vain vuoden.

Varmenteen CN:n tulisi ilmaista, mihin palveluun se on tarkoitettu. Lisää siis palvelusi nimi siihen.

Suosittelemme vahvasti dokumentoimaan, kuinka saml-varmenne vaihdetaan palvelun puolella. Varmenne on vaihdettava kerran vuodessa tai kahdessa vuodessa riippuen siitä, kumpi varmennetyyppi on valittu.

Lisätietoja Virtusta

Lisätietoja löytyy täältä.