Hallintaliittymän käyttäminen
Suomi.fi-tunnistuksen hallintaliittymässä voit lisätä organisaatiosi Tunnistusta käyttävät asiointipalvelut sekä hallinnoida niiden teknistä rekisteröintiä.
Hallintaliittymän käyttö jakautuu kahteen vaiheeseen:
- Ensin hallintaliittymässä luodaan asiointipalvelu eli palvelu, jossa organisaatiosi aikoo käyttää Tunnistus-palvelua. Asiointipalvelun tiedot sisältävät asiointipalvelun nimen ja kuvauksen asiointipalvelun toiminnasta.
- Kun asiointipalvelu on luotu, sille voidaan rekisteröidä yksi tai useampia ympäristöjä esimerkiksi testausta tai varsinaista tuotantokäyttöä varten.
Kun organisaatiosi on ottanut Tunnistus-palvelun käyttöön, tunnistaudu Suomi.fi-palveluhallintaanAvautuu uuteen ikkunaan.. Tunnistautumisen jälkeen avautuu Suomi.fi-palveluhallinnan päänäkymä, josta pääset Tunnistus-palvelun hallintaliittymään klikkaamalla Hallintaliittymään-painiketta (kuva 1).
Asiointipalvelun lisääminen
Lisätyt asiointipalvelut listataan Tunnistus-palvelun hallintaliittymän päänäkymässä. Kun käytät hallintaliittymää ensimmäistä kertaa, hallintaliittymän päänäkymä ohjeistaa sinua eteenpäin. Jos yhtään asiointipalvelua ei ole vielä lisätty, voit aloittaa ensimmäisen lisäämisen klikkaamalla Lisää asiointipalvelu -painiketta (kuva 2).
Asiointipalvelun tietoihin lisätään asiointipalvelun nimi ja kuvaus asiointipalvelun toiminnasta (kuva 3). Näitä tietoja ei käytetä loppukäyttäjille näytettävissä näkymissä, vaan ne on tarkoitettu oman organisaatiosi työn tueksi.
Huomaa, että asiointipalvelun voi poistaa, kun sille ei ole rekisteröity yhtään ympäristöä. Ympäristöjen rekisteröimisen jälkeen asiointipalvelua ei voi poistaa hallintaliittymästä, vaan se vaatii yhteydenoton Tunnistus-palvelun tukeen.
Ympäristön rekisteröinti
Asiointipalvelun lisäämisen jälkeen voit rekisteröidä asiointipalvelullesi yhden tai useampia ympäristöjä erilaisia käyttötarkoituksia varten.
Ympäristön rekisteröinti on tekninen toimenpide, ja tarvitset sitä varten SAML 2.0 -standardin mukaisen metadatatiedoston. Jos sinulla ei ole asiointipalvelun metadatatiedostoa valmiina, katso ohjeet metadatatiedoston muodostamiseen.
Ympäristö voidaan rekisteröidä joko testi- tai tuotantokäyttöön. Huomaa, että ennen tuotantokäyttöä organisaatiosi tulee hakea asiointipalvelulle myös käyttölupaa hyvissä ajoin ennen käytön aloittamisen haluttua ajankohtaa.
Rekisteröinti tapahtuu asiointipalvelun omasta näkymästä (kuva 4). Tähän näkymään listataan myös rekisteröidyt ympäristöt sekä niiden tilat. Voit aloittaa ympäristön rekisteröimisen asiointipalvelullesi klikkaamalla Rekisteröi ympäristö -painiketta.
Valitse rekisteröitävän ympäristön tyyppi ja lataa aiemmin luotu SAML 2.0 -standardin mukainen metadatatiedosto (kuva 5).
Kun olet ladannut metadatatiedoston ja tallentanut ympäristön tiedot, metadata siirtyy Digi- ja väestötietovirastolle tarkastettavaksi. Näet ympäristön tilan asiointipalvelun omasta näkymästä (kuva 6).
