Muutokset

'''Signature Creation Service''' (''SCS'') on [[Digivirasto]]n vuonna 2014 kehittämä ja tuottamaallekirjoitusratkaisu, jonka avulla päätelaitteella (web-selain, mobiililaite) voi allekirjoittaa web-palvelussa sijaitsevaa sisältöä. Itse toteutus on ilmeisesti merkittävästi vanhempi henkilökortin alkuajoista (2000 alusta) lähtien, sen nimi, dokumentaatio ja mobiililaitteiden tuki tehtiin vasta vuoden 2014 aikoihin.

Allekirjoitustapahtumassa SCS tukeutuu käyttää käyttäjän päätelaitteessa väliohjelmiston (''eng middleware'') kautta saatavilla olevaan varmenteisiinolevia henkilökortin varmenteita, tarjoaa niistä listan käyttäjälle ja allekirjoittaa tapahtuman käyttäjän valinnan ja syöttämän tunnusluvun jälkeen.

SCS on oma ohjelmointirajapinta jonka tuki on toteutettava väliohjelmistossa toimiakseen. Nykyisellään tuli sille löytyy [[DigiSign Client]] - ja [[SecMaker]] Net iD ohjelmistosta-ohjelmistoissa sekä Android ''SCS Signer'' -sovelluksessa. Ilmeisesti tarkoitus on ollut tukea myös [[Apple]] [[Apple/iOS|iOS]]- ja [[Apple/iPadOS|iPadOS]]-laitteita, mutta tällä hetkellä (2022-01) SCS Signer-ohjelmaa ei ole edelleenkään saatavilla niihin.

Yksinkertaisimmillaan kyseessä == Toteutuksesta ==Totetustapa on siis JSON rajapinta http protokollan ylitse paikalliseen porttiintietotekniikassa harvinainen. Eli tuota pystyy kokeilemaan menemällä selaimella osoitteeseen https://localhost:53952/ jolloin saat sieltä sivun jossa pystyy käyttämään erilaisia testejä jnePaikallisesti suoritettava ohjelmisto (web-selain) kommunikoi verkkoa käyttäen toisen paikallisesti suoritettavan ohjelmiston kanssa (DigiSign middleware). Itse json rajapinta tukee kahta operaatiota eli '''version''' ja '''sign''' operaatiotSyitä toteutustavan valinnalle voi vain arvailla. Jos haluaa käyttää rajapintaa ilman httpsSeuraavat kohdat silti liittyvät toteutustapaan:ää* web-selain käsittelee verkon sisältöä ja yrittää suojata sitä suorittavaa käyttöjärjestelmää ja muita sovelluksia, niin porttinumero joten pääsy henkilökortin varmenteisiin on em suojausten takia hankalaa* Digiviraston kehitystyötä on 53951aina ohjannut pelkät Microsoftin tuotteet ja Googlen mobiiliohjelmistot* DigSign-ohjelmiston kehitysaikoihin selaimien PKCS#11-rajapinta oli mahdollisesti tekemättä eri selaimissa* verkon yli kommunikoidessa laitteessa päällä oleva palomuuri voi estää toiminnan, toisin kuin PKCS#11 tai muissa IPC-/RPC-yhteystavoissa.* allekirjoitusrajapinta tulee suojata ulkoiselta käytöltä (joko middlewaressa, palomuurilla tai molemmilla)* toteutettavaa toimintoa ei ollut aikanaan eikä nykyään kansainvälisesti standardoitu.

Version operaatio Virossa ja Belgiassa vastaava on toteutettu selaimen PKCS#11 laajennoksella joka kommunikoi varmennekortteja hallinnoivan PCSC-ohjelmiston kanssa. == Toiminta ==  Tekninen toteutus on JSON-muotoa käyttävä rajapinta HTTP-yhteystavalla paikalliseen porttiin. Rajapintaa voi kokeilla avaamalla selaimella osoitteen https://localhost:53952/ jolloin aukeaa sivu 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 salausta (https) niin porttinumero on 53951. Versionkyselyoperaatio toimii hyvin yksinkertaisesti urli , osoite https://localhost:53952/version palauttaa:

Varsinainen allekirjoitus operaatio allekirjoitusoperaatio on hieman monimutkaisempi, eli sinne osoitteeseen https://localhost:53952/sign pitää lähettää seuraavan tapainen jsonseuraavanlainen JSON:

Missä tuo missä ''xxxx '' on base64 encoodattu -koodattu merkkijono, joka siis allekirjoitetaan. Tuossa '''data''' versiossa tuon pitää olla muotoa jossa alussa on urli URL ja sen perässä vähintään 64-merkkiä pitkä digest.