Varmenteet ja tunnisteet

Palveluväylään liitetyn liityntäpalvelimen varmenteet uusitaan liityntäpalvelimen hallintakäyttöliittymän kautta. Uusimiseen kuluu vähintään viikko, joten varmenteiden uusiminen tulee tehdä hyvissä ajoin ennen niiden vanhenemista.

Yleisellä tasolla varmenteiden uusiminen tapahtuu seuraavasti:

1. Varmennepyynnöt luodaan liityntäpalvelimen hallintakäyttöliittymässä.
2. Varmenteet haetaan Digi- ja väestötietoviraston (DVV) verkkoasioinnissa. Tallennetut allekirjoitus- ja autentikointivarmennepyynnöt liitetään varmennehakemukseen joko hakemusta tehtäessä tai myöhemmin teknisen yhteyshenkilön toimesta.
3. Uudet varmenteet lisätään vanhenevien varmenteiden rinnalle liityntäpalvelimelle hallintakäyttöliittymän kautta.

Tutustu varmenteiden uusimisen tarkkoihin ohjeisiin.

Voit tarkistaa Palveluväylän varmenteiden voimassaoloajan kolmella eri tavalla:

• Tieto löytyy liityntäpalvelimen käyttöliittymästä välilehdeltä Keys and Certificates. Valitse SIGN and AUTH keys ja tarkista varmenteiden voimassaoloajat kohdasta Expires.
• Liityntäpalvelimen hallintarajapinnan API endpointin kautta voit hakea kaikkien autentikointi- ja allekirjoitusvarmenteiden voimassaoloajat. Katso lisätietoja X-Road Open APIn sivuilta (englanniksi)Avautuu uuteen ikkunaan..
• X-Road Toolkitin komennolla xrdsst cert list saat listattua varmenteet ja niiden voimassaoloajat. Katso lisätietoja X-Road Toolkitin sivuilta (englanniksi).Avautuu uuteen ikkunaan.

Jos varmenne on vanhenemassa, voit uusia sen seuraamalla Liityntäpalvelimen vanhenevien varmenteiden uusiminen -artikkelin ohjeita.

Palveluväylään liittymiseen tarvitaan allekirjoitusvarmenne sekä autentikointivarmenne. Allekirjoitusvarmenne on organisaatiokohtainen ja autentikointivarmenne on liityntäpalvelinkohtainen. Yhteyden salaamiseen liityntäpalvelimen ja asiakasjärjestelmän välillä vaaditaan TLS-asiakasvarmenne, joka on alijärjestelmäkohtainen.

Tutustu varmenteiden luomisen ja hyväksymisen vaiheisiin ohjevideossa (YouTube)Avautuu uuteen ikkunaan..

Lue lisää Palveluväylän varmenteista eri tilanteissa:

• Useiden organisaatioiden yhteinen liityntäpalvelin
• Ulkoisen toimijan toimittama liityntäpalvelin.

Jos Suomi.fi-palveluväylän varmenteiden hakijana on henkilö, jolla ei ole organisaation nimenkirjoitusoikeutta, hän tarvitsee valtakirjan. Valtakirjaksi riittää seuraavan kaltainen teksti: ”Valtuutamme henkilön X organisaation Y edustajana hakemaan autentikointivarmenteita Digi- ja väestötietovirastolta organisaatio.fi-verkkotunnukselle.” Valtakirjan tulee olla sellaisen henkilön allekirjoittama, jolla on organisaatiossa nimenkirjoitusoikeus.