Tietoluettelon tarkoituksena on kuvata MPASSid:n kautta välitettäviä tietosisältöjä opetuksen- ja koulutuksen järjestäjän henkilörekisteristä MPASSid:n kautta digitaalisten palveluiden tarjoajille. Tietoluetteloa ylläpitää Opetushallitus.
Opetuksen ja koulutuksen järjestäjä, MPASSid:n luottamusverkoston jäsenenä ja rekisterinpitäjänä vastaa loppukäyttäjien henkilötiedoista, joita välitetään MPASSid:n kautta palveluntarjoajille.
Kunkin opetuksen ja koulutuksen järjestäjän tietoja ylläpidetään Opetushallituksen Organisaatiopalvelussa. MPASSid:n välittämät tiedot opetuksen- ja koulutuksen järjestäjästä saadaan Organisaatiopalvelusta.
Versio | Tieto | Esimerkki | Attribuuttinimi (SAML ja OIDC) | Moniarvoinen attribuutti | Selite (fi) | Lähde |
1.0 | Sukunimi | Laitinen | urn:oid:2.5.4.4 (SAML) family_name (OIDC) | Käyttäjän sukunimi. | Kotiorganisaatio | |
1.0 | Etunimi | Mari | urn:oid:2.5.4.42 (SAML) given_name (OIDC) | Käyttäjän etunimi. | Kotiorganisaatio | |
1.0 | Yksilöllinen tunniste |
| urn:mpass.id:uid | Käyttäjän yksilöivä tunniste käyttäjähakemistossa. Yleensä esim. objectGUID käyttäjähakemistossa. Tämä on tällä hetkellä suositeltu käyttäjän yksilöivä tunniste. HUOM! Tunniste todennäköisesti muuttua silloin, kun käyttäjä siirtyy toiseen käyttäjähakemistoon. | Kotiorganisaatio | |
1.0 | CryptID (legacy) | f0ba7691aeff3ef2302d6edce5303641@ldap_test.
| urn:mpass.id:legacyCryptId | Käyttäjän yksilöivä tunnus, joka koostuu salatusta (MD5) henkilötunnuksesta sekä käyttäjähakemiston tunnisteesta erotettuna @-merkillä. Attribuutti on korvautumassa oppijanumerolla ja se tulee jäämään pois MPASSid:n tietomallista, joten sen käyttämistä palveluissa ei suositella. | Kotiorganisaatio | |
1.0 | Vahvennettu CryptID | 9ecb8b0256d0c177320037322cf87e4f12 11f2df45a2f8e4a667ca5b24a10e89@ldap_test. | urn:mpass.id:legacyCryptIde | Vahvennettu versio CryptID attribuutista, jonka käyttäjän yksilöivä tunniste (@-merkin vasemmanpuoleinen osa) on salattu vahvemmalla salausmenetelmällä MPASS:n toimesta. Esimerkiksi: Attribuutti on korvautumassa oppijanumerolla ja se tulee jäämään pois MPASSid:n tietomallista, joten sen käyttämistä palveluissa ei suositella. | Opetushallitus | |
1.0 | Kuntakoodi |
| urn:mpass.id:municipalityCode | x | Käyttäjän kunnan kuntakoodi. Kuntakoodit löytyvät Tilastokeskuksen palvelusta https://tilastokeskus.fi/fi/luokitukset/kunta/. Tieto korvataan opetuksen tai koulutuksen järjestäjän oid -tiedolla versiosta 1.2 eteenpäin | Kotiorganisaatio |
1.0 | Kunta |
| urn:mpass.id:municipality | x | Käyttäjän kunnan nimi. Tieto korvataan opetuksen tai koulutuksen järjestäjän nimi -tiedolla versiosta 1.2 eteenpäin | Kotiorganisaatio |
1.0 | Koulukoodi |
| urn:mpass.id:schoolCode | x | Käyttäjän koulun koulukoodi, ks. https://koski.opintopolku.fi/koski/dokumentaatio/koodisto/oppilaitosnumero/latest | Kotiorganisaatio |
1.0 | Koulu |
| urn:mpass.id:school | x | Käyttäjän koulun nimi. Nimi haetaan urn:mpass.id:schoolCode attribuutin perusteella OPH:n ylläpitämistä tiedoista. | Opetushallitus |
1.0 | Luokka | 8A tai 3B. Tieto on pakollinen perusasteen oppijoille. | urn:mpass.id:class | Käyttäjän luokka. | Kotiorganisaatio | |
1.0 | Vuosiluokka | 8 tai 3. Tieto on pakollinen perusasteen oppijoille. | urn:mpass.id:classLevel | Käyttäjän vuosiluokka (0–10). Ks. https://www.stat.fi/meta/kas/vuosiluokka.html. | Kotiorganisaatio | |
1.0 | Rooli | Helsinki;32132;9A;Oppilas | urn:mpass.id:role | x | Käyttäjän rooli. Sallitut arvot ovat: "opettaja" ja "oppilas" Rooli koostuu neljästä osasta, jotka on eroteltu puolipisteellä (;). Roolin tiedot ovat opetuksen tai koulutuksen järjestäjän nimi, koulukoodi, luokka ja tieto siitä onko käyttäjä oppilas vai opettaja.
| Kotiorganisaatio |
1.1 | Oppijanumero
| 1.2.246.562.24.10000000008 | urn:oid:1.3.6.1.4.1.16161.1.1.27 | Oppijan yksilöivä valtakunnallinen pysyvä yksilöintitunnus. Oppijanumeroa voidaan käyttää yksilöintiin ja indeksointiin, ja sitä voivat käyttää niin koulutuksen ja opetuksen järjestäjät kuin viranomaisetkin. Henkilölle luodaan oppijanumero, kun hän asioi ensimmäistä kertaa Opintopolku-palvelussa. Teknisesti oppijanumero rakentuu osaksi JHS 159:n ohjeistamaa ISO OID -yksilöintitunnusta (International Standard Organization: Object Identifier). Oppijanumeron loppuosa on 11 numeroa pitkä luku, jonka viimeinen numero on tarkistusmerkki. | Kotiorganisaatio | |
1.1 | Opetuksen tai koulutuksen järjestäjän OID | 1.2.246.562.10.494695390410 | urn:mpass.id:educationProviderId | x | Opetushallituksen ylläpitämä opetuksen tai koulutuksen järjestäjän yksilöintitunnus. Teknisesti oppijanumero rakentuu osaksi JHS 159:n ohjeistamaa ISO OID -yksilöintitunnusta (International Standard Organization: Object Identifier). Attribuutti tulee korvaamaan kuntakoodi-attribuutin tietomallin versiossa 1.2. | Opetushallitus |
1.1 | Opetuksen tai koulutuksen järjestäjän nimi | urn:mpass.id:educationProvider | x | Opetuksen tai koulutuksen järjestäjän virallinen nimi, joka korvaa kunta-attribuutin versiossa 1.2 | Opetushallitus |