Järjestelmäkäyttäjän luonti
Videolla on esitetty lyhyesti järjestelmäkäyttäjän luonti käyttöliittymässä. Tarkemmat kirjalliset ohjeet löytyvät heti sen alta.
Järjestelmäkäyttäjän rakenne
Osapuolten järjestelmät liittyvät Datahubiin rajapinnan (B2B-sanomarajapinta ja/tai tietorajapinta) kautta. Järjestelmäkäyttäjät ovat Datahubiin liittyville osapuolten järjestelmille määritettyjä käyttäjiä.
Datahubin käyttäjärakenne on kaksiosainen. Datahubin käyttäjät koostuvat aina käyttäjäidentiteetistä sekä tälle annetuista käyttöoikeuksista/rooleista. Kaksiosaisuus koskee sekä käyttöliittymäkäyttäjiä että järjestelmäkäyttäjiä.
Tämän kaksiosaisen rakenteen vuoksi uusi käyttäjä luodaan Datahubiin kahdessa osassa. Ensin luodaan käyttäjäidentiteetti, jolla käyttäjä tunnistautuu järjestelmään. Käyttäjäidentiteetille luodaan sen jälkeen käyttöoikeudet.
Varmenne rajapintayhteyttä varten
Osapuolten Datahubiin liittyvät järjestelmät tunnistetaan SSL-varmenteiden avulla. Esiehtona uuden järjestelmäkäyttäjän perustamiselle on, että osapuolella on olemassa varmenne. Fingrid Datahub vastaa osapuolten varmenteiden luonnista ja toimituksesta. Varmenne toimitetaan lähtökohtaisesti osapuolen pääkäyttäjälle osapuolen järjestelmäkäyttäjää varten.
Osapuolen vastuulla on asentaa myönnetty varmenne omaan järjestelmäänsä. Osapuoli, jolle varmenne on myönnetty, vastaa aina varmenteellaan tehdyistä toimista.
Varmenteet ovat osapuolikohtaisia. Osapuolella voi olla käytössään yksi tai useampi Datahubiin liittyvä järjestelmä, jolloin osapuolella voi myös olla useampi varmenne eri järjestelmien tunnistamiseen. Lähtökohtaisesti varmenteet ovat aina järjestelmäkohtaisia, eli suosituksena on, että osapuolen jokaiselle järjestelmälle on käytössä oma varmenteensa. Teknisesti on kuitenkin mahdollista, että esimerkiksi osapuolen asiakastietojärjestelmä ja mittaustietojärjestelmä käyttävät samaa varmennetta, joten tällainen järjestelmäratkaisu on myös sallittu.
Ohjeistus varmenteen lataamiseen löytyy erikseen nimellä Datahubin SSL-varmenteen (B2B-varmenne) hakuohje.
Järjestelmän käyttäjätunnuksen luonti
Kun osapuoli on ladannut vastaanottamansa varmenteen, Fingrid Datahub perustaa osapuolelle järjestelmän käyttäjätunnuksen eli järjestelmäkäyttäjäidentiteetin. Järjestelmäkäyttäjäidentiteetti nimetään vastaavasti kuin varmenne, eli identiteetin tunnus on muodossa:
[GLN-tunnus].[markkinarooli].[järjestysnumero]Testiympäristöjen varmenteissa ei ole mukana järjestysnumeroa, ellei osapuolella ole useampaa varmennetta käytössä testiympäristöissä. Testiympäristöissä järjestelmäkäyttäjäidentiteetin tunnus on siis muodossa:
[GLN-tunnus].[markkinarooli]Järjestelmäkäyttäjän sekä varmenteen tiedot pääsee tarkistamaan käyttöliittymältä valikosta Järjestelmän hallinta → Osapuolten hallinta -> Hae järjestelmän käyttäjätunnuksia.
Kenttä | Kentän kuvaus | Muu lisätieto |
|---|---|---|
Osapuoli | Osapuolen nimi, GLN-tunnus ja rooli |
|
Käyttäjätunnus | Käyttäjän tunnus, jolla järjestelmän käyttäjätunnus ja osapuolen käyttäjä kytketään toisiinsa. On sama kuin varmenteen nimi. | Nimeämiskäytäntö tuotantoympäristössä:
Nimeämiskäytäntö testiympäristöissä:
|
Tunnistautumistapa | Varmenne (CRT) | Järjestelmäkäyttäjät tunnistetaan aina varmenteen avulla. |
Osapuolen käyttäjät | Tähän kohtaan sivua listautuu ne osapuolen käyttäjät, jotka tähän järjestelmän käyttäjätunnukseen on liitetty. | Listauksessa näkyy sekä aktiiviset että inaktiiviset osapuolen käyttäjät. Mikäli jokin osapuolen käyttäjä on poistettu käytöstä (inaktivoitu), näkyy käyttäjä edelleen listauksessa. |
Varmenteen aihe | Tässä kohtaa sivua näkyy tähän järjestelmän käyttäjätunnukseen liitetyt varmenteet ja esimerkiksi varmenteiden voimassaoloajat. | Varmenteita on lähtökohtaisesti yksi per järjestelmäkäyttäjä, mutta varmenteen vaihtotilanteissa järjestelmäkäyttäjällä voi olla kaksi varmennetta rinnakkain, jotta varmenne voidaan vaihtaa osapuolen järjestelmässä ilman yhteyskatkoksia. |
Kun Fingrid Datahub on perustanut järjestelmäkäyttäjäidentiteetin, osapuoli voi luoda sen jälkeen järjestelmäkäyttäjälleen osapuolen käyttäjän.
Osapuolen käyttäjän luonti
Kun järjestelmäkäyttäjäidentiteetti on luotu, osapuoli pystyy itse luomaan järjestelmäkäyttäjälleen osapuolen käyttäjän. Luonti onnistuu pääkäyttäjätason oikeuksilla. Osapuolen käyttäjä tarvitaan määrittämään markkinaosapuolen markkinaroolin mukaiset käyttöoikeudet järjestelmäkäyttäjälle.
Osapuolen käyttäjän luonti onnistuu käyttöliittymältä valikosta
Järjestelmän hallinta -> Osapuolten hallinta -> Luo osapuolen käyttäjä.
Lomakkeelle tulee täydentää kaikki pakolliset kentät. Kenttien kuvaukset, ohjeistukset täydentämiseen sekä muut lisähuomiot löytyvät kuvan alapuolella olevasta taulukosta.
Kenttä | Kentän kuvaus | Ohjeistus täydentämiseen | Muu lisätieto |
|---|---|---|---|
Osapuoli | Määrittää osapuolen, jolle osapuolen käyttäjä luodaan | Täydentyy automaattisesti organisaation mukaan |
|
Käyttäjätunnus | Määrittää, mihin järjestelmän käyttäjätunnukseen (=käyttäjäidentiteettiin) osapuolen käyttäjä liitetään | Oltava sama kuin järjestelmäkäyttäjän tunnus. On käytännössä sama kuin varmenteen nimi. Tuotannossa muotoa [GLN-tunnus].[markkinarooli].[järjestysnumero] ja testissä lähtökohtaisesti muotoa [GLN-tunnus].[markkinarooli]
|
Osapuolen käyttäjän luonti ei onnistu, mikäli Datahubista ei löydy ilmoitettua käyttäjätunnusta vastaavaa järjestelmän käyttäjätunnusta |
Käyttäjän nimi | Määrittää osapuolen käyttäjälle nimen, jota käytetään rajapintayhteydessä organisationuser-parametrinä | Käyttäjän nimen tulee sisältää osapuolen GLN-tunnus sekä mielellään jokin tarkenne, millaisesta järjestelmästä on kyse. Esimerkit: 9009876543210-B2B-ATJ (asiakastietojärjestelmän järjestelmäkäyttäjä) 9009876543210-B2B-MDM (mittaustietojärjestelmän järjestelmäkäyttäjä) |
|
Koko nimi | Sama kuin käyttäjätunnus | Sama kuin käyttäjätunnus |
|
Sähköpostiosoite | Yhteyshenkilön sähköpostiosoite | Käyttäjän sähköpostiosoite |
|
Puhelinnumero | Yhteyshenkilön puhelinnumero | Käyttäjän puhelinnumero kansainvälisessä muodossa (+358) |
|
Sopimuksen päättymispäivä (EI KÄYTÖSSÄ) |
|
|
|
Kun lomakkeen kentät on täydennetty, valitaan lomakkeen alaosasta löytyvästä listauksesta vielä tarvittavat käyttäjäroolit käyttäjälle. Roolin valinta tehdään klikkaamalla haluttua roolia, ja siirtämällä se oikealle puolelle keskellä olevasta oikeaan osoittavasta nuolesta.
Alla on listattuna järjestelmäkäyttäjälle olennaiset roolit. Tietorajapinnalla tarkoitetaan Datahubin REST-rajapintaa, ja Markkinaprosesseilla Datahubin B2B SOAP -rajapinnan käyttöä.
Kukin rooli löytyy markkinaroolikohtaisena. Roolin nimi sisältää markkinaroolilyhenteen, ja valittavan roolin tulee edustaa sitä markkinaroolia, jossa osapuoli toimii.
User Role | Markkinarooli | Käyttötapa |
DDQ_DataInterface | Myyjä | Tietorajapinta |
DDQ_RegulatedProcesses | Myyjä | Markkinaprosessit |
DSO_DataInterface | Jakeluverkonhaltija | Tietorajapinta |
DSO_RegulatedProcesses | Jakeluverkonhaltija | Markkinaprosessit |
THP_DataInterface | Kolmas osapuoli | Tietorajapinta |
THP_RegulatedProcesses | Kolmas osapuoli | Markkinaprosessit |
Muutokset järjestelmäkäyttäjiin
Järjestelmäkäyttäjiin voi tehdä vain rajatusti muutoksia. Järjestelmäkäyttäjän identiteettiä, käyttäjänimeä tai käyttäjän osapuolta ei voi muuttaa. Mikäli esimerkiksi osapuolen GLN-tunnus muuttuu, luodaan kokonaan uusi käyttäjä ja sille varmenne.
Järjestelmäkäyttäjän käyttöoikeuksia voi muuttaa, ja järjestelmäkäyttäjän tunnukseen (identiteettiin) liitettyjä osapuolen käyttäjiä voi poistaa ja/tai lisätä. On kuitenkin huomioitava, että uutta osapuolen käyttäjää ei voi luoda täysin samalla käyttäjänimellä kuin poistettu käyttäjä, sillä poistetut käyttäjät vain inaktivoidaan poistettaessa, eivätkä käyttäjien tiedot häviä kokonaan järjestelmästä.