Saml2

MPASSid-hallintapalvelussa palveluntarjoajat ja MPASSid-yhteensopivia palveluita tuottavat koulutustoimijat voivat tehdä muutoksia palveluintegraatioihinsa.

Tälle sivulle on koottu ohjeet palveluintegraatioiden muokkausominaisuksiin integraatiotyypeittäin.

Palveluintegraatioiden muokkausominaisuuksien versiohistoriaa: 

• 3.10.2024: MPASSid-hallintapalvelun versiossa 2.4. lisätty ensimmäiset palveluntarjoajien integraatiotyyppien muokkausominaisuudet:
  • Uuden SAML-palveluintegraation luominen testi- ja tuotantoympäristöön
  • Olemassa olevan SAML-palveluintegraation muokkaus ja integraation poistaminen
  • Redirect uri -osoitteiden lisääminen ja poistaminen OIDC-palveluintegraatioissa

SAML-integraation luominen ja palvelun tietojen päivittäminen

Uuden SAML-palveluintegraation lisääminen

Avaa MPASSid-hallintapalvelu virkailijan Opintopolun Rekisterit ja tiedonsiirrot -välilehdeltä

Uuden integraation perustiedot

Klikkaa plus ("+") -painiketta integraatioiden listausnäkymässä sivun oikeassa alakulmassa

Plus-painiketta klikattuasi avautuu popup-ikkuna "Luo uusi integraatio", josta voit valita, minkälaisen uuden integraation haluat luoda.

Valitse ikkunan valinnoista haluamasi uuden integraation perusmääritteet:

• Organisaatio: Valitse, mille organisaatiolle luot uuden integraation.
  • Tähän on valittuna oletusarvoisesti se organisaatio, johon liitetyllä käyttöoikeudella käytät hallintapalvelua. Jos sinulla on muokkausoikeudet useampaan organisaatioon, valitse pudotusvalikosta haluamasi organisaatio.
• Integraatio: Valitse, oletko luomassa koulutustoimija- vai palveluintegraatiota
• Integraation tyyppi: valitse uuden integraation tyyppi, esimerkiksi SAML (uuden OIDC-integraation lisääminen mahdollistetaan myöhemmin)
• Palvelu: Valitse, mille palvelulle ja mihin ympäristöön integraatio luodaan
  • Tuotanto- tai testiympäristö
  • Uusi palvelu tai olemassa oleva palvelu
    • Mikäli organisaatiollasi on jo olemassa yksi tai useampi palvelu, voit lisätä niihin useampia integraatioita

Syötettyäsi uuden integraation alustavat valinnat, paina "Luo"-painiketta. Aukeaa uusi sivu, johon uuden integraation tietokentät avautuvat tyhjinä muokattaviksesi.

Integraation tietojen täydentäminen

Syötä seuraavaksi integraation tiedot ja valinnat.

Integraatiotyyppikohtaiset tiedot:

• Testioppijanumero sallittu: valitse liukusäätimestä kyllä tai ei.
  • Valintasi määrittää, hyväksytäänkö integraatiossasi testioppijanumeroa käyttävän käyttäjän kirjautuminen 
  • Vain tuotantoon vaikuttava valinta, testiympäristössä käytetään aina testikäyttäjätunnuksia
•  Palvelun nimi: mikäli olet luomassa uutta palvelua, syötä tähän palvelun nimi. Nimi tulee tähän syöttämässäsi muodossa näkyville esimerkiksi koulutustoimijoiden kirjautumisessaan sallimien palveluiden valintanäkymään. 

Syötä integraation muut pakolliset metadatatiedot:

• wantAssertionsSigned: Valitse, vaaditaanko MPASSid:n välittämiin käyttäjätietoihin allekirjoitus, tämän on pakko olla aina valittuna, ei voi olla inaktiivinen
• Signing certificates: Lisää yksi tai useampi allekirjoitusvarmenne
  • Allekirjoitusvarmenne on pakollinen tuotantoympäristössä ja testissä
  • Lisätessäsi uusia tekstimuotoisia tietoja kuten sertifikaatteja, muista painaa "+ Lisää"-painiketta kentän vieressä, jotta lisäämäsi tieto tallentuu
• Entity-ID: Syötä integraation yksilöllinen tunniste (Entity-ID)
• Encryption certificates: Lisää yksi tai useampi salausvarmenne
• authnRequestsSigned: Valitse, vaaditaanko autentikointipyyntöihin allekirjoitus
• assertionConsumerServiceUrls: Lisää osoitteet, joihin käyttäjätiedot lähetetään. Autentikointipyynnöissä vaaditaan, että osoite vastaa palvelun ilmoittamaa osoitetta.
  • Lisää kullekin consumer service url -osoitteelle seuraavat tiedot:
  • IsDefault: valitse liukusäätimestä, onko lisäämäsi osoite oletusarvoinen kyllä tai ei
    • Voit määrittää useamman osoitteen oletusarvoiseksi, mutta loppukäyttäjälle päätyy aina ensin syötetty oletusarvoinen osoite
  • Location: syötä url-osoite
    • Tuotantoympäristössä https-protokollan käyttö on pakollista
    • Lisätessäsi uusia tekstimuotoisia tietoja kuten url-osoitteita, muista painaa "+ Lisää"-painiketta kentän vieressä, jotta lisäämäsi tieto tallentuu
  • Index-tieto kertoo osoitteen järjestysnumeron silloin kun osoitteita on useampia. Tätä tietoa ei voi muokata.

Pakolliset tiedot on merkitty sivulle punaisella.

Huom. Lisätessäsi tekstimuotoisia tietoja kuten integraation yksilöllistä tunnistetta tai varmenteita, kirjoita tai kopioi haluamasi tieto tekstikenttään ja paina sen jälkeen "+ Lisää" -painiketta, joka tallentaa syöttämäsi tiedon. Jos et paina ko. painiketta, tieto ei tallennu etkä voi tallentaa integraation valintoja.

Integraation tallentaminen

Syötettyäsi integraation pakolliset tiedot ja valittuasi haluamasi asetukset, valitse sivun alakulmasta "Tallenna". Järjestelmä kysyy vielä vahvistuksen, jonka jälkeen saat ilmoituksen muutosten onnistuneesta tallentumisesta.

Tämän jälkeen sivulle aukeaa integraation katselunäkymä, josta näet kaikki integraatioon syöttämäsi tiedot ja voit avata ne halutessasi uudelleen muokattavaksi.

Palveluintegraation tietojen muokkaaminen

Avaa MPASSid-hallintapalvelu virkailijan Opintopolun Rekisterit ja tiedonsiirrot -välilehdeltä ja siirry integraation tietojen katselunäkymään valitsemalla listauksesta haluamasi integraatio.

Avaa integraation tiedot muokkaustilaan kynäpainikkeesta sivun oikeasta alakulmasta.

Muokattavat kentät avautuvat käsiteltäviksi. Voit muokata samoja kenttiä kuin integraatiota luodessa - nämä on kuvattu yllä.

Tehtyäsi haluamasi muokkaukset voit tallentaa tai perua tekemäsi muutokset. Palvelu kysyy vielä varmistuksen ja ilmoittaa muutosten onnistuneesta tallentumisesta.

Palveluintegraation poistaminen

Avaa MPASSid-hallintapalvelu virkailijan Opintopolun Rekisterit ja tiedonsiirrot -välilehdeltä ja siirry integraation tietojen katselunäkymään valitsemalla listauksesta haluamasi integraatio.

Avaa integraation tiedot muokkaustilaan kynäpainikkeesta sivun oikeasta alakulmasta.

Klikkaa sivun vasemmassa alakulmassa olevaa "Poista integraatio" -painiketta.

"Poista integraatio" -painiketta klikattaessa "Tallenna muutokset" -ikkunan tallennuspainike muuttuu muotoon "Poista".

Järjestelmä kysyy vielä varmistuksen, jonka hyväksyttyäsi integraation tiedot poistetaan näkyvistä.

Tiedot eivät poistu MPASSid-tunnistuksenvälityspalvelusta pysyvästi vaan ne voidaan tarvittaessa vielä palauttaa. Ole tässä tapauksessa yhteydessä MPASSid:n asiakaspalveluun.