OIDC-sanasto
Sanasto kokoaa yhteen OIDC-integraation ohjeissa käytettyjä termejä
- joiden kääntäminen ei ole itsestään selvää
- joita käytetään dokumentaatiossa englanninkielisenä teknisenä terminä myös suomenkielisessä tekstissä (esim. client_assertion, nonce).
Sanasto on tarkoitettu avuksi, kun termien merkitys tai käännös halutaan tarkistaa. Termit on ryhmitelty aihepiireittäin.
Tutustu myös muihin ohjesivuihin:
Termi | Englanninkielinen termi | Kuvaus |
|---|---|---|
Asiointipalvelu | Relying Party (RP) | OIDC-integraation osapuoli, joka luottaa Suomi.fi-tunnistuksen tekemään tunnistukseen ja hyödyntää sen palauttamia henkilötietoja. Vastaa esimerkiksi verkkopalvelua, joka toteuttaa kirjautumisen. |
Loppukäyttäjä | End User | Henkilö, joka tunnistautuu asiointipalveluun Suomi.fi-tunnistuksen kautta. |
Suomi.fi-tunnistus | OpenID Provider (OP), Identity Provider (IdP) | Taho, joka suorittaa käyttäjän tunnistamisen ja välittää tunnistustiedot asiointipalvelulle. Vastaa OIDC-standardin "Identity Providerin" roolia. |
Termi | Englanninkielinen termi | Kuvaus |
|---|---|---|
Tunnistuspyyntö | authentication request | Pyyntö, jolla asiointipalvelu ohjaa käyttäjän selaimen Suomi.fi-tunnistuksen authorization-rajapintaan tunnistautumista varten. |
Valtuutuskoodi | authorization code | Lyhytikäinen, kertakäyttöinen koodi, joka palautuu onnistuneen tunnistuspyynnön vastauksena ja vaihdetaan token-rajapinnassa henkilötietoihin. |
Token-pyyntö | token request | Palvelimelta toiselle (back-channel) tehtävä pyyntö, jolla valtuutuskoodi vaihdetaan id_tokeniin. |
Pyyntöobjekti | request object | JWT-muotoinen, allekirjoitettu tunnistuspyynnön sisältö. Katso alla Allekirjoitettu pyyntöobjekti (JAR). |
Allekirjoitettu pyyntöobjekti (JAR) | signed request object / JWT Secured Authorization Request (JAR) | RFC 9101:n mukainen mekanismi, jossa tunnistuspyynnön parametrit välitetään allekirjoitettuna JWT:nä query-parametrissa request, eikä selkokielisinä query-parametreina. |
Asiakastodistus | client assertion | JWT-muotoinen todiste, jolla asiointipalvelu todistaa identiteettinsä token-rajapinnalle. Käytetään englanninkielisenä termina client_assertion myös suomenkielisessä tekstissä, koska se on myös HTTP-parametrin nimi. |
Epäsymmetrinen avainautentikointi | private_key_jwt | Token-rajapinnan autentikointimenetelmä, jossa asiointipalvelu allekirjoittaa client_assertionin yksityisellä avaimellaan client secretin sijaan.- |
Selainkanava | front-channel | Pyynnön tai vastauksen välittämistapa, jossa tieto kulkee käyttäjän selaimen kautta (esim. tunnistuspyyntö). Altis selaimen historiaan/lokeihin jäämiselle, joten arkaluonteista tietoa ei välitetä tätä kautta. |
Taustakanava | back-channel | Pyynnön tai vastauksen välittämistapa, jossa tieto kulkee suoraan palvelimien välillä selaimen ohittaen (esim. tokenpyyntö). |
Kertakäyttöarvo | nonce | Kertakäyttöinen, satunnainen merkkijono, jolla sidotaan tunnistuspyyntö ja token-vastauksen id_token toisiinsa sekä estetään toistohyökkäykset (replay attack). Käytetään aina englanninkielisenä termina nonce. |
Tilatieto / CSRF-suojausarvo | state | Tunnistuspyynnössä lähetetty arvo, joka palautetaan sellaisenaan vastauksessa. Käytetään CSRF-hyökkäysten estämiseen. Käytetään aina englanninkielisenä termina state. |
Valtuutuskoodin käytön suojausmenetelmä | Proof Key for Code Exchange (PKCE) | OAuth 2.0 -protokollan tietoturvalaajennus, jolla estetään valtuutuskoodin luvaton käyttö. Menetelmä perustuu tunnistuspyynnössä toimitettavaan haastearvoon (code_challenge) ja token-pyynnössä toimitettavaan tarkistusarvoon (code_verifier), joiden vastaavuus tarkistetaan token-pyynnön käsittelyssä. |
Termi | Englanninkielinen termi | Kuvaus |
|---|---|---|
Käyttöoikeusalue | scope | OIDC-standardin mukainen tapa ryhmitellä, mitä tietoja käyttäjästä pyydetään tunnistuspyynnössä (esim. names, mail). |
Attribuutti / henkilötietoattribuutti | claim | Yksittäinen henkilötiedon kenttä, joka palautuu id_tokenissa (esim. givenname, address_fi). |
Käyttöluvan taso / tietoluvan taso | permission tier / consent level | Suomi.fi-tunnistuksen porrastus, joka määrittää, mitä scopeja asiointipalvelu saa pyytää (suppea, keskilaaja, laaja). |
Tietosuojan minimointiperiaate | data minimization principle | Periaate, jonka mukaan asiointipalvelun tulee pyytää vain sellaisia scopeja, jotka ovat aidosti tarpeen palvelun toiminnan kannalta. |
Termi | Englanninkielinen termi | Kuvaus |
|---|---|---|
Henkilötunnus (hetu) | Finnish national identification number | Suomalainen henkilön yksilöivä tunnus, palautuu claiminä nationalidentificationnumber. |
VTJ | Population Information System (Finnish Digital Agency) | Suomen väestötietojärjestelmä, jonka tietoja voidaan hakea täydentämään tunnistusvälineeltä saatuja tietoja. |
Tunnistusväline | authentication method / electronic identification method | Väline, jolla käyttäjä tunnistautuu (esim. pankkitunnistus, mobiilivarmenne, eIDAS-tunnistus). |
Varmuustaso / tunnistustaso | Level of Assurance (LoA) | Tunnistustapahtuman luottamustaso, ilmaistaan claiminä acr ja metadatakentässä default_acr_values. |
Termi | Englanninkielinen termi | Kuvaus |
|---|---|---|
Istunto | session | Käyttäjän tunnistautumisen aikainen tila, tunnistetaan sid-arvolla. |
Uloskirjautuminen | logout | Käyttäjän istunnon päättäminen sekä asiointipalvelussa että Suomi.fi-tunnistuksessa. |
Kertakirjautuminen | Single Sign-On (SSO) | Tilanne, jossa käyttäjällä on samanaikaisesti aktiivinen istunto useammassa asiointipalvelussa saman tunnistustapahtuman perusteella. |
Piilotettu kutsu (iframe) | front-channel logout | SSO-tilanteessa tapahtuva uloskirjautumisilmoitus, joka lähetetään asiointipalvelulle selaimen kautta piilotetussa iframe-elementissä. |
Termi | Englanninkielinen termi | Kuvaus |
|---|---|---|
Avainrotaatio | key rotation | Allekirjoitus- ja salausavainten säännöllinen vaihtaminen. Ks. Suomi.fi-tunnistuksen avainten vaihto OIDC-rajapinnassa ja Asiointipalveluiden avainten vaihto OIDC-rajapinnassa. |
Julkisten avainten joukko | JSON Web Key Set (JWKS) | JSON-muotoinen tiedosto, joka sisältää joukon julkisia avaimia. |
Avaimen tunniste | Key ID (kid) | JWT:n otsikossa oleva tunniste, jolla vastaanottaja tietää, mitä avainta käyttää julkisten avainten joukosta (JWKS). |
Avaintyyppi | Key Type (kty) | JWK-avaimen kenttä, joka kertoo avainalgoritmin perheen (esim. RSA, EC). |
Käyttötarkoitus | Key Use (use) | JWK-avaimen valinnainen kenttä, joka kertoo, käytetäänkö avainta allekirjoitukseen (sig) vai salaukseen (enc). |
Allekirjoitusavain | signing key | Allekirjoituksen tarkoitettu avainpari. Yksityisellä avaimella JWT-tunnus allekirjoitetaan. Julkisella avaimella allekirjoitus tarkistetaan. |
Salausavain | encryption key | Salaukseen tarkoitettu avainpari. Julkisella avaimella JWT-tunnus (esim. id_token) salataan. Yksityisellä avaimella salaus puretaan. |
Termi | Englanninkielinen termi | Kuvaus |
|---|---|---|
Palveluhallinta | Service Management (portal) | Suomi.fi-tunnistuksen hallintaportaali, jonka kautta asiointipalvelu toimittaa metadatansa. |
Toistohyökkäys | replay attack | Hyökkäys, jossa aiemmin kaapattua, kelvollista viestiä (esim. tokenia) käytetään uudelleen luvattomasti. Estetään nonce-arvon avulla. |
Sivustojen välinen pyyntöväärennös | Cross-Site Request Forgery (CSRF) | Hyökkäys, jossa hyökkääjä huijaa käyttäjän selaimen tekemään pyynnön käyttäjän tietämättä. Estetään state-arvon avulla |