Muutokset

Siirry navigaatioon Siirry hakuun

SCS

1 305 merkkiä lisätty, 10. maaliskuuta 2021 kello 13.08
ei muokkausyhteenvetoa
SCS on oma ohjelmointirajapinta jonka tuki on toteutettava väliohjelmistossa toimiakseen. Nykyisellään tuli sille löytyy [[mPollux DigiSign Client]] ja [[SecMaker]] Net iD ohjelmistosta.
 
Yksinkertaisimmillaan kyseessä on siis JSON rajapinta http protokollan ylitse paikalliseen porttiin. Eli tuota pystyy kokeilemaan menemällä selaimella osoitteeseen https://localhost:53952/ jolloin saat sieltä sivun jossa pystyy käyttämään erilaisia testejä jne. Itse json rajapinta tukee kahta operaatiota eli '''version''' ja '''sign''' operaatiot. Jos haluaa käyttää rajapintaa ilman https:ää, niin porttinumero on 53951.
 
Version operaatio toimii hyvin yksinkertaisesti urli https://localhost:53952/version palauttaa:
 
<pre>
{ "version": "1.1",
"httpMethods": "GET, POST",
"contentTypes": "data, digest",
"signatureTypes": "signature,cms,cms-pades",
"selectorAvailable": true,
"hashAlgorithms": "SHA1, SHA224, SHA256, SHA384, SHA512"
}
</pre>
 
Varsinainen allekirjoitus operaatio on hieman monimutkaisempi, eli sinne https://localhost:53952/sign pitää lähettää seuraavan tapainen json:
 
<pre>
{ "version": "1.1",
"selector": {
"keyusages": [ "digitalsignature" ]
},
"signatureType": "signature",
"hashAlgorithm": "SHA256",
"contentType": "data",
"content: "xxxx"
}
</pre>
 
Missä tuo xxxx on base64 encoodattu merkkijono, joka siis allekirjoitetaan. Tuossa '''data''' versiossa tuon pitää olla muotoa jossa alussa on urli ja sen perässä vähintään 64-merkkiä pitkä digest.
== Katso myös==
 
* [[Google/Android]]
* [[Apple/iOS]]
== Aiheesta muualla ==
* https://developer.fineid.fi/scs/
* https://dvv.fi/fineid-maaritykset - SCS määritykset
* https://developer.fineid.fi/scs/ - SCS testisivustoja jne.
[[Luokka:Tekniikka]]

Navigointivalikko