Liityntäpalvelimen liittäminen testiympäristöön esuomi.fi esuomi.fi/palveluntarjoajille/palveluvayla/ymparistot/testiymparisto/liityntapalvelimen-liittaminen-testiymparistoon/ Suomi.fi-palveluväylä Liityntäpalvelimen liittäminen testiympäristöön Sisältö [näytä] Suomi.fi-palveluväylä Liityntäpalvelimen liittäminen testiympäristöön 1 Palvelimen liittäminen Suomi.fi-palveluväylän testiympäristöön 1.1 Palvelimen perusasetusten määrittely 1.2. Avainten allekirjoituspyyntöjen luominen 1.3. Allekirjoitettujen sertifikaattien importointi Dokumentin tiedot 1 Palvelimen liittäminen Suomi.fi-palveluväylän testiympäristöön Palveluväyläohjelmistojen asennuksen jälkeen liityntäpalvelin on vielä liitettävä palveluväyläinstanssin jäseneksi. Testiympäristössä instanssi on nimeltään FI-TEST. Tämä ohje käy läpi liittämisen eri vaiheet. 1.1 Palvelimen perusasetusten määrittely Ota selaimella yhteyttä hallintakäyttöliittymään, joka tässä tapauksessa on siis https://rhel7pvtest.csc.fi:4000 Hyväksy palvelimen sertifikaatti: 1/32
Antamalla linkin http://rhel7pvtest.csc.fi:4000, voit tarkastaa, että nginx toimii ja se vain odottelee taustapalveluiden (jetty) käynnistymistä. Mikäli näin käy, odottele vielä tovi: 2/32
Palveluiden käynnistyttyä kirjaudu sisään antamillasi tunnuksella ja salasanalla: 3/32
Tuo (import) palveluväylän ylläpidolta saamasi ns. konfiguraatioankkuri hakemalla se käyttöliittymään ja valitsemalla Import: 4/32
Hyväksy ankkurin tuominen järjestelmään; valitse Confirm: 5/32
Täytä tiedot alla olevan mukaisesti ja valitse Submit: Member code: oman organisaatiosi Y-tunnus Member Name: oman organisaatiosi nimi (järjestelmän pitäisi täydentää se automaattisesti) Jos automaattinen täydennys ei toimi, tarkista, että palvelimesi pystyy ottamaan yhteyttä keskuspalvelimille portissa TCP/80. Yleensä syynä virheeseen on se, että palvelimeltasi ei ole sallittu ulospäin tehtävää yhteydenottoa keskuspalvelimelle. Security Server code: palvelimen nimen host-osa PIN: käyttäjän palvelimen päättämä koodi, jonka pituus on vähintään 10 merkkiä. PIN-koodissa pitää olla merkkejä vähintään kolmesta luokasta: pienet kirjaimet, isot kirjaimet, numerot, erikoismerkit. PIN-koodi täytyy säilyttää turvallisessa paikassa. 6/32
Lopputilanne, mikäli asiat sujuivat oletetusti. Valitse OK: 7/32
Onnistuneen asennuksen jälkeinen käyttöliittymänäkymä: Huom! Kuvat on kaapattu FI-sandbox-instanssissa tapahtuneesta asennuksesta, FI-TEST-instanssissa instanssinimi on luonnollisesti FI-TEST. 8/32
Valitse System Parameters. Valitse Timestamping Services. Valitse ADD: 9/32
Valitse ehdotettu ja valitse OK: 10/32
Tilanne onnistuneen TSA-asetusmuutoksen jälkeen. Tässä asennusesimerkissä on käytetty kehitysjärjestelmän aikaleimapalvelua. FI-TEST-ympäristössä aikaleimapalvelun tuottaa VRK. 11/32
1.2. Avainten allekirjoituspyyntöjen luominen Valitse Keys and Certificates. Valitse ENTER PIN: 12/32
Kirjoita rekisteröinnin yhteydessä aikana antamasi palvelimen PIN ja valitse OK: 13/32
Valitse GENERATE KEY: 14/32
Jos Key-rivi ei ole aktiivinen, valitse se aktiiviseksi ja jatka valitsemalla GENERATE CERTIFICATE REQUEST: 15/32
Ensimmäisenä luodaan allekirjoitusvarmennepyyntö (Sign certfificate request). Valitse siis Usage alavetovalikosta SIGN valinta. Allekirjoitusvarmennepyynnössä tarvittavat kentät: C=<country> (aina = FI) O=<organization> (= organisaation nimi tai ilman ääkkösiä) CN=<memberCode> (= organisaation Y-tunnus) serialnumber=<instanceidentifier/servercode/memberclass/> serialnumber muodostuu seuraavasti: instanceidentifier = instanssin eli ympäristön tunnus (testiympäristössä FI-TEST) servercode = ankkurin syöttämisen jälkeen annettu security server code eli palvelimen nimen host-osa memberclass = esimerkissä GOV, parametrin arvo vaihtelee ohjeistuksen mukaisesti (esim. julkishallinnolla: GOV, kaupallisilla toimijoilla: COM jne.) Täytä tiedot seuraavan esimerkkiohjeen mukaisesti:: Usage: Sign (varmista että alasvetovalikosta valittuna) Client: oletusarvo on oikein Distinguished Name (tämän esimerkin tapauksessa seuraavat arvot, käytä aina omia arvojasi): C=FI, O=Vaestorekisterikeskus, CN=0245437-2, serialnumber=fi-test/rhel7pvtest/gov/ 16/32
Valitse OK. Huom! Alla olevassa kuvassa Distinguished Name on muodostettu FI-sandbox ympäristössä (instanceidentifier) ja lisäksi se on muodostettu vanhan sertifikaattiformaatin mukaisesti. Näistäkin huolimatta täytä Distinguished Name-kenttä ylläolevan esimerkin mukaisilla tiedoilla; muuta ne vastaamaan oman orgamisaatiosi tietoja. Tallenna sertifikaattipyyntö, se lähetetään palveluväylän ylläpidon välityksellä osoitteella palveluvayla@palveluvayla.fi CA:lle allekirjoittamista varten: 17/32
Valitse Token: softtoken-0. Jatka valitsemalla GENERATE KEY: Valitse luomasi?-merkkiin päättyä avainrivi ja jatka valitsemalla GENERATE CERTIFICATE REQUEST: 18/32
Seuraavaksi luodaan autentikointivarmennepyyntö (Auth certificate request). Valitse siis Usage alavetovalikosta AUTH valinta. Autentikointivarmennnepyynnössä tarvittavat kentät: C=<country> (aina = FI) O=<organization> (= organisaation nimi ilman ääkkösiä) CN=<commonName> (= palvelimen FQDN) serialnumber=<instanceidentifier/servercode/memberclass/> serialnumber muodostuu seuraavasti: instanceidentifier = instanssin eli ympäristön tunnus (testiympäristössä FI-TEST) servercode = ankkurin syöttämisen jälkeen annettu security server code eli palvelimen nimen host-osa memberclass = esimerkissä GOV, parametrin arvo vaihtelee ohjeistuksen mukaisesti (esim. julkishallinnolla: GOV, kaupallisilla toimijoilla: COM jne.) Täytä tiedot kenttiin seuraavan esimerkkiohjeen mukaisesti: Usage: Auth (varmista että alasvetovalikosta valittuna) Distinguished Name (tämän esimerkin tapauksessa seuraavat arvot, käytä aina omia arvojasi): C=FI, O=Vaestorekisterikeskus, CN=rhel7pvtest.csc.fi, serialnumber=fi-test/rhel7pvtest/gov/ 19/32
Huom! Alla olevassa kuvassa Distinguished Name on muodostettu FI-sandbox ympäristössä (instanceidentifier) ja lisäksi se on muodostettu vanhan sertifikaattiformaatin mukaisesti. Näistäkin huolimatta täytä Distinguished Name-kenttä ylläolevan esimerkin mukaisilla tiedoilla; muuta ne vastaamaan oman orgamisaatiosi tietoja. Tallenna sertifikaattipyyntö, se lähetetään palveluväylän ylläpidon välityksellä osoitteella palveluvayla@palveluvayla.fi CA:lle allekirjoittamista varten: 20/32
Lähetä sertifikaattipyynnöt palveluväylän ylläpidolle, joka allekirjoituttaa ne CA:lla ja palauttaa allekirjoitetut avaimet importointia varten. 1.3. Allekirjoitettujen sertifikaattien importointi Allekirjoitetut sertifikaatit tuodaan (import) palvelimelle seuraavasti: Valitse Keys and Certificates. Valitse Request auth-päätteisen Key:n alta. Jatka valitsemalla IMPORT CERTIFICATE: 21/32
Hae palveluväylän ylläpidolta saamasi autentikaatiosertifikaatti (Auth) Browse nappi painamalla Import certificate ikkunaan. Autentikaatiosertifikaatin tiedosto on muotoa: pem_ liityntäpalvelimen DSN-nimi.cer (HUOM! Alla olevassa kuvassa tiedoston nimi on eri muotoa). Tämän jälkeen valitse OK. 22/32
Tilanne tuomisen (import) jälkeen: 23/32
Valitse sign request ja klikkaa IMPORT CERTIFICATE: 24/32
Hae palveluväylän ylläpidolta saamasi allekirjoitussertifikaatti (Sign) Browse nappi painamalla Import certificate ikkunaan. Allekirjoitussertifikaatin tiedosto on muotoa: pem_ liityntäpalvelimen Y-tunnus.cer (HUOM! Alla olevassa kuvassa tiedoston nimi on eri muotoa). Tämän jälkeen valitse OK. 25/32
Tuonnin (import) jälkeinen tilanne: 26/32
Valitse auth-keyn alla oleva sertifikaatti ja valitse ACTIVATE: 27/32
Valitse REGISTER: 28/32
Anna palvelimen FQDN-nimi. Valitse OK: 29/32
Tässä vaiheessa näkymän pitäisi näyttää alla olevan kaltaiselta: 30/32
Kun palveluväylän ylläpito on rekisteröinyt palvelimesi, muuttuu näkymä seuraavaksi: 31/32
Liityntäpalvelimen liittäminen palveluväylään on nyt suoritettu. Dokumentin tiedot Versionro Mitä tehty Pvm/henkilö 1.0 Dokumentti luotu 29.09.15/PM 1.1 Sisältöä lisätty 30.9.15 / PM 1.2 Muokattu julkaistavaksi 12.11.15 / NP 2.0 Dokumenttia päivitetty 27.1.16 / NP 2.1 Lukua 1.2 päivitetty 22.6.16 / HH 2.2. Luku 1.3 päivitetty: sertifikaattitiedostojen nimeämistä tarkennettu. 13.12.16 / HH Yksilöintitunnus: JTO21 32/32