Datahubin SSL-varmenteen (B2B-varmenne) hakuohje

Tässä ohjeessa on kuvattu ohjeet Datahubin rajapintayhteyttä varten käytettävien varmenteiden lataamiselle, käyttöönotolle sekä varmenteiden uusinnalle ja sulkemiselle.

Varmenteen hakuviesti tulee pääkäyttäjän ilmoittamaan sähköpostiosoitteeseen Telian palvelusta, osoitteesta noreply@teliacompany.com.

Open

Viestissä oleva linkki on muotoa https://vadelma.cover.telia.fi/ct6?o=xx..xx , jossa loppuosa sisältää yksilöllisen koodin.

Viestissä itsessään ei näy varmenteen nimeä, vaan varmenteen nimi tulee näkyviin linkin takaa löytyvältä sivulta. Varmenteen nimi on sama kuin osapuolen järjestelmän käyttäjätunnus eli käyttäjäidentiteetti (system user identity).

Haettava varmenne on suojattu salasanalla, joka toimitetaan yhtiön ilmoittamaan puhelinnumeroon tekstiviestillä. Tekstiviesti saapuu numerosta 20040. Tekstiviestissä näkyy varmenteen nimi sekä varmenteen salasana erillisellä rivillä.

Open

Avattuasi sähköpostissa tulleen linkin, varmista avautuvalla Telian varmenteen hakusivulla, että varmenteen tiedot ovat oikein.

• CN eli varmenteen nimi = tuotantovarmenteissa GLN-numero.markkinarooli.järjestysnumero, testivarmenteissa GLN-numero.markkinarooli (mikäli testissä on käytössä usea varmenne, järjestysnumero lisätään varmenteen tunnukseen toisesta varmenteesta alkaen)

• Email address (=sähköposti) = Sähköpostiosoite, johon linkki oli lähetetty

• Mobile (=puhelinnumero) = Puhelinnumero, johon olet vastaanottanut salasanan sisältävän tekstiviestin

• Customer (=asiakas) = Yhtiönne nimi

• Purpose (=tarkoitus) = Testivarmenteissa TEST ja tuotantovarmenteissa PROD

• Provider (=toimittaja) = Fingrid Datahub Oy

Open

Mikäli tiedot ovat oikein, valitse hyväksy. Mikäli tiedoissa on virheitä, ota yhteyttä Fingrid Datahubiin.

Open

Kun valitset ”Lataa”, selain aloittaa varmennetiedoston lataamisen (varmenne luodaan tässä vaiheessa automaattisesti ja salataan tekstiviestillä saamallasi salasanalla).

Tallenna varmennetiedosto koneellesi paikkaan, josta saat sen siirrettyä B2B-yhteyden muodostavalle sovellukselle.

Saat lopuksi seuraavan ilmoituksen.

Open

Voit vielä tässä kohtaa ladata varmenteen uudelleen ”Asenna uudelleen” -toiminnolla, mutta mikäli painat ”Jatka” tai suljet selaimen, ei varmennetta enää voi ladata uudelleen vaan se täytyy pyytää uudelleen Fingrid Datahubilta, mikäli uudelle lataukselle on tarvetta.

Säilytä tekstiviestillä saamasi varmennetiedoston salasana huolellisesti, koska sitä tarvitaan varmenteen asentamisvaiheessa.

Fingrid Datahubilla tai Telian palvelussa ei ole kopiota varmenteesta, joten säilytä se huolellisesti. Mikäli varmenne katoaa tai tuhoutuu, on pyydettävä uusi varmenne Fingrid Datahubilta.

Älä tee varmennetiedostosta kopioita tai jätä tiedostoa koneellesi (paikka jonne tiedoston tallensit ladattuasi sen Telian palvelusta), kun varmenne on onnistuneesti asennettu B2B-sovellukseen. Näin voidaan pienentää riskiä varmenteen päätymiseksi vääriin käsiin.

Varmenteen voi aina tarvittaessa uusia ottamalla yhteyttä Fingrid Datahubiin.

Asenna .pfx-muotoinen varmenne B2B-yhteyden muodostavaan sovellukseesi. Varmenteen asentamisessa tarvitset tekstiviestillä toimitetun varmennetiedoston salasanan.

Kun osapuoli on ladannut varmenteen, Fingrid Datahub vie varmenteen julkisen osan Datahub-järjestelmään osapuolen järjestelmän käyttäjätunnukselle (system user identity). Mikäli kyseessä on kokonaan uusi osapuoli, jolla ei vielä ole järjestelmäkäyttäjää Datahub-järjestelmässä, Fingrid Datahub luo osapuolelle järjestelmän käyttäjätunnuksen varmenteen julkisen osan järjestelmään viennin yhteydessä. Kun Fingrid Datahub on luonut järjestelmän käyttäjätunnuksen, osapuolen tulee luoda vielä järjestelmäkäyttäjälle osapuolen käyttäjä (organisation user). Järjestelmäkäyttäjän osapuolen käyttäjän luonti on ohjeistettu erillisellä ohjeella Järjestelmäkäyttäjän luonti.

Datahubin varmenne on voimassa 3 vuotta ja se on uusittava ennen voimassaolon päättymistä. Tuotantoyhteyksien varmenteiden osalta Fingrid Datahub seuraa varmenteiden voimassaoloja ja lähestyy yhtiön pääkäyttäjää sähköpostitse ennen varmenteen vanhenemista. Testiympäristöjen varmenteiden osalta Fingrid Datahub ei seuraa varmenteiden voimassaoloja, vaan testiympäristöjen osalta osapuoli on itse vastuussa seurannasta.

Varmenteen uusimiseksi yhtiön pääkäyttäjän tulee luoda Fingrid Datahubin tukipalveluun tiketti, jolla pyydetään uuden varmenteen toimittamista. Tiketillä tulee ilmoittaa seuraavat tiedot:

• Sähköpostiosoite, johon varmenne lähetetään (lähtökohtaisesti pääkäyttäjän sähköpostiosoite)

• Puhelinnumero, johon varmenteen salasana lähetetään

• Tieto, mitä varmenteita uusiminen koskee

• Ympäristö, jota varmenteen uusiminen koskee (testiympäristöt CERT01 ja CERT02 vai tuotantoympäristö)

Fingrid Datahub toimittaa osapuolelle uuden varmenteen tiketillä ilmoitettujen tietojen perusteella. Kun osapuoli on ladannut varmenteen, tulee siitä ilmoittaa tiketille. Ilmoituksen jälkeen Fingrid Datahub käy lisäämässä uuden varmenteen julkisen osan Datahub-järjestelmään osapuolen järjestelmäkäyttäjälle. Uusi ja vanha varmenne toimivat yhtä aikaa vanhan varmenteen vanhenemiseen asti. Kun uuden varmenteen julkinen osa on viety Datahubiin Fingrid Datahubin toimesta, osapuoli voi ottaa uuden varmenteen käyttöön omassa järjestelmässään.

Kun osapuoli on ottanut uuden varmenteen käyttöön, eikä tarvitse enää vanhaa varmennetta, tulee vanha varmenne poistaa Datahub-järjestelmästä. Poisto voidaan tehdä joko osapuolen tai Fingrid Datahubin toimesta. Kun vanha varmenne on poistettu, poiston tehnyt taho (osapuoli tai Fingrid Datahub) ilmoittaa siitä tiketille, jolla uuden varmenteen toimittamista on käsitelty. Kun vanha varmenne on poistettu, on varmenteen uusimisen prosessi käsitelty loppuun, ja tiketti suljetaan.

Tätä osiota tulee soveltaa vain sellaisissa tilanteissa, joissa Datahubin järjestelmäkäyttäjälle jo asennettu varmenne on tarve uusia joko varmenteen vanhentumisen, sen vaarantumisen vuoksi tai muusta syystä, jossa Datahubin järjestelmäkäyttäjällä olevaa varmennetta ei voida enää käyttää.

Mikäli haluat, että varmenne suljetaan ennen sen voimassaolon päättymistä, ota yhteys Fingrid Datahubiin tukipalvelun kautta.

Jos varmenne on kadonnut tai on epäilys, että se on joutunut vääriin käsiin, voit estää sen käytön inaktivoimalla järjestelmäkäyttäjän Datahub-järjestelmän käyttöliittymästä ja/tai ottamalla yhteyttä Fingrid Datahubiin varmenteen sulkemiseksi.

Tietosuojaseloste löytyy osoitteesta https://www.fingrid.fi/tietosuojaselosteet/.

Mikäli varmenteen hakusivu näyttää seuraavan virheilmoituksen, on varmenne jo haettu viestissä ollutta linkkiä käyttäen:

Open

Mikäli et ole jo hakenut varmennetta, ota välittömästi yhteyttä Fingrid Datahubiin.

Datahubin tukipalvelu: https://support.datahub.fi/fingrid.