Todistusten myöntäminen selitettynä: tarjouksesta hyväksyttyyn todistukseen
OpenID4VCI on eurooppalainen standardi todistuksen toimittamiseen jonkun wallettiin: tutkintotodistuksen, kaupparekisteriotteen tai katsastustodistuksen. Luovutus näyttää haltijalle yhdeltä hetkeltä, mutta sen takana monen asian on loksahdettava kohdalleen, ja jokainen niistä voi epäonnistua omalla tavallaan. Tämä sivu käy sen läpi käyttäen esimerkkinä kuljetusliikettä.
Kaksi tapaa aloittaa myöntäminen
Useimmiten myöntäminen alkaa siitä, että myöntäjä tarjoaa todistusta, tavallisesti QR-koodina tai linkkinä. Se, pitääkö haltijan tämän jälkeen kirjautua, riippuu yhdestä asiasta: tietääkö myöntäjä jo, kenen kanssa se asioi. Molemmat reitit päättyvät samaan paikkaan, todistus walletissa.
Haltija tunnetaan jo
1. Myöntäjä
Tietää jo, kenen kanssa se asioi, ja tarjoaa todistuksen siinä ja heti
2. Wallet
Hyväksyy tarjouksen, joskus vahvistamalla erikseen lähetetyn lyhyen koodin
3. Wallet
Noutaa todistuksen ja sitoo sen tähän laitteeseen
Haltijan on kirjauduttava ensin
1. Wallet
Alkaa tarjouksesta tai menee myöntäjän luo haltijan omasta aloitteesta
2. Myöntäjän kirjautuminen
Ohjaa haltijan kirjautumisen ja myönnettävän hyväksymisen läpi
3. Wallet
Noutaa todistuksen ja sitoo sen tähän laitteeseen
Credential-tarjouksen koko elinkaari
Myöntäminen etenee alla olevien vaiheiden kautta. Jokainen niistä voi epäonnistua erikseen, ja juuri ne epäonnistumiset päätyvät tukipalvelun hoidettaviksi, joten kannattaa tietää, missä ne sijaitsevat, ennen kuin suunnittelee prosessin niiden ympärille.
Käytännön esimerkki: katsastustodistus kuljetusliikkeen kalustolle
Katsastusasema myöntää katsastustodistuksen kuljetusliikkeen Business Walletiin rutiinikatsastuksen jälkeen. Katsastaja on jo vahvistanut paikan päällä, kuka kalustopäällikkö on, joten ei ole syytä vaatia häntä kirjautumaan uudelleen.
1. Tarjous
Katsastusaseman päätelaite näyttää QR-koodin
Sen lukeminen avaa walletin ja näyttää, mitä todistusta tarjotaan
2. Mitä tarjotaan
Wallet lukee myöntäjän julkaiseman kuvauksen todistuksesta
Näin kalustopäällikkö näkee, mitä todistus sisältää, ennen kuin hyväksyy mitään
3. Vahvistus
Wallet vahvistaa lyhyen koodin, jonka katsastusasema lähetti tekstiviestillä kalustopäällikölle
Se, joka kuvaa QR-koodin olan yli, ei silti saa todistusta itselleen
4. Sitominen wallettiin
Wallet osoittaa hallitsevansa salaisuutta, joka ei koskaan poistu laitteelta
Todistus on sidottu tuohon salaisuuteen, joten sen kopio on arvoton toisella laitteella
5. Myönnetty ja tallennettu
Katsastusasema allekirjoittaa todistuksen ja wallet tallentaa sen
Tästä eteenpäin kuljetusliike voi näyttää sen asiakkaalle tai valvontaviranomaiselle sekunneissa
Kun todistus ei ole vielä valmis
Yllä oleva esimerkki olettaa, että katsastuksen tulos on lopullinen. Jos rajatapaus on vietävä ensin vanhemman katsastajan käsiteltäväksi, todistusta ei voi luovuttaa paikan päällä. Standardi kattaa tämän tilanteen sen sijaan, että kalustopäällikön olisi tultava uudelleen.
Myönnetään paikan päällä
Haltija poistuu todistus walletissaan, yhdellä kertaa.
Myönnetään myöhemmin
Myöntäjä ilmoittaa tarvitsevansa lisää aikaa, ja wallet noutaa todistuksen, kun se on valmis. Haltijan ei tarvitse aloittaa alusta eikä tulla uudelleen paikan päälle.
Ympyrän sulkeminen
Myöntämisen jälkeen wallet voi kertoa myöntäjälle, miten se päättyi. Tämä on vapaaehtoista molemmin puolin eikä perillemenoa taata, joten se on hyödyllinen rikkinäisen kulun havaitsemiseen, mutta myöntäjä ei voi päätellä mitään viestistä, joka ei koskaan saavu.
Wallet
Voi kertoa myöntäjälle, miten myöntäminen päättyi
Tallennettu
Todistus on walletissa ja valmis käyttöön
Epäonnistui
Jokin meni pieleen, esimerkiksi todistus ei läpäissyt tarkistusta
Hylätty
Haltija päätti olla säilyttämättä sitä
Mitä tämä tarkoittaa sinulle
Myöntäjä
Yksi standarditapa jakaa todistuksia, jonka jokainen vaatimustenmukainen wallet hyväksyy, ilman wallet-kohtaista integraatiota ja ilman portaalia, johon haltijoiden pitäisi kirjautua.
Haltija
Näet, mitä sinulle ollaan antamassa, ennen kuin hyväksyt sen, ja se on sidottu laitteeseesi eikä kirjautumiseen, jonka voisit menettää.
Todentaja
Todistukset saapuvat valmiiksi tarkistettuina ja valmiiksi sidottuina ne esittävään wallettiin, joten sellaisen hyväksyminen on tarkistus eikä tutkimus.
Tekninen syväsukellus
Tämä sivu kertoo, mitä teknologia tekee ja keitä se koskee. Kehittäjädokumentaatiomme käsittelee itse toteutusta: viestit, kentät ja käytännön esimerkit, joita integraatiotiimi tarvitsee.
Lue tekninen dokumentaatioAiheeseen liittyvät termit
Usein kysytyt kysymykset
Milloin haltijan on kirjauduttava ja milloin ei?
Se riippuu siitä, tietääkö myöntäjä jo, kenen kanssa se asioi. Katsastaja, joka on juuri tarkastanut ajoneuvon paikan päällä, ei tarvitse kalustopäällikön kirjautumista uudelleen, joten todistus tarjotaan heti. Verkkopalvelu, joka ei ole koskaan tavannut haltijaa, ohjaa hänet ensin omaan kirjautumiseensa. Tarjous itse kertoo, kumpi näistä pätee.
Mistä wallet tietää, mitä se on vastaanottamassa?
Jokainen myöntäjä julkaisee kuvauksen siitä, mitä se myöntää, ja wallet lukee sen ennen kuin mitään muuta tapahtuu. Juuri se mahdollistaa sen, että wallet näyttää haltijalle, mikä todistus on ja mitä se sisältää, jotta suostumuksella on merkitystä. Se tarkoittaa myös, että myöntäjä voi lisätä uuden todistustyypin ilman että jokaista wallettia pitää päivittää.
Mikä estää kopioimasta todistusta toiselle laitteelle?
Ennen myöntämistä wallet osoittaa hallitsevansa salaisuutta, joka ei koskaan poistu laitteelta, ja myöntäjä sitoo todistuksen siihen. Todentaja voi myöhemmin pyytää wallettia osoittamaan saman uudelleen. Todistuksen kopio ilman tuota salaisuutta ei läpäise tarkistusta, joten tiedoston kopioimisesta ei ole mitään hyötyä.
Entä jos todistusta ei voi myöntää heti?
Jotkin tarkistukset kestävät pidempään kuin ihminen on valmis odottamaan: manuaalinen käsittely tai kysely hitaaseen ulkoiseen rekisteriin. Myöntäjä voi ilmoittaa tästä, ja wallet noutaa todistuksen, kun se on valmis. Haltijan ei tarvitse aloittaa alusta eikä tulla uudelleen paikan päälle.
Saako myöntäjä tietää, säilytettiinkö todistus todella?
Se voi, mutta vain kohteliaisuutena. Wallet voi ilmoittaa, että todistus tallennettiin, että haltija kieltäytyi siitä tai että jokin epäonnistui. Kumpaakaan osapuolta ei vaadita tukemaan tätä eikä perillemenoa taata, joten myöntäjän tulisi pitää sitä hyödyllisenä signaalina eikä koskaan tapahtuneen kirjauksena.
Lähteet
Tämä sivu on informatiivinen eikä muodosta oikeudellista neuvontaa. Luotettavaa ohjeistusta varten ota yhteyttä suoraan OpenID Foundationiin ja Euroopan komissioon.