Yhteyden muodostaminen Datahubiin
Datahub-yhteyttä varten seuraavat kolme asiaa tulee olla kunnossa:
Osapuolella on voimassa oleva varmenne, joka on asennettu osapuolen omaan järjestelmään, ja varmenteen julkinen osa on lisätty Datahubiin osapuolen järjestelmäkäyttäjälle.
Osapuolella on järjestelmän käyttäjätunnus ja osapuolen käyttäjä, jolle on määritetty tarvittavat käyttöoikeudet rajapinnan käytölle.
Lisäksi rajapintayhteyttä varten datahubiin tulee sallia liikenne osapuolen järjestelmästä. Osapuolen tulee ilmoittaa käyttämänsä IP-osoitteet Fingrid Datahubille, joka tekee tarvittavat yhteysavaukset Datahub-järjestelmään.
Kun edellä luetellut toimenpiteet on suoritettu, tulee osapuolen varmistaa rajapintayhteyden toiminta.
Yhteys voidaan varmistaa lähettämällä mikä tahansa DH-hakusanoma Datahubiin, mutta on suositeltavaa lähettää esimerkiksi peek-sanoma.
Yhteys on toiminnassa, ellei rajapinta palauta virhettä, joka viittaa pääsyoikeuksiin (not authorised, invalid certificate jne.). Alla on kuvattu yleisimpiä virhetilanteita:
Virheilmoitus | Mahdollinen syy | Debug |
|---|---|---|
User not authorised
| Osapuolen käyttäjä puuttuu tai on nimetty väärin. Virhe aiheutuu myös, jos käyttäjä ei vastaa sanoman lähettäjäorganisaatiota.
| Rajapintakutsussa on käytettävä osapuolen käyttäjän ”Käyttäjän nimi” -arvoa. Jos parametrina on käytetty esimerkiksi käyttäjätunnusta, joka eroaa käyttäjänimestä, kutsu ei mene läpi. Lähettävän organisaation GLN-tunnuksen parametrin tulee vastata osapuolen GLN-tunnusta. |
Invalid client certificate
| Varmenne on muuttunut.
| Tarkistetaan järjestelmän käyttäjätunnuksen Varmenne, että vastaa omaan järjestelmään vietyä varmennetta (käyttöliittymällä ”Hae järjestelmän käyttäjätunnuksia”). |
Testiympäristöissä 403-virhe, tuotantoympäristössä aikakatkaisu | IP-osoite on sallimatta, liikenne reitittyy väärästä IP-osoitteesta tai IP-osoite on muuttunut siitä, mitä alun perin ilmoitettu. | Tarkistetaan, että liikenne ohjautuu oikeasta IP-osoitteesta ulos. Ilmoitetaan uusi IP-osoite Fingrid Datahubille tukipalvelun kautta, mikäli IP-osoite on todellisuudessa muuttunut. |